添加 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 目录下的文件系统持久性缓存中。这样做的目的是让元数据能够在心跳重启时保持持久性。要控制此缓存,请使用 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 网关的 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 配置。