18e4f7e891
- ServerConfig 新增 Host 字段:空=监听所有接口(兼容),设值=绑定指定地址 (127.0.0.1 仅本机 / 内网IP 绑定指定网卡),避免生产暴露 0.0.0.0 - app.go 启动地址改 host:port,日志区分"所有接口"/指定地址 - 面向用户/调用的文案统一中文: - middleware/recover.go: "Panic recovered"→"panic 已恢复","Panic: %v"→"服务器内部错误: %v" - middleware/logger.go: 5 处日志消息改中文 - middleware/metrics.go: 3 个 Prometheus Help 改中文 - app.go/database/manager.go/logger.go: 英文 error 改中文 - 保留英文:JSON 协议字段名、Prometheus metric Name、MySQL 错误串匹配、技术专有名词 - CLI 模板与 example 配置加 host 注释 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
65 lines
1.7 KiB
Go
65 lines
1.7 KiB
Go
package middleware
|
|
|
|
import (
|
|
"strconv"
|
|
"time"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
"github.com/prometheus/client_golang/prometheus"
|
|
"github.com/prometheus/client_golang/prometheus/promauto"
|
|
)
|
|
|
|
// #18 Prometheus 指标。三个标配:
|
|
// - http_requests_total: 请求计数(按 method/route/status 维度)
|
|
// - http_request_duration_seconds: 请求耗时直方图(按 method/route 维度)
|
|
// - http_requests_in_flight: 当前在飞请求数
|
|
|
|
var (
|
|
httpRequestsTotal = promauto.NewCounterVec(
|
|
prometheus.CounterOpts{
|
|
Name: "http_requests_total",
|
|
Help: "HTTP 请求总数。",
|
|
},
|
|
[]string{"method", "route", "status"},
|
|
)
|
|
|
|
httpRequestDuration = promauto.NewHistogramVec(
|
|
prometheus.HistogramOpts{
|
|
Name: "http_request_duration_seconds",
|
|
Help: "HTTP 请求耗时(秒)。",
|
|
Buckets: prometheus.DefBuckets,
|
|
},
|
|
[]string{"method", "route"},
|
|
)
|
|
|
|
httpRequestsInFlight = promauto.NewGauge(
|
|
prometheus.GaugeOpts{
|
|
Name: "http_requests_in_flight",
|
|
Help: "正在处理的 HTTP 请求数。",
|
|
},
|
|
)
|
|
)
|
|
|
|
// Metrics Prometheus 指标中间件(#18)。记录请求计数、耗时、在飞数。
|
|
// route 标签用 c.FullPath()(路由模板,如 /api/v1/users/:id),避免高基数。
|
|
func Metrics() gin.HandlerFunc {
|
|
return func(c *gin.Context) {
|
|
httpRequestsInFlight.Inc()
|
|
start := time.Now()
|
|
|
|
c.Next()
|
|
|
|
httpRequestsInFlight.Dec()
|
|
elapsed := time.Since(start).Seconds()
|
|
status := strconv.Itoa(c.Writer.Status())
|
|
route := c.FullPath()
|
|
if route == "" {
|
|
route = "not_found"
|
|
}
|
|
method := c.Request.Method
|
|
|
|
httpRequestsTotal.WithLabelValues(method, route, status).Inc()
|
|
httpRequestDuration.WithLabelValues(method, route).Observe(elapsed)
|
|
}
|
|
}
|