添加 Cloud Foundry 元数据

编辑

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

每个事件都用以下信息进行注释:

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

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

为了高效地进行注释,Cloud Foundry 客户端检索到的应用程序元数据会存储在path.data目录下的文件系统持久缓存中。这样可以确保元数据在 Heartbeat 重启后仍然存在。可以使用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 配置。