新服務的 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 與請求經過的路徑。

服務完成後,請 Claude Code 查詢錯誤 log,確認監控服務確實有資料。查詢入口的接法見 監控的 MCP。

接著把服務網址加入作者自製的 golem,這是定期檢查主機與網站的維運服務。golem 發現問題時會發出通知,並提出修復計畫。

查不到資料與查到異常,要分開處理

查不到錯誤 log 時,先分清楚服務未送出,還是監控服務讀不到。若網站已送出 log,修正目標就是讓監控服務讀到資料。

有資料後,再依症狀判斷修改位置。頁面緩慢時,分別檢查伺服器、網路與瀏覽器,不應只憑頁面症狀決定修改伺服器。

下圖示範分層判讀:伺服器未出現緩慢問題,查出的原因是頁面沒有預先載入。這時應修正頁面的預先載入。

頁面緩慢時怎麼查?

處理方式

  • 1猜測伺服器緩慢
  • 2直接修改伺服器

可能結果

  • 修改到無關的位置
缺少紀錄,就難以確認問題的位置。直接修改伺服器可能改錯地方。

來源

讀完之後

習慣設計部署PARAlog簡單