0

0

Golang的expvar库如何暴露运行指标 讲解内存统计与自定义指标监控

P粉602998670

P粉602998670

发布时间:2025-08-11 11:56:02

|

503人浏览过

|

来源于php中文网

原创

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

Golang的expvar库如何暴露运行指标 讲解内存统计与自定义指标监控

Golang 的

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

Golang的expvar库如何暴露运行指标 讲解内存统计与自定义指标监控

下面我们就来看看怎么用

expvar
暴露内存统计信息,以及如何添加自己的监控指标。

Golang的expvar库如何暴露运行指标 讲解内存统计与自定义指标监控

如何查看默认的运行时指标

expvar
默认会在
/debug/vars
路径下暴露一些运行时指标,比如:

立即学习go语言免费学习笔记(深入)”;

  • memstats
    :包括当前堆内存使用、GC 信息等
  • cmdline
    :命令行参数
  • goroutine
    :当前活跃的 goroutine 数量

你可以通过启动一个简单的 HTTP server 来访问这些数据:

Golang的expvar库如何暴露运行指标 讲解内存统计与自定义指标监控
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 是否泄露。


如何添加自定义指标

除了默认的指标,你还可以注册自己的变量,比如计数器、响应时间、请求次数等。

跃问视频
跃问视频

阶跃星辰推出的AI视频生成工具

下载

添加一个计数器

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
,可以在不引入额外依赖的前提下快速搭建起服务的基础监控能力。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

178

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

338

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

209

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

391

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

196

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

191

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

23

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
golang socket 编程
golang socket 编程

共2课时 | 0.1万人学习

nginx浅谈
nginx浅谈

共15课时 | 0.8万人学习

golang和swoole核心底层分析
golang和swoole核心底层分析

共3课时 | 0.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号