Saltar al contenido
Telemetry
Documentación Telemetry

Envía tu primer evento. Crea tu primer panel.

Aprenda Telemetry desde el primer evento hasta la instrumentación de producción, SDK, API, diseño de eventos estructurados, DataFusion SQL, paneles, alertas y solución de problemas.

Revisado por el equipo de producto Telemetry en . Revisamos los temas, la navegación, las fuentes y las indicaciones para usar Telemetry en producción. Quién revisa esta página

98

páginas de documentación

5

secciones de aprendizaje

HTML para personas, Markdown para agentes

Lee cada artículo en el sitio o dale su versión en Markdown a tu agente de programación.

Elige tu objetivo

Empieza por lo que necesitas decidir o implementar

Supervise la IA y los flujos de trabajo de los agentes

Conecte el uso del modelo, el costo, la latencia, las herramientas, la calidad de la recuperación y los resultados de los productos revisados sin almacenar indicaciones sin procesar de forma predeterminada.

Resuelve problemas de eventos o resultados ausentes

Separe los errores de ingesta, esquema, consulta, alerta y entrega posterior antes de cambiar la instrumentación.

Empezando

Cree una clave, envíe y verifique el primer evento, escriba SQL y finalice la lista de verificación de producción inicial.

Inicio rápido

Envíe un evento estructurado, inspeccione su tabla, consúltelo con SQL y convierta el resultado en un panel o alerta.

Leer la página

Envíe su primer evento estructurado

Cree una clave API con alcance de escritura, envíe un evento estructurado sintético y elija un nombre de evento y campos que sigan siendo útiles en producción.

Leer la página

Verificar la ingesta y el esquema de eventos

Confirme que un evento de prueba alcanzó la tabla esperada con los tipos, marcas de tiempo, identificadores y límites de privacidad previstos antes de expandir la instrumentación.

Leer la página

Escribe tu primera consulta SQL en Telemetry

Consulte una tabla de eventos estructurados verificada, calcule el volumen y la tasa de error, inspeccione filas sin procesar y valide el resultado con un elemento sintético conocido.

Leer la página

Cree su primer panel y alerta

Promueva una consulta validada en un widget de panel enfocado y una alerta de umbral con un propietario explícito, una ventana de tiempo y una acción de respuesta.

Leer la página

Lista de verificación de instrumentación en producción

Revise la propiedad de los eventos, la estabilidad del esquema, los límites de los datos confidenciales, las credenciales, el comportamiento de falla, la retención, las consultas, los paneles y las alertas antes del lanzamiento de la producción.

Leer la página

Claves de API y autenticación

Cree, alcance, almacene, rote y revoque claves Telemetry API sin exponer la ingesta ni consultar el acceso a clientes que no son de confianza.

Leer la página

Equipos, espacios de trabajo, miembros y roles

Organice análisis en espacios de trabajo de equipo, invite a miembros, comprenda las funciones de administrador y de miembro, y revise el acceso antes de compartir datos.

Leer la página

Uso, facturación y límites de los planes

Revise el uso del almacenamiento y la duración de las consultas, comprenda la aplicación de planes gratuitos, compare los precios actuales y planifique actualizaciones de forma segura.

Leer la página

SDK y HTTP

Utilice JavaScript, Python, Rust, Go, Ruby, PHP o cURL del lado del servidor con entrega explícita y límites de credenciales.

SDK de JavaScript y TypeScript

Instale Telemetry JavaScript SDK, envíe eventos estructurados, ejecute consultas SQL escritas, verifique la entrega y maneje los modos de falla de producción.

Leer la página

SDK de Python

Utilice los clientes Telemetry Python sincrónicos y asincrónicos para enviar eventos, consultar datos, filas por lotes y gestionar la entrega de producción de forma segura.

Leer la página

SDK de Rust

Inicialice el cliente de bloqueo Telemetry Rust, envíe eventos JSON estructurados, consulte SQL y diseñe un comportamiento de entrega de producción seguro.

Leer la página

SDK de Go

Inicialice el cliente Telemetry Go, envíe eventos estructurados, consulte SQL, verifique la entrega y diseñe tiempos de espera y reintentos de producción seguros.

Leer la página

Integración Ruby HTTP

Envíe eventos estructurados, ejecute SQL, configure los tiempos de espera de Net::HTTP, verifique esquemas y maneje las fallas de Telemetry API de forma segura desde Ruby.

Leer la página

Integración PHP HTTP

Envíe eventos estructurados, ejecute SQL, configure tiempos de espera de cURL, verifique esquemas y maneje fallas de Telemetry API de forma segura desde PHP.

Leer la página

Ejemplos de cURL y HTTP API

Envíe eventos, inspeccione esquemas, ejecute SQL, exporte Parquet y maneje fallas de Telemetry HTTP de forma segura con cURL.

Leer la página

Integración de Java HTTP

Envíe eventos Telemetry estructurados y consultas SQL desde Java con un HttpClient compartido, tiempos de espera limitados, JSON seguro y manejo explícito de fallas.

Leer la página

Integración .NET HTTP

Envíe eventos Telemetry estructurados y consultas SQL desde .NET con IHttpClientFactory, tiempos de espera limitados, cargas útiles escritas y manejo explícito de fallas.

Leer la página

Conceptos y patrones de SQL

Diseñe contratos de eventos estables, controle el esquema y la cardinalidad y utilice patrones DataFusion SQL reutilizables.

Arquitectura de Telemetry

Vea cómo Telemetry valida y almacena en buffer eventos, almacena Parquet en S3 y combina datos nuevos e históricos para consultas de SQL.

Leer la página

Crear paneles

Cree paneles de control Telemetry enfocados a partir de los resultados de consultas de Explore y SQL y luego organice widgets para tomar decisiones operativas rápidas.

Leer la página

Evolución del esquema

Descubra cómo Telemetry se adapta a medida que se agregan campos de eventos o se cambia el tipo, y cómo evolucionar los esquemas sin interrumpir el análisis.

Leer la página

Elegir columnas de partición

Utilice columnas de partición para hacer que las consultas Telemetry selectivas analicen menos datos.

Leer la página

Consultando JSON anidado

Consulta los campos JSON anidados y de nivel superior en Telemetry utilizando nombres de columnas de puntos estables.

Leer la página

Trabajar con marcas de tiempo

Almacene marcas de tiempo de manera consistente y use SQL para extraer, agrupar, comparar y medir intervalos de tiempo.

Leer la página

CamelCase frente a snake_case

Comprenda por qué Snake_case produce nombres de columna SQL más simples y portátiles para datos de eventos Telemetry.

Leer la página

Eventos estructurados frente a registros de texto

Compare eventos estructurados y registros de texto, incluido cuándo usar cada uno, en qué se diferencian en SQL y cómo evitar la duplicación de telemetría.

Leer la página

Registros, métricas, seguimientos y eventos estructurados

Elija la señal de observabilidad adecuada para depuración, tendencias, rutas de solicitud y flujos de trabajo empresariales sin recopilar datos redundantes.

Leer la página

Diseñar un esquema de evento

Cree nombres de eventos estables y campos escritos para SQL, paneles, alertas y evolución de esquemas confiables.

Leer la página

Campos de alta cardinalidad

Utilice ID de usuario, ID de solicitud, URL y otros campos de eventos de alta cardinalidad deliberadamente en SQL, paneles y particiones.

Leer la página

ID de correlación para eventos estructurados

Conecte solicitudes, trabajos, webhooks y seguimientos con identificadores de correlación seguros y, al mismo tiempo, evite datos confidenciales y uniones inestables.

Leer la página

Eliminar datos sensibles de los eventos

Evite que secretos, datos personales y contenido sin procesar de los clientes entren en eventos estructurados con listas permitidas y controles a nivel de límites.

Leer la página

Referencia de DataFusion SQL para Telemetry

Escriba tablas de eventos prácticas DataFusion SQL para Telemetry utilizando filtros de tiempo, agregados condicionales, percentiles, ventanas, uniones y proporciones seguras.

Leer la página

Entrega de eventos, idempotencia y manejo de duplicados

Diseñe productores de eventos estructurados para reintentos, entrega duplicada, identidad de eventos estable y fallas de ingesta medibles.

Leer la página

Procesamiento por lotes, contrapresión y cierre controlado

Elija tamaños de lote seguros, colas de telemetría vinculadas, controle la sobrecarga y vacíe o persista los eventos pendientes durante el cierre de la aplicación.

Leer la página

Estrategias de muestreo de eventos para Telemetry estructurado

Reduzca el volumen de telemetría sin invalidar tarifas, percentiles, investigaciones de incidentes o análisis de impacto en el cliente.

Leer la página

Modelado de identidad multiinquilino para análisis de eventos

Modele cuentas, usuarios, sesiones, visitantes anónimos y límites de inquilinos sin mezclar semántica de identidad ni exponer datos personales.

Leer la página

Alertas

Cree alertas de umbral comprensibles a partir de gráficos de tiempo de una sola serie en Explorar y consultar resultados.

Leer la página

Tipos de datos de eventos y valores nulos

Elija campos estables de cadena, numéricos, booleanos, de marca de tiempo y de eventos anidados para que los esquemas evolucionen sin romper SQL.

Leer la página

Retención y eliminación de datos

Planifique la retención de tablas, la eliminación selectiva, la eliminación de toda la tabla y la verificación de datos de eventos estructurados.

Leer la página

Eventos amplios canónicos

Diseñe eventos canónicos amplios que capturen una unidad de trabajo completada con el contexto necesario para SQL, depuración, paneles y análisis de agentes.

Leer la página

Agregación condicional SQL

Utilice expresiones CASE con COUNT, SUM y AVG para calcular tasas, segmentos y resultados operativos a partir de datos de eventos estructurados.

Leer la página

Agrupación de eventos en intervalos de tiempo con SQL

Agrupe eventos estructurados en intervalos UTC completos con date_trunc o date_bin, luego compare tasas y volumen sin errores de segmento parcial.

Leer la página

Percentiles de latencia y distribuciones con SQL

Calcule los valores aproximados de p50, p95 y p99 en DataFusion SQL e interprete la latencia de la cola sin ocultar el volumen ni la forma de distribución.

Leer la página

Funciones de ventana SQL para analizar eventos

Utilice LAG, ROW_NUMBER y agregados enmarcados para comparar períodos, deduplicar eventos y calcular líneas de base móviles sin perder detalles de filas.

Leer la página

Eliminación de eventos estructurados duplicados con SQL

Defina la identidad del evento y use ROW_NUMBER para eliminar entregas duplicadas sin colapsar accidentalmente los reintentos válidos ni las acciones repetidas del usuario.

Leer la página

Análisis de embudo SQL

Cree embudos de productos a nivel de cuenta con hitos condicionales, pedidos explícitos, una ventana de cohorte y denominadores de conversión que sigan siendo revisables.

Leer la página

Análisis de retención de cohortes con SQL

Mida si los usuarios o las cuentas regresan después de un hito inicial manteniendo explícitas las fechas de la cohorte, las ventanas de actividad, las identidades y los períodos incompletos.

Leer la página

Guías para producción

Implemente flujos de trabajo completos de productos, confiabilidad, inteligencia artificial, facturación, bases de datos, seguridad y generación de informes.

Guía de registro estructurado

Diseñe eventos de aplicaciones estructurados que sean seguros de recopilar, fáciles de consultar con SQL y útiles para paneles, depuración y decisiones de productos.

Leer la página

Telemetría de aplicaciones: guía práctica

Diseñe aplicaciones de telemetría que conecten eventos, registros, métricas y seguimientos estructurados con alertas, paneles y paneles SQL confiables.

Leer la página

Seguimiento de costes de la API de OpenAI por modelo y función

Realice un seguimiento de los costos de OpenAI API por modelo, característica, equipo y resultado. Copie un formulario de evento listo para producción y una consulta SQL, luego concilie las estimaciones con su factura.

Leer la página

Evalúe agentes de IA con eventos estructurados y SQL

Diseñe eventos de evaluación de agentes de IA, combine calidad con costo y confiabilidad, y compare lanzamientos con SQL revisables y denominadores explícitos.

Leer la página

Monitoreo de seguridad del agente de IA con eventos estructurados

Supervise la autorización de herramientas de agentes, denegaciones de políticas, aprobaciones humanas y resultados de terminales con eventos acotados y SQL revisables.

Leer la página

Conecte los seguimientos de GenAI del OpenTelemetry a los eventos de resultados

Correlacione los seguimientos de IA generativa de OpenTelemetry con eventos de resultados compactos de Telemetry sin copiar indicaciones, cargas útiles de herramientas ni intervalos completos.

Leer la página

Pruebas A/B de ingresos

Compare los ingresos por visitante expuesto entre las variantes del experimento y cuantifique el aumento sin dejarse engañar por un tráfico desigual.

Leer la página

Monitoreo del tiempo de actividad del sitio web

Registre comprobaciones de latidos programadas para medir el tiempo de actividad, investigar incidentes y alertar sobre fallas repetidas.

Leer la página

Observabilidad de procesos de trabajo en cola

Supervise la profundidad de la cola y la latencia de la cola en conjunto para detectar retrasos, trabajadores atascados y retrasos en el procesamiento visibles para el usuario.

Leer la página

Visualizando distribuciones

Utilice percentiles para revelar valores típicos, colas largas y segmentos de clientes de alto valor que un único promedio puede ocultar.

Leer la página

Medición de tasas de conversión con SQL

Instrumente los hitos del embudo y calcule las tasas de conversión a nivel de usuario para que pueda localizar la baja sin contar dos veces los eventos repetidos.

Leer la página

Análisis de errores del servidor web

Capture el estado, la ruta, la publicación y el contexto de la solicitud para que los picos de error conduzcan a una regresión específica en lugar de un recuento genérico.

Leer la página

Análisis del rendimiento de la ejecución de código

Registre la duración de los pasos y el contexto de ejecución para encontrar cuellos de botella, comparar ejecuciones y priorizar el trabajo de rendimiento.

Leer la página

Exportación de resultados de consultas

Elija exportaciones síncronas de JSON o asincrónicas de JSON y Parquet, realice sondeos de forma segura y conserve el contexto de consulta para generar informes posteriores.

Leer la página

Entrega de alertas y solución de problemas

Verifique las consultas de alerta Telemetry, los períodos de tiempo, los umbrales, los destinatarios, el historial de evaluación y la entrega de correo electrónico sin crear páginas ruidosas.

Leer la página

Solución de problemas de ingesta de eventos

Diagnostique eventos Telemetry faltantes o rechazados comprobando las respuestas de HTTP, el alcance de la clave API, la forma de la carga útil, la normalización de la tabla, las marcas de tiempo, los esquemas, los reintentos y la actualización.

Leer la página

Solución de problemas de consultas SQL

Depure Telemetry SQL sistemáticamente comprobando la respuesta de API, el esquema de la tabla, la sintaxis de DataFusion, los tipos de campo, las ventanas de tiempo, las uniones, las tasas y el estado de exportación asíncrona.

Leer la página

Respuesta a incidentes con SQL

Utilice un flujo de trabajo repetible SQL para determinar el alcance de un incidente, identificar rutas y liberaciones afectadas, crear un cronograma y verificar la recuperación de eventos estructurados.

Leer la página

Monitoreo de confiabilidad de bases de datos con SQL

Instrumente eventos seguros de bases de datos a nivel de aplicación y utilice SQL para investigar huellas digitales de consultas lentas, contención de grupos, reversiones, bloqueos, retrasos en la replicación y migraciones.

Leer la página

Migrar de registros ad hoc a eventos estructurados y SQL

Mueva un flujo de trabajo de producción desde una búsqueda de registros de formato libre a eventos estructurados limitados, SQL probados, paneles y alertas sin necesidad de una arriesgada transición todo a la vez.

Leer la página

Monitoreo de confiabilidad frontend con SQL

Instrumente eventos de rendimiento del navegador escritos y use SQL para comparar Core Web Vitals por ruta y lanzamiento sin recopilar contenido de página sin procesar.

Leer la página

Proxy de telemetría del navegador y Core Web Vitals

Recopile eventos del navegador que tengan en cuenta la privacidad y Core Web Vitals a través de un servidor proxy de velocidad limitada sin exponer una clave Telemetry API.

Leer la página

Plan de seguimiento de eventos y gobernanza

Cree un plan de seguimiento de eventos con grano explícito, propiedad, campos, privacidad, validación, retención y dependencias posteriores de SQL.

Leer la página

Prueba la instrumentación de Telemetry en CI

Pruebe contratos de eventos estructurados, límites de privacidad, fallas de entrega y resultados de SQL en CI sin enviar datos de producción o dependiendo de un API en vivo.

Leer la página

Utilice Telemetry con OpenTelemetry

Utilice eventos de resultados Telemetry junto con seguimientos, métricas y registros de OpenTelemetry con ID de correlación segura y límites de señal explícitos.

Leer la página

Monitoreo de confiabilidad Kubernetes con SQL

Utilice eventos de carga de trabajo estructurados Kubernetes y SQL para investigar reinicios de contenedores, pérdida de preparación, cambios de implementación e impacto en las aplicaciones.

Leer la página

Análisis de auditoría de seguridad con SQL

Diseñe eventos de acción privilegiada limitados y utilice SQL para revisar denegaciones, fallas y colas de revisión humana sin exponer secretos.

Leer la página

Análisis del recorrido del producto con SQL

Modele los hitos del producto ordenado y utilice SQL para medir la finalización del recorrido de la sesión y el abandono paso a paso con reglas de conteo explícitas.

Leer la página

Gestión del coste y el volumen de telemetría

Mida el recuento de eventos, los bytes de carga útil, la tasa de rechazo, la retención y la cardinalidad antes de cambiar un contrato de recopilación de telemetría.

Leer la página

Análisis de impacto del cliente con SQL

Conecte incidentes con eventos de impacto de cuentas seguros para la privacidad y use SQL para contar las cuentas afectadas, el porcentaje afectado y la duración del impacto por plan.

Leer la página

Evaluación RAG con SQL

Versione los eventos de evaluación de RAG y utilice SQL para comparar la relevancia de la recuperación, las respuestas fundamentadas, la latencia y el costo en todas las versiones del canal.

Leer la página

Análisis de implementación de funciones con SQL

Compare cohortes de control e implementación con SQL utilizando asignación de funciones estable, contexto de lanzamiento, volumen de solicitudes, errores y latencia.

Leer la página

SQL para observabilidad y análisis de eventos

Descubra cómo los eventos estructurados se convierten en datos de observabilidad listos para SQL, qué contratos de eventos funcionan, cómo consultarlos y dónde debe complementar SQL los registros, las métricas y los seguimientos.

Leer la página

Enviar informes SQL programados a Slack

Ejecute una consulta Telemetry SQL según una programación, formatee el resultado como un mensaje de Slack conciso, proteja las credenciales de webhook y haga que los errores de entrega sean observables.

Leer la página

Migrar consultas LogQL, KQL y SPL a SQL

Traduzca patrones de análisis comunes de LogQL, Kusto Query Language y Splunk SPL a SQL revisables sin asumir que los lenguajes o modelos de datos son idénticos.

Leer la página

Demostración de observabilidad de SaaS de extremo a extremo

Ejecute un pequeño flujo de trabajo SaaS de Node.js que emita eventos estructurados, consulte la tabla resultante con SQL y convierta un contrato de evento en vistas de confiabilidad, producto y costos.

Leer la página

Mide el rendimiento de ingesta y consultas de Telemetry

Ejecute una prueba comparativa Telemetry API limitada y reproducible, separe la sincronización del cliente del comportamiento del servicio, publique las condiciones de prueba y evite afirmaciones de rendimiento no respaldadas.

Leer la página

Monitoreo de presupuesto de errores, SLI y SLO con SQL

Defina indicadores de servicio basados en solicitudes, calcule el cumplimiento de SLO y el presupuesto de errores, y cree alertas de confiabilidad revisables con SQL.

Leer la página

Explore eventos estructurados sin comenzar desde SQL

Inspeccione muestras de eventos, aplique filtros escritos, agregue campos, cree gráficos y promueva un resultado de Explore revisado en un panel o alerta.

Leer la página

SQL asistido por IA: generar, revisar y validar consultas

Convierta una pregunta de evento enfocada en DataFusion SQL editable y luego revise los supuestos del esquema, la lógica de conteo, los límites de privacidad y la validez de los resultados.

Leer la página

Consultas guardadas, historial, favoritos y colaboración

Organice el SQL revisado en espacios de trabajo de equipo, conserve el historial de consultas, utilice favoritos personales y promueva resultados estables en paneles y alertas compartidos.

Leer la página

Proxy seguro de telemetría para aplicaciones móviles

Enrute eventos de React Native, Swift, Kotlin y Flutter a través de un proxy de servidor autenticado que mantiene las claves de ingesta fuera de los binarios de las aplicaciones.

Leer la página

Cómo evalúa Telemetry las alertas de SQL

Vea cómo Telemetry evalúa el SQL guardado, selecciona puntos, agrega valores, registra transiciones de estado e intenta la entrega de correo electrónico.

Leer la página