› › › ›

使用 Metricbeat 发送监控数据

使用 Metricbeat 发送监控数据编辑

在 7.3 及更高版本中，您可以使用 Metricbeat 收集有关 APM Server 的数据并将其发送到监控集群。与内部收集相比，使用 Metricbeat 的好处是，即使 APM Server 实例停止运行，监控代理也会保持活动状态。

要收集和发送监控数据

配置要监控的发送器编辑

启用 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://127.0.0.1:5066"]
  #username: "user"
  #password: "secret"
  xpack.enabled: true
```
根据您的环境设置 hosts、username 和 password 设置。对于其他模块设置，建议您接受默认值。

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

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

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

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

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

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

  # Optional protocol and basic auth credentials.
  #protocol: "https"
  #api_key:  "id:api_key" 
  #username: "elastic"
  #password: "changeme"
```
在此示例中，数据存储在具有节点 es-mon-1 和 es-mon-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 中查看监控数据.

« 选择指标 API »

	在此示例中，数据存储在具有节点 `es-mon-1` 和 `es-mon-2` 的监控集群上。
	指定 `api_key` 或 `username`/`password` 之一。