腾讯云CLS日志查询

技能简介

clscli 是面向腾讯云日志服务（CLS）的命令行工具，支持在终端快速检索、过滤和分析海量日志数据，无需登录控制台即可完成排查与统计。

能做什么

• 列出指定地域的日志主题，快速定位目标 Topic
• 使用 CQL 或 Lucene 语法进行关键词、范围、模糊匹配检索
• 执行 SQL 聚合统计（count、group by、order by 等）
• 导出结果为 JSON/CSV 文件，便于二次处理
• 自动分页拉取大批量日志，支持时间窗口限定

使用说明

1. 安装 clscli

brew tap dbwang0130/clscli
brew install dbwang0130/clscli/clscli

2. 配置环境变量

export TENCENTCLOUD_SECRET_ID="your-secret-id"
export TENCENTCLOUD_SECRET_KEY="your-secret-key"

密钥获取方式参考：腾讯云文档

3. 基础用法

先列出日志主题（若未知 Topic）：

clscli topics --region ap-guangzhou

执行日志查询：

clscli query -q "level:ERROR" --region ap-guangzhou -t <TopicId> --last 1h

SQL 聚合示例：

clscli query -q "* | select count(*) as cnt, status group by status" --region ap-guangzhou -t <TopicId> --last 24h

导出到文件：

clscli query -q "..." --region ap-guangzhou -t <TopicId> --last 1h -o result.csv

输入与输出

见下方输入与输出表格。

项目	内容
输入	查询语句（CQL/SQL）、地域标识、日志主题 ID、时间范围、输出格式选项
输出	JSON/CSV 格式日志条目、主题元数据列表、SQL 聚合计算结果
适用人群	云运维工程师、安全审计人员、后端开发、DevOps 工程师
不包含	日志采集配置、告警规则、可视化仪表盘、Kafka 消费组管理

 

风险提示

• SecretKey 属于敏感凭证，避免硬编码或提交至代码仓库
• 大范围时间查询可能产生较多费用，建议先用小时间窗口测试
• SQL 语句中 LIMIT 默认 100，超大结果需显式调整或使用分页
• Lucene 语法对特殊字符限制较多，优先使用 CQL

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/dbwang0130/clscli/SKILL.md
来源类型：GitHub 开源技能