使用内部集合发送监控数据
编辑

使用内部收集器直接将 Beats 监控数据发送到您的监控集群。或者,作为内部收集的替代方案,可以使用使用 Metricbeat 收集。使用内部收集而不是 Metricbeat 的好处是,您需要安装和维护的软件更少。

  1. 创建一个 API 密钥或用户,该密钥或用户具有向 Elasticsearch 发送系统级监控数据的适当权限。例如,您可以使用内置的 apm_system 用户或将内置的 apm_system 角色分配给另一个用户。有关所需权限的更多信息,请参阅创建监控角色。有关如何使用 API 密钥的更多信息,请参阅使用 API 密钥授予访问权限
  2. 在 APM Server 配置文件中添加 monitoring 设置。如果您配置了 Elasticsearch 输出并希望将 APM Server 监控事件发送到同一个 Elasticsearch 集群,请指定以下最小配置

    monitoring:
      enabled: true
      elasticsearch:
        api_key:  id:api_key 
        username: apm_system
        password: somepassword

    指定 api_keyusername/password 中的一个。

    如果您想将监控事件发送到 Elastic Cloud 监控集群,您可以使用两个更简单的设置。定义后,这些设置将覆盖配置中其他部分的设置。例如

    monitoring:
      enabled: true
      cloud.id: 'staging:dXMtZWFzdC0xLmF3cy5mb3VuZC5pbyRjZWM2ZjI2MWE3NGJmMjRjZTMzYmI4ODExYjg0Mjk0ZiRjNmMyY2E2ZDA0MjI0OWFmMGNjN2Q3YTllOTYyNTc0Mw=='
      cloud.auth: 'elastic:{pwd}'

    如果您配置了不同的输出(例如 Logstash),或者您想将 APM Server 监控事件发送到单独的 Elasticsearch 集群(称为监控集群),则必须指定其他配置选项。例如

    monitoring:
      enabled: true
      cluster_uuid: PRODUCTION_ES_CLUSTER_UUID 
      elasticsearch:
        hosts: ["https://example.com:9200", "https://example2.com:9200"] 
        api_key:  id:api_key 
        username: apm_system
        password: somepassword

    此设置标识此 APM Server 实例的监控数据在 Stack Monitoring UI 中将出现的 Elasticsearch 集群。要获取集群的 cluster_uuid,请针对该集群调用 GET / API。

    此设置标识作为监控集群一部分的 Elasticsearch 节点的主机和端口号。

    指定 api_keyusername/password 中的一个。

    如果您想使用 PKI 身份验证将监控事件发送到 Elasticsearch,则必须指定一组不同的配置选项。例如

    monitoring:
      enabled: true
      cluster_uuid: PRODUCTION_ES_CLUSTER_UUID
      elasticsearch:
        hosts: ["https://example.com:9200", "https://example2.com:9200"]
        username: ""
        ssl.certificate_authorities: ["/etc/pki/root/ca.pem"]
        ssl.certificate: "/etc/pki/client/cert.pem"
        ssl.key: "/etc/pki/client/cert.key"

    您必须显式指定 username"",以便使用客户端证书中的用户名 (CN)。有关 SSL 设置的更多信息,请参阅SSL/TLS 输出设置

  3. 启动 APM Server。
  4. 在 Kibana 中查看监控数据.
内部集合的设置编辑

当您不使用 Metricbeat 收集监控数据时,请使用以下设置配置内部集合。

您在 apm-server.yml 配置文件的 X-Pack 监控部分中指定这些设置

monitoring.enabled编辑

monitoring.enabled 配置是一个布尔设置,用于启用或禁用 X-Pack 监控。如果设置为 true,则启用监控。

默认值为 false

monitoring.elasticsearch编辑

您要将 APM Server 指标发送到的 Elasticsearch 实例。此配置选项包含以下字段

api_key编辑

用于将监控信息发送到 Elasticsearch 的 API 密钥的详细信息。有关更多信息,请参阅使用 API 密钥授予访问权限

bulk_max_size编辑

单个 Elasticsearch 批量 API 索引请求中要批量处理的最大指标数。默认值为 50。有关更多信息,请参阅Elasticsearch

backoff.init编辑

在网络错误后尝试重新连接到 Elasticsearch 之前等待的秒数。等待 backoff.init 秒后,APM Server 会尝试重新连接。如果尝试失败,则退避计时器会呈指数级增加,直到 backoff.max。成功连接后,退避计时器会重置。默认值为 1s

backoff.max编辑

在网络错误后尝试连接到 Elasticsearch 之前等待的最大秒数。默认值为 60s

compression_level编辑

gzip 压缩级别。将此值设置为 0 将禁用压缩。压缩级别必须在 1(最佳速度)到 9(最佳压缩)的范围内。默认值为 0。提高压缩级别会减少网络使用量,但会增加 CPU 使用量。

headers编辑

要添加到每个请求的自定义 HTTP 标头。有关更多信息,请参阅Elasticsearch

hosts编辑

要连接的 Elasticsearch 节点列表。监控指标会以循环方式分发到这些节点。有关更多信息,请参阅Elasticsearch

max_retries编辑

在失败后重试发送监控指标的次数。在达到指定的重试次数后,通常会丢弃指标。默认值为 3。有关更多信息,请参阅Elasticsearch

parameters编辑

要在 URL 中使用索引操作传递的 HTTP 参数字典。

password编辑

APM Server 用于通过 Elasticsearch 实例进行身份验证以发送监控数据的密码。

metrics.period编辑

将指标发送到 Elasticsearch 集群的时间间隔(以秒为单位)。每个周期都会生成并计划发布 APM Server 指标的新快照。默认值为 10 * time.Second。

state.period编辑

将状态信息发送到 Elasticsearch 集群的时间间隔(以秒为单位)。每个周期都会生成并计划发布 APM Server 状态的新快照。默认值为 60 * time.Second。

protocol编辑

连接到 Elasticsearch 集群时要使用的协议名称。选项为:httphttps。默认值为 http。但是,如果您为 hosts 指定 URL,则 protocol 的值会被您在 URL 中指定的方案覆盖。

proxy_url编辑

连接到 Elasticsearch 集群时要使用的代理的 URL。有关更多信息,请参阅Elasticsearch

timeout编辑

Elasticsearch 请求的 HTTP 请求超时时间(以秒为单位)。默认值为 90

传输层安全性 (TLS) 或安全套接字层 (SSL) 参数的配置选项,例如用于基于 HTTPS 的连接的证书颁发机构 (CA)。如果缺少 ssl 部分,则主机 CA 将用于与 Elasticsearch 的 HTTPS 连接。有关更多信息,请参阅SSL/TLS 输出设置

username编辑

APM Server 用于通过 Elasticsearch 实例进行身份验证以发送监控数据的用户 ID。