Gérer les erreurs
Consultez les exceptions regroupées de l'APM, marquez-les comme nouvelles, connues, résolues ou ignorées, et fermez leur incident avec « Déclarer une correction ».
Sur cette page
L'APM regroupe les exceptions identiques en une seule erreur : même type, même message (sans les données qui changent) et même point du code. Au lieu de mille lignes répétées, vous voyez une erreur avec son nombre d'occurrences, depuis quand elle existe, dans quelle version et une trace d'exemple.
Avant de commencer
L'autorisation Consulter sur le module APM pour consulter. Pour modifier l'état d'une erreur, l'autorisation Opérer.
Consulter les erreurs
Allez dans APM → Erreurs.
Choisissez l'État (Tous, Nouveaux, Connus, Résolus ou Ignorés) et la Période.
Pour chaque erreur, consultez :
Erreur : le type d'exception, son message et l'endpoint où elle s'est produite.
Service, Sur la période et Total.
Vu : la dernière fois et depuis quand elle existe.
Version : la dernière version où elle est apparue et, si elle a changé, depuis quelle version.
Appuyez sur Trace pour voir une requête réelle qui a échoué avec cette erreur.
Depuis la fiche d'un service, onglet Erreurs et journaux, le bouton Voir tout ouvre cette page filtrée sur ce service. Pour retirer le filtre, appuyez sur Voir tout dans le message du haut.
Les états d'une erreur
État | Quand l'utiliser |
|---|---|
Nouveau | Apparue ou réapparue récemment. C'est l'état à l'arrivée |
Connu | Vous l'avez déjà vue et quelqu'un s'en occupe |
Résolu | Vous l'avez corrigée. Elle passe aussi dans cet état quand son incident est fermé. Si elle réapparaît, elle repasse automatiquement à Nouveau et déclenche une nouvelle notification |
Ignoré | Elle ne nécessite aucune action (par exemple, une erreur de validation attendue) |
Pour le modifier, choisissez l'état dans la liste de la colonne État.
Erreurs et incidents
Une erreur nouvelle ouvre un incident dans le Noyau, sauf pendant la première demi-heure d'un service tout juste apparu (pour ne pas notifier ce qui échouait déjà avant son instrumentation).
Une erreur qui était Résolue et qui réapparaît déclenche Une erreur est réapparue et ouvre un nouvel incident (ou s'ajoute à l'incident s'il est toujours ouvert).
Dans le service de ARGUNIS lui-même, la session expirée et le mot de passe ou le code de vérification incorrects à la connexion ne comptent pas comme erreurs (ils figurent déjà dans le journal d'audit).
Si les alertes du service sont en sourdine, aucun incident n'est ouvert.
Les incidents d'erreurs de l'APM ne se ferment pas dès que l'erreur cesse de se produire. Ils se ferment de quatre façons :
Déclarer une correction : la façon recommandée. Ouvrez l'incident dans Noyau → Incidents, appuyez sur Déclarer une correction, décrivez ce qui a été corrigé ou modifié et confirmez. L'incident se ferme, la description est conservée dans son historique et dans le journal d'audit, et la fermeture est notifiée comme un rétablissement.
Nouveau déploiement : si vous déployez une nouvelle version du service (avec un autre
service.version) et que l'erreur ne réapparaît pas dans les 30 minutes qui suivent, ARGUNIS ferme l'incident tout seul et indique la version.Jours sans répétition : si l'erreur ne réapparaît pas pendant les jours de Clôturer les erreurs qui ne se répètent pas (jours) (2 par défaut ; réglable dans les seuils de l'entreprise ou du service), ARGUNIS ferme l'incident tout seul, avec la note « résolu : l'erreur ne s'est pas répétée en 2 jours », et notifie la fermeture.
Taux d'erreurs normal : l'incident « Erreurs dans … » (taux au-dessus du seuil) se ferme tout seul quand le taux est sous le seuil depuis 30 minutes.
Les erreurs client (HTTP 4xx, comme 404 ou 409) restent dans APM → Erreurs et comme événement, mais n'ouvrent pas d'incident.
Résoudre manuellement depuis l'incident.
Quand l'incident est fermé, de quelque façon que ce soit, l'erreur passe à Résolu dans cette liste (sauf si elle est Ignorée). Ainsi, si elle réapparaît, ARGUNIS la détecte comme une réapparition et ouvre un nouvel incident.
L'inverse ne fonctionne pas : marquer l'erreur comme Résolue dans APM → Erreurs ne ferme pas son incident. L'état de l'erreur organise la liste de l'APM ; l'incident se ferme depuis le Noyau.