告警表达式语法

告警规则表达式语法本质是时序指标数据之间的运算，运算逻辑是寻找相同的 Label(数据标签)的指标值进行运算，不相同的 Label(数据标签)的指标值无法进行运算，所以表达式语法在做运算时 Label(数据标签) 需要保持一致。

举例：

在时序指标数据中，每个时间序列都由指标名称（Metric Name）和数据标签（Label）来唯一标识，格式为<metric name>{<label name>=<label value>, …}。

在配置告警时，辅助配置中有两个很重要的配置，值字段和标签字段。

值字段：指定查询结果的某列作为查询条件的结果，可以理解为指标名称（Metric Name）。

标签字段：指定查询结果的那些列作为值字段的标签名和标签值，也就是标签（Label）。

根据上图数据格式转化如下

变量	变量的值字段（Metric Name）	变量值的标签字段（Label）	转化时序数据格式
A	$A.price	$A.product_name	A.price{product_name=} value

如果在告警配置查询统计中在增加一个 B 查询条件，且还需要 A 查询条件与 B 查询条件运算，那么 A 和 B 两个查询条件的数据标签必须一致，才可以进行运算，否则无法进行运算，下图 B 的数据标签与 A 的数据标签不一致，是无法运算的，通过字段重命名统一数据标签实现 $A 和 $B 的运算。

运算	说明	示例
==	检查两个值是否相等，如果相等返回 True 否则返回 False。	$A == $B $A == 0
!=	检查两个值是否不相等，如果不相等返回 True 否则返回 False。	$A != $B $A.count != 0
>	检查左边值是否大于右边值，如果是返回 True 否则返回 False。	$A > $B $A > 0
<	检查左边值是否小于右边值，如果是返回 True 否则返回 False。	$A < $B $A < 0
>=	检查左边值是否大于等于右边值，如果是返回 True 否则返回 False。	$A >= $B $A > 0
<=	检查左边值是否小于等于右边值，如果是返回 True 否则返回 False。	$A <= $B $A <= 0

当前时间字段	说明	示例
now().Unix()	用于比对查询数据时间戳字段与当前时间的差，Unix()时间格式只支持加减运算。	$A.timestamp - now().Unix()

运算	说明	示例
&&	逻辑 AND 运算符。如果两边的操作数都是 True，则条件 True，否则为 False。	$A > 0 && $B < 10
\|\|	逻辑 OR 运算符。如果两边的操作数有一个 True，则条件 True，否则为 False。	$A + $B >20

运算	说明	示例
in	用于检查元素是否存在于数组中，返回 true 或 false 。如果元素存在是 True，则条件 True，否则为 False。	expr:$A in [“admin”, “moderator”] data:map[string]interface{}{“$.A”: “admin”} expected: true
not in	用于检查元素是否存在于数组中，返回 true 或 false 如果元素不存在是 True，则条件 True，否则为 False。	expr:$A not in [1, 2, 3] data:map[string]interface{}{“$.A”: 5} expected: true

运算	说明	示例
contains	用于检查元素是否存在于数组中，返回 true 或 false 。如果元素存在是 True，则条件 True，否则为 False。	expr:$A contains $B data: map[string]interface{}{“$.A”: “hello world”, “$.B”: “world”} expected: true
not contains	用于检查一个字符串是否不包含另一个字符串，，返回 true 或 false 。如果不包含返回 True，否则为 False。	expr: $.A contains $.B data:map[string]interface{}{“$.A”: “hello world”, “$.B”: “go”} expected: false,

运算	说明	示例
maeches	用于检查一个字符串是否符合给定的正则表达式，返回 true 或 false 。如果符合返回 True，否则为 False。	expr:$A matches $B data:map[string]interface{}{“$.A”: “123”, “$.B”: “^[0-9]+$”} expected: truee

运算	说明	示例
between	检查一个值是否在指定范围内，返回 true 或 false 。如果在指定范围内True，否则为 False。	expr:between($.A, [100,200]) data: map[string]interface{}{“$.A”: 155.0}, expected: true
not between	检查一个值是否不在指定范围内，返回 true 或 false 。如果不在指定范围内 True，否则为 False。	expr: not between($.A, [100.3,200.3]) data: map[string]interface{}{“$.A”: 155.1}, expected: false