Logstash Sidecar无法读取环境变量问题求助

以下是针对Logstash作为Sidecar无法解析Kubernetes Deployment注入环境变量的排查与解决步骤：

1. 验证环境变量是否成功注入容器 #

先确认Kubernetes是否将环境变量正确传递到Logstash Sidecar容器中：

• 执行命令查看容器内的环境变量：

  kubectl exec <目标Pod名称> -c logstash-sidecar -- printenv
  

• 检查输出中是否存在MYSQL_HOST、MYSQL_USER、MYSQL_PASSWORD这些变量，且值符合预期。如果变量不存在，说明Deployment的环境变量配置存在层级错误，请确认env字段是直接嵌套在容器定义下（参考正确的YAML结构）。

2. 确保Logstash启用环境变量插值 #

Logstash默认支持${VAR}语法解析环境变量，但需确认以下配置：

• 检查Logstash的启动命令是否正确加载了配置文件，未禁用插值功能。可以添加--config.debug参数启动Logstash，查看日志中加载的配置是否已替换环境变量：

  logstash -f /path/to/your/pipeline.conf --config.debug
  

• 若使用自定义logstash.yml，确保未设置config.support_escapes: false（默认值为true，允许环境变量插值）。

3. 调整Logstash JDBC配置的变量引用 #

在JDBC插件配置中，可添加默认值来排查变量解析问题，同时确保语法正确：

jdbc {
    jdbc_driver_library => "/usr/share/logstash/mysql-connector-java-8.0.22.jar"
    jdbc_driver_class => "com.mysql.cj.jdbc.Driver"
    # 添加默认值localhost，若变量未解析则使用默认值
    jdbc_connection_string => "jdbc:mysql://${MYSQL_HOST:localhost}/<DB_NAME>"
    jdbc_user => "${MYSQL_USER:root}"
    jdbc_password => "${MYSQL_PASSWORD:default_pass}"
    ...
}

如果使用默认值后Logstash能正常启动，说明环境变量未成功注入；若仍无法启动，则需检查Logstash的配置加载逻辑。

4. 检查Logstash镜像的启动脚本 #

部分自定义Logstash镜像可能通过自定义启动脚本调用Logstash，导致环境变量未传递到Logstash进程：

• 查看镜像的ENTRYPOINT或CMD配置，确保直接调用logstash命令，而非通过脚本丢失环境变量。例如正确的启动命令应为：

  logstash -f /usr/share/logstash/config/pipeline.conf
  

5. 排查配置文件权限问题 #

如果Logstash进程（运行用户为1001）无法读取配置文件，也会导致变量解析失败：

• 执行命令检查配置文件权限：

  kubectl exec <目标Pod名称> -c logstash-sidecar -- ls -l /usr/share/logstash/config/pipeline.conf
  

• 确保文件所有者或组包含1001用户，且具备读权限。

内容的提问来源于stack exchange，提问作者Sarthak Sinha