咨询Prometheus指标go_memstats_buck_hash_sys_bytes的用途及只增不减合理性

1. 指标用途 #

go_memstats_buck_hash_sys_bytes是Go运行时暴露的指标，用于统计所有哈希表（map的底层实现）的桶（buckets）所占用的系统内存总量。

Go中的map依赖哈希桶存储键值对，当map需要扩容（比如负载因子超过阈值）、分裂桶，或者创建新map时，运行时会从系统分配内存来创建新的哈希桶，这个指标就是所有这些哈希桶内存的累加值。

2. 仅增不减是否正常？ #

这种情况通常是正常的，但需要结合场景判断：

• Go运行时的map在删除元素后，并不会主动释放哈希桶的内存返回给操作系统——只会标记桶内的元素为已删除，哈希桶本身会被保留复用。只有当整个map对象被垃圾回收（GC）完全清理时，对应的哈希桶内存才会被释放，此时指标才会下降。
• 如果你的应用持续创建新map，或者现有map不断扩容（比如持续往map中添加元素，即使删除部分元素也无法触发桶的收缩），这个指标就会持续增长。若增长到一定程度后趋于稳定，说明map不再扩容或新增，属于正常现象；但如果无限制持续增长，可能存在map泄漏（比如全局map累积大量无效数据，或持有大量未被回收的map引用），需要排查代码。

3. 源码结论验证 #

你查看源码的结论是正确的：mstats.buckhash_sys确实仅在创建新哈希桶时增长。
Go运行时中，当map需要扩容、分裂桶或创建新map时，会通过内部函数分配新的哈希桶内存，此时buckhash_sys会累加对应内存大小；而删除元素的操作不会触发哈希桶的释放，也就不会减少该指标的值。只有当整个map被GC回收时，对应的哈希桶内存才会被归还，此时buckhash_sys的减少是通过GC的统计更新实现的，日常元素删除操作不会影响该指标的数值。

内容的提问来源于stack exchange，提问作者Dzmitry Y