Saltar al contenido
Telemetry
Ingresos y facturación receta SQL

Calcular la cuota de uso quemada por cuenta

Mida las unidades facturables con respecto a la cuota mensual incluida de cada cuenta y clasifique las cuentas que se acerquen a un excedente.

Principianteusage_meter_eventsRevisado 2026-07-28Probado con Apache DataFusion 45.2.0

Revisado por el equipo de producto Telemetry en . Compatibilidad con SQL, contrato de eventos, resultados sintéticos y advertencias operativas. Revisar los estándares y la propiedad

Pregunta respondida

¿Qué cuentas consumen su uso incluido más rápido este mes?

La facturación basada en el uso necesita una unidad estable, un evento de medidor idempotente y la cuota que se aplicó cuando ocurrió el uso. Esta consulta hace visible el consumo de cuota sin tratar el recuento de eventos sin procesar como uso facturable.

Contrato de evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampCuándo se completó la actividad facturable en UTC.
meter_event_idUtf8Clave de idempotencia para un registro de uso lógico.
account_idUtf8Identificador de cuenta de facturación estable.
planUtf8Plan que poseía la cuota cuando se produjo el uso.
billable_unitsFloat64Unidades normalizadas agregadas por este evento.
included_unitsFloat64Cuota mensual incluida para la cuenta y el plan.
DataFusionSQL

Copiar la consulta

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;

Esta consulta de solo lectura se planifica y ejecuta en una tabla escrita vacía con Apache DataFusion 45.2.0. El resultado de la muestra determinista es sintético y se revisa por separado; valide tipos de campos, umbrales y definiciones comerciales con sus propios datos. Lea la metodología de prueba.

Resultado de la consulta

Cuota mensual utilizada por cuenta

Harbour ha superado su cuota incluida, mientras que Lumen está lo suficientemente cerca como para necesitar un pronóstico o una notificación al cliente.

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_northstarter3610168.000250.00067,2-82.000

Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.

Monthly quota used by account: gráfico estático de valores sintéticos de quota_used_pct del resultado del ejemplo Calculate Usage Quota Burn by Account
SVG indexable de la salida del ejemplo determinista. Descárguelo para ver un artículo, un runbook o una revisión de diseño con atribución.

Reproducir el ejemplo

Descargar el accesorio público

El paquete JSON incluye el contrato de evento escrito, illustrative filas de entrada, SQL exacto, resultado esperado, notas de revisión y versión del motor. El CSV contiene el resultado mostrado.

Cómo funciona el SQL

  1. 1El primer CTE agrupa por ID de evento de medidor, por lo que una entrega de al menos una vez no puede facturar el mismo uso lógico dos veces.
  2. 2Las unidades facturables se suman independientemente del recuento de eventos porque una solicitud puede representar muchas unidades o fracciones.
  3. 3El porcentaje de cuota y el excedente preservan el denominador específico del plan necesario para la clasificación de la cuenta y la revisión de facturación.

Casos extremos para decidir

  • Los cambios de plan necesitan una política de prorrateo explícita; un máximo mensual único es ilustrativo cuando las cuotas pueden cambiar a mitad del período.
  • Las correcciones y el uso negativo requieren un contrato de ajuste de solo anexo en lugar de mutar silenciosamente eventos anteriores.
  • Concilie el total con el proveedor de facturación antes de que la factura sea definitiva.

Panel recomendado

  • Barras: quota_used_pct por cuenta
  • Tabla: unidades usadas, incluidas y excedentes
  • Tendencia: unidades facturables diarias para cuentas superiores al 75%

Guía de alerta

Notifique a los propietarios de cuentas en los umbrales de cuota documentados y avise solo cuando la entrega o conciliación del medidor falle.

Leer configuración de alerta

Pon la receta a trabajar

Instrumentación y guías relacionadas.

Definir los datos de origen

Esquemas de eventos para este análisis.

Continuar el análisis

Ejecútelo en eventos reales.

Crea una tabla, adapta los campos y guarda el resultado.

Comience gratis, envíe eventos estructurados y utilice el resultado de la consulta como un gráfico, un widget de panel compartido o una entrada de alerta.

Obtén una clave API