¿El registro está en logfmt o ya es JSON estructurado?
Convierte logfmt cuando las comillas o claves duplicadas ocultan campos; analiza directamente JSON si ya contiene atributos tipados.
Elysia Tools
Navegación
Guía de flujo de trabajo
Inventaría atributos antiguos, migra convenciones semánticas, comprueba la propagación y revisa una traza real antes de publicar cambios de instrumentación.
¿Nuevo en este flujo? Sigue los pasos en orden, empezando por la primera herramienta abajo. ¿Ya sabes lo que necesitas? Ve directo al paso correspondiente: todas las herramientas de este flujo están en la tabla comparativa.
Primera herramienta: Analizador de logs estructurados
Temas
| Herramienta | Qué hace | Categoría |
|---|---|---|
| Analizador de logs estructurados | Detecta formatos comunes de logs, extrae campos clave e infiere tipos para exportar en JSON, CSV o SQL. | Procesamiento de datos |
| Puente logfmt ↔ JSON para logs estructurados | Convierte logfmt (clave=valor) a JSON o JSON a logfmt, con escape de comillas, coerción de números/booleanos y manejo de claves duplicadas. | Conversión de formatos |
| Herramienta de Migración de Atributos Semantic-Convention v1.20 → v1.27 de OpenTelemetry | Reescribe nombres de atributos de spans/logs entre versiones de convenciones semánticas de OpenTelemetry: http.method → http.request.method, http.status_code → http.response.status_code, http.url → url.full, db.system → db.system.name, messaging.destination → messaging.destination.name y 25+ más — sobre código JS/TS/Python/Go/Java/.NET pegado, YAML del collector o JSON de dashboards de Grafana, con mapa de renombres para el collector, avisos de eliminación/división manual, estadísticas de diff por atributo e informe de atributos no mapeados. |
Temas
| Desarrollo |
| Validador de propagación OpenTelemetry W3C traceparent / tracestate / baggage y cabeceras OTLP | Valida traceparent según la ABNF de W3C Trace Context (versión / trace-id de 16 bytes / parent-id de 8 bytes / trace-flags de 1 byte; rechaza ceros y versión ff, avisa en mayúsculas), tracestate (≤32 miembros, claves simples y tenant@sistema, avisos por duplicados) y baggage (valores percent-codificados con propiedades opacas); comprueba el Content-Type de exportación OTLP y el contexto binario de 25 bytes de grpc-trace-context-bin; correlaciona dos traceparent en un round-trip simulado (estabilidad del trace-id y colisión de span-id hijo aleatorio) y emite cabeceras normalizadas listas para reenviar. | Desarrollo |
| Decodificador de trazas distribuidas y waterfall | Analiza JSON de Jaeger, Zipkin u OpenTelemetry y muestra spans, tiempos y errores en un waterfall | Desarrollo |
| Planificador de presupuesto de latencia de API | Planifica y visualiza un presupuesto de latencia de API. Introduce un objetivo P99 (p. ej. ≤ 300ms) y la asignación por etapa (DNS, TCP, TLS, TTFB, Processing, Network) para ver un waterfall en vivo, la utilización del presupuesto y alertas de exceso. Opcionalmente pega un trace OpenTelemetry o Datadog para deducir una asignación medida. | Desarrollo |
Esta guía está dirigida a quien mantiene un servicio y actualiza sus convenciones semánticas OpenTelemetry, no a quien investiga un incidente abierto. Guarda un registro anterior al cambio, la configuración de instrumentación o del Collector y una petición que cruce al menos dos servicios. Elimina secretos y datos personales. Con structured-log-analyzer identifica los atributos actuales; si el registro está en logfmt, logfmt-to-json-structured-log-bridge ayuda a revelar comillas, conversiones de tipo y claves duplicadas. No conviertas un JSON ya estructurado por rutina. Para decidir qué datos pueden circular entre equipos, consulta pii-log-redaction.
Ejecuta otel-semantic-convention-migration-tool sobre una copia de código, reglas del Collector o consultas de paneles. Anota versión de origen y destino, diferencias, atributos eliminados y campos sin asignación. Su resultado es un borrador, no una actualización de producción. http.target, por ejemplo, puede necesitar una separación consciente entre ruta y consulta en lugar de un reemplazo literal. Valida esos casos con las personas responsables y despliega únicamente el cambio revisado. Comprueba también los paneles: un contador de atributos renombrados no detecta consultas que todavía usan nombres antiguos. La migración sustituye texto conocido, no interpreta la aplicación. Revise el contexto; cambiar una cadena no prueba que la instrumentación o los paneles se hayan migrado.
Entrega ejemplos de traceparent, tracestate, baggage y cabeceras OTLP a opentelemetry-w3c-traceparent-tracestate-baggage-and-otlp-protobuf-headers-propagation-validator. En el salto siguiente debe mantenerse el identificador de traza y cambiar el identificador de span. Esa comprobación no prueba que se hayan emitido spans. Decodifica una exportación posterior con distributed-trace-decoder-waterfall-visualizer y compara servicios, parentesco, errores y duración con la petición prevista. Registra los tramos ausentes sin deducirlos de cabeceras correctas. La revisión valida cabeceras aportadas y puede mostrar tramos hijos simulados. Una correlación sintética no demuestra propagación real. Compare dos cabeceras saneadas de saltos y exija aparte una traza conectada.
Si hay un objetivo de latencia, usa api-latency-budget-planner para contrastar los tiempos observados con las asignaciones por etapa. Una traza indica dónde se consumió tiempo; no equivale a un P99 medido. Conserva junto a la decisión las versiones, el inventario comparado, el resultado de cabeceras, la exportación y los campos pendientes. Si el objetivo real es resolver una incidencia o repetir cargas de una API, cambia a observability-debugging o api-request-replay-and-debugging, respectivamente.
Guía de flujo de trabajo
Analiza un registro depurado anterior al cambio. Convierte logfmt a JSON solo cuando haga falta para ver valores entre comillas y claves repetidas.
Reescribe atributos admitidos desde v1.20, revisa diferencias y reglas propuestas, y separa campos eliminados o no asignados para decisión manual.
La revisión valida cabeceras aportadas y puede mostrar tramos hijos simulados. Una correlación sintética no demuestra propagación real. Compare dos cabeceras saneadas de saltos y exija aparte una traza conectada.
Decodifica una exportación JSON OTel, Jaeger o Zipkin posterior y contrasta servicios, relaciones, errores y tiempos con la ruta prevista.
Convierte logfmt cuando las comillas o claves duplicadas ocultan campos; analiza directamente JSON si ya contiene atributos tipados.
Aplica los nombres propuestos solo tras revisar los atributos eliminados o sin correspondencia, como http.target, antes de modificar reglas del Collector.
Valida cabeceras para continuidad de contexto, comprueba los spans emitidos en la traza y usa un presupuesto de latencia solo si existe un objetivo.
Si existe un objetivo, sitúa los tiempos de cada span frente a las asignaciones acordadas y documenta los tramos excedidos.