告警规则

告警规则允许您可以基于 Prometheus 表达式定义告警条件,并将有关发出告警的通知发送到到外部服务。只要告警表达式在给定的时间点生成一个或多个矢量元素,告警就被这些元素的标签集视为活动状态。

' class="reference-link">

定义告警规则

告警规则的配置方式与记录规则相同。

示例告警规则文件如下:

  1. groups:
  2. - name: example
  3. rules:
  4. - alert: HighRequestLatency
  5. expr: job:request_latency_seconds:mean5m{job="myjob"} > 0.5
  6. for: 10m
  7. labels:
  8. severity: page
  9. annotations:
  10. summary: High request latency

可选的for子句使 Prometheus 在第一次遇到新的表达式输出向量元素与将告警即为对此元素触发进行计数之间等待一段时间。在本例中,Prometheus 在触发告警之前,检查10分钟内告警是否持续处于活动状态。处于活动状态但未触发的元素处于挂起状态。

labels子句指定一组标签添加到告警,与现有的标签冲突将会被覆盖。便签值可以模板化。

annotations子句指定一组信息标签,这些标签可用于存储更长的附加信息,例如告警描述或运行手册链接。注解值可以模板化。

' class="reference-link">

模板化

标签和注解值可以使用控制台模板模板化。$labels变量保存告警实例的标签键/值对。可以通过$externalLabels变量访问已配置的扩展标签。$value变量保存告警实例执行的值。

  1. # 输入告警实例的标签值
  2. {{ $labels.<labelname> }}
  3. # 输入触发告警元素的标志表达式的值
  4. {{ $value }}

示例:

  1. groups:
  2. - name: example
  3. rules:
  4. # Alert for any instance that is unreachable for >5 minutes.
  5. - alert: InstanceDown
  6. expr: up == 0
  7. for: 5m
  8. labels:
  9. severity: page
  10. annotations:
  11. summary: "Instance {{ $labels.instance }} down"
  12. description: "{{ $labels.instance }} of job {{ $labels.job }} has been down for more than 5 minutes."
  13. # Alert for any instance that has a median request latency >1s.
  14. - alert: APIHighRequestLatency
  15. expr: api_http_request_latencies_second{quantile="0.5"} > 1
  16. for: 10m
  17. annotations:
  18. summary: "High request latency on {{ $labels.instance }}"
  19. description: "{{ $labels.instance }} has a median request latency above 1s (current value: {{ $value }}s)"
' class="reference-link">

在运行时检查告警

要手动检查哪些告警处于活动状态(挂起或触发),请导航到 Prometheus 实例的 “Alerts” 选项卡。该页面将向您展示每个定义的的告警当前处于活动状态的确切标签集。

对于挂起和触发的告警,Prometheus 存储格式为ALERTS{alertname="<alert name>", alertstate="pending|firing", <additional alert labels>}的时间序列。只要警报处于活动(挂起或触发)状态,样本值就设置为1;如果不再是这种情况,则将该系列标记为过时。

' class="reference-link">

发送告警通知

Prometheus 的告警规则擅长确定当前已经发生的问题,但它并不是完美的通知解决方案。在简单的告警定义之上,还需要另一层来添加摘要,通知速率限制,静默和告警依赖。在 Prometheus 生态系统中,Alertmanager 扮演了这个角色。因此,Prometheus 可以配置为定期将有关告警状态的信息发送到 Alertmanager 实例,该实例随后负责调度正确的通知。

可以将 Prometheus 配置为通过其服务发现集成自动发现可用的 Alertmanager 实例。