Ordinare e confrontare i livelli di log per gravità

Questa capacità applica la progressione convenzionale da trace a fatal, ordina l’elenco fornito da Lei e confronta due livelli nella stessa richiesta. Restituisce nomi normalizzati in minuscolo, l’ordine di riferimento completo e una relazione esplicita adatta a script, test, dashboard e strumenti di documentazione. I nomi sconosciuti generano un errore chiaro, senza essere indovinati né collocati silenziosamente a un’estremità del risultato.

Adotti un’unica scala convenzionale di gravità

La capacità usa l’ordine crescente ampiamente riconosciuto trace, debug, info, warn, error, fatal. Trace rappresenta gli eventi diagnostici più dettagliati, mentre fatal indica guasti tanto gravi da arrestare un processo o renderlo inutilizzabile. Inserisca i livelli rilevati nell’array <code>levels</code>. Il risultato include <code>sorted_levels</code>, dal meno al più grave, e <code>severity_order</code> come riferimento completo. I valori ripetuti vengono conservati perché possono rappresentare voci reali di una configurazione, un campione o un rapporto. L’ordinamento è stabile per valori uguali. Gli spazi esterni vengono rimossi, il confronto non distingue maiuscole e i nomi tornano in minuscolo canonico. Il vocabolario è volutamente ristretto: notice, verbose, warning, critical o emergency sono rifiutati. Questi nomi appartengono ad altre convenzioni e non possono essere inseriti nella scala senza una scelta politica da parte Sua. Il rifiuto esplicito rende visibili gli errori prima che compromettano i filtri o la gestione degli incidenti.

Legga il risultato del confronto

Fornisca <code>first</code> e <code>second</code> per confrontare due livelli insieme all’ordinamento. La risposta normalizza entrambi gli operandi e riporta una <code>relation</code> dalla prospettiva del primo. <code>more_severe</code> significa che il primo appare più avanti nell’ordine standard; <code>less_severe</code> che appare prima; <code>equal</code> che entrambi indicano lo stesso livello. Il valore con segno <code>rank_difference</code> offre la distanza precisa: un numero positivo favorisce il primo, uno negativo il secondo e zero rappresenta l’uguaglianza. Se gli operandi differiscono, <code>more_severe</code> indica direttamente il vincitore, evitando al client un secondo confronto. Se sono uguali, il campo viene omesso invece di assumere null. Il formato è adatto ad asserzioni e automazioni condizionali. Per esempio, warn confrontato con error produce una differenza negativa e identifica error come più grave. ERROR confrontato con error diventa uguale dopo la normalizzazione, rendendo innocue le differenze di maiuscole senza indebolire la convalida del vocabolario.

Applichi la classificazione in sicurezza nello sviluppo

La classificazione della gravità è utile quando una configurazione testuale deve diventare una decisione inequivocabile. Un visualizzatore di log può ordinare i filtri prima di mostrarli. Un controllo di distribuzione può verificare che la soglia di produzione sia almeno warn. Un generatore di documentazione può presentare i livelli coerentemente anche se il file sorgente li elenca senza ordine. I test di monitoraggio possono confrontare la soglia configurata con il minimo richiesto e bloccare una versione prima della produzione. La funzione è deterministica e non effettua richieste di rete, quindi lo stesso input produce sempre lo stesso output nel browser e tramite API. Questo strumento classifica nomi: non analizza righe di log, non deduce il livello dal messaggio e non converte schemi incompatibili come syslog ed etichette personalizzate. Se il Suo sistema usa notice, critical, panic, off o numeri, li converta secondo la Sua politica documentata. Rifiutare gli input sconosciuti impedisce che un refuso nasconda eventi importanti senza alcun avviso.