跳转到主要内容
Monitors 通过 SLS 的 SQL 查询获取数据,并根据查询结果触发告警。

核心概念

阈值判定模式

此模式适用于需要对聚合后的数值进行阈值比对的场景。

配置方式

  1. 查询语句:编写 SLS SQL 聚合查询。
    • 示例:统计最近 15 分钟内,各主机的错误日志数量。
  2. 查询参数:
    • sls.project:(必填)项目名称。
    • sls.logstore:(必填)日志库名称。
    • sls.timespan.value:(选填)时间跨度数值,默认为 15。
    • sls.timespan.unit:(选填)时间跨度单位,支持 s(秒)、m(分)、h(时)、d(天)。默认为 m。
  3. 字段映射:
    • 值字段:选择 error_cnt,用于阈值判定。
    • 标签字段:选择 host,用于标识告警对象。明确选择标签字段后,其他非值字段会作为附加信息随告警携带。
    • 详细规则请参见查询结果字段映射。
  4. 阈值条件:
    • 使用 $A.field_name 引用数值。
    • 示例:Critical: $A.error_cnt > 50,Warning: $A.error_cnt > 10。

工作原理

Monitors 按配置的时间范围执行 SLS 查询,按标签字段区分告警对象,并使用值字段进行阈值判定。标签字段留空时,除值字段外的返回字段会作为标签。

恢复逻辑

恢复方式见告警恢复。恢复查询是独立 SQL,支持 ${label_name} 变量,也支持 Go 模板 {{ $labels.<标签名> }}(需告警引擎 v0.75.4 及以上)。

数据存在模式

此模式适用于将过滤逻辑直接写在 SQL 中的场景。

配置方式

  1. 查询语句:使用 HAVING 子句过滤异常数据。
    • 示例:查询错误数超过 50 的主机。
  2. 查询参数:同上,需配置 sls.project 和 sls.logstore。
  3. 判定规则:只要查询返回了数据,即触发告警。
数据存在模式无法区分多级告警;需要分级时使用阈值判定模式。

恢复逻辑

恢复方式见告警恢复。

数据缺失模式

此模式用于监控”预期应该有数据,但实际没有数据”的场景。 SLS 提供两种无数据判定,二选一或按需分别启用: 云日志类数据源里只有腾讯云 CLS 不支持按曲线判定,见腾讯云 CLS。

配置方式

  1. 查询语句:编写一个预期应该持续返回数据的查询。
    • 示例:查询所有主机的日志上报心跳。
  2. 判定规则:选择上表中的判定方式并启用。选「所有查询均无返回数据时告警」时,N 由该页签共享的 触发条件 决定;选「之前查到过数据,现在查不到了,就告警」时,按曲线分别判定,可另外配置上表中的恢复方式。

恢复逻辑

“所有查询均无返回数据时告警”的恢复方式不可配置,固定为任一查询重新查到数据后自动恢复,界面上以只读文本展示。

高级配置

如果需要使用 SLS 的增强 SQL 语法,在查询参数中添加:sls.powersql: true
默认查询最近 15 分钟的数据。可通过参数调整:
不要在 SQL 中使用 __time__ 进行过滤,引擎会自动根据参数设置时间范围。
原始日志检索模式下,通过 sls.lines 控制单次查询最多返回的日志条数。每返回一条日志,就可能生成一条告警。该参数仅对原始日志检索有效;查询中包含 SQL 时,阿里云会忽略该配置。
仅用于调试,不要配置在生产规则中: