添加 Cloud Foundry 元数据

编辑

add_cloudfoundry_metadata 处理器会使用 Cloud Foundry 应用程序的相关元数据来注释每个事件。只有当事件包含对 Cloud Foundry 应用程序的引用(使用字段 cloudfoundry.app.id)并且配置的 Cloud Foundry 客户端能够检索应用程序信息时,才会使用 Cloud Foundry 元数据注释事件。

每个事件都将添加以下注释:

  • 应用程序名称
  • 空间 ID
  • 空间名称
  • 组织 ID
  • 组织名称

Pivotal Application Service 和 Tanzu Application Service 从 2.8 版本开始就在 firehose 的所有事件中包含此元数据。 在这些情况下,将使用事件中的元数据,并且 add_cloudfoundry_metadata 处理器不会修改这些字段。

为了高效地添加注释,Cloud Foundry 客户端检索到的应用程序元数据将存储在 path.data 目录下的文件系统持久缓存中。 这样做的目的是使元数据能够在 Metricbeat 重启后仍然存在。 要控制此缓存,请使用 cache_durationcache_retry_delay 设置。

processors:
  - add_cloudfoundry_metadata:
      api_address: https://api.dev.cfdev.sh
      client_id: uaa-filebeat
      client_secret: verysecret
      ssl:
        verification_mode: none
      # To connect to Cloud Foundry over verified TLS you can specify a client and CA certificate.
      #ssl:
      #  certificate_authorities: ["/etc/pki/cf/ca.pem"]
      #  certificate:              "/etc/pki/cf/cert.pem"
      #  key:                      "/etc/pki/cf/cert.key"

它具有以下设置:

api_address
(可选) Cloud Foundry API 的 URL。默认情况下使用 http://api.bosh-lite.com
doppler_address
(可选) Cloud Foundry Doppler Websocket 的 URL。默认情况下使用 ${api_address}/v2/info 中的值。
uaa_address
(可选) Cloud Foundry UAA API 的 URL。默认情况下使用 ${api_address}/v2/info 中的值。
rlp_address
(可选) Cloud Foundry RLP Gateway 的 URL。默认情况下使用 ${api_address}/v2/info 中的值。
client_id
用于向 Cloud Foundry 进行身份验证的客户端 ID。
client_secret
用于向 Cloud Foundry 进行身份验证的客户端密钥。
cache_duration
(可选) 缓存应用程序元数据的最大时间。默认为 120 秒。
cache_retry_delay
(可选) 在发生错误的情况下,再次获取应用程序元数据之前等待的时间。默认为 20 秒。
ssl
(可选) 连接到 Cloud Foundry 时使用的 SSL 配置。