跳转至

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

阅读本文前，请先阅读：

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

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

1. 配置结构

本采集器无需配置

2. 数据上报格式

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

上报的数据示例如下：

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "measurement": "cloud_billing_by_instance",
  "tags": {
    "billing_account_name"  : "xxxxxx",
    "billing_account_id"    : "xxxxxx",
    "billing_product_code"  : "ecs",
    "billing_product_name"  : "云服务器 ECS",
    "name"                  : "i-xxxxxxxx",
    "billing_date"          : "20220909",
    "billing_timestamp"     : "1657507021",
    "cloud_provider"        : "aliyun",
    "AliyunCostUnit"        : "未分配",
    "AliyunRegion"          : "杭州",
    "AliyunZone"            : "cn-hangzhou-h",
    "AliyunBillingType"     : "其它",
    "AliyunSubscriptionType": "PayAsYouGo"
  },
  "fields": {
    "billing_amount"        : 9419.23,
    "billing_offical_amount": 18843.258604
  },
  "timestamp": 1657507021
}

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

3. 字段说明

上报字段 API 返回字段 API 字段含义
产品代码 billing_product_code ProductCode 产品代码
产品名称 billing_product_name ProductName 产品名称
原价 billing_official_amount PretaxGrossAmount 官网价
实付金额 billing_amount PretaxAmount 用户支付价格
实例ID name InstanceID 实例ID
账期 billing_date 资源消费记录的日期。格式：YYYYMMDD
账期 billing_timestamp 资源消费记录的日期(时间戳)
财务单元 AliyunCostUnit AliyunCostUnit 财务单元
地域 AliyunRegion AliyunRegion 地域
可用区 AliyunZone AliyunZone 可用区
计费模式 AliyunBillingType AliyunBillingType 计费模式
订阅类型 AliyunSubscriptionType AliyunSubscriptionType 订阅类型
账号名称 billing_account_name BillAccountName 账号名称
账号 ID billing_account_id BillAccountID 账号 ID

4. 与自定义对象采集器联动

当同一个 DataFlux Func 中运行了其他自定义对象采集器（如 ECS、RDS）时，本采集器会自动根据 InstanceID 字段尝试匹配自定义对象中的 tags.name 字段。当成功匹配后，会将所匹配的自定义对象 tags 中除 name 以外的字段加入到账单数据的 tags 中。

假设账单采集到的原始数据如下：

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
{
  "measurement": "cloud_billing_by_instance",
  "tags": {
    "billing_product_code": "ecs",
    "billing_product_name": "云服务器 ECS",
    "name"                : "i-xxxxxxxx",
    "billing_date"        : "20220909",
    "billing_timestamp"   : "1657507021",
    "cloud_provider"      : "aliyun",
    "billing_account_id"  : "xxxxx",
    "billing_account_name": "xxxxx"
  },
  "fields": {
    "billing_amount"        : 9419.23,
    "billing_offical_amount": 18843.258604
  },
  "timestamp": 1657507021
}

同时，阿里云 ECS 采集器采集到的自定义对象数据如下：

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
  "measurement": "aliyun_ecs",
  "tags": {
    "billing_account_name": "xxxxxx",
    "billing_account_id"  : "xxxxxx",
    "name"                : "i-xxxxxxxx",
    "InstanceId"          : "i-xxxxxxxx",
    "RegionId"            : "cn-hangzhou",
    "{其他字段}"          : "{略}"
  },
  "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_by_instance",
  "tags": {
    "billing_account_id"  : "xxxxx",
    "billing_account_name": "xxxxx",
    "InstanceId"          : "i-xxxxxxxx",
    "RegionId"            : "cn-hangzhou",
    "billing_product_code": "ecs",
    "billing_product_name": "云服务器 ECS",
    "name"                : "i-xxxxxxxx",
    "billing_date"        : "20220909",
    "billing_timestamp"   : "1657507021",
    "cloud_prvider"       : "aliyun",
    "{其他字段}"          : "{略}"
  },
  "fields": {
    "billing_amount"        : 9419.23,
    "billing_offical_amount": 18843.258604
  },
  "timestamp": 1657507021
}

附录

阿里云-账单管理「查询实例账单服务」