采集器「腾讯云-账单(实例维度)」配置手册
阅读本文前,请先阅读:
使用本采集器前,必须安装「观测云集成 Core 核心包」及其配套的第三方依赖包
为了保证数据的完整性,所采集的的账单日期为当前日期的前一天
目前支持的腾讯云采集器有 cdb、clb、cos、cvm、mongodb、redis
1. 配置结构
本采集器无需配置
2. 数据上报格式
数据正常同步后,可以在观测云的「云账单查看器」中查看数据。
上报的数据示例如下:
JSON |
---|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20 | {
"measurement": "cloud_billing",
"tags": {
"billing_id" : "anvxfafakjflxxxxxxx",
"account_id" : "100025xxxxxx113474",
"account_name": "100025xxxxxx113474",
"product_code": "mongodb",
"product_name": "云数据库TencentDB for MongoDB",
"region_id" : "cn-shenzhen-1",
"instance_id" : "cmgo-xxxxxx",
"cloud_provider" : "tencentcloud",
"billing_date" : "2022-09-12",
"name" : "cmgo-xxxxxx"
},
"fields": {
"amount" : 13.25492784,
"offical_amount": 13.25492784
},
"timestamp": 1662940800
}
|
tags、fields 中的字段可能会随后续更新有所变动
3. 字段说明
|
上报字段 |
API 返回字段 |
说明 |
账单 ID |
billing_id |
|
账单唯一 ID |
产品代码 |
product_code |
BusinessCode |
BusinessCode 截取所得 如:"p_mongodb" -> "mongodb" |
产品名称 |
product_name |
BusinessCodeName |
|
原价 |
offical_amount |
ComponentSet.Cost |
|
地域 |
region_id |
Region |
地域 |
实付金额 |
amount |
CashPayAmount + VoucherPayAmount |
现金支付 + 代金劵支付 |
账单日期 |
billing_date |
|
查询日期(采用 YYYY-MM-DD 格式,手动添加) |
实例 ID |
instance_id |
ResourceId |
|
消费的客户账号 ID |
account_id |
PayerUin |
进入腾讯云,找到右上角的头像-访问管理-用户-用户列表,就可以看到账号名称,账号 ID 等信息 |
消费的客户账号名称 |
account_name |
接口 ListUsers.Name 字段,或者 PayerUin 字段 |
ListUsers 接口返回所有子用户信息,通过账单接口返回的 PayerUin 字段与 ListUsers 接口返回的 Uin 字段匹配对应的 Name 字段,如果匹配不到,默认使用 PayerUin |
数据统计颗粒度为 实例 ID :InstanceID
实例 ID 相同的消费金额会合并计算,一个产品可能对应多个组件 (ComponentSet),所以需要把组件全部累加在一起在进行赋值,具体可以查看下面腾讯云 API 原始数据和脚本汇总后的数据对比
腾讯云查询账单明细数据(DescribeBillDetail)接口返回数据
JSON |
---|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38 | [
{
"BusinessCodeName": "云数据库 TencentDB for MongoDB",
"BusinessCode" : "p_mongodb",
"ComponentSet": [
{
"Cost" : "0.20000000",
"VoucherPayAmount": "0",
"CashPayAmount" : "0.20000000",
"{其他字段}" : "{略}"
},
{
"Cost" : "0.10000000",
"VoucherPayAmount": "0",
"CashPayAmount" : "0.10000000",
"{其他字段}" : "{略}"
}
]
},
{
"BusinessCodeName": "云数据库TencentDB for MongoDB",
"BusinessCode" : "p_mongodb",
"ComponentSet": [
{
"Cost" : "0.10000000",
"VoucherPayAmount": "0",
"CashPayAmount" : "0.10000000",
"{其他字段}" : "{略}"
},
{
"Cost" : "0.30000000",
"VoucherPayAmount": "0",
"CashPayAmount" : "0.30000000",
"{其他字段}" : "{略}"
}
]
}
]
|
脚本汇总后
JSON |
---|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18 | [
{
"measurement": "cloud_billing",
"tags": {
"billing_id" : "anvxfafakjflxxxxxxx",
"account_id" : "100025xxxxxx113474",
"account_name": "100025xxxxxx113474",
"billing_date": "2022-09-12",
"product_code": "mongodb",
"product_name": "云数据库 TencentDB for MongoDB"
},
"fields": {
"amount" : 0.7,
"offical_amount": 0.7
},
"timestamp": 1657507837
}
]
|
4. 与自定义对象采集器联动
当同一个 DataFlux Func 中运行了其他自定义对象采集器(如: CVM )时,本采集器会根据 数据采集说明的维度信息补充字段。例如 CVM
根据账单返回的 ResourceId
字段尝试匹配自定义对象中的 name
字段。
当成功匹配后,会将所匹配的自定义对象 tags
中除 name
意外的字段加入到账单数据的 tags
中。具体效果如下:
假设原始账单计算后的数据如下:
JSON |
---|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16 | {
"measurement": "cloud_billing",
"tags": {
"billing_id" : "anvxfafakjflxxxxxxx",
"instance_id" : "cmgo-xxxx",
"product_code": "mongodb",
"product_name": "云数据库TencentDB for MongoDB",
"account_id" : "100025xxxxxx113474",
"account_name": "100025xxxxxx113474"
},
"fields": {
"amount" : 13.25492784,
"offical_amount": 13.25492784
},
"timestamp": 1662940800
}
|
自定义对象采集器采集到的数据如下:
JSON |
---|
1
2
3
4
5
6
7
8
9
10
11
12 | {
"measurement": "tencentcloud_mongodb",
"tags": {
"RegionId" : "cn-nanjing",
"instance_id": "cmgo-xxxxx",
"{其他字段}" : "{略}"
},
"fields": {
"{其他字段}": "{略}"
}
}
|
那么,最终上报的账单数据如下:
JSON |
---|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21 | {
"measurement": "cloud_billing",
"tags": {
"billing_id" : "anvxfafakjflxxxxxxx",
"instance_id" : "cmgo-x",
"region_id" : "cn-nanjing",
"product_code": "mongodb",
"product_name": "云数据库TencentDB for MongoDB",
"account_id" : "100025xxxxxx113474",
"account_name": "100025xxxxxx113474",
"cloud_provider" : "tencentcloud",
"{其他字段}" : "{略}"
},
"fields": {
"amount" : 13.25492784,
"offical_amount": 13.25492784,
"{其他字段}" : "{略}"
},
"timestamp": 1662940800
}
|
X. 附录
腾讯云-账单管理 「查询账单明细数据」
请参考腾讯云官方文档: