Kiali项目中缺失的内部指标问题分析与修复

背景介绍

Kiali作为一个服务网格的可观测性工具，其内部会收集和暴露各种指标数据用于监控自身的运行状态。在Kiali v2.10.0版本中，开发团队发现代码中定义并使用了几个内部指标，但这些指标并未出现在Prometheus的抓取端点中。

问题指标分析

Kiali代码中主要涉及三个内部指标：

1. Kubernetes客户端数量指标：用于统计Kubernetes客户端的数量
2. 缓存请求总数指标：记录特定缓存的总请求次数
3. 缓存命中总数指标：记录特定缓存的命中次数

深入调查与解决方案

缓存相关指标

经过深入调查发现，缓存请求总数和缓存命中总数这两个指标实际上是被正确使用的，主要用于Tempo缓存。这些指标已经正确定义并带有"name"标签。当前唯一会出现的标签值是"tempo"，因此我们只会看到一个时间序列，其标签为"tempo"，代表Tempo缓存的统计数据。

虽然这些指标功能正常，但开发团队注意到指标变量的命名没有遵循项目中其他指标的命名模式。这是一个代码风格问题，只需要对单个文件进行微小修改即可解决。

Kubernetes客户端指标

关于Kubernetes客户端数量指标的问题，进一步调查发现这个指标实际上是用于统计用户客户端的数量。要看到这个指标正常工作，需要使用非匿名(anonymous)的身份验证策略。这意味着在默认的匿名认证配置下，这个指标不会出现，这是预期行为而非错误。

技术实现细节

在Kiali的内部指标实现中，这些指标通过Prometheus客户端库进行定义和暴露。每个指标都遵循特定的标签规范，确保数据的一致性和可查询性。缓存相关指标特别设计为支持多种缓存类型，虽然当前只应用于Tempo缓存，但架构上已经为未来扩展做好准备。

总结

通过对Kiali内部指标的深入分析，开发团队确认这些指标实际上工作正常，只是部分指标在特定配置下才会出现。对于缓存指标，团队进行了命名规范的统一调整以保持代码一致性。这个案例展示了在复杂系统中，看似问题的现象背后可能有合理的解释，深入理解系统行为和配置依赖关系对于正确诊断问题至关重要。