Saltar al contenido
Telemetry
Calidad de datos receta SQL

Medir el volumen Telemetry por nombre de evento

Clasifique los tipos de eventos por bytes de carga útil, tamaño promedio de evento y tasa de rechazo antes de cambiar la política de retención o recolección.

Principiantetelemetry_ingestion_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é contratos de eventos generan el mayor volumen de ingesta?

El recuento de eventos por sí solo puede ocultar cargas útiles de gran tamaño. Esta consulta mantiene juntos el recuento y el volumen de bytes, lo que hace visibles los contratos de eventos ruidosos o inesperadamente grandes sin pretender que los bytes de carga útil equivalgan a una factura de proveedor.

Contrato de evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampHora del intento de ingesta en UTC.
event_nameUtf8Nombre del evento controlado.
sourceUtf8Productor limitado o fuente SDK.
payload_bytesInt64Tamaño del evento serializado antes de la compresión del transporte.
acceptedBooleanSi la ingestión aceptó el evento.
environmentUtf8Entorno de implementación.
DataFusionSQL

Copiar la consulta

sql
SELECT
  event_name,
  source,
  COUNT(*) AS events,
  SUM(payload_bytes) AS total_payload_bytes,
  AVG(payload_bytes) AS avg_payload_bytes,
  SUM(CASE WHEN accepted THEN 0 ELSE 1 END) AS rejected_events,
  100.0 * SUM(CASE WHEN accepted THEN 0 ELSE 1 END)
    / NULLIF(COUNT(*), 0) AS rejection_rate_pct
FROM telemetry_ingestion_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY event_name, source
ORDER BY total_payload_bytes DESC, event_name;

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

Volumen de carga útil por contrato de evento

El seguimiento de depuración sintético tiene el mayor volumen de bytes a pesar de tener menos eventos que visitas a páginas.

event_namesourceeventstotal_payload_bytesavg_payload_bytesrejected_eventsrejection_rate_pct
debug_traceworker416.0004000125
llm_request_completedapi36000200000
page_viewedweb63000500116,67

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

Payload volume by event contract: gráfico estático de valores sintéticos de total_payload_bytes del resultado del ejemplo Measure Telemetry Volume by Event Name
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, reproducible 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. 1Los bytes totales y el promedio de bytes distinguen un evento de alta frecuencia de un contrato de gran tamaño.
  2. 2La fuente mantiene visible la propiedad cuando varios productores pueden emitir el mismo nombre de evento.
  3. 3La tasa de rechazo convierte los cambios en la recopilación en una revisión de la calidad de los datos en lugar de un ejercicio de costos únicamente.

Casos extremos para decidir

  • El tamaño de la carga útil serializada no es el tamaño almacenado, los bytes de escaneo, la salida de la red ni el costo de la factura.
  • Mida la cardinalidad de la dimensión por separado; un evento pequeño aún puede crear grupos costosos o inutilizables.
  • Excluya el tráfico sintético y de desarrollo antes de cambiar la retención de producción.

Panel recomendado

  • Barras: total_payload_bytes por event_name
  • Tendencia: recuento de eventos y bytes por fuente
  • Tabla: tamaño promedio, tasa de rechazo, propietario de retención y versión del esquema

Guía de alerta

Alerta sobre cambios sostenidos en el tamaño o el volumen del contrato en relación con una línea de base revisada, no sobre un umbral de bytes global fijo.

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