培训认证 CLS 日志排查

要解决什么问题

培训认证平台把日志分散在 6 套腾讯云 CLS 环境里：国内/国际各覆盖测试、生产、灰度，ap-guangzhou 与 ap-singapore 的 Topic ID 各不相同。线上排障时常见情况是：只有一句报错、requestId/traceId、或「刚才生产环境 500」——人工要先猜环境、再拼查询、再在控制台里翻上下文，很容易漏查 灰度（与生产并行）或查错地域。

技能如何工作

技能把一次排查收成固定流程：

1. 解析意图：从描述里抽出关键词（requestId、traceId、错误文案、API 路径、HTTP 状态等），映射目标环境（默认 prod + gray）、站点（默认国内），以及时间窗（如「最近」→ 15 分钟，未说明 → 最近 30 分钟）。
2. 解析 Topic：按 {site}_{environment}（如 domestic_prod）读取 references/env_config.md，得到 Region 与 TopicId。
3. 构造并执行查询：按 ID/错误/关键词拼 CLS 查询；复杂自然语言可经 TextToSearchLogQuery 转成合法语句，再用 SearchLog 拉取（时间戳用 ConvertTimeStringToTimestamp）。
4. 扩上下文与报告：对关键条目调用 DescribeLogContext（前后各约 15 条），必要时跨环境对比，输出结构化根因分析。

适用边界与注意点

• 使用前需确认 SKILL 内 Topic ID 快查表 与现网一致，变更后更新配置。
• 单次查询时间范围不宜超过 24 小时；结果过多应收窄时间与过滤条件，超时则拆窗重试。
• 无结果时会依次放宽时间、放宽关键词、尝试相邻环境，并说明已搜过的环境与区间——仍依赖 MCP 与 CLS 侧权限、网络可用性。