配置集中式管道管理 · Logstash中文文档（个人翻译）

# 配置集中式管道管理要安装[集中式管道管理](http://www.elastic.co/guide/en/logstash/6.5/logstash-centralized-pipeline-management.html)： 1. 确定你使用的授权包括管道管理功能。更多信息，查看<https://www.elastic.co/subscriptions>和[License Management](https://www.elastic.co/guide/en/elastic-stack-overview/6.5/license-management.html)。 2. 在`logstash.yml`中指定[configuration management settings](https://www.elastic.co/guide/en/logstash/6.5/configuring-centralized-pipelines.html#configuration-management-settings)。至少包含下面的设置 + `xpack.management.enable: true`来开启集中式配置管理。 + `xpack.management.elasticsearch.url`来指定将会存储Logstash管道配置和元数据的Elasticsearch实例。 + `xpack.management.pipeline.id`来注册你想要集中管理的管道。 3. 重启Logstash。 4. 如果Elasticsearch使用了基本认证进行保护，给将要使用集中管道管理的任何用户分配`logstash_admin`的角色。参见[X-Pack security](https://www.elastic.co/guide/en/logstash/6.5/ls-security.html)。 > <font color=#DC143C size=4>NOTE</font>：在配置并启用X-Pack security之前，集中式管理是禁用的。（这句话让我不是很明白集中式管道管理开启的前提是开启X-Pack Security还是说在开启X-Pack Security之后如果没有正确配置则集中式管理会被禁用，区别在于X-Pack security是否是必须开启的。） > > Centralized management is disabled until you configure and enable X-Pack security. > <font color=#FF0000 size=4>IMPORTANT</font>：在配置Logstash使用集中式管道管理之后，本地管道配置将不再可用。这意味着`pipeline.yml`文件和类似`path.config`以及`config.string`的设置将不再处于活跃状态。 # Logstash中的配置管理策略(设置) 你可以设置下面的`xpack.management`设置在`logstash.yml`文件中来开启[集中式管道管理](https://www.elastic.co/guide/en/logstash/6.5/logstash-centralized-pipeline-management.html)。更多配置Logstash的信息，查看[logstash.yml](https://www.elastic.co/guide/en/logstash/6.5/logstash-settings-file.html)。下面的基本示例假定Elasticsearch和Kibana已经在本地安装并且开启了基本认证，但没有SSL。如果你使用SSL，你需要指定额外的SSL设置。 ```yaml xpack.management.enabled: true xpack.management.elasticsearch.url: "http://localhost:9200/" xpack.management.elasticsearch.username: logstash_admin_user xpack.management.elasticsearch.password: t0p.s3cr3t xpack.management.logstash.poll_interval: 5s xpack.management.pipeline.id: ["apache", "cloudwatch_logs"] ``` `xpack.management.enabled` 设置为`true`表示为Logstash开启X-Pack 集中式配置管理。 `xpack.management.logstash.poll_interval` Logstash实例轮询来自Elasticsearch的管道更改的频率。默认值为5s。 How often the Logstash instance polls for pipeline changes from Elasticsearch. The default is 5s. `xpack.management.pipeline.id` 指定以逗号分隔的管道标识列表，以便为集中式管道生产管理注册。更改此设置后，您需要重新启动Logstash来使更改生效。 `xpack.management.elasticsearch.url` 存储Logstash管道配置和元数据的Elasticsearch示例。可以是和`outputs`中的相同的实例，也可以是不同的。默认是 `http://localhost:9200`. `xpack.management.elasticsearch.username` and `xpack.management.elasticsearch.password` 如果你的Elasticsearch集群使用基本认证进行保护，这些设置提供用户名和密码，Logstash实例使用这些用户名和密码对访问配置数据进行身份验证。你在这里指定的用户名和密码必须具有`logstash_admin`角色，它提供对于`.logstash-*`的索引的认证。 `xpack.management.elasticsearch.ssl.ca` 可选项，你可以给你的Elasticsearch示例指定一个`.pem`文件格式的证书的路径。 `xpack.management.elasticsearch.ssl.truststore.path` 可选设置，提供了验证服务器证书的Java密钥库(JKS)的路径。 Optional setting that provides the path to the Java keystore (JKS) to validate the server’s certificate. `xpack.management.elasticsearch.ssl.truststore.password` 可选项，向truststore提供一个密码 `xpack.management.elasticsearch.ssl.keystore.path` 可选设置，提供了验证客户端证书的Java密钥库(JKS)的路径。 Optional setting that provides the path to the Java keystore (JKS) to validate the client’s certificate. `xpack.management.elasticsearch.ssl.keystore.password` 可选设置，向keystore提供密码。 Optional setting that provides the password to the keystore.