用 cx CLI 检查与管理 Coralogix SLO…

当需要列出或查看 Coralogix SLO、判断其是否接近违约、或从 JSON 增删改 SLO 定义时使用 `cx slos` 系列命令。

适用场景

解决思路

1. 列出所有 SLO 定义：运行 `cx slos list`；要只看关键字段可用 `cx slos list -o json | jq '[.[] | {name, targetThresholdPercentage, sloType, sloTimeFrame}]'`。
2. 查看单个 SLO 的完整定义：运行 `cx slos get <id>`，加 `-o json` 获得结构化输出。
3. 判断健康度：把实时达成率（attainment）与 `targetThresholdPercentage` 对比，而不是只看 SLO 是否存在；例如达成 99.91%、目标 99.9% 表示错误预算几乎耗尽，需在违约前介入。
4. 区分两种度量口径：`sloType` 为 `SLO_TYPE_REQUEST` 时衡量好事件占比；为 `SLO_TYPE_WINDOW` 时衡量好时间窗口占比。
5. 确认违约根因时，转到 `cx-telemetry-querying` 技能，在日志、span、指标中排查导致违约的原因。
6. 创建 SLO 时使用「往返（round-trip）」方式：先用 `cx slos get <existing-slo-id> -o json > slo.json` 从已有 SLO 导出模板，不要手写 JSON，以保证字段形状与 API 期望一致。
7. 编辑 slo.json 中的 `name`、`targetThresholdPercentage`、`sloType`、`sloTimeFrame` 等字段，然后运行 `cx slos create --from-file slo.json --yes`。
8. 替换已有定义时运行 `cx slos update --from-file slo.json --yes`。
9. `create`/`update` 从 `--from-file <path>` 读取定义，也可用 `-` 从 stdin 读取（stdin 为默认）。
10. 删除 SLO 时运行 `cx slos delete <id> --yes`。
11. `create`、`update`、`delete` 都是写操作，在非交互 / agent 模式下必须加 `--yes`。
12. 所有命令都支持 `-o json` 输出结构化结果，以及可重复的 `-p <profile>` 进行多 profile 扇出，用于跨环境对比 SLO。
13. 检查 `update`/`delete` 返回的 `effectedSloAlertIds`，审阅受影响的告警 ID；修改或删除 SLO 可能禁用其关联告警，删除 SLO 会使其告警静默。
14. 识别 SLO 定义的关键字段：`name`（名称）、`description`（可选描述）、`targetThresholdPercentage`（目标，如 99.9）、`sloType`（请求型/窗口型）、`sloTimeFrame`（如 `SLO_TIME_FRAME_7_DAYS`、`SLO_TIME_FRAME_28_DAYS`）、`productType`（计算所用的支柱，如 `SLO_PRODUCT_TYPE_APM`）。
15. 需要排查或联动时使用相关技能：`cx-alerts` 对应错误预算燃烧时触发的告警定义，`cx-cases` 用于分诊按服务分组的告警事件。

适用边界 · 注意事项

• 未安装并配置 Coralogix 的 `cx` CLI 与账号/profile 时不可用——本技能完全依赖 `cx slos` 命令。
• 不在 Coralogix 可观测性栈内管理 SLO 的场景不适用，本技能只覆盖 `cx slos` 的 SLO 生命周期。
• 想手写 JSON 定义而不做 `cx slos get` 往返模板时风险高，容易与 API 期望的字段形状不符，不建议使用。