SuperAPI AI 工具集

slo-sli

部署与运维

查看项目

更新于 10-16 03:11

技能介绍

用途:该技能提供在 Prometheus 中落地 SLO(服务等级目标)与 SLI(服务等级指标)的模板,覆盖 SLI 定义、记录规则、错误预算计算和燃烧率告警,遵循 Google SRE 手册的多窗口燃烧率方法,用于服务可靠性管理。

主要能力:提供可用性 SLI(非 5xx 请求占比)与延迟 SLI(在阈值内完成的请求占比)的 PromQL 查询模板,支持按服务分组;还提供 GenAI 专用 SLI,基于 gen_ai_client_operation_duration_seconds 直方图按操作名与模型计算。记录规则按 sli:http_availability:ratio_rate<window> 等命名,窗口为 5m、30m、1h、6h、1d、3d、30d,预计算 SLI 以加速查询。错误预算部分给出 99.9%、99.5%、99.0% 目标的允许停机时间,以及剩余预算公式 1-(1-SLI)/(1-SLO_target) 和消耗率查询。燃烧率部分实现单窗口与多窗口(快烧 14.4x / 慢烧 1x)查询及对应 Prometheus 告警规则。

使用方式:所有查询通过 Prometheus HTTP API http://localhost:9090/api/v1/query 执行,本地无认证。记录规则和告警规则为 YAML 块,需加入 docker-compose/prometheus/prometheus.yml 的 rule_files 部分。连接默认变量包括 OPENSEARCH_ENDPOINT=https://localhost:9200、OPENSEARCH_USER=admin、OPENSEARCH_PASSWORD=My_password_123!@#、PROMETHEUS_ENDPOINT=http://localhost:9090。可通过 /api/v1/alerts 与 /api/v1/rules 查询告警状态。

适用场景:需要对 HTTP 服务或 GenAI 操作建立可用性与延迟 SLO、计算错误预算并据此告警的可靠性工程场景。

限制:需自行确认 OTel SDK 版本对应的状态码标签名(http_status_code 或 http_response_status_code),并确认指标单位以正确设置 le 桶边界;未提及收费、部署规模或效果保证等信息,暂未提供。