跳转至

采集器「AWS-ELB」配置手册

阅读本文前，请先阅读：

使用本采集器前，必须安装「观测云集成 Core 核心包」及其配套的第三方依赖包

1. 配置结构

本采集器配置结构如下：

字段 类型 是否必须 说明
regions list 必须 所需采集的地域列表
regions[#] str 必须 地域 ID。如：'cn-north-1'
总表见附录

2. 配置示例

采集宁夏、北京地域的实例数据

Python
1
2
3
collector_configs = {
    'regions': [ 'cn-northwest-1', 'cn-north-1' ]
}

3. 数据上报格式

数据正常同步后，可以在观测云的「基础设施 / 自定义（对象）」中查看数据。

上报的数据示例如下：

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "measurement": "aws_aelb",
  "tags": {
    "name"                 : "app/openway/8e8d762xxxxxx",
    "RegionId"             : "cn-northwest-1",
    "LoadBalancerArn"      : "arn:aws-cn:elasticloadbalancing:cn-northwest-1:588271xxxxx:loadbalancer/app/openway/8e8d762xxxxxx",
    "State"                : "active",
    "Type"                 : "application",
    "VpcId"                : "vpc-2exxxxx",
    "Scheme"               : "internet-facing",
    "DNSName"              : "openway-203509xxxx.cn-northwest-1.elb.amazonaws.com.cn",
    "LoadBalancerName"     : "openway",
    "CanonicalHostedZoneId": "ZM7IZAIxxxxxx"
  },
  "fields": {
    "CreatedTime"         : "2022-03-09T06:13:31Z",
    "ListenerDescriptions": "{JSON 数据}",
    "AvailabilityZones"   : "{可用区 JSON 数据}",
    "message"             : "{实例 JSON 数据}"
  }
}

tags、fields 中的字段可能会随后续更新有所变动

AWS ELB 指标集根据不同类型的负载均衡分四种

  1. Application ELB 对应指标集 aws_aelb
  2. Network ELB 对应指标集 aws_nelb
  3. Gateway ELB 对应指标集 aws_gelb
  4. Classic ELB 对应指标集 aws_elb

tags.name 取值方式分两种

  1. Classic Load Balancers 取 LoadBalancerName 字段。
  2. Application、Network、Gateway 三类 Load Balancers 截取负载均衡器 ARN 的结尾部分（LoadBalancerArn）。

以 Network Load Balancer 为例：

LoadBalancerArn为arn:awS-cn:elasticloadbalancing:cn-northwest-1:xxxx1335135:loadbalancer/net/k8s-forethou-kodongin-xxxxa46f01/xxxxe75ae81d08c2

对应的tags.name为net/k8s-forethou-kodongin-xxxxa46f01/xxxxe75ae81d08c2

Tip

  • fields.message、tags.AvailabilityZones 为 JSON 序列化后字符
  • tags.state字段表示 Load Balancers 状态，取值：active、provisioning、active_impaired、failed （"classic" 类型负载均衡实例没有该字段）
  • tags.Type字段表示 Load Balancers 类型，取值：application、network、gateway、classic
  • tags.Scheme字段表示 Load Balancers 模式，取值：internet-facing、internal
  • fields.ListenerDescriptions字段为该负载均衡的监听器列表
  • fields.AvailabilityZones 字段表示负载均衡器关联的 Amazon Route 53 可用区信息

4. IAM 策略权限

如果用户使用代入 IAM 角色的方式采集资源，需要开启一定的权限

该采集器需要如下操作权限：

elasticloadbalancing:DescribeLoadBalancers

elasticloadbalancing:DescribeListeners

X. 附录

请参考 AWS 官方文档：