Classer et comparer la gravité des niveaux de journalisation

Cette capacité applique la progression conventionnelle de trace à fatal, trie la liste que vous fournissez et compare deux niveaux dans la même requête. Elle renvoie les noms normalisés en minuscules, l’ordre de référence complet et une relation explicite exploitable dans vos scripts, tests, tableaux de bord et outils documentaires. Tout nom inconnu déclenche une erreur claire au lieu d’être deviné ou placé silencieusement dans le résultat.

Adoptez une seule échelle conventionnelle de gravité

La capacité suit l’ordre croissant reconnu trace, debug, info, warn, error, fatal. Trace désigne les événements de diagnostic les plus détaillés, tandis que fatal correspond aux défaillances susceptibles d’arrêter un processus ou de le rendre inutilisable. Envoyez les niveaux rencontrés dans le tableau <code>levels</code>. Le résultat contient <code>sorted_levels</code>, du moins grave au plus grave, et <code>severity_order</code> comme référence complète. Les doublons sont conservés, car ils peuvent représenter de véritables entrées d’une configuration, d’un échantillon ou d’un rapport. Le tri reste stable pour les valeurs égales. Les espaces sont retirés, la casse est ignorée et les noms reviennent sous leur forme canonique en minuscules. Le vocabulaire est volontairement strict : notice, verbose, warning, critical ou emergency sont refusés. Ces termes relèvent d’autres conventions et leur conversion exigerait une règle métier définie par vous. Ce refus explicite révèle les erreurs avant qu’elles ne perturbent le filtrage ou la gestion des incidents.

Interprétez le résultat de la comparaison

Renseignez <code>first</code> et <code>second</code> pour comparer deux niveaux pendant le tri. La réponse normalise les deux opérandes et fournit une <code>relation</code> du point de vue du premier. <code>more_severe</code> signifie que le premier apparaît plus loin dans l’ordre standard ; <code>less_severe</code>, qu’il apparaît plus tôt ; et <code>equal</code>, que les deux désignent le même niveau. La valeur signée <code>rank_difference</code> précise l’écart : un nombre positif favorise le premier, un nombre négatif le second et zéro indique l’égalité. Si les niveaux diffèrent, <code>more_severe</code> nomme directement le plus grave et évite au client de refaire le calcul. En cas d’égalité, ce champ est omis plutôt que défini à null. Ce format convient aux assertions et aux automatisations conditionnelles. Ainsi, warn comparé à error produit un écart négatif et désigne error comme plus grave. ERROR comparé à error devient égal après normalisation, sans affaiblir le contrôle du vocabulaire autorisé.

Intégrez le classement sans risque dans vos processus

Le classement par gravité est utile dès qu’une configuration textuelle doit conduire à une décision sans ambiguïté. Un lecteur de journaux peut ordonner les filtres avant de les afficher. Un contrôle de déploiement peut vérifier que le seuil de production est au moins warn. Un générateur documentaire peut présenter les niveaux de façon cohérente même si le fichier source les mélange. Des tests de supervision peuvent comparer le seuil configuré au minimum requis et bloquer une version avant la production. La fonction est déterministe et n’effectue aucune requête réseau : une même entrée donne toujours la même sortie dans le navigateur et via l’API. Cet outil classe des noms ; il n’analyse pas les lignes, ne déduit pas le niveau d’un message et ne convertit pas des systèmes incompatibles comme syslog et des libellés personnalisés. Si votre système utilise notice, critical, panic, off ou des nombres, convertissez-les selon votre politique documentée. Le refus des entrées inconnues empêche une faute de frappe de masquer discrètement un événement important.