---
site: "zyx.tw"
title: "新服務的 log 要從監控端查到，才算完成驗證"
description: "沿著訊號傳送與查詢的路徑，安排上線驗證與故障排查。"
url: "https://www.zyx.tw/map/craft/observability-first"
---

# 新服務的 log 要從監控端查到，才算完成驗證

紀錄 036，深讀 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 經過這條管線後，才進入供後續查詢的儲存端。

```text
╭─────────╮  OTLP   ╭──────────── COLLECTOR ────────────╮
│ SERVICE │ ──────> │ receiver > processor > exporter   │
│ and SDK │         ╰────┬────────────┬────────────┬────╯
╰─────────╯              v            v            v
                    ╭─────────╮  ╭─────────╮  ╭─────────╮
                    │ METRICS │  │  LOGS   │  │ TRACES  │
                    ╰────┬────╯  ╰────┬────╯  ╰────┬────╯
                         ╰────────────┴────────────╯
                              queried by an AGENT
```

Figure: A service with an SDK sends signals over OTLP to a collector, which receives, processes and exports them to stores for metrics, logs and traces that an agent queries.

1. Service: 服務裡的 SDK 產生訊號。
2. OTLP: 訊號用 OTLP 傳送。任何支援 OTLP 的服務都能接收。
3. Collector: receiver 接收，processor 處理，exporter 轉送。
4. Signals: metrics 是數字，logs 是事件，traces 是一次請求經過的路徑。
5. Query: agent 透過查詢介面讀取訊號，不需要監控畫面。

## 把查詢排進交付流程

接入工作從最初的 pull request 開始，也就是修改合併進專案之前的那一關。此時接上 log 套件，送出 log 與請求經過的路徑。

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

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

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

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

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

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

**頁面緩慢時怎麼查？ 直接猜原因**

處理方式:
- 猜測伺服器緩慢
- 直接修改伺服器

可能結果:
- 修改到無關的位置

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

**頁面緩慢時怎麼查？ 分層檢查**

檢查層次:
- 伺服器
- 網路
- 瀏覽器

示範判讀:
- 伺服器未出現緩慢問題
- 問題出在頁面沒有預先載入

分別檢查伺服器、網路與瀏覽器。例如，查出問題是頁面沒有預先載入，就修正預先載入。

**頁面緩慢時怎麼查？ 已送出但查不到**

檢查狀況:
- 網站已送出紀錄
- 監控服務讀不到紀錄

修正目標:
- 讓監控服務讀到紀錄

網站送出紀錄後，還要從監控服務查詢。查到資料才算完成驗證。

## 來源

- [OpenTelemetry: Signals](https://opentelemetry.io/docs/concepts/signals/), OpenTelemetry
- [OpenTelemetry Collector architecture](https://opentelemetry.io/docs/collector/architecture/), OpenTelemetry
- [OTLP specification](https://opentelemetry.io/docs/specs/otlp/), OpenTelemetry
- [Monitoring Distributed Systems](https://sre.google/sre-book/monitoring-distributed-systems/), Google SRE Book

## 地圖

- 相關：[替監控提供 agent 可查詢的入口](https://www.zyx.tw/map/beyond/monitoring-for-agents.md)
- 回到：[習慣](https://www.zyx.tw/map.md)
