## Alerting rules 警报规则
---
警报规则允许你基于Prometheus表达式语言的表达式定义报警报条件,并在触发警报时发送通知给外部的接收者。每当警报表达式在给定时间点产生一个或者多个向量元素,这个警报统计活跃的这些元素标签集。
警报规则在Prometheus系统中用同样的record rules方式进行配置
### 定义警报规则
警报规则的定义遵循下面的风格:
```
ALERT <alert name>
IF <expression>
[ FOR <duration> ]
[ LABELS <label set> ]
[ ANNOTATIONS <label set> ]
```
`FOR`选项语句会使Prometheus服务等待指定的时间, 在第一次遇到新的表达式输出向量元素(如:具有高HTTP错误率的实例)之间,并将该警报统计为该元素的触发。如果该元素的活跃的,且尚未触发,表示正在挂起状态。
`LABELS`选项语句允许指定额外的标签列表,把它们附加在警告上。任何已存在的冲突标签会被重写。这个标签值能够被模板化。
`ANNOTATIONS`选项语句指定了另一组标签,它们不被当做警告实例的身份标识。它们经常用于存储额外的信息,例如:警告描述,后者runbook链接。这个注释值能够被模板化。
### Templating 模板
```
# Alert for any instance that is unreachable for >5 minutes.
ALERT InstanceDown
IF up == 0
FOR 5m
LABELS { severity = "page" }
ANNOTATIONS {
summary = "Instance {{ $labels.instance }} down",
description = "{{ $labels.instance }} of job {{ $labels.job }} has been down for more than 5 minutes.",
}
# Alert for any instance that have a median request latency >1s.
ALERT APIHighRequestLatency
IF api_http_request_latencies_second{quantile="0.5"} > 1
FOR 1m
ANNOTATIONS {
summary = "High request latency on {{ $labels.instance }}",
description = "{{ $labels.instance }} has a median request latency above 1s (current value: {{ $value }}s)",
}
```
### 运行时检查警告
为了能够手动检查哪个警告是活跃的(挂起或者触发),导航到你的Prometheus服务实例的"Alerts"tab页面。这个会显示精确的标签集合,它们每一个定义的警告都是当前活跃的。
对于挂起和触发警告,Prometheus也存储形如`ALERTS{alertname="<alert name>", alertstat=s"pending|firing", <additional alert labels>}`. 只要警告是在指定的活跃(挂起或者触发)状态上,这个样本值设置为1。当一个警告从活跃状态变成不活跃状态时,这个样本值被设置为0。一旦不活跃,这个时间序列将不会再更新。
### 发送警告通知
Prometheus的警告规则擅长确定当前哪个实例有问题。但它们并不是一个完整的通知解决方案。在简单的警报定义上,需要另一个层来添加总结,通知速率限制,silencing,警报依赖。在Prometheus的生态系统中,Alertmanager发挥了这一作用。因此,Prometheus可能被配置为定期向Alertmanager实例发送有关警报信息,该实例然后负责调用正确的通知,可以通过`-alertmanager.url`命令行标志配置Alertmanager实例。