Instrumentar un servicio en producción
Pase de un evento verificado a procesamiento por lotes, manejo de apagado, revisión de privacidad y una lista de verificación de producción.
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
Pase de un evento verificado a procesamiento por lotes, manejo de apagado, revisión de privacidad y una lista de verificación de producción.
Elija el grano del evento, los tipos de campos estables, los identificadores de correlación, el límite de privacidad y la estrategia de evolución.
Conozca el modelo de consulta, pruebe patrones analíticos comunes y promueva los resultados revisados en paneles y alertas.
Pase de la exploración en una sola tabla a consultas guardadas revisadas, espacios de trabajo compartidos, paneles y alertas.
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.
Pase de mensajes de formato libre y lenguajes de consulta de proveedores a eventos acotados y SQL inspeccionables por etapas.
Separe los errores de ingesta, esquema, consulta, alerta y entrega posterior antes de cambiar la instrumentación.
Cree una clave, envíe y verifique el primer evento, escriba SQL y finalice la lista de verificación de producción inicial.
Envíe un evento estructurado, inspeccione su tabla, consúltelo con SQL y convierta el resultado en un panel o alerta.
Leer la páginaCree 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áginaConfirme 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áginaConsulte 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áginaPromueva 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áginaRevise 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áginaCree, 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áginaOrganice 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áginaRevise 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áginaUtilice JavaScript, Python, Rust, Go, Ruby, PHP o cURL del lado del servidor con entrega explícita y límites de credenciales.
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áginaUtilice 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áginaInicialice 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áginaInicialice 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áginaEnví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áginaEnví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áginaEnvíe eventos, inspeccione esquemas, ejecute SQL, exporte Parquet y maneje fallas de Telemetry HTTP de forma segura con cURL.
Leer la páginaEnví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áginaEnví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áginaRevise los contratos de solicitud y respuesta para ingesta, consultas, paneles, alertas, tablas, eliminación, límites de velocidad y errores.
Ingerir eventos estructurados JSON en Telemetry a través de HTTP API.
Leer la páginaEjecute consultas SQL y exportaciones asíncronas con sus datos Telemetry.
Leer la páginaEnumere, cree, actualice y elimine paneles Telemetry con HTTP API.
Leer la páginaEnumere, cree, actualice y elimine alertas de umbral Telemetry con HTTP API.
Leer la páginaInspeccione las tablas Telemetry y configure las columnas de retención y partición a través de HTTP API.
Leer la páginaElimine filas o tablas completas a través del punto final de eliminación heredado de Telemetry.
Leer la páginaManeje errores, limitaciones, reintentos, idempotencia y fallas parciales de Telemetry HTTP de manera segura en clientes de ingesta y consulta.
Leer la páginaDescargue y valide la especificación OpenAPI 3.1 de Telemetry para la ingesta de eventos, consultas, tablas, paneles, alertas y eliminación de SQL.
Leer la páginaDiseñe contratos de eventos estables, controle el esquema y la cardinalidad y utilice patrones DataFusion SQL reutilizables.
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áginaCree 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áginaDescubra 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áginaUtilice columnas de partición para hacer que las consultas Telemetry selectivas analicen menos datos.
Leer la páginaConsulta los campos JSON anidados y de nivel superior en Telemetry utilizando nombres de columnas de puntos estables.
Leer la páginaAlmacene marcas de tiempo de manera consistente y use SQL para extraer, agrupar, comparar y medir intervalos de tiempo.
Leer la páginaComprenda por qué Snake_case produce nombres de columna SQL más simples y portátiles para datos de eventos Telemetry.
Leer la páginaCompare 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áginaElija 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áginaCree nombres de eventos estables y campos escritos para SQL, paneles, alertas y evolución de esquemas confiables.
Leer la páginaUtilice ID de usuario, ID de solicitud, URL y otros campos de eventos de alta cardinalidad deliberadamente en SQL, paneles y particiones.
Leer la páginaConecte solicitudes, trabajos, webhooks y seguimientos con identificadores de correlación seguros y, al mismo tiempo, evite datos confidenciales y uniones inestables.
Leer la páginaEvite 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áginaEscriba tablas de eventos prácticas DataFusion SQL para Telemetry utilizando filtros de tiempo, agregados condicionales, percentiles, ventanas, uniones y proporciones seguras.
Leer la páginaDiseñe productores de eventos estructurados para reintentos, entrega duplicada, identidad de eventos estable y fallas de ingesta medibles.
Leer la páginaElija 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áginaReduzca el volumen de telemetría sin invalidar tarifas, percentiles, investigaciones de incidentes o análisis de impacto en el cliente.
Leer la páginaModele cuentas, usuarios, sesiones, visitantes anónimos y límites de inquilinos sin mezclar semántica de identidad ni exponer datos personales.
Leer la páginaCree alertas de umbral comprensibles a partir de gráficos de tiempo de una sola serie en Explorar y consultar resultados.
Leer la páginaElija 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áginaPlanifique 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áginaDiseñ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áginaUtilice expresiones CASE con COUNT, SUM y AVG para calcular tasas, segmentos y resultados operativos a partir de datos de eventos estructurados.
Leer la páginaAgrupe 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áginaCalcule 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áginaUtilice 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áginaDefina 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áginaCree 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áginaMida 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áginaImplemente flujos de trabajo completos de productos, confiabilidad, inteligencia artificial, facturación, bases de datos, seguridad y generación de informes.
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áginaDiseñe aplicaciones de telemetría que conecten eventos, registros, métricas y seguimientos estructurados con alertas, paneles y paneles SQL confiables.
Leer la páginaRealice 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áginaDiseñ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áginaSupervise 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áginaCorrelacione 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áginaCompare 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áginaRegistre comprobaciones de latidos programadas para medir el tiempo de actividad, investigar incidentes y alertar sobre fallas repetidas.
Leer la páginaSupervise 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áginaUtilice percentiles para revelar valores típicos, colas largas y segmentos de clientes de alto valor que un único promedio puede ocultar.
Leer la páginaInstrumente 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áginaCapture 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áginaRegistre 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áginaElija 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áginaVerifique 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áginaDiagnostique 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áginaDepure 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áginaUtilice 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áginaInstrumente 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áginaMueva 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áginaInstrumente 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áginaRecopile 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áginaCree 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áginaPruebe 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áginaUtilice 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áginaUtilice 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áginaDiseñ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áginaModele 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áginaMida 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áginaConecte 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áginaVersione 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áginaCompare 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áginaDescubra 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áginaEjecute 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áginaTraduzca 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áginaEjecute 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áginaEjecute 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áginaDefina 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áginaInspeccione 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áginaConvierta 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áginaOrganice 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áginaEnrute 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áginaVea 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