腾讯云日志服务（CLS）查询与分析指南，用于在查询或分析腾讯云 CLS 日志时提供操作规范与语法参考。
用途 该技能面向腾讯云 CLS 的日志检索与分析场景，帮助使用者编写 CQL 搜索查询、对日志数据执行 SQL 分析，以及通过 CLS MCP 工具完成日志搜索、聚类、上下文获取和时间分布统计。
主要能力
- CQL 搜索：支持键值搜索、数值搜索、全文搜索、逻辑与、范围查询、通配符、字段存在判断与排除等语法。
- SQL 分析：以“<CQL过滤> | SELECT ...”的形式对日志做聚合统计，例如统计总数与去重 UV，并按时间分组排序。
- MCP 工具：提供 search（搜索日志）、cluster_logs（聚类相似日志）、log_context（获取日志上下文）、histogram（时间分布统计）四类工具，各自带有 topic、query、from、limit、format、field、simTh、time、pkgId、pkgLogId、buckets 等关键参数。
使用方式 通过 mcp-cli 调用 CLS MCP 工具，例如搜索日志：mcp-cli call <cls-server>/search '{"topic":"my-topic","query":"level:"ERROR"","from":"-6h","limit":50}'；聚类分析：mcp-cli call <cls-server>/cluster_logs '{"topic":"my-topic","query":"level:"ERROR"","from":"-3d"}'；日志上下文：mcp-cli call <cls-server>/log_context '{"topic":"my-topic","time":"...","pkgId":"...","pkgLogId":"..."}'；时间分布：mcp-cli call <cls-server>/histogram '{"topic":"my-topic","from":"-24h","buckets":24}'。
关键规则 CQL 中的字符串值必须加引号，例如 level:"ERROR" 而非 level:ERROR；搜索时必须指定 topic，CLS 需要 topic 上下文；SQL 分析仅在 topic 开启“统计分析”时可用，结果为空可能意味着 Analysis: false；SQL 分析中的时间操作使用 cast(TIMESTAMP as timestamp)。逻辑运算中 AND 优先级高于 OR，建议用括号明确，如 (A OR B) AND C。
参考文档 references/cql-syntax.md 提供 CQL 搜索语法详解、时间格式与日志解析失败排查；references/sql-analysis.md 提供 SQL 分析语法、常用函数与分析示例；references/mcp-tools.md 提供 CLS MCP 工具完整参数、响应格式与 CLI 配置。
适用场景与限制 适用于腾讯云 CLS 日志的检索、聚合分析与 MCP 工具调用。使用前需具备可用的 CLS topic 与 MCP 服务配置；SQL 分析依赖 topic 已开启统计分析功能。关于收费、价格、平台支持范围等信息，资料中暂未提供。