使用 Metricbeat 发送监控数据

在 7.3 及更高版本中，你可以使用 Metricbeat 收集有关 APM Server 的数据并将其发送到监控集群。使用 Metricbeat 而不是内部收集的好处是，即使 APM Server 实例挂掉，监控代理依然保持活跃。

要收集和发送监控数据

配置要监控的发送端
安装并配置 Metricbeat 以收集监控数据

配置要监控的发送端

启用 HTTP 端点以允许外部收集监控数据

在 APM Server 配置文件 (apm-server.yml) 中添加以下设置
```
http.enabled: true
		
```
默认情况下，指标在 5066 端口上公开。如果您需要监控运行在同一台服务器上的多个 Beats 发送端，请设置 http.port 以在不同的端口号上公开每个发送端的指标
```
http.port: 5067
		
```
禁用 APM Server 监控指标的默认收集。

在 APM Server 配置文件 (apm-server.yml) 中添加以下设置
```
monitoring.enabled: false
		
```
有关更多信息，请参阅监控配置选项。
配置主机（可选）。

如果你打算使用安装在另一台服务器上的 Metricbeat 获取指标，则需要将 APM Server 绑定到主机的 IP
```
http.host: xxx.xxx.xxx.xxx
		
```
配置集群 UUID（可选）。

如果你拥有一个集群，为了在 Kibana 中查看 Beats 监控部分，你需要将 APM Server 与集群 UUID 关联
```
monitoring.cluster_uuid: "cluster-uuid"
		
```
启动 APM Server。

安装并配置 Metricbeat 以收集监控数据

在与 APM Server 相同的服务器上安装 Metricbeat。要了解如何安装，请参阅 Metricbeat 入门。如果服务器上已经安装了 Metricbeat，请跳过此步骤。
在 Metricbeat 中启用 beat-xpack 模块。

例如，要启用 modules.d 目录中的默认配置，请使用适合您的操作系统的正确命令语法运行以下命令
```
metricbeat modules enable beat-xpack
		
```
有关更多信息，请参阅配置模块和 beat 模块。
在 Metricbeat 中配置 beat-xpack 模块。

modules.d/beat-xpack.yml 文件包含以下设置
```
- module: beat
  metricsets:
    - stats
    - state
  period: 10s
  hosts: ["https://:5066"]
  #username: "user"
  #password: "secret"
  xpack.enabled: true
		
```
根据您的环境要求设置 hosts、username 和 password 设置。对于其他模块设置，建议您接受默认值。

默认情况下，该模块从 localhost:5066 收集 APM Server 监控数据。如果你在启用 HTTP 端点时将指标暴露在不同的主机或端口上，请更新 hosts 设置。

要监控多个 APM Server 实例，请指定主机列表，例如
```
hosts: ["https://:5066","https://:5067","https://:5068"]
		
```
如果你将 APM Server 配置为使用加密通信，则必须通过 HTTPS 访问它。例如，使用类似 https://:5066 的 hosts 设置。

如果启用了 Elastic 安全功能，您还必须提供用户 ID 和密码，以便 Metricbeat 能够成功收集指标
1. 在 Elasticsearch 集群上创建一个拥有 remote_monitoring_collector 内置角色的用户。或者，如果在你的环境中可用，请使用 remote_monitoring_user 内置用户。
2. 将 username 和 password 设置添加到 beat 模块配置文件中。
可选：禁用 Metricbeat 中的 system 模块。

默认情况下，系统模块处于启用状态。但是，它收集的信息不会显示在 Kibana 的 Stack Monitoring 页面上。除非您想将该信息用于其他目的，否则请运行以下命令
```
metricbeat modules disable system
		
```
确定将监控数据发送到何处。

提示

在生产环境中，我们强烈建议使用单独的集群（称为监控集群）来存储数据。使用单独的监控集群可防止生产集群中断影响您访问监控数据的能力。它还可以防止监控活动影响生产集群的性能。

例如，在 Metricbeat 配置文件 (metricbeat.yml) 中指定 Elasticsearch 输出信息
```
output.elasticsearch:
  # Array of hosts to connect to.
  hosts: ["<ES_MONITORING_HOST1_URL>:9200", "http://es-mon2:9200"]

  # Optional protocol and basic auth credentials.
  #protocol: "https"
  #api_key:  "id:api_key"
  #username: "elastic"
  #password: "changeme"
		
```
1. 在此示例中，数据存储在带有节点 es-mon-1 和 es-mon-2 的监控集群上。
2. 指定 api_key 或 username/password 之一。
如果您将监控集群配置为使用加密通信，则必须通过 HTTPS 访问它。例如，使用类似 https://es-mon-1:9200 的 hosts 设置。

重要提示

Elasticsearch 监控功能使用摄取管道，因此存储监控数据的集群必须至少有一个摄取节点。

如果在监控集群上启用了 Elasticsearch 安全功能，您必须提供有效的用户 ID 和密码，以便 Metricbeat 能够成功发送指标
1. 在监控集群上创建一个拥有 remote_monitoring_agent 内置角色的用户。或者，如果在你的环境中可用，请使用 remote_monitoring_user 内置用户。
  
  提示
  
  如果你正在使用索引生命周期管理，则远程监控用户需要额外的权限来创建和读取索引。有关更多信息，请参阅使用功能角色。
2. 将 username 和 password 设置添加到 Metricbeat 配置文件中的 Elasticsearch 输出信息中。
有关这些配置选项的更多信息，请参见配置 Elasticsearch 输出。
启动 Metricbeat 以开始收集监控数据。
在 Kibana 中查看监控数据.