golang 的 expvar 库可用于暴露程序运行时指标并支持自定义监控。1. 默认指标通过 /debug/vars 路径提供,如内存使用、goroutine 数量等,需启动 http server 访问;2. 可通过 expvar.newint 或 expvar.newstring 添加自定义计数器或字符串变量;3. 指标可通过中间件转换为 prometheus 格式,如使用 expvarmon 或 prometheus/client_golang 中的 expvar_collector;4. 注意路径冲突、版本差异及频繁操作性能影响等问题。

Golang 的
expvar库是一个标准库,用于暴露程序运行时的各种指标。它默认提供了一些基本的运行时变量,比如内存使用情况、goroutine 数量等,同时也支持自定义指标。这对于监控服务状态、排查性能问题非常有用。

下面我们就来看看怎么用
expvar暴露内存统计信息,以及如何添加自己的监控指标。

如何查看默认的运行时指标
expvar默认会在
/debug/vars路径下暴露一些运行时指标,比如:
立即学习“go语言免费学习笔记(深入)”;
memstats
:包括当前堆内存使用、GC 信息等cmdline
:命令行参数goroutine
:当前活跃的 goroutine 数量
你可以通过启动一个简单的 HTTP server 来访问这些数据:

import _ "expvar"
import "net/http"
func main() {
go func() {
http.ListenAndServe(":8080", nil)
}()
// 正常业务逻辑...
}然后访问
http://localhost:8080/debug/vars,你会看到类似如下的 JSON 数据(部分):
{
"memstats": {
"Alloc": 1234567,
"TotalAlloc": 987654321,
"Sys": 123456789,
...
},
"goroutine": 12
}这些数据可以用来做基础监控,比如观察内存增长是否异常,或者 goroutine 是否泄露。
如何添加自定义指标
除了默认的指标,你还可以注册自己的变量,比如计数器、响应时间、请求次数等。
添加一个计数器
import "expvar"
var requestCount = expvar.NewInt("myapp_requests_total")
func handleRequest() {
requestCount.Add(1)
// 处理请求...
}上面这段代码中,我们创建了一个名为
myapp_requests_total的整型变量,并在每次处理请求时加一。这个变量也会自动出现在
/debug/vars接口里。
添加一个字符串变量
有时候你想记录一些动态配置或状态信息,可以用字符串变量:
var appVersion = expvar.NewString("myapp_version")
appVersion.Set("v1.0.0")这样就可以在接口里看到当前版本号了。
配合 Prometheus 抓取指标
虽然
expvar提供的是 JSON 格式的数据,但可以通过中间件或者 exporter 转换为 Prometheus 可识别的格式。
如果你不想自己写转换逻辑,可以考虑使用 expvarmon,它能直接读取
expvar暴露的变量并输出 Prometheus 指标。
当然,也可以用第三方包,比如
prometheus/client_golang中的
expvar_collector来集成到你的 Prometheus 抓取流程中。
注意事项与常见坑点
-
路径冲突:如果你自己注册了
/debug/vars
的 handler,可能会和默认的冲突。 -
并发安全:
expvar
的变量是线程安全的,可以直接在多个 goroutine 中操作。 -
字段不全:
memstats
中有些字段可能在某些 Go 版本中没有,注意版本差异。 -
性能影响小:一般不会对性能造成明显影响,但如果频繁调用
.Add()
或设置字符串,还是要注意控制频率。
基本上就这些。用好
expvar,可以在不引入额外依赖的前提下快速搭建起服务的基础监控能力。










