Trazas

Una traza es una solicitud, seguida a través de cada servicio que toca. Cada paso es un span: una llamada HTTP, una consulta a la base de datos, una llamada a otro servicio. Las trazas te muestran en qué gastó el tiempo una solicitud lenta y dónde falló una con errores.

Abre Observability → Trazas en tu página de estado. Cada fila es una solicitud.

El explorador de trazas, con la duración de las solicitudes a lo largo del tiempo y una fila por solicitud

Las trazas llegan cuando tu app las envía: marca Trazas al copiar el prompt de configuración, o usa la autoinstrumentación.

Lee el gráfico

Cada punto es una solicitud, colocado según cuándo ocurrió y cuánto tardó. Los puntos rojos fallaron. Encima del gráfico:

  • Trazas: cuántas solicitudes encontró la búsqueda.
  • Errores: cuántas fallaron y qué proporción son.
  • p50, p95, p99: la mitad, el 95 % y el 99 % de las solicitudes fueron más rápidas que esto.

Arrastra sobre el gráfico para ampliar una ventana de tiempo.

Encuentra solicitudes lentas y con errores

Usa el cuadro de búsqueda como en la página Logs. Estos filtros están pensados para trazas:

FiltroEncuentra
status:errorSolicitudes que fallaron
duration:>1sSolicitudes de más de un segundo. También >500ms, <100ms
service:apiSolicitudes atendidas por un servicio
span.name:Spans con un nombre concreto, como GET /v1/users
Cualquier atributoComo http.route: o http.response.status_code:

El texto libre busca en los nombres de los spans. Spans raíz está activado por defecto, así que cada solicitud aparece una vez. Desactívalo para listar cada span por separado.

El botón de descarga exporta la lista en CSV.

Abre una traza

Haz clic en una fila. La traza se abre con cada span en una línea de tiempo, anidado bajo el span que lo llamó. Las barras largas son donde se fue el tiempo.

Una traza que cruza tres servicios, con una llamada lenta a Okta al final de la cascada

En este ejemplo, cargar una página tarda 842 ms. La cascada muestra por qué: web llama a api, api llama a sso y sso espera 468 ms a Okta.

  • Haz clic en un span para ver sus atributos, como la ruta, el código de estado o la consulta a la base de datos.
  • N logs de este span abre los logs escritos durante ese span.
  • N logs arriba abre cada log de la solicitud, en todos los servicios.
  • Copiar ID de traza copia el ID, para compartirlo o buscarlo con trace_id:.
  • Usa ↑ ↓ o J K para pasar a la traza anterior o siguiente, y Esc para cerrar.

Arregla una solicitud con errores

Los spans que fallaron están en rojo. Solo errores oculta los que funcionaron, para que el fallo destaque en una traza larga.

Una solicitud fallida, con los spans con error en rojo y un botón para copiar un prompt que la arregle

Copiar prompt para corregir copia una descripción de la solicitud fallida: los spans, sus errores y atributos. Pégala en tu agente de programación, en el proyecto de tu app, y tendrá lo que necesita para encontrar la causa.