Saltar al contenido
Telemetry
Banco de trabajo SQL y API de consulta

Haga preguntas detalladas con el mismo SQL que los humanos y agentes pueden inspeccionar

Ejecute DataFusion SQL sobre datos de eventos recientes e históricos, guarde consultas importantes, exporte resultados más grandes de forma asincrónica y utilice la salida en paneles o sistemas posteriores.

Empieza gratisLeer la documentación

Resultados

  • Pase de un gráfico de alto nivel a las filas y campos exactos detrás de él.
  • Utilice CTE, uniones, agregados, percentiles y funciones de ventana para un análisis más profundo.
  • Permita que los agentes generen una primera consulta mientras mantienen la lógica final revisable.

como funciona

Un flujo de trabajo revisable desde la señal hasta la decisión

1

Partir de una decisión

Escriba la pregunta operativa o de producto antes de seleccionar columnas. Una pregunta enfocada produce una consulta que puede interpretarse y mantenerse.

2

Inspeccionar el resultado, no sólo la sintaxis.

Verifique volumen, nulos, ventanas de tiempo, denominadores y grupos inesperados. SQL puede ejecutarse correctamente y aun así responder a la pregunta incorrecta.

3

Guarde la consulta cuando siga siendo útil

Convierta el análisis recurrente en una consulta con nombre, un widget de panel, una exportación o una alerta para que el equipo no lo vuelva a crear durante cada incidente.

Escribir y ejecutar SQL en Telemetry

Una breve captura del editor de consultas real, el autocompletado, la tabla de resultados y el flujo de trabajo del gráfico.

Límites

Lo que esto no reemplaza

  • Una consulta válida aún puede codificar el denominador, unión, límite de tiempo o definición de negocio incorrectos; Se debe revisar el análisis guardado.
  • La API de consulta interactiva está diseñada para el análisis, mientras que los extractos grandes deben utilizar la ruta de exportación asincrónica.
  • Telemetry expone DataFusion SQL, por lo que las funciones específicas del motor de otro almacén pueden necesitar una expresión equivalente.

Ruta de prueba inspeccionable

Del contrato de evento a una respuesta visible

Este ejemplo utiliza un esquema declarado, SQL de solo lectura y resultados sintéticos deterministas. Demuestra el flujo de trabajo sin presentar datos de muestra como punto de referencia del cliente.

1. Contrato de evento

una fila en api_requests, con los tipos utilizados por la consulta explícitos.

timestamp_utc
Timestamp
route_template
Utf8
latency_ms
Float64
status_code
Int64
Explorar contratos de eventos

2. SQL de solo lectura

¿Qué puntos finales tienen la peor latencia de cola?

SELECT
  route_template,
  COUNT(*) AS requests,
  approx_percentile_cont(latency_ms, 0.50) AS p50_ms,
  approx_percentile_cont(latency_ms, 0.95) AS p95_ms,
  approx_percentile_cont(latency_ms, 0.99) AS p99_ms
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND status_code < 500
GROUP BY route_template
HAVING COUNT(*) >= 50
ORDER BY p95_ms DESC
LIMIT 10;

3. Resultado sintético

Las solicitudes de exportación tienen la cola más lenta y la mayor brecha entre el desempeño típico y el peor.

route_templaterequestsp50_ms
/api/reports/export50800
/api/projects/:id/sync50320
/api/search50120
Inspeccionar consultas, resultados y advertencias

Capacidades

Que esta incluido

Consultas JSON síncronas para análisis interactivo
Exportaciones asincrónicas de JSON y Parquet para conjuntos de resultados más grandes
Consultas en tiempo real que combinan eventos frescos almacenados en búfer con un historial duradero
Validación de consultas de solo lectura para SQL del panel guardado
Consultar gráficos de resultados, tablas, exportaciones y alertas.

Documentación

Referencia de API de consultaTrabajar con marcas de tiempoColumnas de partición

Ver el análisis

Recetas SQL que utilizan esta capacidad

Calcule la latencia API p50, p95 y p99

Compare la latencia media y de cola por punto final con SQL percentil compatible con DataFusion.

Receta abierta

Calcular la retención de cohorte semanal

Agrupe a los usuarios por primera semana de actividad y mida el porcentaje que regresa en semanas posteriores.

Receta abierta

Encuentre funciones utilizadas antes de la actualización

Únase a eventos destacados para actualizar eventos y clasificar comportamientos que ocurren antes de la conversión paga.

Receta abierta

Casos de clientes

Cómo utilizan los equipos este flujo de trabajo

“Telemetry es mi opción para volcar registros y rastrear eventos. Es sencillo, el banco de trabajo SQL es rápido y no tengo que preocuparme por el esquema por adelantado. Ejecutar SQL a través de una API REST me permite recuperar datos y volcar informes directamente a Slack. Es lo esencial de lo que Sentry hizo por mí.”

Prem Viswanathan, SwiftCX

Revisar el flujo de trabajo documentado

Capacidades relacionadas

Continuar el flujo de trabajo desde el evento hasta la decisión

Explorar

Filtre, agregue y visualice una tabla sin comenzar desde SQL en blanco

Explorar capacidad

Paneles compartidos

Mantenga las señales operativas y de productos legibles en una vista compartida

Explorar capacidad

Alertas de umbral

Notificar a las personas cuando una señal consultable se mueve fuera de su rango esperado

Explorar capacidad

Comience con un flujo de trabajo de producción

Utilice un mensaje enfocado, envíe eventos sintéticos y verifique la primera consulta útil antes de ampliar la cobertura.

Abrir el paquete de instruccionesRevisar la evidencia del cliente