Diagrama de Sankey de resultados de peticiones API: de endpoints a errores
Sigue las peticiones de una API desde el endpoint hasta la clase de estado y la causa de cada error. Descubre qué endpoints fallan y por qué, y sustituye los recuentos de ejemplo por tus registros.
Un Sankey de resultados de API sigue las peticiones desde el endpoint que las recibió hasta el éxito o una clase de error, y luego divide cada clase de error por causa. Señala el endpoint y la causa que conviene arreglar primero.
El ejemplo tiene un millón de peticiones en cuatro endpoints. De ellas, 920 mil tienen éxito, 60 mil son errores de cliente (4xx) y 20 mil son errores de servidor (5xx). La última columna da la causa de cada error: entrada no válida, token caducado, no encontrado y límite de tasa en el cliente; tiempo de espera, fallo de una dependencia y error de código en el servidor.
Una tasa de errores por endpoint es un solo número. El Sankey conserva el recorrido: Pago tiene la mayor tasa de errores de servidor del ejemplo (7 de 150) e Inicio de sesión la mayor de errores de cliente (22 de 200). Las cifras son inventadas. Usa recuentos de una ventana y di si los reintentos cuentan una vez o cada vez. La misma idea para alertas en lugar de peticiones es /es/sankey/incident-response.
Cómo leer este diagrama
- 920 de 1000 miles de peticiones (92 %) tienen éxito; el 6 % son errores de cliente y el 2 % de servidor.
- Pago tiene la mayor tasa de errores de servidor: 7 de 150 (cerca del 5 %).
- Inicio de sesión tiene la mayor tasa de errores de cliente: 22 de 200 peticiones (11 %). Los tokens caducados causan 20 de los 60 errores de cliente.
- La mitad de los errores de servidor (10 de 20) son tiempos de espera.
Los datos detrás del diagrama
Cifras inventadas con fines ilustrativos. No son datos de ninguna empresa, equipo o sistema reales.
| Desde | Hacia | Cantidad (miles de peticiones) |
|---|---|---|
| Búsqueda | Éxito (2xx) | 370 |
| Búsqueda | Error de cliente (4xx) | 22 |
| Búsqueda | Error de servidor (5xx) | 8 |
| Pago | Éxito (2xx) | 135 |
| Pago | Error de cliente (4xx) | 8 |
| Pago | Error de servidor (5xx) | 7 |
| Inicio de sesión | Éxito (2xx) | 175 |
| Inicio de sesión | Error de cliente (4xx) | 22 |
| Inicio de sesión | Error de servidor (5xx) | 3 |
| Catálogo | Éxito (2xx) | 240 |
| Catálogo | Error de cliente (4xx) | 8 |
| Catálogo | Error de servidor (5xx) | 2 |
| Error de cliente (4xx) | Entrada no válida | 25 |
| Error de cliente (4xx) | Token caducado | 20 |
| Error de cliente (4xx) | No encontrado | 10 |
| Error de cliente (4xx) | Límite de tasa | 5 |
| Error de servidor (5xx) | Tiempo de espera | 10 |
| Error de servidor (5xx) | Fallo de dependencia | 6 |
| Error de servidor (5xx) | Error de código | 4 |
Los mismos datos en CSV
source,target,value
Búsqueda,Éxito (2xx),370
Búsqueda,Error de cliente (4xx),22
Búsqueda,Error de servidor (5xx),8
Pago,Éxito (2xx),135
Pago,Error de cliente (4xx),8
Pago,Error de servidor (5xx),7
Inicio de sesión,Éxito (2xx),175
Inicio de sesión,Error de cliente (4xx),22
Inicio de sesión,Error de servidor (5xx),3
Catálogo,Éxito (2xx),240
Catálogo,Error de cliente (4xx),8
Catálogo,Error de servidor (5xx),2
Error de cliente (4xx),Entrada no válida,25
Error de cliente (4xx),Token caducado,20
Error de cliente (4xx),No encontrado,10
Error de cliente (4xx),Límite de tasa,5
Error de servidor (5xx),Tiempo de espera,10
Error de servidor (5xx),Fallo de dependencia,6
Error de servidor (5xx),Error de código,4Cómo funciona
Exporta una ventana de registros
Toma una hora, un día o una semana, con el endpoint y el código de estado de cada petición.
Agrupa endpoints y códigos de estado
Conserva los cuatro a seis endpoints con más tráfico y agrupa el resto como Otros. Agrupa los códigos de estado por clase.
Añade la causa de cada error
Usa el código o mensaje de error que devuelve tu servicio. Agrupa las causas en cinco a siete etiquetas.
Comprueba el balance
Cada clase de error debe sacar tantas peticiones como entraron. Los éxitos terminan en la segunda columna.
Preguntas frecuentes
¿Hay que mostrar las redirecciones (3xx)?
Solo si importan para tu pregunta. Si no, cuéntalas como éxito, o déjalas fuera y dilo en la nota de datos.
¿Sirve para monitorización en tiempo real?
No. Es una imagen de una ventana fija. Una herramienta de monitorización es mejor para tasas en vivo; el diagrama sirve para explicar de dónde vienen los fallos.
Edita este Sankey de API
Abre el ejemplo como gráfico propio e introduce tus recuentos de peticiones.