告警配置

通常我们可以使用运行参数 -alertmanager.xxx 来配置 Alertmanager， 但是这样不够灵活，没有办法做到动态更新加载，以及动态定义告警属性。

所以 alerting 配置主要用来解决这个问题，它能够更好的管理 Alertmanager, 主要包含 2 个参数：

  • alert_relabel_configs: 动态修改 alert 属性的规则配置。
  • alertmanagers: 用于动态发现 Alertmanager 的配置。

其代码结构体定义为：

  1. // AlertingConfig configures alerting and alertmanager related configs.
  2. type AlertingConfig struct {
  3.     AlertRelabelConfigs []*RelabelConfig      `yaml:"alert_relabel_configs,omitempty"`
  4.     AlertmanagerConfigs []*AlertmanagerConfig `yaml:"alertmanagers,omitempty"`
  6.     // Catches all undefined fields and must be empty after parsing.
  7.     XXX map[string]interface{} `yaml:",inline"`
  8. }

配置文件结构大概为：

  1. # Alerting specifies settings related to the Alertmanager.
  2. alerting:
  3.   alert_relabel_configs:
  4.     [ - <relabel_config> ... ]
  5.   alertmanagers:
  6.     [ - <alertmanager_config> ... ]

其中 alertmanagers 为 alertmanager_config 数组，而 alertmanager_config 的代码结构体为,

  1. // AlertmanagerConfig configures how Alertmanagers can be discovered and communicated with.
  2. type AlertmanagerConfig struct {
  3.     // We cannot do proper Go type embedding below as the parser will then parse
  4.     // values arbitrarily into the overflow maps of further-down types.
  6.     ServiceDiscoveryConfig ServiceDiscoveryConfig `yaml:",inline"`
  7.     HTTPClientConfig       HTTPClientConfig       `yaml:",inline"`
  9.     // The URL scheme to use when talking to Alertmanagers.
  10.     Scheme string `yaml:"scheme,omitempty"`
  11.     // Path prefix to add in front of the push endpoint path.
  12.     PathPrefix string `yaml:"path_prefix,omitempty"`
  13.     // The timeout used when sending alerts.
  14.     Timeout time.Duration `yaml:"timeout,omitempty"`
  16.     // List of Alertmanager relabel configurations.
  17.     RelabelConfigs []*RelabelConfig `yaml:"relabel_configs,omitempty"`
  19.     // Catches all undefined fields and must be empty after parsing.
  20.     XXX map[string]interface{} `yaml:",inline"`
  21. }

配置文件结构大概为:

  1. # Per-target Alertmanager timeout when pushing alerts.
  2. [ timeout: <duration> | default = 10s ]
  4. # Prefix for the HTTP path alerts are pushed to.
  5. [ path_prefix: <path> | default = / ]
  7. # Configures the protocol scheme used for requests.
  8. [ scheme: <scheme> | default = http ]
  10. # Sets the `Authorization` header on every request with the
  11. # configured username and password.
  12. basic_auth:
  13.   [ username: <string> ]
  14.   [ password: <string> ]
  16. # Sets the `Authorization` header on every request with
  17. # the configured bearer token. It is mutually exclusive with `bearer_token_file`.
  18. [ bearer_token: <string> ]
  20. # Sets the `Authorization` header on every request with the bearer token
  21. # read from the configured file. It is mutually exclusive with `bearer_token`.
  22. [ bearer_token_file: /path/to/bearer/token/file ]
  24. # Configures the scrape request's TLS settings.
  25. tls_config:
  26.   [ <tls_config> ]
  28. # Optional proxy URL.
  29. [ proxy_url: <string> ]
  31. # List of Azure service discovery configurations.
  32. azure_sd_configs:
  33.   [ - <azure_sd_config> ... ]
  35. # List of Consul service discovery configurations.
  36. consul_sd_configs:
  37.   [ - <consul_sd_config> ... ]
  39. # List of DNS service discovery configurations.
  40. dns_sd_configs:
  41.   [ - <dns_sd_config> ... ]
  43. # List of EC2 service discovery configurations.
  44. ec2_sd_configs:
  45.   [ - <ec2_sd_config> ... ]
  47. # List of file service discovery configurations.
  48. file_sd_configs:
  49.   [ - <file_sd_config> ... ]
  51. # List of GCE service discovery configurations.
  52. gce_sd_configs:
  53.   [ - <gce_sd_config> ... ]
  55. # List of Kubernetes service discovery configurations.
  56. kubernetes_sd_configs:
  57.   [ - <kubernetes_sd_config> ... ]
  59. # List of Marathon service discovery configurations.
  60. marathon_sd_configs:
  61.   [ - <marathon_sd_config> ... ]
  63. # List of AirBnB's Nerve service discovery configurations.
  64. nerve_sd_configs:
  65.   [ - <nerve_sd_config> ... ]
  67. # List of Zookeeper Serverset service discovery configurations.
  68. serverset_sd_configs:
  69.   [ - <serverset_sd_config> ... ]
  71. # List of Triton service discovery configurations.
  72. triton_sd_configs:
  73.   [ - <triton_sd_config> ... ]
  75. # List of labeled statically configured Alertmanagers.
  76. static_configs:
  77.   [ - <static_config> ... ]
  79. # List of Alertmanager relabel configurations.
  80. relabel_configs:
  81.   [ - <relabel_config> ... ]