From fb32deb2b1f68d080d077443ba300588ee9f5959 Mon Sep 17 00:00:00 2001
From: phamnazage-jpg <phamnazage-jpg@users.noreply.github.com>
Date: Tue, 2 Jun 2026 07:22:24 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E9=AA=8C=E8=AF=81?=
 =?UTF-8?q?=E6=8A=A5=E5=91=8A=EF=BC=8C=E8=AE=B0=E5=BD=95=20metrics=20?=
 =?UTF-8?q?=E7=AB=AF=E7=82=B9=E4=BF=AE=E5=A4=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...2026-06-02-PRODUCTION-VALIDATION-REPORT.md | 27 +++++++++++--------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/docs/2026-06-02-PRODUCTION-VALIDATION-REPORT.md b/docs/2026-06-02-PRODUCTION-VALIDATION-REPORT.md
index 3eab5547..7a1f443d 100644
--- a/docs/2026-06-02-PRODUCTION-VALIDATION-REPORT.md
+++ b/docs/2026-06-02-PRODUCTION-VALIDATION-REPORT.md
@@ -189,19 +189,24 @@ Dockerfile
 | 多阶段构建 | ✅ 使用builder模式 |
 | 环境变量文档 | ✅ 已添加注释 |
 | 必需配置标记 | ✅ ADMIN_TOKEN标记为必需 |
+### 6.3 Metrics 暴露 (⚠️ 已修复)
 
-### 6.3 Metrics 暴露
+**修复前问题**: `/metrics` 返回 404
+- 原因: metrics handler 仅定义在独立启动函数中，未注册到主路由
+
+**修复方案**: 在 `NewAPIHandlerWithAuth` 中添加:
+```go
+mux.Handle("GET /metrics", metrics.Handler())
 ```
-GET /metrics - Prometheus格式 ✅
-指标覆盖:
-- http_requests_total
-- http_request_duration_seconds
-- active_hosts
-- active_providers
-- route_decisions_total
-- route_failovers_total
-- log_flush_errors_total
-- log_dropped_events_total
+
+**验证结果**:
+```bash
+✅ curl http://127.0.0.1:18080/metrics
+返回 Prometheus 格式数据:
+# HELP active_hosts Number of active hosts
+# TYPE active_hosts gauge
+active_hosts 0
+...
 ```
 
 ### 6.4 日志系统