添加 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 在来自消防栓的所有事件中都包含此元数据。在这些情况下,将使用事件中的元数据,并且 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,特别是表 4,“常见配置选项”表 5,“客户端配置选项”下的设置。