用hcache JSON输出 jq打造你的专属缓存监控脚本【免费下载链接】hcacheshowing top X biggest cache files global项目地址: https://gitcode.com/gh_mirrors/hc/hcache如果你管理着Linux服务器一定遇到过内存明明很大却总感觉不够用的困惑——其实大部分都被页面缓存page cache占用了。hcache就是一款专注于缓存监控的开源命令行工具它基于mincore系统调用能精确告诉你每一个文件被缓存在内存中的实际大小并通过--top参数一键展示全局缓存占用最大的前N个文件。本文教你将 hcache 的JSON输出与神器jq结合快速打造一套属于自己的缓存监控脚本彻底告别内存去哪了的谜题。为什么需要hcache做缓存监控Linux 会利用空闲内存缓存磁盘文件free -h只能告诉你缓存总量却无法回答最关键的问题到底是哪些大文件霸占了缓存hcache 用mincore(2)系统调用逐页扫描文件缓存状态从根源上解决了这个痛点。作为 pcstat 的增强版hcache 最大的亮点是--top [X]选项它扫描系统所有进程打开的映射文件去重后按缓存大小降序排列直接输出全局缓存占用最大的 X 个文件这是原生 pcstat 不具备的能力。最快安装方法三分钟跑起来hcache 是 Go 语言项目需要 Go 1.12 环境安装非常简单git clone https://gitcode.com/gh_mirrors/hc/hcache cd hcache make build sudo cp hcache /usr/local/bin/核心构建逻辑就在项目根目录的 Makefile 中。安装完成后先看一条基础命令感受效果sudo hcache --top 5输出包含文件路径、Size总大小、Pages总页数、Cached Size缓存大小、Cached Pages已缓存页数和 Percent缓存命中率最后还会附一行 Sum 汇总一目了然。掌握hcache JSON输出监控脚本的数据基础表格输出适合人看但脚本处理必须用结构化数据。hcache 原生支持-json参数输出标准 JSON 数组这是打造缓存监控脚本的关键一步。快速上手-json参数sudo hcache --top 5 -json输出形如[ { time: 2026-08-18T08:20:0008:00, name: /usr/bin/mysqld, size: 385875968, mtime: 2026-07-01T10:00:0008:00, pages: 94208, cached: 90112, percent: 95.65, pp: null } ]每个字段的含义name文件路径、size文件总字节数、pages总页数、cached已缓存页数、percent缓存命中率0-100。默认情况下pp逐页状态为空避免输出体积过大这正是脚本处理想要的轻量格式。相关格式化逻辑见源码 formats.go 中的FormatJson方法。善用辅助参数组合参数作用推荐场景--top N只看全局缓存最大的N个文件定位缓存大户-bname只显示文件名不显示完整路径输出更紧凑-nohdr表格模式去掉表头日志收集-pid查看指定进程的缓存文件进程级分析注意-pid与--top不能同时使用这是 main.go 中设计的限制。jq过滤与排序让JSON数据活起来拿到 JSON 只是第一步jq 是处理 JSON 输出的黄金搭档。它安装简单apt install jq一行命令就能完成过滤、排序、聚合。技巧一只看缓存命中率最高的文件sudo hcache --top 20 -json | jq sort_by(-.percent)[0:10] | .[] | \(.name) \(.percent)%技巧二按缓存字节数精确排序--top默认按已缓存页数排序如果想按缓存字节数排序sudo hcache --top 20 -json | jq -r map(select(.percent 0)) | sort_by(-(.size * .percent / 100))[:10][] | \(.size * .percent / 100 | ./1048576 | floor)MB \(.name)技巧三过滤出特定目录的缓存文件排查某个应用如 MySQL 数据目录的缓存情况sudo hcache --top 50 -json | jq -r .[] | select(.name | contains(/var/lib/mysql)) | \(.name) \(.percent)%实战一键安装版缓存监控脚本把 hcache 与 jq 组合起来配合 cron 定时任务就能实现无人值守的缓存监控。下面是一个可直接使用的完整脚本思路#!/bin/bash # 缓存监控脚本统计全局缓存Top文件并输出告警 sudo hcache --top 10 -json | jq -r 时间: \(.time)\n Top缓存文件:\n ([.[] | \(.name) 缓存\(.cached * 4096 / 1048576)MB 命中\(.percent)%] | join(\n)) /tmp/cache_report.txt # 阈值告警命中率低于80%的文件告警 sudo hcache --top 50 -json | jq -r .[] | select(.percent 80) | 警告: \(.name) 命中率仅\(.percent)% /tmp/cache_report.txt配置定时执行crontab -e # 每天凌晨3点生成缓存监控报告 0 3 * * * /usr/local/bin/cache_monitor.sh进阶玩法持续追踪缓存变化把每天的 Top 文件快照保存下来用 diff 对比就能发现哪些缓存文件在持续增长从而定位内存压力的源头比如某个被频繁读写的日志文件或数据库表空间。常见问题排查指南为什么 --top 需要 root 权限因为读取/proc/*/maps和调用 mincore 需要权限非 root 可能扫描不全建议用sudo执行。JSON 输出为空或报错先确认没有同时使用-pid和--top再用sudo hcache --top 3 -json | head -c 500验证原始输出是否正常。jq 命令报语法错误注意单引号内的转义jq 表达式建议先jq .测试管道是否通畅再逐步叠加过滤条件。总结hcache 用--top参数解决了全局缓存文件排行的难题而hcache JSON输出 jq的组合把这份能力变成可编程、可自动化、可告警的缓存监控脚本。无论是日常巡检、容量规划还是故障排查这套组合都能帮你快速定位缓存大户让 Linux 内存管理从此透明可控。现在就去 clone 项目试试把缓存监控脚本纳入你的运维工具箱吧【免费下载链接】hcacheshowing top X biggest cache files global项目地址: https://gitcode.com/gh_mirrors/hc/hcache创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用hcache JSON输出 + jq：打造你的专属缓存监控脚本
用hcache JSON输出 jq打造你的专属缓存监控脚本【免费下载链接】hcacheshowing top X biggest cache files global项目地址: https://gitcode.com/gh_mirrors/hc/hcache如果你管理着Linux服务器一定遇到过内存明明很大却总感觉不够用的困惑——其实大部分都被页面缓存page cache占用了。hcache就是一款专注于缓存监控的开源命令行工具它基于mincore系统调用能精确告诉你每一个文件被缓存在内存中的实际大小并通过--top参数一键展示全局缓存占用最大的前N个文件。本文教你将 hcache 的JSON输出与神器jq结合快速打造一套属于自己的缓存监控脚本彻底告别内存去哪了的谜题。为什么需要hcache做缓存监控Linux 会利用空闲内存缓存磁盘文件free -h只能告诉你缓存总量却无法回答最关键的问题到底是哪些大文件霸占了缓存hcache 用mincore(2)系统调用逐页扫描文件缓存状态从根源上解决了这个痛点。作为 pcstat 的增强版hcache 最大的亮点是--top [X]选项它扫描系统所有进程打开的映射文件去重后按缓存大小降序排列直接输出全局缓存占用最大的 X 个文件这是原生 pcstat 不具备的能力。最快安装方法三分钟跑起来hcache 是 Go 语言项目需要 Go 1.12 环境安装非常简单git clone https://gitcode.com/gh_mirrors/hc/hcache cd hcache make build sudo cp hcache /usr/local/bin/核心构建逻辑就在项目根目录的 Makefile 中。安装完成后先看一条基础命令感受效果sudo hcache --top 5输出包含文件路径、Size总大小、Pages总页数、Cached Size缓存大小、Cached Pages已缓存页数和 Percent缓存命中率最后还会附一行 Sum 汇总一目了然。掌握hcache JSON输出监控脚本的数据基础表格输出适合人看但脚本处理必须用结构化数据。hcache 原生支持-json参数输出标准 JSON 数组这是打造缓存监控脚本的关键一步。快速上手-json参数sudo hcache --top 5 -json输出形如[ { time: 2026-08-18T08:20:0008:00, name: /usr/bin/mysqld, size: 385875968, mtime: 2026-07-01T10:00:0008:00, pages: 94208, cached: 90112, percent: 95.65, pp: null } ]每个字段的含义name文件路径、size文件总字节数、pages总页数、cached已缓存页数、percent缓存命中率0-100。默认情况下pp逐页状态为空避免输出体积过大这正是脚本处理想要的轻量格式。相关格式化逻辑见源码 formats.go 中的FormatJson方法。善用辅助参数组合参数作用推荐场景--top N只看全局缓存最大的N个文件定位缓存大户-bname只显示文件名不显示完整路径输出更紧凑-nohdr表格模式去掉表头日志收集-pid查看指定进程的缓存文件进程级分析注意-pid与--top不能同时使用这是 main.go 中设计的限制。jq过滤与排序让JSON数据活起来拿到 JSON 只是第一步jq 是处理 JSON 输出的黄金搭档。它安装简单apt install jq一行命令就能完成过滤、排序、聚合。技巧一只看缓存命中率最高的文件sudo hcache --top 20 -json | jq sort_by(-.percent)[0:10] | .[] | \(.name) \(.percent)%技巧二按缓存字节数精确排序--top默认按已缓存页数排序如果想按缓存字节数排序sudo hcache --top 20 -json | jq -r map(select(.percent 0)) | sort_by(-(.size * .percent / 100))[:10][] | \(.size * .percent / 100 | ./1048576 | floor)MB \(.name)技巧三过滤出特定目录的缓存文件排查某个应用如 MySQL 数据目录的缓存情况sudo hcache --top 50 -json | jq -r .[] | select(.name | contains(/var/lib/mysql)) | \(.name) \(.percent)%实战一键安装版缓存监控脚本把 hcache 与 jq 组合起来配合 cron 定时任务就能实现无人值守的缓存监控。下面是一个可直接使用的完整脚本思路#!/bin/bash # 缓存监控脚本统计全局缓存Top文件并输出告警 sudo hcache --top 10 -json | jq -r 时间: \(.time)\n Top缓存文件:\n ([.[] | \(.name) 缓存\(.cached * 4096 / 1048576)MB 命中\(.percent)%] | join(\n)) /tmp/cache_report.txt # 阈值告警命中率低于80%的文件告警 sudo hcache --top 50 -json | jq -r .[] | select(.percent 80) | 警告: \(.name) 命中率仅\(.percent)% /tmp/cache_report.txt配置定时执行crontab -e # 每天凌晨3点生成缓存监控报告 0 3 * * * /usr/local/bin/cache_monitor.sh进阶玩法持续追踪缓存变化把每天的 Top 文件快照保存下来用 diff 对比就能发现哪些缓存文件在持续增长从而定位内存压力的源头比如某个被频繁读写的日志文件或数据库表空间。常见问题排查指南为什么 --top 需要 root 权限因为读取/proc/*/maps和调用 mincore 需要权限非 root 可能扫描不全建议用sudo执行。JSON 输出为空或报错先确认没有同时使用-pid和--top再用sudo hcache --top 3 -json | head -c 500验证原始输出是否正常。jq 命令报语法错误注意单引号内的转义jq 表达式建议先jq .测试管道是否通畅再逐步叠加过滤条件。总结hcache 用--top参数解决了全局缓存文件排行的难题而hcache JSON输出 jq的组合把这份能力变成可编程、可自动化、可告警的缓存监控脚本。无论是日常巡检、容量规划还是故障排查这套组合都能帮你快速定位缓存大户让 Linux 内存管理从此透明可控。现在就去 clone 项目试试把缓存监控脚本纳入你的运维工具箱吧【免费下载链接】hcacheshowing top X biggest cache files global项目地址: https://gitcode.com/gh_mirrors/hc/hcache创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考