Saltar al contenido
Telemetry
Ingestión de eventos estructurados

Convierta el comportamiento de la aplicación en tablas de eventos consultables

Envíe eventos JSON pragmáticos para flujos de productos, API, trabajos, webhooks, agentes y operaciones comerciales. Telemetry crea y desarrolla el esquema de la tabla para que los datos estén listos para SQL.

Empieza gratisLeer la documentación

Resultados

  • Mantenga los nombres y campos de los eventos legibles en todos los servicios y agentes de programación.
  • Capture el estado, la latencia, los identificadores, los costos y el contexto de error seguro juntos.
  • Agregue campos a medida que evoluciona el flujo de trabajo sin reconstruir primero una canalización de almacén.

como funciona

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

1

Elija un flujo de trabajo completo

Comience donde un usuario, trabajador, API, webhook o agente produzca un resultado significativo. Es más fácil confiar en un pequeño evento en el límite que en una carga útil gigante.

2

Registre los campos que necesitarán preguntas futuras

Incluya identificadores estables, estado, duración, entorno, característica y contexto de error categorizado. Mantenga fuera los secretos y el contenido privado sin procesar.

3

Verificar la tabla antes de expandir

Envíe eventos de prueba sintéticos, inspeccione el esquema inferido y ejecute la primera consulta. Agregue más cobertura solo después de que el contrato del evento sea útil.

Tablas de eventos estructuradas en Telemetry

Tablas de eventos estructuradas en Telemetry

Un espacio de trabajo Telemetry real que muestra las tablas de eventos ingeridos y la superficie de consulta utilizada para verificarlas.

Límites

Lo que esto no reemplaza

  • Telemetry no decide qué datos personales o regulados puede recopilar su organización; el contrato del evento aún necesita un propietario y una política de retención.
  • La evolución automática del esquema no puede reparar nombres de eventos ambiguos, unidades inconsistentes o identificadores que cambian de significado entre productores.
  • Los eventos estructurados complementan los seguimientos y los diagnósticos nativos de la base de datos; no sustituyen a todas las señales de depuración de bajo nivel.

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 agent_events, con los tipos utilizados por la consulta explícitos.

timestamp_utc
Timestamp
event_name
Utf8
data.tool_name
Utf8
data.status
Utf8
data.args.operation
Utf8
data.latency_ms
Float64
Explorar contratos de eventos

2. SQL de solo lectura

¿Qué herramientas y argumentos de IA están asociados con la mayor cantidad de llamadas fallidas?

SELECT
  "data.tool_name" AS tool_name,
  "data.args.operation" AS operation,
  COUNT(*) AS calls,
  SUM(CASE
    WHEN "data.status" = 'failed' THEN 1 ELSE 0
  END) AS failures,
  100.0 * SUM(CASE
    WHEN "data.status" = 'failed' THEN 1 ELSE 0
  END) / NULLIF(COUNT(*), 0) AS failure_rate_pct,
  approx_percentile_cont("data.latency_ms", 0.95) AS p95_latency_ms
FROM agent_events
WHERE event_name = 'agent_tool_called'
  AND timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY "data.tool_name", "data.args.operation"
HAVING COUNT(*) >= 20
ORDER BY failure_rate_pct DESC, calls DESC;

3. Resultado sintético

La búsqueda de CRM es la operación de herramienta menos confiable y la más lenta en p95.

tool_nameoperationcalls
crm_lookupsearch_contact842
order_apifetch_order2210
knowledge_searchsemantic_search4510
Inspeccionar consultas, resultados y advertencias

Capacidades

Que esta incluido

API de ingesta HTTP más SDK JavaScript, Python, Go y Rust
Campos JSON anidados expuestos como columnas de puntos consultables
Verificaciones de compatibilidad de esquemas antes de que los eventos ingresen al búfer en vivo
Campo automático de marca de tiempo UTC para análisis de series temporales
Ámbitos de clave API de lectura, escritura y lectura y escritura

Documentación

Gestión de registros estructuradosReferencia de API de registroEvolución del esquemaNombrar campos de eventos

Ver el análisis

Recetas SQL que utilizan esta capacidad

Consultar eventos de llamadas de herramientas de IA anidadas

Filtre campos anidados con puntos y clasifique las herramientas que fallan sin aplanar la carga útil del evento original.

Receta abierta

Detectar latidos de servicio faltantes

Encuentre servicios, trabajadores o tareas programadas que dejaron de informar antes de que apareciera un evento de falla.

Receta abierta

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 abierta

Casos 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 documentado

Capacidades relacionadas

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

Banco de trabajo SQL y API de consulta

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

Explorar capacidad

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

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