Inspector de contexto de trazas

Pega un valor traceparent o un bloque de cabeceras para revisar los identificadores y el muestreo. Genera después un contexto raíz o hijo para depurar la propagación.

Se ejecuta localmente en tu navegador
Esta herramienta procesa todos los datos localmente en tu navegador.
Cabeceras de trazasPega un bloque de cabeceras o un valor traceparent.

Las cabeceras de trazado y baggage pueden exponer contexto de servicios o clientes. Revisa los valores antes de copiarlos en tickets.

Entradas de tracestate
Todavía no hay entradas de tracestate.
Entradas de baggage
Todavía no hay entradas de baggage.

Cómo inspeccionar un contexto de trazas

Pega un valor traceparent o un bloque de cabeceras y la página lee el contexto de trazas W3C que contienen: el trace ID, el ID del span padre, la marca de muestreo, cada miembro de tracestate y cada entrada de baggage. Los valores se comprueban contra las reglas de formato de las especificaciones W3C Trace Context y Baggage, no contra un servicio en ejecución.

El mismo panel vuelve a escribir las cabeceras de propagación. Generar contexto hijo conserva el trace ID y emite un nuevo ID de span padre; Generar contexto raíz inicia una traza nueva; ambos mantienen las líneas tracestate y baggage originales. Todo se ejecuta en el navegador —las cabeceras pegadas no se suben— y el bloque generado queda listo para curl, un registro o un informe de error.

  1. Pega un bloque de cabeceras (traceparent, tracestate, baggage) o un valor traceparent suelto y pulsa Inspeccionar contexto; Cargar ejemplo rellena una muestra si quieres ver antes la forma de la salida.
  2. Lee el resumen: versión, trace ID, ID del span padre, estado de muestreo y número de entradas de tracestate y baggage, seguido de la lista de hallazgos.
  3. Pulsa Generar contexto hijo para conservar el trace ID con un nuevo ID de span padre, o Generar contexto raíz para empezar una traza nueva; el bloque de cabeceras salientes aparece debajo.
  4. Usa Copiar para el bloque generado y Limpiar para reiniciar la entrada, el resumen y ambas tablas.

Qué revisa el inspector, campo por campo

La comprobación de traceparent, regla por regla

Un traceparent son cuatro campos separados por guiones: una versión de dos dígitos hex en minúsculas, un trace ID de 32 hex, un ID de span padre de 16 hex y un campo de flags de dos hex. La versión ff está reservada y se rechaza; la versión 00 debe tener exactamente cuatro campos, mientras que las versiones superiores pueden añadir campos y se aceptan por compatibilidad futura. Ambos IDs deben ser hex en minúsculas y no pueden ser todo ceros; el estado de muestreo se lee del primer bit de los flags: 01 significa muestreado y 00 no muestreado.

Un bloque con dos líneas traceparent se rechaza: la especificación exige exactamente una. Los nombres de cabecera se comparan sin distinguir mayúsculas, así que Traceparent: funciona igual que traceparent:, y los valores se comparan de forma exacta: un ID en mayúsculas, un trace ID de 31 caracteres, un campo ausente o un sufijo extra fallan cada uno con el motivo que nombra el campo roto.

tracestate y baggage, entrada por entrada

tracestate es una lista separada por comas de pares clave=valor. Cada clave debe seguir la gramática W3C —una clave simple en minúsculas como acme, o una clave tenant@system— y la lista admite como máximo 32 miembros. La tabla muestra cada entrada, marca los pares mal formados, señala una clave que se repite y avisa cuando la lista supera el límite. Los valores en sí son datos del proveedor y se muestran tal como llegaron, sin interpretarlos.

Las entradas de baggage usan claves con formato de token HTTP y pueden añadir metadatos tras un punto y coma. Las claves que no son tokens válidos se señalan, y una comprobación por palabras clave resalta las entradas cuya clave o valor menciona secret, token, password, correo, authorization, cookie, session o user. Es un recordatorio para revisar antes de compartir un bloque: no es un escaneo de seguridad, no puede saber si un valor es realmente sensible y los valores de baggage se imprimen tal como aparecen, sin decodificar el porcentaje.

Generar contexto y lo que la herramienta no hace

Generar contexto hijo vuelve a leer la entrada primero, después conserva el trace ID, crea un nuevo ID de span padre aleatorio y mantiene los flags, el tracestate y el baggage originales: es el conjunto de cabeceras que recibiría un servicio posterior. Generar contexto raíz crea un trace ID y un ID de span padre nuevos y aleatorios con la marca de muestreo activada: es el conjunto con el que arranca una traza nueva.

Esto es un inspector de las cabeceras W3C, no un backend de trazas: no puede saber si un trace ID existe en tu colector y no analiza formatos B3, Zipkin, Jaeger ni propagación propia de un proveedor. La entrada nunca sale del navegador, la página sigue funcionando sin conexión una vez cargada y la herramienta no envía las cabeceras a ningún servidor.

Herramientas recientes: