observability-manage-slos

服务级目标（SLO）

在 Elastic Observability 中创建和管理 SLO。SLO 使用根据 Elasticsearch 数据计算的服务级指标（SLI），跟踪服务性能是否达到可衡量的目标。

身份验证

SLO 操作通过 Kibana API 执行。使用 API key 或基本身份验证：

# API key
curl -H "Authorization: ApiKey <base64-encoded-key>" -H "kbn-xsrf: true" <KIBANA_URL>/api/observability/slos

# Basic auth
curl -u "$KIBANA_USER:$KIBANA_PASSWORD" -H "kbn-xsrf: true" <KIBANA_URL>/api/observability/slos

对于非默认空间，请在路径前添加：/s/<space_id>/api/observability/slos。

所有 POST、PUT 和 DELETE 请求都需包含 kbn-xsrf: true。

SLI 类型

类型	API 值	使用场景
自定义 KQL	sli.kql.custom	原始日志 — 使用 KQL 查询计算良好事件数/总事件数
自定义指标	sli.metric.custom	指标字段 — 使用聚合的计算公式
时间片指标	sli.metric.timeslice	指标字段 — 按时间片检查阈值
直方图指标	sli.histogram.custom	直方图字段 — 范围/值计数
APM 延迟	sli.apm.transactionDuration	APM — 延迟阈值
APM 可用性	sli.apm.transactionErrorRate	APM — 成功率
Synthetics 可用性	sli.synthetics.availability	Synthetics 监视器 — 正常运行时间百分比

指南

• objective.target 是介于 0 和 1 之间的小数（例如，99.5% 对应 0.995）。
• 时间片指标指示器要求设置 budgetingMethod: "timeslices"。
• 更新 SLO 会重置底层转换 — 历史数据将重新计算。
• 集群需要同时具有 transform 和 ingest 角色的节点。
• 当 SLO 卡住或索引映射发生更改后，请使用 POST .../slos/{id}/_reset。
• 按字段分组的 SLO 会为每个唯一值创建一个实例 — 避免使用基数过高的字段。
• Synthetics SLO 会自动按监视器和位置分组；请勿手动设置 groupBy。
• 不会通过 API 自动创建消耗率告警规则 — 请单独设置。

更多参考资料

如需查看官方文档，请参阅以下资源：

SLO 文档

• 服务级目标（SLO） — 概念、SLI 类型、预算方法和仪表板面板。
• 创建 SLO — 在 Kibana UI 中创建 SLO 的 分步指南。
• 查看和管理 SLO — 搜索、筛选和管理现有 SLO。

Kibana SLO API

• 创建 SLO — 包含所有 SLI 类型载荷的完整请求正文架构。
• 获取 SLO | 更新 | 删除 | 重置
• 启用 | 停用 | 获取定义

故障排查与访问权限

• 排查 SLO
• 配置 SLO 访问权限
• 创建 SLO 消耗速率规则