Metricbeat 參考指南（步驟2：配置Metricbeat）

步驟2：配置Metricbeat

要配置Metricbeat，你須要編輯配置文件，對於rpm和deb，你將在/etc/metricbeat/metricbeat.yml找到配置文件，在Docker下，它位於/usr/share/metricbeat/metricbeat.yml，對於mac和win，請查看你解壓的歸檔，還有一個完整的示例配置文件，名爲metricbeat.reference.yml，它顯示了全部可用的選項。

有關配置文件結構的更多信息，請參閱Beats平臺參考資料中的 配置文件格式部分。

在配置Metricbeat時，須要指定要運行哪些modules，Metricbeat使用模塊收集指標，每一個模塊定義從特定服務（如Redis或MySQL）收集數據的基本邏輯，模塊由用於獲取和構造數據的指標集組成，閱讀Metricbeat是如何工做的以瞭解更多。

配置Metricbeat：

1.啓用你想要運行的模塊，若是你接受默認配置而不啓用其餘模塊，那麼Metricbeat只收集系統指標。

你能夠啓用在modules.d目錄中定義的默認模塊配置（推薦），或者將模塊配置添加到metricbeat.yml文件，modules.d目錄包含全部可用的Metricbeat模塊的默認配置。

若是你正在使用Docker鏡像，請參閱在Docker上運行Metricbeat。

下面的示例啓用了modules.d目錄中的apache和mysql配置：

deb和rpm：

metricbeat modules enable apache mysql

mac：

./metricbeat modules enable apache mysql

win：

PS > .\metricbeat.exe modules enable apache mysql

請參閱modules命令以瞭解關於此命令的更多信息。

要更改默認模塊配置，修改在modules.d目錄中的.yml文件，有關可用設置的更多信息，請參閱標準配置選項。

若是要將模塊配置添加到metricbeat.yml文件而不是使用modules.d目錄，請參閱指定要運行的模塊。

2.配置輸出，Metricbeat支持多種輸出，但一般狀況下，你能夠直接將事件發送到Elasticsearch，也能夠將事件發送到Logstash以進行其餘處理。

要將輸出直接發送到Elasticsearch（不使用Logstash），請設置Elasticsearch安裝的位置：

• 若是你正在Elastic Cloud上運行咱們託管的Elasticsearch服務，請指定你的雲ID，例如：

  cloud.id: "staging:dXMtZWFzdC0xLmF3cy5mb3VuZC5pbyRjZWM2ZjI2MWE3NGJmMjRjZTMzYmI4ODExYjg0Mjk0ZiRjNmMyY2E2ZDA0MjI0OWFmMGNjN2Q3YTllOTYyNTc0Mw=="

• 若是你在本身的硬件上運行Elasticsearch，請設置Metricbeat能夠找到Elasticsearch安裝的主機和端口，例如：

  output.elasticsearch:
    hosts: ["myEShost:9200"]

若要將輸出發送到Logstash輸出，配置Logstash輸出替代，對於全部其餘輸出，請參見配置輸出。

3.若是你計劃使用Metricbeat提供的示例Kibana儀表盤，請配置Kibana端點，若是Kibana與Elasticsearch在同一臺主機上運行，則能夠跳過此步驟。

setup.kibana:
  host: "mykibanahost:5601"

host => 運行Kibana的機器的主機名和端口，例如mykibanahost:5601，若是你在端口號以後指定了一個路徑，請包括方案和端口：http://mykibanahost:5601/path。

4.若是Elasticsearch和Kibana被保護，在運行設置和啓動Metricbeat的命令以前，在metricbeat.yml配置文件中設置憑證。

• 若是你正在Elastic Cloud上運行咱們託管的Elasticsearch服務，請指定你的Cloud auth憑據 ，例如：

  cloud.auth: "elastic:YOUR_PASSWORD"

• 若是你在本身的硬件上運行Elasticsearch，請指定Elasticsearch和Kibana憑證：

  output.elasticsearch:
    hosts: ["myEShost:9200"]
    username: "filebeat_internal"
    password: "YOUR_PASSWORD" 
  setup.kibana:
    host: "mykibanahost:5601"
    username: "my_kibana_user"  
    password: "YOUR_PASSWORD"

這個示例顯示了硬編碼的密碼，可是你應該將敏感值存儲在secret keystore中。

Kibana的用戶名和密碼設置是可選的，若是你沒有爲Kibana指定憑據，那麼Metricbeat使用爲Elasticsearch輸出指定的用戶名和密碼。

若是你計劃設置Kibana儀表盤，用戶必須具備kibana_user內置角色或同等權限。

有關更多信息，請參閱Securing Metricbeat。

在開始Metricbeat以前，你應該查看配置文件中的配置選項，有關這些選項的更多信息，請參閱配置Metricbeat。