Fluent Bit中node_exporter_metrics插件CPU指标收集问题解析

问题背景

在使用Fluent Bit的node_exporter_metrics插件收集主机CPU指标时，许多用户遇到了指标无法收集的问题，并伴随出现"read error, check permissions: /devices/system/cpu/cpu[0-9]*"的错误日志。这个问题在Docker容器化部署环境中尤为常见。

问题现象

当配置node_exporter_metrics插件收集CPU指标时，系统会持续输出以下错误信息：

[error] [input:node_exporter_metrics:node_exporter_metrics.0] read error, check permissions: /devices/system/cpu/cpu[0-9]*
[error] [/src/fluent-bit/plugins/in_node_exporter_metrics/ne_utils.c:170 errno=2] No such file or directory

尽管容器已经以root权限运行，并且挂载了主机的/proc和/sys文件系统，CPU指标仍然无法正常收集。

根本原因

这个问题的根源在于路径处理逻辑存在缺陷。错误日志中显示的路径"/devices/system/cpu/cpu[0-9]"实际上是不完整的，正确的完整路径应该是"/sys/devices/system/cpu/cpu[0-9]"。

在Docker环境中，当用户将主机的/sys目录挂载到容器的/host/sys路径时，插件未能正确处理这个挂载点前缀，导致无法找到正确的CPU信息文件路径。

解决方案

该问题已在Fluent Bit的最新版本中得到修复。修复方案主要涉及以下几个方面：

1. 修正了路径拼接逻辑，确保能够正确处理挂载点前缀
2. 改进了错误日志的输出，现在会显示完整的路径信息，便于诊断
3. 增强了路径存在性检查，避免因路径问题导致插件功能异常

最佳实践建议

对于需要在容器中收集主机指标的用户，建议遵循以下配置原则：

1. 确保正确挂载主机文件系统：

volumes:
  - /proc:/host/proc:ro
  - /sys:/host/sys:ro

2. 在插件配置中明确指定挂载点路径：

[INPUT]
    Name            node_exporter_metrics
    path.procfs     /host/proc
    path.sysfs      /host/sys

3. 使用最新版本的Fluent Bit，以确保包含所有相关修复

总结

Fluent Bit的node_exporter_metrics插件在收集CPU指标时出现的路径问题，反映了在容器化环境中处理主机文件系统时需要特别注意路径映射关系。通过理解问题的本质并采用正确的配置方法，用户可以确保主机指标收集功能的稳定运行。随着Fluent Bit的持续迭代，这类问题将得到更好的解决，为监控和日志收集提供更可靠的保障。