添加 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 客户端检索的应用程序元数据存储在文件系统上的持久缓存中。这样做是为了使元数据可以在 Elastic Agent 及其底层程序重启后仍然存在。要控制此缓存,请使用 cache_durationcache_retry_delay 设置。

示例

编辑
  - 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"

配置设置

编辑

Elastic Agent 处理器在摄取管道之前执行,这意味着它们处理的是原始事件数据,而不是发送到 Elasticsearch 的最终事件。有关相关限制,请参阅使用处理器有哪些限制?

名称 必需 默认值 描述

api_address

http://api.bosh-lite.com

Cloud Foundry API 的 URL。

doppler_address

${api_address}/v2/info

Cloud Foundry Doppler Websocket 的 URL。

uaa_address

${api_address}/v2/info

Cloud Foundry UAA API 的 URL。

rlp_address

${api_address}/v2/info

Cloud Foundry RLP 网关的 URL。

client_id

用于使用 Cloud Foundry 进行身份验证的客户端 ID。

client_secret

用于使用 Cloud Foundry 进行身份验证的客户端密钥。

cache_duration

120 秒

缓存应用程序元数据的最大时间。

cache_retry_delay

20 秒

如果发生错误,在尝试再次获取应用程序元数据之前等待的时间。

ssl

连接到 Cloud Foundry 时要使用的 SSL 配置。有关可用设置的列表,请参阅SSL/TLS,特别是表 7,“常用配置选项”表 8,“客户端配置选项”下的设置。