CLS CLI 安装与使用

一、安装（30秒）

直接执行以下命令，一行搞定：

git clone https://github.com/trumphuang/CLS_CLI.git /tmp/CLS_CLI && cd /tmp/CLS_CLI/cls-cli && go build -o cls-cli . && mv cls-cli /usr/local/bin/ && rm -rf /tmp/CLS_CLI && cls-cli version

前提：系统已安装 Git 和 Go 1.23+。如果 /usr/local/bin 需要权限，把 mv 改成 sudo mv。

验证安装成功：

cls-cli version
# 输出: cls-cli version 0.2.0 (darwin/arm64)

二、配置（10秒）

cls-cli config init --secret-id \x3CSECRET_ID> --secret-key \x3CSECRET_KEY> --region ap-guangzhou

用户需要提供腾讯云 API 密钥，获取地址：https://console.cloud.tencent.com/cam/capi

也支持环境变量（CI/CD 场景推荐）：

export TENCENTCLOUD_SECRET_ID=xxx
export TENCENTCLOUD_SECRET_KEY=xxx
export CLS_DEFAULT_REGION=ap-guangzhou

三、升级

cls-cli upgrade

四、使用教程

全局参数

任何命令都可以加：

日志检索 log

cls-cli log +search --topic-id \x3Cid> --query "level:ERROR" --from "1 hour ago"
cls-cli log +context --topic-id \x3Cid> --pkg-id \x3Cpkg_id> --pkg-log-id \x3Clog_id>
cls-cli log +tail --topic-id \x3Cid> --query "*"
cls-cli log +histogram --topic-id \x3Cid> --query "*" --from "1 hour ago"
cls-cli log +download --topic-id \x3Cid> --query "*" --from "1 hour ago" --output logs.json

日志主题 topic

cls-cli topic +list
cls-cli topic +create --logset \x3Clogset_id> --name "my-topic" --ttl 30
cls-cli topic +info --topic \x3Ctopic_id>
cls-cli topic +delete --topic \x3Ctopic_id>
cls-cli topic +logsets                     # 列出日志集

告警管理 alarm

cls-cli alarm +list
cls-cli alarm +history --from "7 days ago"
cls-cli alarm +create --name "Error Alert" --topic \x3Cid> \
  --query "level:ERROR | SELECT COUNT(*) as cnt" \
  --condition '$1.cnt > 100' --period 5
cls-cli alarm +delete --alarm-id \x3Cid>
cls-cli alarm +notices                     # 列出通知渠道

仪表盘 dashboard（别名 dash）

cls-cli dash +list
cls-cli dash +info --id \x3Cdashboard_id>
cls-cli dash +create --name "运维总览"
cls-cli dash +update --id \x3Cid> --name "新名称"
cls-cli dash +delete --id \x3Cid>

机器组 machinegroup（别名 mg）

cls-cli mg +list
cls-cli mg +create --name web --type ip --values "10.0.0.1,10.0.0.2"
cls-cli mg +create --name web --type label --values "webserver"
cls-cli mg +status --id \x3Cgroup_id>
cls-cli mg +info --id \x3Cgroup_id>
cls-cli mg +delete --id \x3Cgroup_id>

采集配置 collector（别名 col）

cls-cli col +list
cls-cli col +create --name "app-logs" --topic \x3Cid> --type json \
  --path "/var/log/app" --file-pattern "*.log" --group-id \x3Cid>
cls-cli col +info --id \x3Cconfig_id>
cls-cli col +delete --id \x3Cconfig_id>
cls-cli col +guide                         # 采集入门指南

LogListener loglistener（别名 ll）

cls-cli ll +install                        # 生成安装脚本
cls-cli ll +init --region ap-guangzhou     # 初始化
cls-cli ll +start                          # 启动
cls-cli ll +stop / +restart / +status / +check / +uninstall

通用 API api

以上快捷命令未覆盖的操作，都可以用通用 API 调用（支持全部 150+ CLS API 3.0）：

cls-cli api \x3CAction> --params '\x3CJSON>'

# 示例
cls-cli api DescribeIndex --params '{"TopicId":"xxx"}'
cls-cli api CreateIndex --params '{"TopicId":"xxx","Rule":{...}}'

五、AI Agent 意图映射

当用户用自然语言描述需求时，按此表匹配命令：

六、常见地域