用途：Cargo Observability 是 Cargo CLI 的告警系统，用于监视 Cargo 工作区，在指标越过阈值时主动通知，与事后排查的 cargo-diagnostics 互补。
主要能力：告警由三部分组成——scope（测量对象，六种来源：spans、runs、records、orchestrationQuery、storageQuery、model）、threshold（指标加 gte/lte 运算符和值）、actions（触发时执行的动作，每个动作作为独立运行发起，可省略为静默告警）。scope 与 threshold 必须匹配，某指标只能在其可计算的 scope 上使用。
使用方式：先安装并登录 CLI，例如 npm install -g @cargo-ai/cli 后运行 cargo-ai login --email you@company.com，用 cargo-ai whoami 确认工作区。创建前先用 cargo-ai observability alert preview 预览当前测量值和是否超阈值，以校准阈值并验证配对是否有效。创建命令形如 cargo-ai observability alert create，支持 --name、--cron、--scope、--threshold、--actions、--disabled、--folder。读取用 alert list / get，修改用 alert update，删除用 alert remove。触发历史用 cargo-ai observability event list <alertUuid> 查看，事件含 status（healthy/unhealthy/error）、测量值、当时的 scope/threshold/actions 快照及 runUuids。
限制：--cron 为 UTC 的 5 字段 cron 或 @every，最快每分钟一次；--enabled 只接受字面 true/false。动作会作为真实运行发起，付费连接器或智能体动作每次触发都会计费，阈值和频率设置不当会反复计费。读取需 observability:read，写操作需 observability:write。scope/threshold 兼容矩阵、指标含义与单位、事件生命周期等细节见对应参考文档；也可用 CDK defineAlert 以声明式方式管理。cron 窗口、ClickHouse 索引延迟等细节暂未在本次资料中完整提供。