添加云元数据编辑

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

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 的最终事件。有关相关限制,请参阅 使用处理器的限制是什么?

名称 必需 默认 描述

超时

3 秒

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

提供程序

要使用的提供程序名称列表。如果未配置 providers,则默认情况下启用所有不访问远程端点的提供程序。

支持的提供程序名称列表包括

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

覆盖

false

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

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

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

特定于提供程序的元数据示例编辑

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

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"
  }
}
阿里云编辑

仅当选择 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"
  }
}