Registro

Usos de Spring Boot Commons Logging para un registro integral interno, pero deja abierta la implementación de registro subyacente. Se proporcionan configuraciones predeterminadas para Java Util Logging, Log4J2 y Volver a iniciar sesión. En cada caso, los administradores de registro están preconfigurados para usar la salida de la consola con la opción de enviarla a un archivo.

De forma predeterminada, si se usan Starters, se usa Logback para el registro. También se proporciona un enrutamiento de inicio de sesión adecuado para garantizar el funcionamiento correcto de las bibliotecas dependientes que utilizan Java Util Logging, Commons Logging, Log4J o SLF4J.

Formato del registrador

La salida del registro predeterminada en Spring Boot es similar a la siguiente ejemplo:

2022-10-20 12:40:11.311  INFO 16138 --- [           main] o.s.b.d.f.s.MyApplication                : Iniciando MyApplication usando Java 1.8.0_345 en myhost con PID 16138 16138 (/opt/apps/myapp.jar iniciado por myuser en /opt/apps/)
2022-10-20 12:40:11.330  INFO 16138 --- [           main] o.s.b.d.f.s.MyApplication                : no hay perfil activo establecido, volviendo a 1 perfil predeterminado: "predeterminado"
2022-10-20 12:40:13.056  INFO 16138 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat inicializado con puerto(s): 8080 (http)
2022-10-20 12:40:13.070  INFO 16138 --- [           main] o.apache.catalina.core.StandardService   : Iniciando servicio [Tomcat]
2022-10-20 12:40:13.070  INFO 16138 --- [           main] org.apache.catalina.core.StandardEngine  : Iniciando el motor Servlet: [Apache Tomcat/9.0.68]
2022-10-20 12:40:13.178  INFO 16138 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Inicializando WebApplicationContext incorporado de Sprin
2022-10-20 12:40:13.178  INFO 16138 --- [           main] w.s.c.ServletWebServerApplicationContext : WebApplicationContext raíz: inicialización completada en 1762 ms
2022-10-20 12:40:13.840  INFO 16138 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat se inició en los puertos: 8080 (http) con ruta de contexto ''
2022-10-20 12:40:13.850  INFO 16138 --- [           main] o.s.b.d.f.s.MyApplication                : Started

Se generan los siguientes elementos:

• Fecha y hora: precisión de milisegundos y clasificación sencilla.

• Nivel de registro: ERROR, WARN, INFO, DEBUG o TRACE.

• ID de proceso.

• Separador --- para separar el comienzo de los mensajes de registro reales.

• Nombre de transmisión: adjunto entre corchetes (se puede truncar para la salida de la consola).

• Nombre del administrador de registros: normalmente el nombre de la clase original (a menudo abreviado).

• Mensaje de registro.

Salida de la consola

En la configuración de registro predeterminada, los mensajes se reflejan en la consola a medida que se escriben. De forma predeterminada, los mensajes en los niveles ERROR, WARN e INFO se escriben en el registro. También puede habilitar el modo "depuración" ejecutando la aplicación con el indicador --debug.

$ java -jar myapp.jar --debug

Si el modo de depuración está habilitado, se configura un conjunto de administradores de registro principales (contenedor integrado, Hibernate y Spring Boot) para generar información adicional. Habilitar el modo de depuración configura la aplicación para registrar todos los mensajes en el nivel DEBUG.

También puede habilitar el modo "rastreo" ejecutando la aplicación con el de marca --trace (o trace=true en el archivo application.properties). Esto le permite registrar registros de seguimiento para varios de los principales administradores de registros (el contenedor integrado, la generación de esquemas de Hibernate y todo el portafolio de Spring).

Salida resaltada en color

Si el terminal admite ANSI, esto se utiliza para facilitar la lectura de la salida en color. Puede instalar spring.output.ansi.enabled en valor admitido para anular la detección automática.

La codificación de color se configura utilizando la palabra de conversión %clr . En su forma más simple, el convertidor colorea la salida según el nivel de registro, como se muestra en el siguiente ejemplo:

%clr(%5p)

La siguiente tabla describe la correspondencia entre los niveles de registro y los colores:

También puede especificar el color o estilo que deseas utilizar, especificándolo como parámetro para la conversión. Por ejemplo, para hacer que el texto sea amarillo, use la siguiente configuración:

%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){amarillo}

Los siguientes colores y estilos son compatibles:

• azul

• cian

• débil

• verde

• magenta

• rojo

• amarillo

Salida a un archivo

De forma predeterminada, Spring Boot registra solo en la consola y no escribe en archivos de registro. Si necesita escribir en archivos de registro además de enviarlos a la consola, debe configurar la propiedad logging.file.name o logging.file.path (por ejemplo, en el archivo application.properties).

La siguiente tabla muestra cómo las propiedades logging.* se pueden usar juntas:5

Los archivos de registro se rotan si alcanzan los 10 MB de tamaño y, como en el caso de la salida de la consola, los mensajes en los niveles ERROR, WARN e INFO se registran de forma predeterminada.

Rotación de archivos

Si está utilizando Logback, puede ajustar los parámetros de rotación de registros utilizando el archivo application.properties o application.yaml. Para todos los demás sistemas de registro, deberá configurar los parámetros de rotación usted mismo (por ejemplo, si está utilizando Log4J2, puede agregar el archivo log4j2.xml o log4j2-spring.xml).

Se admiten las siguientes propiedades de política de rotación:

Niveles de registro

Todos los sistemas de registro compatibles pueden tener niveles de registro establecidos a Environment desde Spring (por ejemplo, application.properties) usando logging.level.<logger-name>=<level>, donde level es uno de los niveles, incluido TRACE, DEBUG, INFO, WARN, ERROR, FATAL u OFF. Puede configurar el administrador de registro root usando logging.level.root.

El siguiente ejemplo muestra posibles opciones de registro en application.properties:

logging.level.root=warn
logging.level.org.springframework.web=debug
logging .level.org.hibernate=error

logging:
    level:
        root: "warn"
        org.springframework.web: "debug"
        org.hibernate: "error"

También puede establecer niveles de registro utilizando variables de entorno. Por ejemplo, LOGGING_LEVEL_ORG_SPRINGFRAMEWORK_WEB=DEBUG establecerá org.springframework.web en DEBUG.

Grupos de registro

En muchos casos, es útil poder para agrupar administradores de registro relacionados para que puedan configurarse simultáneamente. Por ejemplo, puede cambiar con frecuencia los niveles de registro para todos los administradores de registro asociados con Tomcat, pero no podrá recordar fácilmente los paquetes de nivel superior.

Para ayudar Con esto, Spring Boot le permite definir grupos que inician sesión en su Environment para Spring. Por ejemplo, así es como puede definir un "grupo Tomcat" agregándolo a su archivo application.properties:

logging.group.tomcat=org.apache.catalina,org.apache.coyote,org.apache.tomcat

registro: grupo: tomcat:
        "org.apache.catalina,org.apache.coyote,org.apache.tomcat"
    

Una vez definido, puede cambiar el nivel de todos los administradores de registro en un grupo con una línea:

logging.level.tomcat=trace

logging: nivel: tomcat: "trace"

Spring Boot contiene los siguientes grupos de registro predefinidos que se pueden usado de fábrica:

Uso de un interceptor de cierre de registros

Para liberar recursos de registro cuando La aplicación se cierra, hay un interceptor de apagado que se ejecuta y borra el sistema de registro al salir de la JVM. Este enlace de finalización se registra automáticamente a menos que su aplicación se implemente como un archivo war. Si su aplicación tiene una jerarquía compleja de contextos, es posible que un interceptor de finalización no satisfaga sus necesidades. Si no coincide, desactive el interceptor de finalización y considere las opciones proporcionadas directamente por el sistema de registro subyacente. Por ejemplo, Logback proporciona selectores de contexto que permiten crear cada registrador en su propio contexto. Puede utilizar la propiedad logging.register-shutdown-hook para desactivar el enlace de apagado. Establecer el valor en false deshabilita el registro. Puede establecer esta propiedad en el archivo application.properties o application.yaml:

logging.register-shutdown-hook=false

logging: Register-shutdown-hook: false

2019-08-30 12:30:04.031 user:someone INFO 22174 --- [ nio-8080-exec-0] demo.Controller
Handling authenticated request

ERROR in ch.qos.logback.core.joran.spi.Interpreter@4:71 - no applicable action for [springProperty], current ElementPath is [[configuration][springProperty]]
ERROR in ch.qos.logback.core.joran.spi.Interpreter@4:71 - no applicable action for [springProfile], current

<springProfile name="staging">
            <!-- configuración que se activará si el perfil "staging" está activo -->
</springProfile>
<springProfile name="dev | staging">
             <!-- la configuración que se activará si el perfil "dev" o "staging" está activo -->
</springProfile>
<springProfile name="!production">
             <!-- configuración que se activará si el perfil "producción" está activo -->
</springProfile>

<springProperty scope="context" name="fluentHost" source="myapp.fluentd.host"
                defaultValue="localhost"/>
<appender name="FLUENT" class="ch.qos.logback.more.appenders.DataFluentAppender">
    <remoteHost>${fluentHost}</remoteHost>
    ...
</appender>