采集器「腾讯云-账单（实例维度）」配置手册

阅读本文前，请先阅读：

• 观测云集成 / 基本操作

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

为了保证数据的完整性，所采集的的账单日期为当前日期的前一天

目前支持的腾讯云采集器有 cdb、clb、cos、cvm、mongodb、redis

1. 配置结构

本采集器无需配置

2. 数据上报格式

数据正常同步后，可以在观测云的「云账单查看器」中查看数据。

上报的数据示例如下：

{
  "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）接口返回数据

[
  {
    "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",
        "{其他字段}"      : "{略}"
      }
    ]
  }
]

脚本汇总后

[
  {
    "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 中。具体效果如下：

假设原始账单计算后的数据如下：

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

自定义对象采集器采集到的数据如下：

  {
    "measurement": "tencentcloud_mongodb",
    "tags": {
      "RegionId"   : "cn-nanjing",
      "instance_id": "cmgo-xxxxx",
      "{其他字段}"  : "{略}"

    },
    "fields": {
      "{其他字段}": "{略}"
    }
  }

那么，最终上报的账单数据如下：

  {
    "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. 附录

腾讯云-账单管理 「查询账单明细数据」

请参考腾讯云官方文档：

• TencentCloud-billing 查询账单明细数据接口文档