Golang的expvar如何暴露运行时指标 集成Prometheus监控方案

golang 的 expvar 包可结合 prometheus 实现轻量级监控。1. expvar 是 go 标准库包，默认暴露内存分配、gc 次数、goroutine 数量等指标，并支持注册自定义变量；2. prometheus 通过 expvar_exporter 中间件转换 json 数据为文本格式抓取；3. 也可在服务中内置适配器，手动遍历变量并按 prometheus 格式输出；4. 注意路径冲突、安全限制、性能影响及指标命名规范等问题。

Golang 的

expvar

expvar

1. expvar 是什么？能暴露哪些指标？

expvar

/debug/vars

• 内存分配、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

方法一：使用

expvar_exporter

登录后复制

转换格式

你可以用社区提供的工具如

expvar_exporter

/debug/vars

快标书AI

10分钟生成投标方案

241

查看详情

配置方式：

1. 启动你的 Go 程序，确保

   /debug/vars

   登录后复制
   接口可访问。
2. 安装并运行

   expvar_exporter

   登录后复制
   ：

   go install github.com/justwatchcom/gosr/cmd/expvar_exporter@latest
   expvar_exporter -listen :8081 -url http://localhost:8080/debug/vars

   登录后复制
3. 访问

   http://localhost:8081/metrics

   登录后复制
   ，就能看到转换后的 Prometheus 指标。

Prometheus 配置抓取：

scrape_configs:
  - job_name: 'myapp'
    static_configs:
      - targets: ['localhost:8081']

这样就完成了基本集成。

3. 如果不想用中间件怎么办？

如果你希望不引入额外组件，也可以自己写一个适配器，将

expvar

思路如下：

1. 遍历所有

   expvar

   登录后复制
   注册的变量。
2. 判断类型（int、float、string 等）。
3. 输出对应格式的指标行，例如：

# HELP my_custom_counter Custom counter.
# TYPE my_custom_counter gauge
my_custom_counter 42

这种方式适合嵌入到已有服务中，不需要额外部署中间件。

4. 常见问题和注意事项

• 路径冲突：默认的

  /debug/vars

  登录后复制
  可能和其他调试接口冲突，可以在启动时修改路由。
• 安全风险：

  expvar

  登录后复制
  默认没有权限控制，生产环境建议加中间件或限制访问 IP。
• 性能影响：频繁更新的变量要小心锁竞争，避免影响主流程性能。
• 指标命名规范：给自定义指标加上合适的 help 和 type 注释，方便 Prometheus 展示。

基本上就这些了。用

expvar

以上就是Golang的expvar如何暴露运行时指标 集成Prometheus监控方案的详细内容，更多请关注php中文网其它相关文章！