别再猜测gcache：使用gcache-inspector检查Galera/PXC写入集
内容提要
Percona工程师开发了开源工具gcache-inspector，用于解码Galera缓存文件（如galera.cache），帮助用户查看缓存内容、分析写入负载和事务细节。该工具支持离线检查、详细报告、行级解码及加密文件，解决了传统上缓存文件难以检查的问题，有助于优化集群维护和故障排查。
延伸解读
为什么需要检查GCache
Galera缓存（galera.cache）是环形缓冲区，存储复制事务的写入集。其大小直接影响节点重连时能否通过增量状态传输（IST）快速同步，否则需全量备份（SST），导致集群性能下降。传统上，缓存文件难以检查，只能依赖wsrep_received/replicated_bytes等变量估算大小，但无法了解具体内容。gcache-inspector填补了这一空白，帮助运维人员直观查看缓存中的事务细节，从而更精准地进行容量规划和故障排查。
工具功能与使用场景
gcache-inspector支持离线检查，可解码galera.cache或gcache.page.X文件，提供默认报告、--detail参数查看每个序列号的事务详情，以及--decode-rows解码行级变更。例如，可查看特定seqno下插入、更新或删除的行数。该工具还支持加密缓存文件（需提供密钥或Vault凭据），但注意加密文件中的新事务会延迟出现。它适用于分析写入负载、验证DDL复制行为（如失败的ALTER仍被复制）等场景。
注意事项与限制
使用gcache-inspector时需注意：它不支持MariaDB Galera Cluster Enterprise Edition的加密（因无源码访问）。此外，加密缓存文件在内存缓存填满或关闭前不会显示新事务，因此检查时可能看到延迟。工具虽能提供详细事务信息，但并非万能，复杂问题仍需结合错误日志、二进制日志和GRA文件综合判断。对于缓存不足导致频繁SST的问题，建议联系Percona专家进行集群健康审查。
Q&A
gcache-inspector是什么工具？
gcache-inspector是一个开源的Galera缓存文件解码工具，由Percona工程师开发，用于检查Galera缓存文件（如galera.cache）的内容，帮助用户理解写入负载和事务细节。
为什么需要检查Galera缓存文件？
检查Galera缓存文件有助于理解写入工作负载的影响、分析事务细节、排查复制问题，以及优化缓存大小规划，避免节点因缓存不足而回退到SST（全量备份）。
gcache-inspector有哪些主要功能？
gcache-inspector可以完全解码Galera缓存文件，提供快速的一般写入模式统计、写入集性质信息，并能解码实际的行级事件（二进制日志风格）。它还支持离线检查、详细报告、行级解码以及加密文件的检查。
如何使用gcache-inspector查看特定事务的详细信息？
使用--detail参数可以查看每个序列号的详细信息，例如事务插入的行数；使用--decode-rows参数可以打印整个事件细节，查看具体哪些行被修改。
gcache-inspector能检查加密的Galera缓存文件吗？
可以，但需要提供加密密钥或vault凭据。需要注意的是，加密缓存文件中的新事务不会立即显示，直到内存中的加密缓存被填满或在关闭时同步。
gcache-inspector支持MariaDB Galera Cluster Enterprise Edition的加密吗？
不支持，因为该版本没有源代码访问权限。
gcache-inspector在哪里可以获取？
该工具以GPLv3许可证发布，源代码和二进制包可在GitHub上获取：https://github.com/PrzemekMalkowski/gcache-inspector。
