Saltar al contenido
Telemetry
Ingresos y facturación receta SQL

Calcular la retención de ingresos netos y brutos

Calcule NRR y GRR a partir de instantáneas de ingresos recurrentes mensuales a nivel de cuenta manteniendo la expansión fuera de la retención bruta.

Intermedioaccount_mrr_snapshotsRevisado 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

¿Cuántos ingresos recurrentes iniciales se retuvieron antes y después de la expansión?

La retención neta incluye la expansión, mientras que la retención bruta limita cada cuenta a su valor inicial. Informar ambos separa la durabilidad de la base de clientes del efecto de las ventas adicionales.

Contrato de evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampHora de la instantánea de fin de mes.
account_idUtf8Identificador de cuenta de facturación estable.
starting_mrr_usdFloat64MRR al inicio del mes de medición.
ending_mrr_usdFloat64MRR al final del mes de medición.
DataFusionSQL

Copiar la consulta

sql
SELECT
  date_trunc('month', timestamp_utc) AS month,
  COUNT(*) AS starting_accounts,
  SUM(starting_mrr_usd) AS starting_mrr_usd,
  SUM(ending_mrr_usd) AS ending_mrr_usd,
  100.0 * SUM(ending_mrr_usd)
    / NULLIF(SUM(starting_mrr_usd), 0) AS net_revenue_retention_pct,
  100.0 * SUM(CASE
    WHEN ending_mrr_usd < 0.0 THEN 0.0
    WHEN ending_mrr_usd > starting_mrr_usd THEN starting_mrr_usd
    ELSE ending_mrr_usd
  END) / NULLIF(SUM(starting_mrr_usd), 0)
    AS gross_revenue_retention_pct
FROM account_mrr_snapshots
WHERE timestamp_utc >= now() - INTERVAL '12 months'
  AND starting_mrr_usd > 0.0
GROUP BY date_trunc('month', timestamp_utc)
ORDER BY month;

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

Retención de ingresos netos por mes

La expansión mantuvo el NRR por encima del 100% en mayo y junio, mientras que la disminución del GRR muestra una creciente contracción o rotación por debajo.

monthstarting_accountsstarting_mrr_usdending_mrr_usdnet_revenue_retention_pctgross_revenue_retention_pct
2026-05418126.400132.900105,1496,44
2026-06431132.900136.100102,4194,88
2026-07446136.100133.70098,2493,31

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

Net revenue retention by month: gráfico estático de valores sintéticos de net_revenue_retention_pct del resultado del ejemplo Calculate Net and Gross Revenue Retention
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. 1Sólo las cuentas con MRR inicial ingresan al denominador, manteniendo los nuevos negocios fuera de la retención.
  2. 2La NRR compara la MRR final total con la MRR inicial y, por lo tanto, incluye la expansión.
  3. 3El GRR limita cada cuenta a su MRR inicial, por lo que la expansión no puede compensar la contracción o la rotación.

Casos extremos para decidir

  • Normalice los contratos anuales, basados en el uso y multidivisa antes de tomar instantáneas.
  • Utilice una jerarquía de cuentas de forma coherente cuando las suscripciones principales y secundarias puedan moverse de forma independiente.
  • Concilie las correcciones de facturación retroactivas para que las instantáneas históricas no se desvíen silenciosamente.

Panel recomendado

  • Tendencia: NRR y GRR por mes
  • Barras: expansión, contracción y abandono MRR
  • Tabla: mayores cambios en los ingresos a nivel de cuenta

Guía de alerta

Revisar un mes completo cuando GRR o NRR caigan por debajo de su rango operativo; no alertar sobre una instantánea incompleta del mes actual.

Leer configuración de alerta

Pon la receta a trabajar

Instrumentación y guías relacionadas.

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