revel 框架不内置 prometheus 支持，需手动集成 prometheus/client_golang 并通过 http.handle("/metrics", promhttp.handler()) 在 init() 中挂载；须用拦截器采集请求级指标，标签取自 c.name 和 c.method.name，延迟观测在 fc.next() 后，且生产环境应设 mode="prod"。
Revel 框架本身不内置 Prometheus 支持，必须手动集成 prometheus/client_golang 并暴露 /metrics 端点；直接用 Revel 的拦截器或 HTTP 中间件挂载指标采集逻辑是最轻量、最可控的方式。
为什么 Revel 没有开箱即用的 /metrics 路由
Revel 是一个强调“约定优于配置”的 Go Web 框架，但它的生态中没有官方维护的 metrics 扩展。不像 Spring Boot 有 Actuator、LoopBack 4 有 @loopback/metrics，Revel 的监控完全交由开发者自行选型和注入。这意味着你无法通过 revel.Config.Set 或插件式 enable 就获得指标端点——必须自己注册 http.Handler 并确保它不被 Revel 的路由机制拦截或覆盖。
常见错误现象包括：
- 访问
/metrics返回 404：Revel 默认只处理注册在app.Init中的控制器路由，未显式挂载promhttp.Handler()就不会响应 - 指标数据为空或只有 Go 运行时指标：没在请求生命周期中调用
Counter.Inc()或Timer.ObserveDuration()，仅暴露了默认指标 - 并发下计数异常：多个 goroutine 同时操作未加锁的
float64变量（错误示范），而非使用promauto.NewCounter等线程安全构造器
在 Revel 中正确挂载 promhttp.Handler
不能把 promhttp.Handler() 当作普通控制器方法注册，而应在 Revel 启动前，直接绑定到底层 http.ServeMux。推荐在 app/init.go 的 init() 函数末尾插入：
func init() {
// ... revel.Init 调用等原有逻辑
revel.InterceptFunc(metricsInterceptor, revel.BEFORE)
// 在 Revel 的 http.Server 启动前，直接注册 /metrics
http.Handle("/metrics", promhttp.Handler())
}
这样做的原因是：http.Handle 绑定的是全局 http.DefaultServeMux，而 Revel 底层的 http.ListenAndServe 正是使用它。只要这行代码在 revel.Run() 之前执行，/metrics 就能被正常响应。
注意几个关键点：
- 不要用
revel.Router.Add或GET("/metrics", ...)：这类路由会被 Revel 的控制器反射机制接管，promhttp.Handler()不接受 Revel 的*revel.Controller参数 - 如果用了自定义
http.Server（比如启用了 HTTPS），需显式将promhttp.Handler()赋给server.Handler，而不是依赖DefaultServeMux - 路径必须严格为
/metrics：Prometheus 默认只抓取这个路径，改名需同步修改scrape_configs.job_name.metrics的metrics_path
给 Revel 请求打上标签并记录延迟
单纯暴露运行时指标意义有限。要真正监控接口级行为，得在 Revel 的拦截器中采集请求维度指标。例如统计每个 Action 的调用次数与耗时：
var (
requestCount = promauto.NewCounterVec(
prometheus.CounterOpts{
Name: "revel_http_requests_total",
Help: "Total HTTP Requests",
},
[]string{"action", "method", "status"},
)
requestLatency = promauto.NewHistogramVec(
prometheus.HistogramOpts{
Name: "revel_http_request_duration_seconds",
Help: "HTTP request duration in seconds",
},
[]string{"action", "method"},
)
)
func metricsInterceptor(c *revel.Controller, fc revel.FilterChain) revel.Result {
start := time.Now()
res := fc.Next()
action := c.Name + "." + c.Method.Name
method := c.Request.Method
status := strconv.Itoa(c.Response.Status)
requestCount.WithLabelValues(action, method, status).Inc()
requestLatency.WithLabelValues(action, method).Observe(time.Since(start).Seconds())
return res
}
这段代码的关键在于：
- 使用
promauto.NewCounterVec和promauto.NewHistogramVec：它们自动注册到默认注册器，且线程安全，避免手动管理prometheus.Register - 标签值来自
c.Name和c.Method.Name：这是 Revel 控制器的全限定名（如GreetingController.Index），比路径更稳定，不受路由参数影响 - 延迟观测在
fc.Next()之后：确保捕获完整处理时间，包括模板渲染、拦截器链等全部环节
容易被忽略的跨域与权限问题
当 Prometheus 服务器不在同一主机或网络时，常因 CORS 或防火墙导致抓取失败。Revel 默认不设置响应头，promhttp.Handler() 也不处理 CORS。
如果你的 Prometheus 配置了跨网段抓取（比如从 192.168.10.5 抓 10.0.2.15），务必确认：
- Revel 应用监听地址不是
127.0.0.1：启动时需设revel.HttpAddr = "0.0.0.0"，否则外部无法连接 - Linux 防火墙放行对应端口（如 9000）：
sudo ufw allow 9000或检查iptables规则 - 不要给
/metrics加 Basic Auth：Prometheus 官方 client 不支持带认证的 scrape，若必须鉴权，应改用反向代理（如 Nginx）前置处理，而非在 Revel 层拦截
最后提醒一点：Revel 的 revel.AppConfig.StringDefault("mode", "dev") 如果是 "dev"，某些中间件可能输出调试日志干扰指标格式；生产环境务必设为 "prod"，避免非标准响应体污染 text/plain; version=0.0.4 格式。
