跳转到内容
Telemetry
收入和账单 SQL查询示例

按账户计算使用配额消耗

根据每个帐户包含的每月配额衡量计费单位,并对接近超额的帐户进行排名。

入门usage_meter_events已审核 2026-07-28测试用 阿帕奇 DataFusion 45.2.0

审阅者 Telemetry产品团队 . SQL 兼容性、事件契约、合成输出和操作注意事项. 审查标准和所有权

问题已回答

本月哪些帐户消耗其包含的使用量最快?

基于使用的计费需要稳定的单位、幂等计量事件以及使用发生时应用的配额。此查询使配额消耗可见,而不将原始事件计数视为可计费使用。

活动合约

查询期望的字段

字段类型为什么存在
timestamp_utcTimestamp当计费活动在 UTC 完成时。
meter_event_idUtf8一个逻辑使用记录的幂等键。
account_idUtf8稳定的计费帐户标识符。
planUtf8使用发生时拥有配额的计划。
billable_unitsFloat64此事件添加的标准化单位。
included_unitsFloat64每月包含帐户和计划的配额。
DataFusion SQL

复制查询

sql
WITH deduplicated_usage AS (
  SELECT
    meter_event_id,
    account_id,
    plan,
    MAX(billable_units) AS billable_units,
    MAX(included_units) AS included_units
  FROM usage_meter_events
  WHERE timestamp_utc >= date_trunc('month', now())
  GROUP BY meter_event_id, account_id, plan
)
SELECT
  account_id,
  plan,
  COUNT(*) AS meter_events,
  SUM(billable_units) AS used_units,
  MAX(included_units) AS included_units,
  100.0 * SUM(billable_units)
    / NULLIF(MAX(included_units), 0) AS quota_used_pct,
  SUM(billable_units) - MAX(included_units) AS overage_units
FROM deduplicated_usage
GROUP BY account_id, plan
ORDER BY quota_used_pct DESC;

此只读查询是针对空类型表计划和执行的 阿帕奇 DataFusion 45.2.0。确定性样本输出是综合的并单独审查;根据您自己的数据验证字段类型、阈值和业务定义。 阅读测试方法。

查询结果

账户每月使用额度

Harbor 已经超出了其包含的配额,而 Lumen 已经足够接近,需要进行预测或通知客户。

account_idplanmeter_eventsused_unitsincluded_unitsquota_used_pctoverage_units
account_harborgrowth18,4201,126,0001,000,000112.6126,000
account_lumengrowth12,880842,0001,000,00084.2-158,000
account_northstarter3,610168,000250,00067.2-82,000

综合示例输出。在将其用于操作决策之前,针对您自己的事件架构和阈值运行查询。

Monthly quota used by account:来自 Calculate Usage Quota Burn by Account 示例结果的合成 quota_used_pct 值的静态图表
确定性示例输出的可索引 SVG。下载它以获取带有归属的文章、操作手册或设计评论。

重现示例

下载公共装置

JSON 包包含类型化事件契约, illustrative 输入行、确切的 SQL、预期输出、审阅注释和引擎版本。 CSV 包含显示的结果。

SQL 是如何工作的

  1. 1第一个 CTE 按计量事件 ID 进行分组,因此至少一次交付不能对相同的逻辑使用量进行两次计费。
  2. 2可计费单位的合计与事件计数无关,因为一个请求可以代表许多单位或小数单位。
  3. 3配额百分比和超额保留了帐户排名和账单审核所需的特定于计划的分母。

需要决定的边缘情况

  • 计划变更需要明确的按比例分配政策;当配额可能在中期发生变化时,单个月的最高限额就很说明问题。
  • 更正和负面使用需要仅附加调整合约,而不是默默地改变先前的事件。
  • 在发票成为最终结果之前,与计费提供商对汇总进行核对。

推荐仪表板

  • 酒吧:quota_used_pct(按账户)
  • 表:已用、包含和超额单位
  • 趋势:75% 以上的帐户每日计费单位

警报指导

仅当仪表传送或对账失败时,才按照记录的配额阈值通知帐户所有者和寻呼。

读取警报设置

让查询示例发挥作用

相关埋点和指南

定义源数据

此分析的事件模式

继续分析

在真实事件中运行它

创建表,调整字段并保存结果

免费开始,发送结构化事件,并将查询结果用作图表、共享仪表板小部件或警报输入。

获取 API 密钥