必须在go项目中主动暴露/metrics端点并注册自定义指标：先用promhttp.handler()启用默认指标，再手动定义copilotsuggestioncount、copilotlatency、activecopilotsessions等业务指标并全局注册，最后在真实请求链路中埋点打标，确保prometheus可采集。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Go项目中让GitHub Copilot相关功能的性能数据被Prometheus持续采集，必须在代码关键路径上主动暴露指标端点并注册可抓取的时序数据。
初始化Prometheus客户端并注册默认指标
在main.go入口文件顶部导入prometheus/client_golang库：import "github.com/prometheus/client_golang/prometheus/promhttp"。
在HTTP服务启动前添加一行：`http.Handle("/metrics", promhttp.Handler())`。这一步必须放在`http.ListenAndServe()`之前，否则/metrics路由不会生效。
这行代码将启用Prometheus标准指标集（如Go运行时内存、Goroutine数、GC统计），无需额外埋点即可获得基础可观测性。但【Copilot专用指标必须手动定义】，默认指标不包含任何与代码建议、聊天响应、模型调用相关的业务维度。
定义Copilot核心业务指标
在项目utils或metrics包中创建指标变量：
定义计数器，统计用户触发Copilot建议的总次数：copilotSuggestionCount = prometheus.NewCounterVec(prometheus.CounterOpts{Namespace: "copilot", Name: "suggestion_count_total", Help: "Total number of Copilot suggestion requests"}, []string{"status", "language"})。
定义直方图，记录每次建议生成的延迟分布：copilotLatency = prometheus.NewHistogramVec(prometheus.HistogramOpts{Namespace: "copilot", Name: "suggestion_latency_seconds", Buckets: []float64{0.1, 0.3, 0.5, 1.0, 2.0}}, []string{"model"})。
定义仪表盘，实时反映当前活跃的Copilot会话数：activeCopilotSessions = prometheus.NewGauge(prometheus.GaugeOpts{Namespace: "copilot", Name: "active_sessions", Help: "Number of currently active Copilot chat sessions"})。
注意：所有指标必须在程序启动早期通过prometheus.MustRegister()注册，否则/metrics端点不会返回这些指标值。
在业务逻辑中埋点打标
第一步：在处理用户请求建议的Handler函数开头，执行`activeCopilotSessions.Inc()`；在响应返回后执行`activeCopilotSessions.Dec()`。
第二步：当调用底层AI模型服务前记录开始时间戳：startTime := time.Now()；收到模型响应后，用`copilotLatency.WithLabelValues(modelName).Observe(time.Since(startTime).Seconds())`上报延迟。
第三步：根据模型返回结果状态（如200/400/500）和当前编辑器语言（go/js/py等），调用`copilotSuggestionCount.WithLabelValues(statusCode, lang).Inc()`累加计数。
这三步必须严格嵌入真实请求链路，不能仅在单元测试中模拟。如果只在mock handler里调用指标方法，生产环境的/metrics将始终显示为0。
验证指标是否成功暴露
启动服务后，直接在浏览器访问http://localhost:8080/metrics。
搜索文本copilot_suggestion_count_total，确认能看到类似copilot_suggestion_count_total{language="go",status="200"} 12的行。
若页面返回404，检查是否漏写了http.Handle("/metrics", ...)；若返回内容里没有copilot前缀指标，说明注册步骤遗漏或变量作用域错误——指标变量必须是包级全局变量，不可定义在函数内部。
