srekit slo¶
Сгенерировать SLO / SLI документ для сервиса: цель, окно, latency budget, с embedded PromQL-примером.
Синопсис¶
Флаги¶
| Флаг | Обязательный | Описание |
|---|---|---|
--service |
да | Имя сервиса |
--target |
нет | SLO-цель (например 99.9%). Default: 99.9% |
--window |
нет | Rolling window (например 30d). Default: 30d |
--latency |
нет | Latency budget (например 300ms). Default: 300ms |
Плюс общие output-флаги. Default имя файла: slo-<slug-of-service>.md.
Примеры¶
Defaults:
Жёстче target, длиннее window:
Структура секций¶
- Front matter:
id,creation_date,modification_date,type: slo,service,tags - Определение SLI (SLI definition) — success ratio и latency percentile, PromQL предрендерен со значениями service / window / latency
- Цель SLO (SLO target)
- Бюджет ошибок (Error budget)
- Последствия истощения бюджета (Consequences of budget exhaustion) — точка передачи в
srekit ebp - Зависимости (Dependencies)
- Регулярность пересмотра (Review cadence)
- Ссылки (References)
Структура данных для шаблона¶
slo шипится как v1 YAML-артефакт (internal/tmpl/templates/slo.yaml) — frontmatter, H1, meta_bullets, секции sli_definition, slo_target, error_budget, consequences_of_budget_exhaustion, dependencies, review_cadence, references. Template-выражения обращаются к .Meta.<Field> для ID, Service, Target, Window, LatencyTarget, Now. См. srekit postmortem для полной схемы.
См. также¶
srekit ebp— политика бюджета ошибок, операционализующая SLO.srekit runbook— что делать когда burn-алерты сработали.