<?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>PromQL on Eric 個人部落格</title><link>https://chihhung.github.io/Blog/tags/promql/</link><description>Recent content in PromQL on Eric 個人部落格</description><generator>Hugo</generator><language>zh-TW</language><lastBuildDate>Thu, 29 Jan 2026 19:08:16 +0800</lastBuildDate><atom:link href="https://chihhung.github.io/Blog/tags/promql/index.xml" rel="self" type="application/rss+xml"/><item><title>Prometheus與Grafana教學手冊</title><link>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/%E5%B7%A5%E5%85%B7/prometheus%E8%88%87grafana%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/</link><pubDate>Thu, 29 Jan 2026 19:08:16 +0800</pubDate><guid>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/%E5%B7%A5%E5%85%B7/prometheus%E8%88%87grafana%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/</guid><description>&lt;h1 id="prometheus與grafana教學手冊"&gt;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）、Alertmanager 0.34.1、Grafana 13.2.3（2026-09-29）、node_exporter 1.12.1；完整矩陣見 &lt;a href="#15-%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.5 版本基準與相容性矩陣&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;Prometheus＋Alertmanager＋Grafana 的規劃、安裝、設定、使用、告警、安全、高可用、維運與升級&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;資深工程師、DevOps／SRE、系統管理員、系統架構師、資安與稽核人員&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 系統管理（systemd、防火牆、檔案權限）、容器與 Kubernetes 基本概念、HTTP 與 TLS、YAML&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;姊妹文件&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;《Metrics Visualization 教學手冊》：指標設計、PromQL 分析、儀表板設計、SLO 與架構決策的深入探討；《OpenTelemetry教學手冊》：OTel SDK 與 Collector；《Logs Visualization 教學手冊》：日誌視覺化&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-27，以 Prometheus 2.48、Grafana 10.2 為基準）&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;：章節重新編排為 15 章與 7 個附錄，全面對齊 Prometheus 3.x、Alertmanager 0.34 與 Grafana 13。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;修正錯誤&lt;/strong&gt;：修正 v1.0 中已不適用或會造成故障的內容。例如 3.x 發行包已不含 &lt;code&gt;consoles&lt;/code&gt;、&lt;code&gt;apt-key&lt;/code&gt; 已棄用、Alertmanager &lt;code&gt;/api/v1&lt;/code&gt; 已移除（回傳 410）、&lt;code&gt;match&lt;/code&gt;／&lt;code&gt;source_match&lt;/code&gt; 已棄用、Teams Office 365 connector 已停用、快照還原步驟會刪除快照本身、儲存估算重複折算壓縮率、Grafana 稽核設定鍵錯誤且為 Enterprise 限定、Istio &lt;code&gt;istio-telemetry&lt;/code&gt; 已不存在等。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;新增內容&lt;/strong&gt;：容量規劃、Alertmanager 安裝、Compose 與 Kubernetes 部署、離線安裝、Service Discovery 與 relabel、抓取保護、Remote Write／Agent mode、OTLP、Grafana 資料庫與認證整合、原生直方圖、Dynamic dashboards、Grafana Alerting 決策、規則單元測試、安全強化、高可用、自我監控、Prometheus 2.x → 3.x 遷移、Grafana 13 升級、AI 輔助維運與臺灣法規對應。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;追溯依據&lt;/strong&gt;：所有差異見 &lt;a href="#e2-v10--v20-%E6%9B%B4%E6%AD%A3%E5%B0%8D%E7%85%A7%E8%A1%A8"&gt;E.2 v1.0 → v2.0 更正對照表&lt;/a&gt;，查證依據見 &lt;a href="#%E9%99%84%E9%8C%84-f%E6%9F%A5%E8%AD%89%E7%B4%80%E9%8C%84"&gt;附錄 F：查證紀錄&lt;/a&gt;。&lt;/li&gt;
&lt;/ul&gt;&lt;/blockquote&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;初次接觸 Prometheus／Grafana&lt;/td&gt;
&lt;td&gt;第 1 章 → 第 2 章 → 4.5 → 第 7 章 → 第 8 章&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;系統管理員（VM／實體機）&lt;/td&gt;
&lt;td&gt;第 3 章 → 4.1–4.4 → 第 5、6 章 → 第 12 章 → 第 13 章&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Kubernetes 平台工程師&lt;/td&gt;
&lt;td&gt;2.6 → 4.6 → 5.2–5.4 → 11.1–11.2 → 12.4&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;SRE／值班人員&lt;/td&gt;
&lt;td&gt;第 7 章 → 第 9 章 → 12.1 → 12.6 → 第 15 章&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;應用程式開發人員&lt;/td&gt;
&lt;td&gt;2.2–2.3 → 7.4 → 14.1–14.2 → 14.5&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;架構師&lt;/td&gt;
&lt;td&gt;2.6–2.7 → 3.2 → 第 11 章 → 14.3–14.4&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;資安／稽核人員&lt;/td&gt;
&lt;td&gt;第 10 章 → 14.6 → 15.3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;技術主管／決策者&lt;/td&gt;
&lt;td&gt;1.1–1.5 → 2.7 → 13.1 → 14.6 → 14.7&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&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;/td&gt;
&lt;td&gt;建議做法／不建議做法&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;⚠️&lt;/td&gt;
&lt;td&gt;容易出錯或有風險的地方&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;💡&lt;/td&gt;
&lt;td&gt;實務技巧&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;🧪&lt;/td&gt;
&lt;td&gt;實驗性功能：需 &lt;code&gt;--enable-feature&lt;/code&gt; 或 feature toggle，行為可能在後續版本變更，不納入 LTS 支援範圍&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;📌&lt;/td&gt;
&lt;td&gt;版本差異或改版說明&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;🏢&lt;/td&gt;
&lt;td&gt;只在 Grafana Enterprise 或 Grafana Cloud 提供的功能&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;$變數&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Grafana 範本變數&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;尖括號&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;需依環境替換的值&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;example.internal&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;範例內部網域，請替換為實際網域&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;⚠️ 本手冊的指令以 RHEL 9／10 與 Ubuntu 24.04 LTS 為例，設定檔與 PromQL 皆以 Prometheus 3.15、Alertmanager 0.34.1、Grafana 13.2.3 撰寫，並以官方二進位檔的 &lt;code&gt;promtool&lt;/code&gt;／&lt;code&gt;amtool&lt;/code&gt; 驗證（見 &lt;a href="#%E9%99%84%E9%8C%84-f%E6%9F%A5%E8%AD%89%E7%B4%80%E9%8C%84"&gt;附錄 F：查證紀錄&lt;/a&gt;）。若仍在 Prometheus 2.x，請先閱讀 &lt;a href="#132-prometheus-2x--3x-%E9%81%B7%E7%A7%BB"&gt;13.2 Prometheus 2.x → 3.x 遷移&lt;/a&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>