Tracing
La superficie de Tracing (/tracing, renderizada con el encabezado "Traces") expone las trazas distribuidas ingeridas a través del endpoint OTLP-HTTP de la plataforma. Agrupa cada traza en estado de salud por servicio, aristas de dependencia entre servicios y una lista con búsqueda de trazas recientes. Al profundizar en cualquier traza se abre la vista en cascada a nivel de span.
Endpoint OTLP
Apunte cualquier SDK o Collector de OpenTelemetry a:
POST /api/v1/tracing/v1/traces
El endpoint acepta OTLP-JSON; los spans se persisten y se agregan en el resumen de servicio en cada actualización.
Filtro de Servicio
El menú desplegable Service en el encabezado limita todos los paneles y la lista de trazas a un único servicio. All services (el valor predeterminado) muestra el resumen a nivel de tenant.
Indicadores KPI
Cuatro métricas principales resumen la última hora:
- Services — Servicios distintos que reportan al menos un span
- Throughput — Tasa de ingesta de spans por minuto en todos los servicios de la ventana
- Error rate —
errors / spanscomo porcentaje; se vuelve rojo por encima del 1 por ciento - Apdex — Puntuación Apdex ponderada por span en todos los servicios; se vuelve ámbar por debajo de 0,85
Tabla de Estado de Servicio
Desglose por servicio de métricas de latencia y errores:
| Columna | Descripción |
|---|---|
| Service | Nombre del servicio tal como lo declaran los atributos de recurso del SDK |
| Apdex | Puntuación Apdex por servicio (mayor es mejor, 1,0 es perfecto) |
| p50 | Duración mediana del span en milisegundos |
| p95 | Duración del span en el percentil 95 en milisegundos |
| p99 | Duración del span en el percentil 99 en milisegundos |
| Errors | Tasa de error como porcentaje de spans |
| Throughput | Spans por minuto |
Aristas del Mapa de Servicio
Cada llamada entre servicios extraída de los spans se agrupa en una fila. El mapa muestra el servicio que realiza la llamada, el servicio receptor, el recuento de llamadas, la latencia p95 para esa arista y la tasa de error.
Esta vista responde a la pregunta "qué dependencia es lenta" sin necesidad de renderizar un gráfico.
Endpoints
Un desglose por endpoint de volumen de solicitudes, fallos y latencia. Active Failing only para restringir la tabla a los endpoints que actualmente devuelven errores. Columnas:
- Endpoint — Nombre de la operación / ruta
- Service — Servicio propietario
- Requests — Recuento de solicitudes en la ventana
- Failed — Recuento de solicitudes fallidas
- Error rate —
failed / requestscomo porcentaje - p50 / p95 / p99 — Percentiles de latencia en milisegundos
Trazas Recientes
La tabla inferior lista las trazas más recientes (las más nuevas primero). Columnas:
- Started — Tiempo relativo desde que comenzó la traza
- Root service — Servicio que emitió el span raíz
- Operation — Nombre del span raíz; hacer clic abre la vista de detalle de la traza
- Spans — Recuento total de spans en la traza
- Errors — Recuento de errores de span (aparece un distintivo rojo cuando es distinto de cero)
- Duration — Duración total de la traza de extremo a extremo
Detalle de Traza
Al hacer clic en una traza se abre la vista en cascada: cada span ordenado por tiempo de inicio, con sangría según el padre y tooltips al pasar el cursor con los atributos del span. Úsela para encontrar el span lento o el span que generó el error.
Buenas Prácticas
- Establezca el atributo de recurso
service.namedel SDK de manera consistente en todos los despliegues; el resumen de Estado de Servicio está indexado por él. - Realice un muestreo selectivo en servicios de alto rendimiento (por ejemplo, muestreo basado en cabecera al 10 por ciento) para mantener predecibles el almacenamiento y el costo de ingesta, mientras se conserva cada span de error.
- Utilice el filtro de servicio al analizar un problema reportado por un cliente; la vista de todos los servicios genera más ruido que la vista por servicio cuando se investiga un recorrido de usuario específico.
- El umbral de Apdex puede ajustarse por servicio en la sección Settings si 0,85 no coincide con los SLOs del equipo.