核心概念
查询参数
地域下拉提供常用地域建议列表(如 ap-guangzhou、ap-shanghai、ap-beijing 等),仅为建议而非白名单;也可以直接输入建议列表之外的地域 code。地域 code 需满足:小写字母开头,由小写字母、数字和连字符组成,且至少含一个连字符(如
ap-nanjing、na-siliconvalley),总长不超过 64 个字符。
地域 code 通过上述形状校验后,该地域是否真实存在、您的密钥在其中是否有权限,仍由腾讯云判定。
查询模式
原始日志检索(raw)
使用 CQL 或 Lucene 语法检索日志,返回匹配的日志行。每返回一条日志,就可能生成一条告警。- 时间窗口最长 6 小时。
- 用
tencent_cls.limit控制单次最多返回的日志条数,可填 1~100。新建规则默认写入1;参数缺失时,告警引擎也按1条执行。 - raw 模式下查询编辑器不提供关键字补全。
SQL 分析(analysis)
对日志进行 SQL 聚合,返回聚合结果,适合阈值判定与数据存在判定。- 时间窗口最长 24 小时。
- 不允许携带
tencent_cls.limit,携带时会被拒绝。
时间范围
默认查询最近 15 分钟(tencent_cls.timespan.value=15、tencent_cls.timespan.unit=m)的数据。时间窗口上限随查询模式变化:原始日志检索最长 6 小时,SQL 分析最长 24 小时;超出上限时表单直接报错(“时间窗口最长 N 小时”),无需等到保存。
数据源与主题要求
单数据源绑定
Tencent CLS 规则只能精确绑定一个数据源,不支持名称通配。主题索引要求
日志主题必须开启索引,否则检索和 SQL 分析都不会返回结果。主题列表会标出未开启索引的主题,请先在腾讯云控制台配置索引。主题 ID 执行
可以按名称搜索主题,或直接粘贴主题 ID。规则只保存并使用主题 ID(日志集筛选只用于查找,不会保存)。如果主题已被删除,编辑规则时需要重新选择。无数据检测
Tencent CLS 不支持按曲线(per-series)的无数据检测:- 只能使用“所有查询均无返回数据时告警”判定,不支持“之前查到过数据,现在查不到了,就告警”(通过 API 也无法开启)。
- 恢复方式固定为任一查询重新查到数据后自动恢复,不可配置,也不支持仅手工关闭。
恢复查询与关联查询
- 恢复查询:阈值判定模式选择“表达式查到数据就算恢复”、数据存在模式选择“恢复检测查到数据才恢复”时,恢复查询同样需要配置地域、日志主题、查询模式等参数,判定逻辑与主查询一致。
- 关联查询:关联查询支持同样的 Tencent CLS 参数,可在告警中附带相关信息。