Gestionar los errores
Revisa las excepciones agrupadas del APM, márcalas como nuevas, conocidas, resueltas o ignoradas, y cierra su incidente con «Declarar corrección».
En esta página
El APM agrupa las excepciones iguales en un solo error: mismo tipo, mismo mensaje (sin los datos que cambian) y mismo punto del código. En vez de mil líneas repetidas ves un error con cuántas veces ocurrió, desde cuándo, en qué versión y una traza de ejemplo.
Antes de empezar
Permiso Ver en el módulo APM para revisar. Para cambiar el estado de un error, permiso Operar.
Revisar los errores
Entra a APM → Errores.
Elige el Estado (Todos, Nuevos, Conocidos, Resueltos o Ignorados) y el Periodo.
Para cada error revisa:
Error: el tipo de excepción, su mensaje y el endpoint donde ocurrió.
Servicio, En el periodo y Total.
Visto: la última vez y desde cuándo existe.
Versión: la última versión donde apareció y, si cambió, desde qué versión.
Presiona Traza para ver una petición real que falló con ese error.
Desde la ficha de un servicio, pestaña Errores y logs, el botón Ver todos abre esta página filtrada por ese servicio. Para quitar el filtro presiona Ver todos en el aviso de arriba.
Los estados de un error
Estado | Cuándo usarlo |
|---|---|
Nuevo | Recién aparecido o reaparecido. Es el estado con que llega |
Conocido | Ya lo viste y alguien lo está trabajando |
Resuelto | Lo corregiste. También queda así cuando se cierra su incidente. Si vuelve a aparecer, pasa solo a Nuevo y avisa otra vez |
Ignorado | No requiere acción (por ejemplo, un error esperado de validación) |
Para cambiarlo, elige el estado en la lista de la columna Estado.
Errores e incidentes
Un error nuevo abre un incidente en el Núcleo, salvo en la primera media hora de un servicio recién aparecido (para no avisar por lo que ya fallaba antes de instrumentarlo).
Un error que estaba Resuelto y vuelve a aparecer avisa Reapareció un error y abre un incidente nuevo (o se suma al incidente si sigue abierto).
En el servicio de ARGUNIS mismo, la sesión vencida y la contraseña o el código de verificación incorrectos al iniciar sesión no cuentan como error (ya quedan en la auditoría).
Si el servicio tiene las alertas silenciadas, no se abren incidentes.
Los incidentes de errores del APM no se cierran apenas el error deja de ocurrir. Se cierran de cuatro formas:
Declarar corrección: la forma recomendada. Abre el incidente en Núcleo → Incidentes, presiona Declarar corrección, describe qué se corrigió o cambió y confirma. El incidente se cierra, la descripción queda en su historial y en la auditoría, y se avisa el cierre como una recuperación.
Despliegue nuevo: si despliegas una versión nueva del servicio (con otro
service.version) y el error no vuelve a aparecer en los 30 minutos siguientes, ARGUNIS cierra el incidente solo e indica la versión.Días sin repetirse: si el error no vuelve a aparecer en los días de Cerrar errores que no se repiten (días) (por defecto 2; se ajusta en los umbrales de la empresa o del servicio), ARGUNIS cierra el incidente solo, con la nota «resuelto: el error no se repitió en 2 días», y avisa el cierre.
Tasa de errores normal: el incidente «Errores en …» (tasa sobre el umbral) se cierra solo cuando la tasa lleva 30 minutos bajo el umbral.
Los errores de cliente (HTTP 4xx, como 404 o 409) quedan en APM → Errores y como evento, pero no abren incidente.
Resolver a mano desde el incidente.
Cuando el incidente se cierra, por cualquiera de estas formas, el error pasa a Resuelto en esta lista (salvo que esté Ignorado). Así, si vuelve a aparecer, ARGUNIS lo detecta como una reaparición y abre un incidente nuevo.
Al revés no funciona: marcar el error como Resuelto en APM → Errores no cierra su incidente. El estado del error ordena la lista del APM; el incidente se cierra desde el Núcleo.