---
site: "zyx.tw"
title: "替監控提供 agent 可查詢的入口"
description: "讓 agent 直接查監控資料，問題處理另依規則與核准流程執行。"
url: "https://www.zyx.tw/map/beyond/monitoring-for-agents"
---

# 替監控提供 agent 可查詢的入口

紀錄 030，經驗 L2，617 字，2 分鐘，v2.0.0，更新 2026-11-16

先檢查 Claude Code 能否讀取現有監控。監控服務通常提供給人看的畫面，但 agent 讀畫面慢，也容易讀錯。

MCP 是把服務操作提供給 agent 的開放標準。現有監控無法讀取時，加入唯讀 MCP server 或查詢指令，讓 agent 透過查詢入口取得監控資料。

## 先讓資料到位，查詢才有內容

sensorium 是給 agent 用的監控服務，儲存監控資料，不提供監控畫面。資料透過 MCP 查詢。

golem 是處理主機與網站問題的維運服務，提供維運畫面與 MCP。畫面顯示狀態，MCP 支援查詢與專案登記。

入口背後需要資料來源。主機上的收集程式負責送出狀態，監控服務負責儲存，維運服務則負責處理問題。

可儲存的內容包括網站的 log，也就是程式執行時留下的紀錄，以及請求經過的路徑。資料採用 OpenTelemetry 公開標準，規定訊號格式與傳送方式。

網站發生問題時，先把觀察到的現象交代給 Claude Code。接著請 Claude Code 透過 sensorium 的 MCP，以唯讀工具查詢 log 與請求經過的路徑，查完後回報查詢結果。

## 接上查詢之後，仍有收集與登記工作

新專案上線時，還有維運登記這一步。以 golem 為例，請 Claude Code 用 golem 的 MCP 登記新專案。

唯讀入口支援查詢，修復則另走核准流程。維運服務發現問題後，先傳送通知並擬定修復計畫，等待核准才執行。

## 查完資料，不等於問題處理完成

維運服務依寫好的規則判斷狀態，等偵測結果恢復正常才結束問題處理。

主機與網站的定期檢查由維運服務執行；持續執行的安排見 筆電關了之後。

## 依需要的工作選入口

若是人要查看主機與網站狀態，維運畫面就有對應用途。下面的互動圖示範查看畫面、Claude Code 查詢與無人查看時，各自使用的入口及處理流程。

無人查看時，查詢入口本身無法偵測問題。

**選擇監控的使用方式。 查看畫面**

入口:
- 維運服務的畫面

顯示內容:
- 主機與網站的狀態
- 新發生的事件

透過畫面查看狀態與新事件。

**選擇監控的使用方式。 Claude Code 查詢**

入口:
- 監控服務的 MCP

查詢內容:
- log
- 請求經過的路徑

使用唯讀工具查詢。Claude Code 查完後回報結果。

**選擇監控的使用方式。 無人查看時**

入口:
- 維運服務依規則檢查

問題處理流程:
- 偵測問題
- 傳送通知
- 擬定修復計畫
- 等待核准

無人查看時，維運服務仍依寫好的規則檢查。

## 地圖

- 原理：[MCP 把服務操作包成 agent 能呼叫的工具](https://www.zyx.tw/map/basics/mcp-wraps-a-service.md)
- 相關：[我把畫面動作與 tool 放進同一份定義，讓 agent 也能操作產品](https://www.zyx.tw/map/principles/agent-experience.md)
- 相關：[新服務的 log 要從監控端查到，才算完成驗證](https://www.zyx.tw/map/craft/observability-first.md)
- 回到：[延伸](https://www.zyx.tw/map.md)
