From dd129d4f187992e55ef276e9dddee2f6f9045762 Mon Sep 17 00:00:00 2001 From: Your Name Date: Fri, 12 Jun 2026 13:30:49 +0800 Subject: [PATCH] =?UTF-8?q?docs(logbook):=20=E8=A8=98=E9=8C=84=20Observabi?= =?UTF-8?q?lity=20=E6=8C=87=E6=8F=AE=E9=9D=A2=E6=9D=BF=E6=AD=A3=E5=BC=8F?= =?UTF-8?q?=E9=A9=97=E8=AD=89=20[skip=20ci]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/LOGBOOK.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 2b1b5ab73..5f55d48f9 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -25,6 +25,44 @@ **邊界**：本段不送 Telegram、不寫 Gateway queue、不呼叫 Bot API、不寫 delivery receipt、不啟動 AI runtime worker、不啟動中低風險 auto worker、不跑 verifier live readback、不讀 secret、不顯示內部對話內容、不提供前端批准 / 執行 / 發送按鈕；不得把 fixture/readback dry-run 解讀成 runtime loop 已運作。 +## 2026-06-12｜Observability 全域可觀測性指揮面板 + +**背景**：統帥指出 `/zh-TW/observability` 必須納入所有主機、專案、網站前後台、服務、套件、工具等視角，並使用更專業的 UI/UX、圖表、流程與拓樸呈現；原頁面僅把服務監控、APM、錯誤、應用、服務目錄分散在 tabs 內，缺少總覽、決策覆蓋率與 AI Agent 接管路徑。 + +**完成**： + +- `/zh-TW/observability` 首屏新增全域可觀測性指揮面板，串接 `agent-deployment-layout`、`observability-contract-matrix`、`service-health-gap-matrix` 與 `automation-inventory-snapshot` 只讀 API。 +- 新增決策支援覆蓋率、全域納管目標、需處置焦點與自動執行授權四張指標卡；決策覆蓋率以 deployment targets、service health targets 與 observability surfaces 的可判讀狀態計算，不再只放低參考性的單一進度文字。 +- 新增全域範圍矩陣：主機、專案、網站前後台、服務、套件、工具、學習與協作全部以同一張矩陣呈現，顯示目標數、可判讀比例與需批准數。 +- 新增訊號拓樸：主機層 → 專案與網站 → 服務健康 → 監控訊號 → AwoooI SRE 戰情室 → AI Agent 決策鏈，讓告警來源、戰情室路由與 AI 接管關係一眼可讀。 +- 新增告警到處置流程視圖：收集、關聯、分類、路由、閘門，明確保留 runtime gate `0` 與「批准前只產生候選、證據與操作建議」邊界。 +- 新增監控合約與降噪候選、健康缺口與過期端點、不可誤讀合約三段內容；Prometheus / Alertmanager / Grafana / SigNoz / Sentry / OTEL 僅只讀呈現，降噪與規則調整先形成 proposal。 +- 原本的監控、APM、錯誤、應用與服務目錄 tabs 保留在下方作為細節鑽取入口，沒有移除既有功能。 +- 補 `observabilityCommand` i18n 文案，`zh-TW.json` / `en.json` 維持繁體中文鏡像；前端 UI 改用 lucide icon，不新增 emoji icon。 + +**驗證**： + +- 本地：`python3 -m json.tool apps/web/messages/zh-TW.json` / `apps/web/messages/en.json` 通過。 +- 本地：i18n key mirror / placeholder diff：`keyDiff=0`、`placeholderDiff=0`。 +- 本地：`git diff --check` 通過。 +- 本地：`python3 scripts/security/source-control-owner-response-guard.py --root .` 通過。 +- 本地：`python3 scripts/security/security-mirror-progress-guard.py --root .` 通過。 +- 本地：`pnpm --filter @awoooi/web typecheck` 通過。 +- 本地：`NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 SENTRY_SUPPRESS_GLOBAL_ERROR_HANDLER_FILE_WARNING=1 pnpm --filter @awoooi/web build` 通過；`/zh-TW/observability` First Load JS `382 kB`。 +- Code commit：`e67193a4 feat(web): 升級可觀測性指揮面板`；Gitea code-review `#2781` 成功，CD `#2780` 成功，deploy marker `c661c4c4 chore(cd): deploy e67193a [skip ci]`。 +- 小修 commit：`6ec45112 fix(web): 防止可觀測性頁水平溢出`；Gitea code-review `#2783` 成功，CD `#2782` 成功，deploy marker `bb47afd0 chore(cd): deploy 6ec4511 [skip ci]`。 +- 正式站 desktop `1440x1000`：`https://awoooi.wooo.work/zh-TW/observability?_v=bb47afd0-observability-prod-desktop` 可見「主機、專案、網站、服務與工具全域監控」、「全域範圍矩陣」、「訊號拓樸與 AI 接管路徑」、「告警到處置的流程視圖」、「監控合約與降噪候選」、「健康缺口與過期端點」、「AwoooI SRE 戰情室」、「細節分頁」與既有 `服務監控 / APM / 錯誤追蹤 / 服務目錄` tabs；`horizontalOverflow=0`、overflowing elements `0`、危險操作入口 `0`、錯誤文字 `0`。 +- 正式站 mobile `390x844`：`https://awoooi.wooo.work/zh-TW/observability?_v=bb47afd0-observability-prod-mobile` 同樣可見新版指揮面板、範圍矩陣、拓樸、流程、監控合約、健康缺口與戰情室文案；`clientWidth=384`、`scrollWidth=384`、`horizontalOverflow=0`、overflowing elements `0`、危險操作入口 `0`、錯誤文字 `0`。 +- 截圖：`/tmp/awoooi-observability-command-prod-desktop-bb47afd0.png`、`/tmp/awoooi-observability-command-prod-mobile-bb47afd0.png`。 + +**完成度同步**： + +- Observability 全域指揮面板：本地 `100%`，正式站 `100%`。 +- 納管範圍顯示：deployment layout `42` 目標、service health `10` 目標、observability surfaces `6` 面向已整合進同一頁。 +- Runtime / Telegram / 修復執行：仍為 `0%`；此段只做只讀可視化與決策支援，不代表 live probe、Telegram 發送、Alertmanager reload、自動修復或 runtime gate 已授權。 + +**邊界**：本段沒有發 Telegram、沒有寫 Gateway queue、沒有 reload Alertmanager / Prometheus、沒有建立 silence、沒有改 endpoint、沒有重啟 service / pod / host、沒有讀 secret、沒有 active probe、沒有啟動 AI runtime worker、沒有新增批准 / 執行按鈕；不得把 `/observability` UI 可見性解讀成 AI 全自動化流程已打通。 + ## 2026-06-12｜P2-403M 報表 runtime no-write dry-run 證據包 **背景**：P2-403L 已把日報 / 週報 / 月報派送、Telegram Gateway queue、讀報回執、AI 讀報後分析、中低風險自動處理與高風險審核拆成啟動前閘門；本段依序推進到 P2-403M，把真正啟動前的 no-write dry-run、SRE 戰情室 queue 草案與 readback verifier 草案固定成可審核證據。