1. Contrato de evento
una fila en api_requests, con los tipos utilizados por la consulta explícitos.
- timestamp_utc
- Timestamp
- route_template
- Utf8
- status_code
- Int64
- latency_ms
- Float64
como funciona
Un flujo de trabajo revisable desde la señal hasta la decisión
1
Inspeccione las muestras primero
Confirme que los campos contengan los valores y tipos esperados antes de agregarlos. Esto detecta los errores de instrumentación a tiempo.
2
Elija la métrica y el grano
Seleccione la agregación, el campo numérico, el período de tiempo y los filtros que coincidan con la pregunta. Tenga en cuenta los depósitos más nuevos incompletos.
3
Promocionar vistas útiles
Agregue el resultado a un panel o alerta cuando se convierta en parte de un flujo de trabajo recurrente. Utilice Consulta para lógica de múltiples tablas y múltiples CTE.
Explorando eventos estructurados
Una captura de producto real que pasa de muestras de eventos a filtros, agregación y un resultado visual.
Límites
Lo que esto no reemplaza
- Explore está optimizado para la investigación en una sola tabla; Las uniones, varios CTE y definiciones analíticas reutilizables pertenecen a Query.
- Una carta no puede compensar instrumentación incompleta, unidades mixtas o nombres de rutas y eventos inestables.
- Los identificadores sin procesar de alta cardinalidad se utilizan mejor para un desglose restringido que como dimensiones de gráficos de nivel superior.
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.
2. SQL de solo lectura
¿Qué rutas API tienen la tasa de error 5xx significativa más alta?
SELECT
route_template,
COUNT(*) AS requests,
SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END) AS errors,
100.0 * SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END)
/ NULLIF(COUNT(*), 0) AS error_rate_pct
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
GROUP BY route_template
HAVING COUNT(*) >= 20
ORDER BY error_rate_pct DESC
LIMIT 10;3. Resultado sintético
La ruta de pago es el riesgo de confiabilidad más claro, aunque la búsqueda tiene más tráfico total.
| route_template | requests | errores |
|---|---|---|
| /api/checkout | 25 | 5 |
| /api/search | 25 | 1 |
| /api/profile | 20 | 0 |
Capacidades
Que esta incluido
Muestras y vistas de tablas para inspección de eventos sin procesar
Gráficos de líneas, barras y áreas apiladas
Agregaciones de recuento, suma, promedio, mínimo, máximo y percentil
Intervalos de tiempo, filtros de campos anidados, series divididas y columnas explícitas
Agregar al panel y crear acciones de alerta a partir de los resultados
Ver el análisis
Recetas SQL que utilizan esta capacidad
Calcular la tasa de errores de API por ruta
Utilice SQL para clasificar las rutas API según una tasa de error 5xx mientras protege el resultado del ruido de bajo volumen.
Receta abiertaMedir el reintento del trabajo en segundo plano y la tasa de fallas
Encuentre trabajos no confiables comparando ejecuciones exitosas, reintentos, fallas y duración de cola.
Receta abiertaCalcular el costo de LLM por característica y modelo
Atribuya el gasto del modelo, los tokens, el volumen de solicitudes y el costo por solicitud a las características del producto.
Receta abiertaCasos de clientes
Cómo utilizan los equipos este flujo de trabajo
“Telemetry es una de las formas más fáciles de pasar de descargar sus datos a comprenderlos realmente.”
Shayan Taslim, LogSnag
Revisar el flujo de trabajo documentado“Telemetry hace que sea muy fácil rastrear, analizar y visualizar lo que sucede en mi negocio. Es la combinación perfecta de simple y poderoso.”
Namu Kang, Browserflow
Revisar el flujo de trabajo documentadoCapacidades relacionadas
Continuar el flujo de trabajo desde el evento hasta la decisión
Paneles compartidos
Mantenga las señales operativas y de productos legibles en una vista compartida
Explorar capacidadAlertas de umbral
Notificar a las personas cuando una señal consultable se mueve fuera de su rango esperado
Explorar capacidadMonitoreo de agentes de IA
Supervise el costo de los agentes de IA, el uso de herramientas y los resultados con eventos estructurados
Explorar capacidadComience 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.