golang 的 expvar 包可结合 prometheus 实现轻量级监控。1. expvar 是 go 标准库包，默认暴露内存分配、gc 次数、goroutine 数量等指标，并支持注册自定义变量；2. prometheus 通过 expvar_exporter 中间件转换 json 数据为文本格式抓取；3. 也可在服务中内置适配器，手动遍历变量并按 prometheus 格式输出；4. 注意路径冲突、安全限制、性能影响及指标命名规范等问题。
Golang 的
expvar包可以很方便地暴露程序运行时的一些指标，虽然它本身功能有限，但结合 Prometheus 可以实现一个轻量级的监控方案。下面介绍几个关键点，帮助你把
expvar集成进 Prometheus 监控体系中。
1. expvar 是什么？能暴露哪些指标？
expvar是 Go 标准库中的一个包，用于方便地导出变量（variables）供外部访问，通常通过
/debug/vars接口以 JSON 格式返回。默认情况下，它会暴露一些运行时信息，比如：
- 内存分配、GC 次数
- Goroutine 数量等基础指标
你可以手动注册自定义变量，例如计数器、状态值等，这些都可以被 Prometheus 抓取。
立即学习“go语言免费学习笔记（深入）”；
使用示例：
import (
"expvar"
"net/http"
)
var myCounter = expvar.NewInt("my_custom_counter")
func main() {
http.ListenAndServe(":8080", nil)
}访问
http://localhost:8080/debug/vars就能看到类似这样的输出：
{
"cmdline": [...],
"memstats": {...},
"my_custom_counter": 0
}2. 如何让 Prometheus 抓取 expvar 的指标？
Prometheus 本身不能直接解析
expvar输出的 JSON 数据，但可以通过中间件或者 Exporter 来转换格式。
方法一：使用 expvar_exporter
转换格式
你可以用社区提供的工具如 expvar_exporter
，它可以把
/debug/vars的内容转换为 Prometheus 可识别的文本格式。
配置方式：
- 启动你的 Go 程序，确保
/debug/vars
接口可访问。 - 安装并运行
expvar_exporter
：go install github.com/justwatchcom/gosr/cmd/expvar_exporter@latest expvar_exporter -listen :8081 -url http://localhost:8080/debug/vars
- 访问
http://localhost:8081/metrics
，就能看到转换后的 Prometheus 指标。
Prometheus 配置抓取：
scrape_configs:
- job_name: 'myapp'
static_configs:
- targets: ['localhost:8081']这样就完成了基本集成。
3. 如果不想用中间件怎么办？
如果你希望不引入额外组件，也可以自己写一个适配器，将
expvar的数据格式转换成 Prometheus 所需的文本格式。
思路如下：
- 遍历所有
expvar
注册的变量。 - 判断类型（int、float、string 等）。
- 输出对应格式的指标行，例如：
# HELP my_custom_counter Custom counter. # TYPE my_custom_counter gauge my_custom_counter 42
这种方式适合嵌入到已有服务中，不需要额外部署中间件。
4. 常见问题和注意事项
-
路径冲突：默认的
/debug/vars
可能和其他调试接口冲突，可以在启动时修改路由。 -
安全风险：
expvar
默认没有权限控制，生产环境建议加中间件或限制访问 IP。 - 性能影响：频繁更新的变量要小心锁竞争，避免影响主流程性能。
- 指标命名规范：给自定义指标加上合适的 help 和 type 注释，方便 Prometheus 展示。
基本上就这些了。用
expvar结合 Prometheus 做监控不算复杂，但有些细节容易忽略，比如格式转换和安全性问题。如果你只是想快速暴露一些运行时状态，这个组合是个不错的轻量级方案。
