Ordenar niveles de registro por severidad y compararlos

Esta capacidad aplica la progresión convencional de trace a fatal, ordena la lista que usted proporcione y compara dos niveles en la misma solicitud. Devuelve nombres normalizados en minúsculas, el orden de referencia completo y una relación explícita útil para scripts, pruebas, paneles y documentación. Los nombres desconocidos producen un error claro, sin conjeturas ni ubicaciones silenciosas en el resultado.

Utilice una única escala convencional de severidad

La capacidad utiliza el orden ascendente ampliamente reconocido trace, debug, info, warn, error, fatal. Trace representa los eventos de diagnóstico más detallados, mientras que fatal identifica fallos capaces de detener un proceso o dejarlo inutilizable. Envíe los niveles encontrados en el arreglo <code>levels</code>. El resultado incluye <code>sorted_levels</code>, desde el menos hasta el más grave, y <code>severity_order</code> como referencia completa. Los valores repetidos se conservan porque pueden corresponder a entradas reales de una configuración, muestra o informe. La ordenación es estable para valores iguales. Los nombres se recortan, se comparan sin distinguir mayúsculas y se devuelven en minúsculas canónicas. El vocabulario es deliberadamente limitado: notice, verbose, warning, critical o emergency se rechazan. Esos nombres pertenecen a otras convenciones y no pueden situarse en esta escala sin que usted defina una política. El rechazo explícito revela errores antes de que afecten al filtrado o a la respuesta ante incidentes.

Interprete el resultado de la comparación

Proporcione <code>first</code> y <code>second</code> para comparar dos niveles además de ordenar la lista. La respuesta normaliza ambos operandos e informa de una <code>relation</code> desde la perspectiva del primero. <code>more_severe</code> indica que el primer operando aparece después en el orden estándar; <code>less_severe</code>, que aparece antes; y <code>equal</code>, que ambos corresponden al mismo nivel. El valor con signo <code>rank_difference</code> expresa la distancia exacta: un número positivo favorece al primero, uno negativo al segundo y cero representa igualdad. Si son distintos, <code>more_severe</code> nombra directamente al ganador y evita repetir la comparación en el cliente. Si son iguales, ese campo se omite en lugar de devolver null. El formato funciona bien en aserciones y automatizaciones condicionales. Por ejemplo, comparar warn con error produce una diferencia negativa e identifica error como más grave. Comparar ERROR con error da igualdad tras normalizar, por lo que las diferencias de mayúsculas no debilitan la validación del vocabulario real.

Aplique la clasificación con seguridad en flujos de desarrollo

Clasificar la severidad resulta útil cuando una configuración textual debe convertirse en una decisión inequívoca. Un visor de registros puede ordenar filtros antes de mostrarlos. Un verificador de despliegue puede confirmar que el umbral de producción sea como mínimo warn. Un generador de documentación puede presentar niveles de manera coherente aunque el archivo de origen los enumere sin orden. Las pruebas de supervisión pueden comparar el umbral configurado con un mínimo requerido y detener una versión antes de producción. La función es determinista y no realiza solicitudes de red, por lo que una misma entrada siempre ofrece la misma salida en el navegador y mediante la API. Esta herramienta clasifica nombres: no analiza líneas de registro, no infiere niveles a partir del mensaje ni traduce entre esquemas incompatibles como syslog y etiquetas personalizadas. Si su sistema usa notice, critical, panic, off o números, conviértalos según su propia política documentada. Rechazar entradas desconocidas evita que una errata oculte accidentalmente eventos importantes.