新服務的 log 要從監控端查到,才算完成驗證
深讀 L2 856 字 2 分鐘 v2.0.0 更新 2026-11-16
log 記下服務執行時發生的事件;監控服務則接收並儲存訊號,提供查詢。新服務送出 log 後,還要請 Claude Code 從監控服務查到資料,才算完成驗證。 查詢透過 MCP,這是把服務操作提供成工具的開放標準,MCP server 替 Claude Code 處理連線與登入。
可觀測性要讓服務的執行過程能在事後查證。
metrics、traces、log 各回答不同的問題
服務送出的訊號分成 metrics、log 與 traces。三者回答不同問題,因此要先依問題選擇訊號。
metrics 是量測資料,回答「有沒有問題」。Google SRE 建議先量四個黃金訊號:延遲、流量、錯誤與飽和度。
traces 記錄請求經過的路徑,回答「問題在哪一段」。log 回答「當時發生了什麼事」。
每筆訊號都需要傳送與儲存,因此訊號越多,成本越高。先送四個黃金訊號與錯誤 log,再依需要增加。
訊號從服務經過 Collector,再進入儲存服務
OpenTelemetry 是規定訊號格式與傳送方式的標準。新服務先接上送 log 的套件,再填入標準設定。
服務透過 SDK,也就是接入服務的套件,以 OpenTelemetry 的傳送協定 OTLP 送出訊號。Collector 是接收與轉送訊號的元件:receiver 收下訊號、processor 處理、exporter 轉送到儲存服務,再由 agent 查詢。
下圖把接收、處理與轉送依序展開。metrics、log 與 traces 經過這條管線後,才進入供後續查詢的儲存端。
服務裡的 SDK 產生訊號。
把查詢排進交付流程
接入工作從最初的 pull request 開始,也就是修改合併進專案之前的那一關。此時接上 log 套件,送出 log 與請求經過的路徑。
查不到資料與查到異常,要分開處理
查不到錯誤 log 時,先分清楚服務未送出,還是監控服務讀不到。若網站已送出 log,修正目標就是讓監控服務讀到資料。
有資料後,再依症狀判斷修改位置。頁面緩慢時,分別檢查伺服器、網路與瀏覽器,不應只憑頁面症狀決定修改伺服器。
下圖示範分層判讀:伺服器未出現緩慢問題,查出的原因是頁面沒有預先載入。這時應修正頁面的預先載入。
處理方式
- 1猜測伺服器緩慢
- 2直接修改伺服器
可能結果
- 修改到無關的位置
來源
- OpenTelemetry: Signals OpenTelemetry
- OpenTelemetry Collector architecture OpenTelemetry
- OTLP specification OpenTelemetry
- Monitoring Distributed Systems Google SRE Book