在 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.16.0
主机目录 ~/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.16.0
或者，可以挂载单个文件
docker run --rm -it -v ~/settings/logstash.yml:/usr/share/logstash/config/logstash.yml docker.elastic.co/logstash/logstash:8.16.0
绑定挂载的配置文件将保留与主机系统上相同的权限和所有权。请确保设置权限，以便容器的 logstash 用户 (UID 1000) 可以读取这些文件，理想情况下不可写入。
自定义镜像
编辑绑定挂载配置当然不是唯一的选择。如果您更喜欢“不变的基础设施”方法，您可以使用类似于此的 Dockerfile 准备包含您配置的自定义镜像
FROM docker.elastic.co/logstash/logstash:8.16.0 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 镜像时，以下设置具有不同的默认值
|
|
|
|
|
|
-oss 镜像中未定义设置 monitoring.elasticsearch.hosts。
这些设置在默认 logstash.yml 中定义。它们可以使用 自定义 logstash.yml 或通过 环境变量 覆盖。
如果使用自定义版本替换 logstash.yml，请确保如果要保留上述默认值，则将其复制到自定义文件。否则，它们将被新文件“屏蔽”。
日志记录配置
编辑在 Docker 中，Logstash 日志默认情况下会输出到标准输出。要更改此行为，请使用上述任何技术替换 /usr/share/logstash/config/log4j2.properties 中的文件。