SLO · 服務等級目標

---
doc_type: "slo"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["user-complaints", "journey-map"]
  optional: ["existing-metrics", "dependency-slos"]
---

# SLO: <service-name>

**Status:** Draft v0.X · **Owner:** <SRE name> · **Last updated:** YYYY-MM-DD

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 6 段（編號 1, 2, 3, 6, 10, 12），全部必填——刻意沿用完整版的章節編號讓兩版可對照。每結論行內加 `（依據：tickets §XXX / journey §YYY）`；每量化欄位加 `[H]/[M]/[L]` confidence badge；缺資料寫 `_TODO: 需要 XXX_` 不編造；**SLI 必須量在 user side**（不能只量 server side）；**SLO target 必須 < 100%**（100% 不是 SLO 是承諾失敗）。

---

## 1. Executive Summary

<!-- ai-fill: 3-5 行，PO + SRE 30 秒讀完。只寫「保護哪個使用者體驗、SLO 數字、為何選這個數字」 -->

<3-5 行說明>

> **TL;DR:** <一句話：本服務的核心 SLI 與 SLO 目標>

---

## 2. SLI Definition

<!-- ai-rule: 輕量版至少 1 條 SLI（latency 或 availability 擇一必填）。where_measured 必須 user-side / edge / synthetic 三選一 -->

| SLI ID | Name | What measured | Where measured | Aggregation | Confidence |
|---|---|---|---|---|---|
| SLI-001 | <e.g. checkout-success-rate> | <user-observable event> | user-side / edge / synthetic | <e.g. successful / total over 5m> | **[H]** |

---

## 3. SLO Target

<!-- ai-rule: target 必須 < 100%；window 至少 28d rolling；rationale 必須對應抱怨頻率或競品基準 -->

| SLI ref | Target | Window | Rationale | Confidence |
|---|---|---|---|---|
| SLI-001 | 99.9% | 28d rolling | <為何這個數字：對應抱怨頻率 / 競品 / 商業影響> | **[H]** |

> **Error budget:** 0.1% = 40.3 min / 28d

---

## 6. Dependency SLOs

<!-- ai-rule: 列出至少 1 條上游依賴的 SLO（math: 我們的 SLO 不能高於依賴 SLO） -->

| Dependency | Their SLO | Our max SLO | Note |
|---|---|---|---|
| <upstream service> | <number or TODO> | <cannot exceed their SLO> | <說明> |

---

## 10. Decision Log（key 2-3 條）

<!-- ai-rule: 每條必含 chosen + 至少 1 個 rejected + 拒絕原因 -->

| Date | Decision | Options | Chosen | Rejected why | Confidence |
|---|---|---|---|---|---|
| YYYY-MM-DD | SLO target 99.9% vs 99.95% | 99.0% / 99.9% / 99.95% | 99.9% | 99.0% (超過抱怨門檻)、99.95% (X 倍成本只減 Y% 抱怨) | **[H]** |

---

## 12. Confidence & Sources & TODO

- **整份文件最低 confidence 欄位：** <列出所有 [L] 與 [M]>
- **Fabricated assumptions（推測但 input 未明說）：**
  - <假設 1>
- **Highest-value next input:** <下一份最該補的資料：過去 90 天 user-side latency 分佈 / 競品 benchmark>

### TODO（缺資料）

- _TODO: 需要 90d user-side latency 分佈校準 SLI-001 閾值_

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 6 段 H2 章節齊全（編號 1, 2, 3, 6, 10, 12，刻意不連號）
> - [ ] 每個 SLI / SLO 帶 inline `[H/M/L]` badge
> - [ ] SLI where_measured 必為 user-side / edge / synthetic（不接受純 server-side）
> - [ ] SLO target < 100%
> - [ ] Window 至少 28d rolling
> - [ ] Dependency SLO 段已列「我們的 SLO 不能高於依賴」的數學檢查
> - [ ] Decision Log ≥ 1 條，每條有 rejected reason
> - [ ] 無 YAML / JSON schema 輸出（SLO 是給人讀的 markdown）