Log-Level nach Schweregrad sortieren und vergleichen

Diese Funktion verwendet die übliche Abstufung von trace bis fatal, sortiert Ihre übergebene Liste und vergleicht zwei benannte Stufen in derselben Anfrage. Sie liefert normalisierte kleingeschriebene Namen, die vollständige Referenzreihenfolge und eine eindeutige Beziehung für Skripte, Tests, Dashboards und Dokumentationswerkzeuge. Unbekannte Namen erzeugen einen klaren Fehler, statt erraten oder stillschweigend an einem Ende des Ergebnisses eingeordnet zu werden.

Verwenden Sie eine einheitliche Schweregradskala

Die Funktion nutzt die weithin anerkannte aufsteigende Reihenfolge trace, debug, info, warn, error, fatal. Trace steht für besonders detaillierte Diagnoseereignisse, fatal für Fehler, die einen Prozess anhalten oder unbrauchbar machen können. Übergeben Sie die tatsächlich gefundenen Stufen im Array <code>levels</code>. Das Ergebnis enthält <code>sorted_levels</code> vom geringsten bis zum höchsten Schweregrad sowie <code>severity_order</code> als vollständige Referenz. Wiederholte Werte bleiben erhalten, weil Duplikate echte Einträge einer Konfiguration, Stichprobe oder Auswertung darstellen können. Bei gleichen Werten bleibt die Sortierung stabil. Leerraum wird entfernt, Groß- und Kleinschreibung werden beim Abgleich ignoriert und die Ausgabe verwendet kanonische Kleinbuchstaben. Das Vokabular ist bewusst eng: notice, verbose, warning, critical oder emergency werden abgelehnt. Diese Namen gehören zu anderen Konventionen und lassen sich ohne eine von Ihnen festgelegte Richtlinie nicht eindeutig abbilden. Die ausdrückliche Ablehnung macht Konfigurationsfehler sichtbar, bevor sie Filter oder die Reaktion auf Vorfälle beeinträchtigen.

Verstehen Sie das Vergleichsergebnis

Geben Sie <code>first</code> und <code>second</code> an, um neben der Sortierung zwei Stufen zu vergleichen. Die Antwort normalisiert beide Operanden und meldet eine <code>relation</code> aus Sicht des ersten. <code>more_severe</code> bedeutet, dass der erste später in der Standardreihenfolge steht; <code>less_severe</code>, dass er früher steht; <code>equal</code>, dass beide dieselbe Stufe bezeichnen. Der vorzeichenbehaftete Wert <code>rank_difference</code> nennt den genauen Abstand: Eine positive Zahl spricht für den ersten Operanden, eine negative für den zweiten, null bedeutet Gleichheit. Bei unterschiedlichen Operanden nennt <code>more_severe</code> den höheren direkt, sodass Clients den Vergleich nicht wiederholen müssen. Bei Gleichheit wird das Feld weggelassen und nicht auf null gesetzt. Diese Form eignet sich gut für Assertions und bedingte Automatisierung. Der Vergleich von warn mit error ergibt beispielsweise einen negativen Abstand und nennt error als schwerwiegender. ERROR und error sind nach der Normalisierung gleich, ohne die Prüfung des zulässigen Vokabulars aufzuweichen.

Setzen Sie die Rangfolge sicher in Entwicklungsabläufen ein

Eine Schweregradrangfolge hilft überall dort, wo Textkonfigurationen zu eindeutigen Entscheidungen werden müssen. Eine Loganzeige kann ausgewählte Filter vor der Darstellung ordnen. Eine Bereitstellungsprüfung kann bestätigen, dass der Produktionsschwellenwert mindestens warn ist. Ein Dokumentationsgenerator kann Stufen konsistent darstellen, selbst wenn die Quelldatei sie ungeordnet aufführt. Überwachungstests können den konfigurierten Schwellenwert mit einem erforderlichen Minimum vergleichen und eine Freigabe vor der Produktion stoppen. Die Funktion ist deterministisch und stellt keine Netzwerkanfragen; dieselbe Eingabe liefert daher im Browser und über die API stets dieselbe Ausgabe. Das Werkzeug ordnet Namen, analysiert jedoch keine Logzeilen, leitet keine Stufe aus Nachrichten ab und übersetzt nicht zwischen inkompatiblen Systemen wie syslog und eigenen Bezeichnungen. Verwendet Ihr System notice, critical, panic, off oder Zahlen, ordnen Sie diese zuvor nach Ihrer dokumentierten Richtlinie zu. Unbekannte Eingaben werden absichtlich abgelehnt, damit ein Tippfehler wichtige Ereignisse nicht unbemerkt ausblendet.