1.4 KiB
1.4 KiB
可觀測性設計 (Observability Design) 知識合約指南
概述
observability-design 是知識合約，用來提供可觀測性設計的原則與模式。涵蓋 Logs、Metrics、Traces、Correlation IDs、Alerts 與 SLOs。供 design-architecture 在定義 Observability Strategy 時參考。
核心原則
可觀測性三支柱
- Logs：離散事件，含上下文（誰、什麼、何時、何地）
- Metrics：時間聚合的數值測量（速率、長條圖、Guage）
- Traces：跨服務端到端請求流
可觀測性不是監控
- 監控告訴你什麼時候壞了（已知未知）
- 可觀測性讓你能問為什麼壞了（未知未知）
- 必須從一開始就內建可觀測性，不能事後追加
設計重點
- Logs：Log 等級、結構化 Log（JSON）、集中式 Log 聚合
- Metrics：Counter、Gauge、Histogram、Summary；命名慣例
- Traces：分散式追蹤、Correlation ID 傳播、Span 設計
- Alerts：症狀警報、非操作警報；閾值與升遷路徑
- SLOs：可用性、延遲、正確性；Error Budget 與 Burn Rate Alerting
知識合約職責
- 提供可觀測性設計的理論指引
- 不直接產生監控設定或警報配置
不應做的事
- 不替系統選擇特定可觀測性工具
- 不定義具體的指標名稱或警報閾值
- 不產生監控設定檔案