腾讯云 CLS 助手

要解决的问题

排查腾讯云 CLS 时，问题往往不止一句“日志没查到”：主题 ID 不对、索引没重建、机器离线、采集规则没绑机器组、告警被屏蔽，或 PromQL 写错。手工调用 API 还容易踩坑，比如 SearchLog 用毫秒时间戳而 QueryRangeMetric 用秒级时间戳，SQL 分析时不能再靠 Limit 和 Offset。该技能把这些动作收敛为基于 scripts/cls_api.py 的 API 工作流。

技能如何工作

• 日志链路：用 DescribeTopics 找主题，SearchLog 做 CQL/SQL 检索，DescribeLogContext 看上下文，DescribeLogHistogram 看时间分布。
• 采集链路：用 DescribeMachineGroups、DescribeMachines、DescribeConfigs、DescribeConfigMachineGroups 检查机器、采集配置和绑定关系。
• 指标与告警：用 QueryRangeMetric 查询 PromQL，用 DescribeAlarms、DescribeAlertRecordHistory、GetAlarmLog、DescribeAlarmShields 定位告警未触发或误触发。

适用边界

• 凭证只能来自环境变量，不能把 TENCENTCLOUD_SECRET_ID 或 TENCENTCLOUD_SECRET_KEY 明文拼进命令。
• 时间精度必须区分：日志类接口多为毫秒，指标类接口多为秒，DescribeLogContext.BTime 是 YYYY-mm-dd HH:MM:SS.FFF 字符串。
• DescribeLogContext 的地域支持有限，部分地域可能需要用 SearchLog 按时间范围模拟上下文。