云开发 CLI 新增监控告警：一条命令，把线上问题拦在用户反馈前

线上出问题，往往是用户先发现、开发者后知后觉。云开发 CLI 新增监控与告警能力，用一条命令替代反复打开控制台，把"看指标、配告警"搬进终端与脚本，让线上问题在用户反馈前就被拦下。

线上问题，别等用户来报

发现问题靠人肉刷控制台，慢且容易漏。函数报错、时延突增，等开发者看到时用户已经踩了半小时。监控告警要能进命令行、进脚本，才能做到持续巡检、异常主动播报。

CLI 新增监控告警，一条命令替代开控制台

CloudBase CLI v3.5.8 新增两类能力：tcb monitor 看指标，tcb api monitor 配告警。统一入口覆盖云函数 / 数据库 / MySQL / 云托管 / 静态托管 / 认证 / 大模型 / 知识库 / 网关 / 登录 / DB Connector / 环境 QPS 共 12 类资源。

• • tcb monitor：一眼看清资源健康度，一行命令拉取 12 类资源的实时指标。
• • tcb api monitor：让风险主动找开发者，指标越界自动告警，推送到企微 / 邮件 / 短信。

快、可编排、有兜底

• • 快：一行命令拉取 12 类资源的实时指标，告别控制台层层点选。
• • 可编排：命令可直接写进脚本、定时巡检、CI 流水线，异常自动播报。
• • 有兜底：指标越界自动告警，质量风险主动通知，不再被动等用户投诉。

两条命令搞定

1. 看指标：tcb monitor

tcb monitor function --name helloWorld --metric-name FunctionError --last 7d
tcb monitor function --name helloWorld --metric-name FunctionDuration --last 24h --json

• • 相对时间窗口：--last 7d / --last 24h
• • 精准指标：--metric-name FunctionError
• • 结构化输出：--json（便于脚本消费）
• • 指标清单：tcb monitor schema <资源类型>

典型用法：排障时一键拉错误数与时延曲线；周报时 --json 输出喂给脚本自动生成水位报表。

2. 配告警：tcb api monitor

场景：函数报错即告警。 当任意云函数版本出现错误，立即推送通知到企微 / 邮件 / 短信：

tcb api monitor CreateAlarmPolicy --api-version 2018-07-24 --body '{ 
  "Module": "monitor",
  "PolicyName": "云函数版本错误数告警",
  "MonitorType": "MT_QCE",
  "Namespace": "SCF",
  "ProjectId": 0,
  "Enable": 1,
  "Condition": {
    "IsUnionRule": 1,
    "Rules": [
      { "MetricName": "Error", "Period": 60, "Operator": "gt",
        "Value": "0", "ContinuePeriod": 1, "NoticeFrequency": 3600, "IsPowerNotice": 0 }
    ]
  },
  "NoticeIds": ["notice-xxxxxxxx"]
}'

• • 创建即覆盖该命名空间下所有函数版本，无需逐个绑定。
• • 返回 PolicyId，可用于后续删除或精确绑定到指定实例。
• • NoticeIds 为通知模板 ID，不需要可删除该行。

3. 升级到 v3.5.8

npm i -g @cloudbase/cli@latest
tcb -v   # 确认 ≥ 3.5.8

参考文档

• • 监控：https://docs.cloudbase.net/cli-v1/monitor/management
• • 告警：https://docs.cloudbase.net/cli-v1/monitor/alert
• • 可观测平台 API：https://cloud.tencent.com/document/api/248/87588