Puppet自定义报告处理器向Sentry发送报告时@host值异常

问题根源 #

在Puppet 7.x的服务器端报告处理器环境中，self.host会被服务器运行上下文覆盖为主节点的主机名，而非客户端节点的FQDN。虽然客户端上传的YAML报告中host字段正确，但处理器实例的host属性已经被服务器环境修改。

解决办法 #

直接读取报告的原始YAML数据字段来获取客户端节点的正确FQDN，具体步骤如下：

1. 修改自定义报告处理器的代码
   在process方法中，放弃使用self.host，转而读取self.raw['host']——这个属性保存了客户端上传的原始报告数据，其中的host字段就是你在YAML文件中看到的正确节点FQDN。

   示例代码：

   class SentryReportProcessor < Puppet::Reports::Base
     def process
       # 获取客户端节点的正确FQDN
       node_fqdn = self.raw['host']
       
       # 设置Sentry的server_name标签
       Sentry.configure_scope do |scope|
         scope.set_tag(:server_name, node_fqdn)
       end
   
       # 筛选并发送err级日志到Sentry
       self.logs.each do |log_entry|
         next unless log_entry.level == :err
         Sentry.capture_message(
           log_entry.message,
           level: :error,
           extra: {
             source: log_entry.source,
             file: log_entry.file,
             line: log_entry.line
           }
         )
       end
     end
   end
   

2. 备选验证方案
   如果raw属性读取有问题，也可以尝试读取self.name——Puppet报告对象的name属性通常对应客户端节点的名称，多数场景下也能得到正确的FQDN。

3. 确认处理器加载配置
   确保你的自定义处理器在Puppet服务器上正确加载：

   • 将处理器文件放在/opt/puppetlabs/puppet/lib/puppet/reports/目录下
   • 在puppet.conf的[main]或[server]段添加reports = sentry（如果已有其他报告处理器，用逗号分隔）

验证 #

修改代码后，触发一次客户端的Puppet运行，检查Sentry中的事件标签，应该能看到对应的客户端节点FQDN，而非主节点名称。

内容的提问来源于stack exchange，提问作者Mihai Cherechesu