如何在EC2 SUSE Linux的Filebeat.yml中使用AWS参数存储值？

核心问题原因 #

FileBeat默认不会自动解析配置文件中的环境变量语法，直接写${parameter}会被当作普通字符串处理，而非读取对应环境变量的值，这就是你遇到字段未设置错误的根源。

可行解决方案 #

方案1：启动时通过--E参数注入变量 #

无需修改配置文件结构，启动时直接传递参数值：

1. 先获取参数并赋值给环境变量：

   export ELASTIC_PASSWORD=$(aws ssm get-parameter --name my_stored_value --query 'Parameter.Value' --output text)
   

2. 启动FileBeat时用--E指定对应配置项（替换成你实际需要的字段，比如name）：

   filebeat -e --E name=${ELASTIC_PASSWORD}
   

方案2：使用FileBeat的环境变量解析（推荐） #

7.x及以上版本的FileBeat支持${ENV_VAR}语法，但要确保环境变量能被FileBeat进程读取：

1. 保持环境变量的设置：

   export parameter=$(aws ssm get-parameter --name my_stored_value --query 'Parameter.Value' --output text)
   

2. 修改filebeat.yml配置，注意不要加引号：

   name: ${parameter}
   # 可选：添加默认值，避免变量不存在时报错
   # name: ${parameter:default_name}
   

3. 若用systemd管理FileBeat服务，需将环境变量加入systemd配置，确保进程能读到：
   • 编辑服务配置文件（如/etc/systemd/system/filebeat.service.d/override.conf）：

     [Service]
     Environment="parameter=$(aws ssm get-parameter --name my_stored_value --query 'Parameter.Value' --output text)"
     

   • 重载配置并重启服务：

     systemctl daemon-reload
     systemctl restart filebeat
     

方案3：预先渲染配置文件（批量场景适用） #

适合批量更新50+实例的场景，用模板渲染工具生成最终配置：

1. 创建模板文件filebeat.yml.tmpl：

   name: ${parameter}
   # 其他配置内容...
   

2. 用envsubst渲染模板生成实际配置：

   export parameter=$(aws ssm get-parameter --name my_stored_value --query 'Parameter.Value' --output text)
   envsubst < filebeat.yml.tmpl > /etc/filebeat/filebeat.yml
   

3. 重启FileBeat：

   systemctl restart filebeat
   

验证方法 #

执行以下命令检查配置是否生效：

filebeat test config

若配置无错误，再查看日志确认值是否正确加载：

journalctl -u filebeat -f

内容的提问来源于stack exchange，提问作者Bart Hofma