前言¶

日志检索、指标采集与告警策略分析是运维与安全场景中的高频需求。在腾讯云 CLS（日志服务）上，传统方式需要多次切换控制台、复制查询语句，容易出现遗漏与不一致。下面介绍一个基于 SkillHub 的 CLS 专家技能，支持 CQL 日志检索、上下文查看、日志主题/日志集与机器组查看、采集规则查看、日志直方图、指标采集与 PromQL 查询、告警策略与告警历史分析，减少重复操作并提升一致性。

这是什么¶

• 一句话定位：腾讯云日志服务 CLS 专家技能，为 Claude 提供对 CLS 的深度操作与查询能力。
• 出品与维护：由腾讯云 CLS 发布，归类为 it-ops-security 分类。
• 解决什么问题：将日志检索、上下文查看、指标采集与 PromQL 查询、告警策略与告警历史分析等操作集中化，便于在对话中完成常见 CLS 任务。

核心功能¶

• CQL 日志检索：使用 CQL 语法进行日志查询，支持过滤、排序与分页。
• 上下文查看：在检索结果中查看上下文日志，便于定位问题链路。
• 日志主题/日志集查看：列出并查看日志主题与日志集信息。
• 机器组与机器状态查看：查看机器组与机器状态，便于排查采集异常。
• 采集规则查看：查看日志采集规则，便于检查配置是否正确。
• 日志直方图：生成日志字段的直方图，便于分析分布。
• 指标采集与 PromQL 查询：支持指标采集与 PromQL 查询，用于监控与告警分析。
• 告警策略与告警历史分析：查看告警策略与告警历史，便于评估与优化告警。

安装与启用¶

• 依赖：Claude Code / Codex CLI / Cursor（请根据实际环境选择对应方式）。
• 安装命令（示例，以 Codex CLI 为例）：

  codex install @tencent-adm/tencentcloud-cls

• 验证：

  codex list | grep tencent-adm/tencentcloud-cls

典型用法¶

• 1）日志检索：发起 CQL 查询，例如：

  SELECT * FROM default WHERE level='ERROR' ORDER BY time DESC LIMIT 100

• 2）上下文查看：在检索结果中调用上下文查看，获取前后日志片段。
• 3）日志直方图：对某字段生成直方图，例如：

  histogram(field='status_code')

• 4）指标采集与 PromQL：使用 PromQL 查询指标，例如：

  rate(http_requests_total[5m])

• 5）告警策略与告警历史：列出告警策略与告警历史记录，用于分析与优化。

适用场景与注意¶

• 适合谁：熟悉腾讯云 CLS 的运维与安全工程师，需要在对话中快速完成日志检索、指标查询与告警分析的开发者。
• 限制：需要有效的腾讯云 CLS API Key，并确保网络可访问 CLS 服务。
• 注意：建议为 CLS 配置最小权限，避免过度授权。

短结尾¶

该技能将日志检索、上下文查看、日志主题/日志集与机器组查看、采集规则查看、日志直方图、指标采集与 PromQL 查询、告警策略与告警历史分析等能力集中化，便于在对话中完成常见 CLS 任务。官方地址：https://api.skillhub.cn/tencent-adm/tencentcloud-cls