用量查询（新版）--内容分发网络-火山引擎

文档中心

立即注册

导航

用量查询（新版）

最近更新时间：2025.10.27 10:41:18首次发布时间：2024.06.18 21:01:46

基于收到的用户请求，火山引擎内容分发网络（CDN）对计费指标，也就是计费项，统计数据。计费项数据也称为用量。
CDN 提供了 用量查询 页面。该页面提供了以下标签页：

用量查询标签页：指定一个或多个加速域名，查询这些加速域名在某一个时间段内的用量。
用量导出标签页：创建用量导出任务，用于生成用量报告供您下载。

说明

我们全新设计了 用量查询 页面。当前，新页面是通过灰度发布对部分用户开放的。如果您希望使用新页面，请提交工单。
指标数据是在缓存节点统计的。受网络抖动的影响，这些数据可能会发生变化。大多数情况下，指标数据会在 12 小时内稳定下来。因此，用量查询页面以及用量报告中展示的计费指标数据均为估算值，并非账单中显示的用量，仅供参考。实际用量请以账单为准。

这些计费指标的说明如下表所示：

计费指标	说明
带宽	表示基于 CDN 向用户传输的数据量而计算的带宽，单位是 bps。
流量	表示 CDN 向用户传输的数据量，单位是 bytes。
QUIC 请求数	表示 CDN 收到的 QUIC 请求数量。如果您有至少一个加速域名启用了 QUIC 特性，CDN 就会统计该计费指标的数据。
HTTPS 请求数	表示 CDN 收到的 HTTPS 请求数量，包含基于 QUIC 的 HTTPS 请求数。如果您有至少一个加速域名启用了 HTTPS 特性，CDN 就会统计该计费指标的数据。
实时日志投递数	表示 CDN 向您指定的投递目标投递的日志条数。如果您账号下的 CDN 服务开通了实时日志特性，CDN 就会统计该计费指标的数据。

说明

如果您刚开始使用 用量查询 页面，请务必先阅读以下文档，可以帮助您理解本篇文档中的描述。

用量查询标签页

在您查询计费指标数据时，您需要指定一个统计时间段。统计时间段有以下要求：

时间跨度不能超过 31 天。
开始日期距离当前日期不能超过 1 年。

另外，您可以指定过滤条件对请求进行过滤，对符合过滤条件的请求统计计费指标数据。

页面介绍

对于符合过滤条件的用户请求，CDN 展示了以下计费指标的数据：

带宽、流量、QUIC 请求数、HTTPS 请求数、实时日志投递数。

说明

如果您账号下没有开启 QUIC 或 HTTPS 特性的加速域名，或者您账号下的 CDN 服务没有开启 "实时日志投递" 特性，则相应的指标标签页不会出现。

操作步骤

登录火山引擎内容分发网络控制台。
在左侧导航栏，点击 用量管理 > 用量查询。

带宽示例图

HTTPS 请求数示例图

数据过滤

您可以的过滤类型如下表所示。

过滤类型	说明
统计时间段	指定一个统计时间段，时间跨度不超过 31 天，精确到天。该配置的可选项有今天、昨天、近7天、近30天、本月，默认是今天。统计时间段的开始日期距离当前日期不能超过 1 年。
加速域名	指定最多 50 个加速域名，用于对用户请求进行过滤，以获取向这些加速域名发送的用户请求。默认包含您账号下所有的加速域名。页面还提供了项目、标签、业务类型这几个过滤类型用于对加速域名进行过滤。对于项目和标签，您只能选择其一。子用户只能指定其有权限访问的加速域名。除了过滤加速域名，项目还用来统计项目级别的指标数据。如果指定了项目，您获取的是指定加速域名在项目级别的指标数据。也就是说，如果这些加速域名在统计时间段内转入或者转出该项目，指标数据会受到影响。如果未指定项目，您获取的是指定加速域名在加速域名级别的指标数据。也就是说，如果这些加速域名在统计时间段内转入或者转出任何项目，指标数据不会受到影响。说明在控制台中，如果您指定了项目，您可以指定的加速域名只能是当前该项目下的加速域名。如果您想获取的项目级别的指标数据涵盖曾经在该项目下，但是当前已转出该项目的加速域名，请使用用量查询 API。项目示例考虑以下场景：您指定的统计时间段是某天的 8:00-10:00。加速域名X 在 9:00 从另一个项目转移到项目A。加速域名Y 一直在项目A 中。在这个场景中，假设您既指定了项目A，又指定了加速域名X 与加速域名Y。在这个情况下，您获取的是项目级别的指标数据，涵盖：加速域名X 在 9:00 至 10:00 之间的指标数据。加速域名Y 在 8:00 至 10:00 之间的指标数据。假设您未指定项目A，但是指定了加速域名X 与加速域名Y。在这个情况下，您获取的是加速域名级别的指标数据，涵盖：加速域名X 在 8:00 至 10:00 之间的指标数据。加速域名Y 在 8:00 至 10:00 之间的指标数据。
计费区域	表示一个计费区域，用于对用户请求进行过滤，以获取来自这些区域的请求。

过滤类型

说明

统计时间段

指定一个统计时间段，时间跨度不超过 31 天，精确到天。该配置的可选项有今天、昨天、近7天、近30天、本月，默认是今天。统计时间段的开始日期距离当前日期不能超过 1 年。

加速域名

指定最多 50 个加速域名，用于对用户请求进行过滤，以获取向这些加速域名发送的用户请求。默认包含您账号下所有的加速域名。

页面还提供了项目、标签、业务类型 这几个过滤类型用于对加速域名进行过滤。

对于项目和标签，您只能选择其一。
子用户只能指定其有权限访问的加速域名。

除了过滤加速域名，项目还用来统计项目级别的指标数据。

如果指定了项目，您获取的是指定加速域名在项目级别的指标数据。也就是说，如果这些加速域名在统计时间段内转入或者转出该项目，指标数据会受到影响。
如果未指定项目，您获取的是指定加速域名在加速域名级别的指标数据。也就是说，如果这些加速域名在统计时间段内转入或者转出任何项目，指标数据不会受到影响。

说明

在控制台中，如果您指定了项目，您可以指定的加速域名只能是当前该项目下的加速域名。如果您想获取的项目级别的指标数据涵盖曾经在该项目下，但是当前已转出该项目的加速域名，请使用用量查询 API。

项目示例

考虑以下场景：

您指定的统计时间段是某天的 8:00-10:00。
加速域名X 在 9:00 从另一个项目转移到项目A。加速域名Y 一直在项目A 中。

在这个场景中，

假设您既指定了项目A，又指定了加速域名X 与加速域名Y。在这个情况下，您获取的是项目级别的指标数据，涵盖：
- 加速域名X 在 9:00 至 10:00 之间的指标数据。
- 加速域名Y 在 8:00 至 10:00 之间的指标数据。
假设您未指定项目A，但是指定了加速域名X 与加速域名Y。在这个情况下，您获取的是加速域名级别的指标数据，涵盖：
- 加速域名X 在 8:00 至 10:00 之间的指标数据。
- 加速域名Y 在 8:00 至 10:00 之间的指标数据。

计费区域

表示一个计费区域，用于对用户请求进行过滤，以获取来自这些区域的请求。

注意

对于 "实时日志投递数" 这个指标，您无法指定项目或计费区域对指标数据进行过滤。

如果您当前正在查看的指标不是 "实时日志投递数"，并且您指定了项目或者计费区域，则 实时日志投递数 标签页会置灰。
如果您当前正在查看 "实时日志投递数" 指标，项目和 计费区域 会置灰。

指标数据

在您设置了过滤条件后，您可以点击查询查看相应的计费指标数据。

计费指标数据包括统计时间段内的汇总数据以及细分数据。细分数据是在一个随时间而变化的折线图中展示的，使您可以了解数据的趋势。

访问统计页面展示的计费指标如下表所示。

计费指标	细分数据	汇总数据
带宽	展示统计时间段内带宽趋势。	展示统计时间段内的带宽峰值以及带宽峰值的时间。
流量	展示统计时间段内流量趋势。	展示统计时间段内的总流量。
QUIC 请求数	展示统计时间段内 QUIC 请求数量的趋势。	展示统计时间段内的 QUIC 请求总数。
HTTPS 请求数	展示统计时间段内 HTTPS 请求数量的趋势。	展示统计时间段内的 HTTPS 请求总数。
实时日志投递数	展示统计时间段内 CDN 向日志服务投递的日志条数趋势。	展示统计时间段内 CDN 向日志服务投递的日志总条数。

关于各计费指标的计算方式，参见指标的定义以及统计方式。

时间粒度

您可以指定数据统计的时间粒度。时间粒度的作用如下：

时间粒度决定了实际统计时间段。参见统计时间段说明。
在 CDN 计算细分数据时，时间粒度决定了每个数据点的时间区间。

对于细分数据，您可以指定的时间粒度有 1 分钟粒度、5 分钟粒度、1 小时粒度。

说明

带宽的汇总数据是基于 5 分钟粒度而计算的带宽峰值。

细分数据下载

在时间粒度选择器右边，您可以点击下载按钮下载趋势图中各时间区间的计费指标数据。

对于每个计费指标，下载文件的命名规范如下表所示。在文件的命名规范中，表示文件的下载时间。

计费指标	下载文件的命名规范
带宽	CDN_AccountingBandwidth_.csv
流量	CDN_AccountingFlux_.csv
QUIC 请求数	CDN_AccountingQUICRequests_.csv
HTTPS 请求数	CDN_AccountingHTTPSRequests_.csv
实时日志投递数	CDN_AccountingTLSRequests_.csv

用量导出标签页

在 CDN 中，您可以创建用量导出任务来生成用量报告供您下载。

操作步骤

登录火山引擎内容分发网络控制台。
在左侧导航栏，点击 用量管理 > 用量查询。
在 用量查询 页面，点击 用量导出。
点击 创建导出任务。
在 创建导出任务 页面，按照配置说明进行设置。
设置完成后，点击确定。
任务创建后，该任务就开始生成用量报告了。生成用量报告可能需要几分钟时间。用量报告生成后，任务列表的操作列上会出现下载链接。
在操作列上，点击下载。

配置说明

配置	说明
任务名称	表示一个任务名称，长度为 3-63 个字符。名称只能包含小写字母、数字、连字符（-），并且必须以小写字母或数字开头或结尾。
计费区域	表示一个计费区域，用于对用户请求进行过滤。该任务对来自该计费区域的用户请求统计指标数据。该配置有以下选项：全部区域：表示您账号下启用的所有计费区域。中国内地：表示中国内地这个计费区域。全球（不含中国内地）：表示除中国内地以外的所有计费区域。说明如果您没有开通全球（不含中国内地）这个加速区域，中国内地和全球（不含中国内地）这两个选项不会出现。在这个情况下，该配置只有全部区域这个选项，包含的计费区域是中国内地。要开通全球（不含中国内地）这个服务区域，请提交工单。
数据类型	表示一个计费指标。您可以选择的指标有：带宽，单位是 bps。流量，单位是 bytes。 QUIC 请求数。 HTTPS 请求数。实时日志投递数。关于这些指标的定义以及计算方式，参见指标的定义以及统计方式。
聚合方式	表示一个时间粒度。基于该时间粒度，CDN 对您的加速域名统计指标数据。如果数据类型是带宽，该配置只有按日峰值这个选项，表示时间粒度是 1 天。如果数据类型不是带宽，您可以指定以下选项：加和量-按小时聚合：表示时间粒度是 1 小时。该任务生成按小时聚合的指标数据的报告。加和量-按日聚合：表示时间粒度是 1 天。该任务生成按天聚合的指标数据的报告。例如，您账号下的 CDN 服务的计费方式是流量日结。那么，您可以指定数据类型为流量，聚合方式为加和量-按日聚合。这样，该任务生成的是每日流量的报告。
用量起止时间	表示一个统计时间段，时间跨度不能超过 31 天。统计时间段的开始日期距离当前日期不能超过 1 年。
导出类型	表示指标数据是对哪些加速域名统计的。该配置有以下选项：账户明细：表示您账号下所有的加速域名。域名明细：表示您指定的那些加速域名。
聚合类型	表示是否汇总所有指定加速域名的数据。当导出类型是域名明细时，该配置会出现。该配置有以下选项：聚合域名导出：表示需要汇总这些数据。分域名导出：表示不汇总这些数据，而是对每个指定的加速域名统计指标数据。
选择域名	如果导出类型是域名明细，该配置会出现。您可以指定最多 300 个加速域名。

下载用量报告

该任务生成的用量报告是在一个 ZIP 包中。包中有一个或者多个 .xlsx 文件。

每个 .xlsx 文件中包含两个工作表（sheet）：

第一个工作表的名称是：指定起止时间的5分钟粒度的计费数据明细
第二个工作表的名称是：指定起止时间的计费值数据

每个工作表中数据的描述如下表所示。关于这些指标的定义以及计算方式，参见指标的定义以及统计方式。

计费方式	导出类型	聚合类型	第一个工作表数据的描述	第二个工作表中数据的描述
带宽	账户明细	N/A	您账号下所有加速域名的一系列带宽值。这些带宽值是以 5 分钟粒度统计的。	您账号下所有加速域名的一系列带宽峰值。这些带宽峰值是以 "聚合方式" 指定的时间粒度而统计的。
	域名明细	聚合域名导出	所有指定加速域名的一系列带宽值。这些带宽值是以 5 分钟粒度统计的。	所有指定加速域名的一系列带宽峰值。这些带宽峰值是以 "聚合方式" 指定的时间粒度而统计的。
	域名明细	分域名导出	一个指定加速域名的一系列带宽值。这些带宽值是以 5 分钟粒度统计的。	一个指定加速域名的一系列带宽峰值。这些带宽峰值是以 "聚合方式" 指定的时间粒度而统计的。
流量	账户明细	N/A	您账号下所有加速域名的一系列流量值。这些流量值是以 5 分钟粒度统计的。	您账号下所有加速域名的一系列流量值。这些流量值是以 "聚合方式" 指定的时间粒度而统计的。
	域名明细	聚合域名导出	所有指定加速域名的一系列流量值。这些流量值是以 5 分钟粒度统计的。	所有指定加速域名的一系列流量值。这些流量值是以 "聚合方式" 指定的时间粒度而统计的。
	域名明细	分域名导出	一个指定加速域名的一系列流量值。这些流量值是以 5 分钟粒度统计的。	一个指定加速域名的一系列流量值。这些流量值是以 "聚合方式" 指定的时间粒度而统计的。

对于其他三个指标 QUIC 请求数、HTTPS 请求数、实时日志投递数，每个工作表中数据的描述与流量类似。