跳转至

采集器「腾讯云-CLB」配置手册

阅读本文前,请先阅读:

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

1. 配置结构

本采集器配置结构如下:

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

2. 配置示例

指定地域

采集上海、广州地域的数据

Python
1
2
3
collector_configs = {
    'regions': [ 'ap-shanghai', 'ap-guangzhou' ]
}

配置过滤器(可选项)

本采集器脚本支持用户自定义过滤器,让用户通过对象属性筛选出目标资源。过滤器函数返回值为 True|False - True:目标资源需要被采集。 - False 目标资源不需要被采集

支持筛选的对象属性:

属性 描述
LoadBalancerId 负载均衡实例 ID
LoadBalancerName 负载均衡实例名称
LoadBalancerType 负载均衡实例的网络类型
Address 负载均衡实例的 VIP
Status 负载均衡实例的状态
VpcId 负载均衡实例所属私有网络的 ID
Zone 负载均衡实例所在可用区
ChargeType 负载均衡实例的计费类型
Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
# 示例:开启过滤器,根据对象的 LoadBalancerId 和 VpcId 属性过滤,配置格式如下:

def filter_load_balance(loadBalance):
    '''
    return True|False
    '''
    # return True
    load_balance_id = loadBalance['LoadBalancerId']
    vpc_id = loadBalance['VpcId']
    if load_balance_id in ['xxx'] and vpc_id in ['yyy']:
        return True
    return False

###### Do not modify the following contents #####
from guance_integration__runner import Runner
import guance_tencentcloud_clb__main as main

def run():
    Runner(main.DataCollector(account, collector_configs, filters=[filter_load_balance])).run()

3. 数据上报格式

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

上报的数据示例如下:

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
{
  "measurement": "tencentcloud_clb",
  "tags": {
    "name"            : "lb-xxxx",
    "RegionId"        : "ap-shanghai",
    "LoadBalancerId"  : "lb-xxxx",
    "LoadBalancerName": "lb-xxxx",
    "Address"         : "81.xxxx",
    "LoadBalancerType": "Public",
    "Status"          : "1",
    "VpcId"           : "vpc-xxxx",
    "Zone"            : "ap-shanghai-3",
    "ChargeType"      : "POSTPAID_BY_HOUR"
  },
  "fields": {
    "CreateTime": "2022-04-27 15:19:49",
    "listeners" : "{监听器 JSON 数据}",
    "message"   : "{实例 JSON 数据}"
  }
}

部分参数说明如下

tags.LoadBalancerType(负载均衡实例的网络类型)取值含义

取值 说明
Public 公网属性
Private 内网属性

tags.Status(负载均衡实例的状态)取值含义

取值 说明
0 创建中
1 正常运行

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

tags.name 值为实例 ID,作为唯一标识

fields.message 为 JSON 序列化后字符串

X. 附录

请参考腾讯云官方文档: