DocumentaciónAyuda

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

  1. Entra a APM → Errores.

  2. Elige el Estado (Todos, Nuevos, Conocidos, Resueltos o Ignorados) y el Periodo.

  3. 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.

  4. 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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  1. 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.

Relacionado

Buscar en Argunis Monitoring

Escribe al menos 2 letras para buscar en Argunis Monitoring.

↑↓ moverse · Enter abrir · Esc cerrar