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。