<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>SLO on Eric 個人部落格</title><link>https://chihhung.github.io/Blog/tags/slo/</link><description>Recent content in SLO on Eric 個人部落格</description><generator>Hugo</generator><language>zh-TW</language><lastBuildDate>Tue, 06 Oct 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://chihhung.github.io/Blog/tags/slo/index.xml" rel="self" type="application/rss+xml"/><item><title>SLO 定義與錯誤預算政策範本（SLO &amp; Error Budget Policy Template）</title><link>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/templates/operations/slo_template/</link><pubDate>Tue, 06 Oct 2026 00:00:00 +0000</pubDate><guid>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/templates/operations/slo_template/</guid><description>&lt;h1 id="slo-定義與錯誤預算政策範本slo--error-budget-policy"&gt;SLO 定義與錯誤預算政策範本（SLO &amp;amp; Error Budget Policy）&lt;/h1&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;參照標準&lt;/strong&gt;：Google SRE Book／SRE Workbook（SLO、Error Budget、Multiwindow Multi-burn-rate Alerts）&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;文件用途&lt;/strong&gt;：定義服務的 SLI、SLO 與錯誤預算，並約定預算耗盡時的處理方式&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;適用階段&lt;/strong&gt;：設計階段定義，上線前完成告警，每季檢討&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;範本版本&lt;/strong&gt;：v2.0（2026-10-06）｜對應《軟體開發標準程序教學手冊》v2.0 第 10.2 節&lt;/p&gt;&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2 id="-章節目錄"&gt;📋 章節目錄&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href="#1-%E6%9C%8D%E5%8B%99%E8%88%87%E4%BD%BF%E7%94%A8%E8%80%85%E6%97%85%E7%A8%8B"&gt;服務與使用者旅程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#2-sli-%E5%AE%9A%E7%BE%A9"&gt;SLI 定義&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#3-slo-%E8%88%87%E9%8C%AF%E8%AA%A4%E9%A0%90%E7%AE%97"&gt;SLO 與錯誤預算&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#4-%E9%8C%AF%E8%AA%A4%E9%A0%90%E7%AE%97%E6%94%BF%E7%AD%96"&gt;錯誤預算政策&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#5-%E5%AF%A9%E6%9F%A5%E8%88%87%E9%A9%97%E8%AD%89"&gt;審查與驗證&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;h2 id="1-服務與使用者旅程"&gt;1. 服務與使用者旅程&lt;/h2&gt;
&lt;h3 id="-範本"&gt;📝 範本&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;內容&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;服務名稱&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;{名稱}&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;關鍵使用者旅程&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;{使用者最在意的 2–3 件事}&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;SLO 擁有者&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;{團隊／負責人}&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;相關 SLA&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;{對客戶的合約承諾，若有}&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="-使用說明"&gt;📖 使用說明&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;SLO 從「使用者感受」出發，不是從伺服器指標出發&lt;/li&gt;
&lt;li&gt;SLO 應比 SLA 嚴格，保留緩衝&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例"&gt;💡 範例&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;內容&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;服務名稱&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;HRMS API&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;關鍵使用者旅程&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;1. 打卡；2. 請假申請；3. 薪資單查詢&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;SLO 擁有者&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;HRMS 開發部（SRE 窗口：張）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;相關 SLA&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;內部服務，無對外 SLA；對 HR 部門承諾每月可用率 99.5%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id="2-sli-定義"&gt;2. SLI 定義&lt;/h2&gt;
&lt;h3 id="-範本-1"&gt;📝 範本&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;SLI&lt;/th&gt;
&lt;th&gt;好事件定義&lt;/th&gt;
&lt;th&gt;總事件定義&lt;/th&gt;
&lt;th&gt;量測位置&lt;/th&gt;
&lt;th&gt;PromQL（比例）&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;{名稱}&lt;/td&gt;
&lt;td&gt;{條件}&lt;/td&gt;
&lt;td&gt;{條件}&lt;/td&gt;
&lt;td&gt;{負載平衡器／應用程式／合成監控}&lt;/td&gt;
&lt;td&gt;{查詢式}&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="-使用說明-1"&gt;📖 使用說明&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;SLI 寫成「好事件 ÷ 總事件」，結果介於 0 與 1&lt;/li&gt;
&lt;li&gt;指標名稱必須與實際 instrumentation 相符，並在 Prometheus 確認查得到資料&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例-1"&gt;💡 範例&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;SLI&lt;/th&gt;
&lt;th&gt;好事件定義&lt;/th&gt;
&lt;th&gt;總事件定義&lt;/th&gt;
&lt;th&gt;量測位置&lt;/th&gt;
&lt;th&gt;PromQL（比例）&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;可用性&lt;/td&gt;
&lt;td&gt;回應狀態非 5xx&lt;/td&gt;
&lt;td&gt;所有請求&lt;/td&gt;
&lt;td&gt;應用程式（Micrometer）&lt;/td&gt;
&lt;td&gt;&lt;code&gt;1 - (sum(rate(http_server_requests_seconds_count{job=&amp;quot;hrms-api&amp;quot;,status=~&amp;quot;5..&amp;quot;}[30d])) / sum(rate(http_server_requests_seconds_count{job=&amp;quot;hrms-api&amp;quot;}[30d])))&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;延遲&lt;/td&gt;
&lt;td&gt;回應時間 ≤ 300 ms&lt;/td&gt;
&lt;td&gt;所有請求&lt;/td&gt;
&lt;td&gt;應用程式（histogram）&lt;/td&gt;
&lt;td&gt;&lt;code&gt;sum(rate(http_server_requests_seconds_bucket{job=&amp;quot;hrms-api&amp;quot;,le=&amp;quot;0.3&amp;quot;}[30d])) / sum(rate(http_server_requests_seconds_count{job=&amp;quot;hrms-api&amp;quot;}[30d]))&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;延遲 SLI 的 &lt;code&gt;le=&amp;quot;0.3&amp;quot;&lt;/code&gt; 必須是 histogram 實際存在的 bucket 邊界；Spring Boot 可用 &lt;code&gt;management.metrics.distribution.slo.http.server.requests=300ms&lt;/code&gt; 加入此邊界。&lt;/p&gt;</description></item><item><title>Metrics Visualization 教學手冊</title><link>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/%E5%B7%A5%E5%85%B7/metrics-visualization-%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/</link><pubDate>Mon, 26 Jan 2026 20:22:55 +0800</pubDate><guid>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/%E5%B7%A5%E5%85%B7/metrics-visualization-%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/</guid><description>&lt;h1 id="metrics-visualization-教學手冊prometheus--grafana"&gt;Metrics Visualization 教學手冊（Prometheus + Grafana）&lt;/h1&gt;
&lt;h2 id="文件資訊"&gt;文件資訊&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;內容&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;文件版本&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;2.0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;最後更新&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;2026-10-01&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;版本基準&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Prometheus 3.15.0（2026-09-24）、Prometheus LTS 3.13.x（支援至 2027-07-31）、Grafana 13.2.3（2026-09-29）、Alertmanager 0.34.1；完整矩陣見 &lt;a href="#13-%E7%89%88%E6%9C%AC%E5%9F%BA%E6%BA%96%E8%88%87%E7%9B%B8%E5%AE%B9%E6%80%A7%E7%9F%A9%E9%99%A3"&gt;1.3 版本基準與相容性矩陣&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;文件定位&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;企業標準技術白皮書／內部標準教材：&lt;strong&gt;指標設計、PromQL 分析、儀表板、告警與 SLO、架構決策與治理&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;適用對象&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;資深後端工程師、系統架構師、SRE／DevOps 工程師、技術主管、資安與稽核人員&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;前置知識&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Linux 與容器、Kubernetes 基本概念、RESTful API、微服務架構、基本監控概念&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;姊妹文件&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;《Prometheus與Grafana教學手冊》：安裝、設定檔、維護、升級操作步驟；《OpenTelemetry教學手冊》：OTel SDK 與 Collector&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;前一版本&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;1.0（2026-01-26，以 Prometheus 2.x／Grafana 11 時期做法為主）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Created by&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Eric Cheng&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;📌 &lt;strong&gt;v2.0 改版重點&lt;/strong&gt;：全面對齊 Prometheus 3.x 與 Grafana 13。修正 v1.0 中無法執行或結果錯誤的範例，例如 relabel 位址改寫、&lt;code&gt;predict_linear&lt;/code&gt; 子查詢語法、錯誤率告警百分比顯示、不存在的指標名稱 &lt;code&gt;redis_keys_total&lt;/code&gt;、Pushgateway「TTL」說法、以「P99 達標時間比例」定義延遲 SLO 等。新增原生直方圖、OTLP 與 UTF-8、Kubernetes Operator、Alertmanager 設計、規則單元測試、Dynamic dashboards、Dashboard as Code（Git Sync）、Grafana Alerting、多視窗多燃燒率告警、SLO 工具鏈、Grafana Assistant 與 MCP、AI 治理，以及第 9 章「企業級部署、容量與治理」。完整差異見 &lt;a href="#d2-v10--v20-%E6%9B%B4%E6%AD%A3%E5%B0%8D%E7%85%A7%E8%A1%A8"&gt;D.2 v1.0 → v2.0 更正對照表&lt;/a&gt;，查證依據見 &lt;a href="#%E9%99%84%E9%8C%84-e%E6%9F%A5%E8%AD%89%E7%B4%80%E9%8C%84"&gt;附錄 E：查證紀錄&lt;/a&gt;。&lt;/p&gt;</description></item></channel></rss>