在 Docker 中配置 Logstash
编辑在 Docker 中配置 Logstash编辑
Logstash 区分两种类型的配置：设置和管道配置。
管道配置编辑
将管道配置放在 Logstash 可以找到的位置至关重要。默认情况下，容器将在 /usr/share/logstash/pipeline/ 中查找管道配置文件。
在此示例中，我们使用绑定挂载卷通过 docker run 命令提供配置
docker run --rm -it -v ~/pipeline/:/usr/share/logstash/pipeline/ docker.elastic.co/logstash/logstash:8.14.2
主机目录 ~/pipeline/ 中的每个文件都将被 Logstash 解析为管道配置。
如果您没有向 Logstash 提供配置，它将使用最小配置运行，该配置侦听来自 Beats 输入插件 的消息，并将接收到的任何消息回显到 stdout。在这种情况下，启动日志将类似于以下内容
Sending Logstash logs to /usr/share/logstash/logs which is now configured via log4j2.properties.
[2016-10-26T05:11:34,992][INFO ][logstash.inputs.beats ] Beats inputs: Starting input listener {:address=>"0.0.0.0:5044"}
[2016-10-26T05:11:35,068][INFO ][logstash.pipeline ] Starting pipeline {"id"=>"main", "pipeline.workers"=>4, "pipeline.batch.size"=>125, "pipeline.batch.delay"=>5, "pipeline.max_inflight"=>500}
[2016-10-26T05:11:35,078][INFO ][org.logstash.beats.Server] Starting server on port: 5044
[2016-10-26T05:11:35,078][INFO ][logstash.pipeline ] Pipeline main started
[2016-10-26T05:11:35,105][INFO ][logstash.agent ] Successfully started Logstash API endpoint {:port=>9600}
这是映像的默认配置，定义在 /usr/share/logstash/pipeline/logstash.conf 中。如果您观察到这种行为，请确保您的管道配置被正确拾取，并且您正在替换 logstash.conf 或整个 pipeline 目录。
设置编辑
该映像提供了多种配置设置的方法。传统方法是提供自定义 logstash.yml 文件，但也可以使用环境变量来定义设置。
绑定挂载设置文件编辑
设置文件也可以通过绑定挂载提供。Logstash 预计在 /usr/share/logstash/config/ 中找到它们。
可以提供包含所有必需文件的整个目录
docker run --rm -it -v ~/settings/:/usr/share/logstash/config/ docker.elastic.co/logstash/logstash:8.14.2
或者，可以挂载单个文件
docker run --rm -it -v ~/settings/logstash.yml:/usr/share/logstash/config/logstash.yml docker.elastic.co/logstash/logstash:8.14.2
绑定挂载的配置文件将保留与主机系统上相同的权限和所有权。确保设置权限，以便容器的 logstash 用户（UID 1000）可以读取这些文件，并且理想情况下不可写入。
自定义映像编辑
绑定挂载配置当然不是唯一的选择。如果您更喜欢不可变基础设施方法，可以使用类似于此的 Dockerfile 来准备包含您的配置的自定义映像
FROM docker.elastic.co/logstash/logstash:8.14.2 RUN rm -f /usr/share/logstash/pipeline/logstash.conf COPY pipeline/ /usr/share/logstash/pipeline/ COPY config/ /usr/share/logstash/config/
确保替换或删除自定义映像中的 logstash.conf，这样您就不会保留基本映像中的示例配置。
环境变量配置编辑
在 Docker 中，Logstash 设置可以通过环境变量进行配置。当容器启动时，一个辅助进程检查环境以查找可以映射到 Logstash 设置的变量。在容器启动时，在环境中找到的设置将覆盖 logstash.yml 中的设置。
为了与容器编排系统兼容，这些环境变量全部大写，并使用下划线作为单词分隔符。
这里显示了一些示例翻译
表 1. 示例 Docker 环境变量
|
环境变量 |
Logstash 设置 |
|
|
|
|
|
|
|
|
|
一般来说，设置文档 中列出的任何设置都可以使用此技术进行配置。
使用环境变量定义设置会导致 logstash.yml 被就地修改。如果 logstash.yml 从主机系统绑定挂载，这种行为可能不理想。因此，不建议将绑定挂载技术与环境变量技术结合使用。最好选择一种方法来定义 Logstash 设置。
Docker 默认值编辑
以下设置在使用 Docker 映像时具有不同的默认值
|
|
|
|
|
|
设置 monitoring.elasticsearch.hosts 未在 -oss 映像中定义。
这些设置在默认的 logstash.yml 中定义。它们可以通过 自定义 logstash.yml 或通过 环境变量 覆盖。
如果用自定义版本替换 logstash.yml，请确保将上述默认值复制到自定义文件，如果您想保留它们。否则，它们将被新文件“屏蔽”。
日志记录配置编辑
在 Docker 中，Logstash 日志默认情况下会写入标准输出。要更改此行为，请使用上述任何技术替换 /usr/share/logstash/config/log4j2.properties 中的文件。