添加云元数据

编辑

收集日志和指标的输入默认使用此处理器,因此您无需显式配置它。

add_cloud_metadata 处理器会使用机器托管提供商的实例元数据来丰富每个事件。在启动时,处理器会查询托管提供商列表并缓存实例元数据。

支持以下提供商

  • Amazon Web Services (AWS)
  • Digital Ocean
  • Google Compute Engine (GCE)
  • 腾讯云 (QCloud)
  • 阿里云 (ECS)
  • 华为云 (ECS)
  • Azure 虚拟机
  • Openstack Nova

阿里云和腾讯云提供商默认情况下处于禁用状态,因为它们需要访问远程主机。使用 providers 设置选择要查询的默认提供商列表。

示例

编辑

此配置启用处理器

  - add_cloud_metadata: ~

添加到事件的元数据因托管提供商而异。有关示例,请参阅 特定于提供商的元数据示例

配置设置

编辑

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

名称 必需 默认值 描述

超时

3s

检测托管提供商时等待成功响应的最长时间。如果发生超时,则不会将任何实例元数据添加到事件中。这使得可以为所有部署(在云中或本地)启用此处理器成为可能。

提供商

要使用的提供商名称列表。如果未配置 providers,则默认情况下会启用所有不访问远程端点的提供商。也可以通过环境变量 BEATS_ADD_CLOUD_METADATA_PROVIDERS 配置提供商列表,方法是将其设置为提供商名称的逗号分隔列表。

支持的提供商名称列表包括

  • alibabaecs 用于阿里云提供商(默认情况下禁用)。
  • azure 用于 Azure 虚拟机(默认情况下启用)。
  • digitalocean 用于 Digital Ocean(默认情况下启用)。
  • awsec2 用于 Amazon Web Services(默认情况下启用)。
  • gcp 用于 Google Compute Engine(默认情况下启用)。
  • openstacknova 用于 Openstack Nova(默认情况下启用)。
  • openstack-sslnova-ssl 用于启用 SSL 元数据 API 时的 Openstack Nova(默认情况下启用)。
  • tencentqcloud 用于腾讯云(默认情况下禁用)。
  • huawei 用于华为云(默认情况下启用)。

覆盖

false

是否覆盖现有的云字段。如果为 true,则处理器会覆盖现有的 cloud.* 字段。

add_cloud_metadata 处理器支持 SSL 选项来配置用于查询云元数据的 http 客户端。

有关更多信息,请参阅 SSL/TLS,特别是 表 7,“通用配置选项”表 8,“客户端配置选项” 下的设置。

特定于提供商的元数据示例

编辑

以下部分显示了每个支持的提供商的示例。

{
  "cloud": {
    "account.id": "123456789012",
    "availability_zone": "us-east-1c",
    "instance.id": "i-4e123456",
    "machine.type": "t2.medium",
    "image.id": "ami-abcd1234",
    "provider": "aws",
    "region": "us-east-1"
  }
}
Digital Ocean
编辑
{
  "cloud": {
    "instance.id": "1234567",
    "provider": "digitalocean",
    "region": "nyc2"
  }
}
{
  "cloud": {
    "availability_zone": "us-east1-b",
    "instance.id": "1234556778987654321",
    "machine.type": "f1-micro",
    "project.id": "my-dev",
    "provider": "gcp"
  }
}
腾讯云
编辑
{
  "cloud": {
    "availability_zone": "gz-azone2",
    "instance.id": "ins-qcloudv5",
    "provider": "qcloud",
    "region": "china-south-gz"
  }
}
华为云
编辑
{
  "cloud": {
    "availability_zone": "cn-east-2b",
    "instance.id": "37da9890-8289-4c58-ba34-a8271c4a8216",
    "provider": "huawei",
    "region": "cn-east-2"
  }
}
阿里云
编辑

此元数据仅在选择 VPC 作为 ECS 实例的网络类型时可用。

{
  "cloud": {
    "availability_zone": "cn-shenzhen",
    "instance.id": "i-wz9g2hqiikg0aliyun2b",
    "provider": "ecs",
    "region": "cn-shenzhen-a"
  }
}
Azure 虚拟机
编辑
{
  "cloud": {
    "provider": "azure",
    "instance.id": "04ab04c3-63de-4709-a9f9-9ab8c0411d5e",
    "instance.name": "test-az-vm",
    "machine.type": "Standard_D3_v2",
    "region": "eastus2"
  }
}
Openstack Nova
编辑
{
  "cloud": {
    "instance.name": "test-998d932195.mycloud.tld",
    "instance.id": "i-00011a84",
    "availability_zone": "xxxx-az-c",
    "provider": "openstack",
    "machine.type": "m2.large"
  }
}