配置集中式管道管理 · 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.