跳至主要內容
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 金鑰