采集器「华为云-云账单」配置手册

阅读本文前，请先阅读：

• 观测云集成 / 基本操作

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

为了保证数据的完整性，所采集的的账单日期为当前日期 - 2 天，建议本脚本每天运行一次

程序已内置防重复采集处理，同一天内反复运行时，除当天第一次运行，后续执行都会自动跳过

1. 配置结构

本采集器无需配置

2. 数据上报格式

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

上报的数据示例如下：

{
  "measurement": "cloud_bill",
  "tags": {
    "product_code": "ec2",
    "product_name": "弹性云服务器",
    "account_id"  : "1e1fed98168xxxxxxxxxxxxxe285140c83",
    "account_name": "1e1fed98168xxxxxxxxxxxxxe285140c83"
  },
  "fields": {
    "amount"        : 0.39,
    "offical_amount": 0.39190277
  },
  "timestamp": 1657065600
}

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

3. 统计说明

	上报字段	API 返回字段	API 字段含义	说明
产品代码	product_code	cloud_service_type	云服务类型编码	cloud_service_type截取所得 如："hws.service.type.vpc" —> "vpc"
产品名称	product_name	cloud_service_type_name	云服务类型名称
原价	official_amount	official_amount	官网价，华为云商品在官网上未叠加应用商务折扣、促销折扣等优惠的销售价格。	official_amount累加所得
实付金额	amount	amount	用户使用云服务享受折扣优惠后需要支付的费用金额，包括现金券和储值卡和代金券金额，精确到小数点后 2 位。	amount累加所得
时间戳	timestamp	bill_date	资源消费记录的日期。格式：YYYY-MM-DD。按照东八区时间截取。
消费的客户账号 ID	account_id	customer_id	消费的客户账号ID。如果是普通客户或者企业子查询消费记录，只能查询到自身的消费记录，则这个地方显示的是自身的客户ID如果是企业主查询消费记录，可以查询到自身以及企业子的消费记录，这个地方是消费的实际客户ID，如果是企业主自身消费，为企业主ID，如果这条消费记录是某个企业子客户的消费，这个地方的ID是企业子账号ID。	customer_id 就是帐号 ID；在“我的凭证”界面，API凭证页签中，查看帐号名、帐号ID、用户名、用户ID、项目名称、项目ID。具体参考附录文档地址
消费的客户账号名称	account_name	customer_id	参考消费的客户账号 ID

数据统计颗粒度为 云服务类型：cloud_service_type；相同类型的账单消费金额会合并计算，具体可以查看下面华为云 API 原始数据和脚本汇总后的数据对比

华为云 API 接口指 华为云-账单管理「查询资源消费记录」接口地址可见附录

华为云 API 接口原始数据

[
  {
    "bill_date"              : "2022-xx-xx",
    "bill_type"              : 5,
    "region"                 : "cn-north-4",
    "region_name"            : "华北-北京四",
    "cloud_service_type"     : "hws.service.type.vpc",
    "cloud_service_type_name": "虚拟私有云",
    "official_amount"        : 0.02,
    "amount"                 : 0.02,
    "customer_id"            : "1e1fed98168d4cxxxxxx0e285140c83",
    "{其他字段}"             : "{略}"
  },
  {
    "bill_date"              : "2022-xx-xx",
    "bill_type"              : 5,
    "region"                 : "cn-north-4",
    "region_name"            : "华北-北京四",
    "cloud_service_type"     : "hws.service.type.vpc",
    "cloud_service_type_name": "虚拟私有云",
    "official_amount"        : 0.02,
    "amount"                 : 0.02,
    "customer_id"            : "1e1fed98168d4cxxxxxx0e285140c83",
    "{其他字段}"             : "{略}"
  },
  {
    "bill_date"              : "2022-xx-xx",
    "bill_type"              : 5,
    "region"                 : "cn-north-4",
    "region_name"            : "华北-北京四",
    "cloud_service_type"     : "hws.service.type.rds",
    "cloud_service_type_name": "云数据库",
    "official_amount"        : 0.18728888,
    "amount"                 : 0.18,
    "customer_id"            : "1e1fed98168d4cxxxxxx0e285140c83",
    "{其他字段}"             : "{略}"
  }
]

### 脚本汇总后

[
  {
    "measurement": "cloud_bill",
    "tags": {
      "product_code": "rds",
      "product_name": "云数据库",
      "account_id"  : "1e1fed98168xxxxxxxxxxxxxe285140c83",
      "account_name": "1e1fed98168xxxxxxxxxxxxxe285140c83"
    },
    "fields": {
      "amount"        : 0.18,
      "offical_amount": 0.18728888
    },
    "timestamp": 1657507021
  },
  {
    "measurement": "cloud_bill",
    "tags": {
      "product_code": "vpc",
      "product_name": "虚拟私有云",
      "account_id"  : "1e1fed98168xxxxxxxxxxxxxe285140c83",
      "account_name": "1e1fed98168xxxxxxxxxxxxxe285140c83"
    },
    "fields": {
      "amount"        : 0.04,
      "offical_amount": 0.04
    },
    "timestamp": 1657507021
  }
]

X. 附录

华为云-账单管理「查询资源消费记录」

请参考华为云官方文档：

• 华为云账单管理-查询资源消费记录
• 华为云账号管理-账号 ID 查看