添加 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 网关的 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 配置。