正在加载

添加云元数据

提示

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

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 处理器在 ingest 管道之前执行，这意味着它们处理原始事件数据而不是发送到 Elasticsearch 的最终事件。有关相关限制，请参阅使用处理器有哪些限制？

名称 必需 默认值 描述
timeout 否 3 秒 检测托管提供商时等待成功响应的最大时间量。如果发生超时，不会向事件添加实例元数据。这使得您可以在所有部署（在云中或本地）中启用此处理器。
providers 否 要使用的提供商名称列表。如果未配置 providers，则默认启用所有不访问远程端点的提供商。提供商列表也可以通过环境变量 BEATS_ADD_CLOUD_METADATA_PROVIDERS 配置，将其设置为逗号分隔的提供商名称列表。

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

* 阿里云提供商使用 alibaba 或 ecs（默认禁用）。
* Azure 虚拟机使用 azure（默认启用）。
* Digital Ocean 使用 digitalocean（默认启用）。
* Amazon Web Services 使用 aws 或 ec2（默认启用）。
* Google Compute Engine 使用 gcp（默认启用）。
* Openstack Nova 使用 openstack 或 nova（默认启用）。
* 当启用 SSL 元数据 API 时，Openstack Nova 使用 openstack-ssl 或 nova-ssl（默认启用）。
* 腾讯云使用 tencent 或 qcloud（默认禁用）。
* 华为云使用 huawei（默认启用）。
overwrite 否 false 是否覆盖现有的云字段。如果为 true，处理器将覆盖现有的 cloud.* 字段。

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

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

以下各节展示了每个受支持提供商的示例。

AWS

{
  "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"
  }
}

GCP

{
  "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"
  }
}

阿里云

只有当 ECS 实例的网络类型选择为 VPC 时，此元数据才可用。

{
  "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"
  }
}
© . All rights reserved.