Capítulo 4: Configuración de Logback

Introducción

Logback es la implementación de logging predeterminada de Spring Boot. Este capítulo le enseña a configurarlo para diferentes entornos.

---

🎯 Objetivos del Capítulo

Al final de este capítulo, usted sabrá:

1. ✅ Crear un archivo logback-spring.xml
2. ✅ Configurar los appenders (Console, File, Rolling)
3. ✅ Personalizar los patrones de log
4. ✅ Utilizar los perfiles de Spring
5. ✅ Configurar logs JSON para producción

---

1. Configuración Básica

Archivo logback-spring.xml

Cree src/main/resources/logback-spring.xml:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>

    <!-- Importar valores de Spring Boot -->
    <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
    
    <!-- Variable para el nombre de la aplicación -->
    <springProperty scope="context" name="APP_NAME" source="spring.application.name" defaultValue="myapp"/>

    <!-- Console Appender -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- Configuración por defecto -->
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
    </root>
    
    <!-- Nivel específico para su aplicación -->
    <logger name="com.myapp" level="DEBUG"/>

</configuration>

---

2. Patrones de Log

Sintaxis de los Patrones

Patrón	Descripción	Ejemplo
%d\{format\}	Fecha/hora	2024-01-15 10:30:00
%thread	Nombre del thread	http-nio-8080-exec-1
%level / %-5level	Nivel (rellenado)	INFO
%logger\{n\}	Nombre del logger (n caracteres)	c.m.s.UserService
%msg	Mensaje	User logged in
%n	Nueva línea
%X\{key\}	Valor MDC	abc-123
%highlight()	Colores (consola)

Ejemplos de Patrones

<!-- Simple -->
<pattern>%d{HH:mm:ss} %-5level %logger{36} - %msg%n</pattern>
<!-- Output: 10:30:00 INFO  c.m.s.UserService - User logged in -->

<!-- Con MDC -->
<pattern>%d{HH:mm:ss} [%X{requestId}] [%X{userId}] %-5level %logger{36} - %msg%n</pattern>
<!-- Output: 10:30:00 [abc-123] [42] INFO  c.m.s.UserService - User logged in -->

<!-- Coloreado para consola -->
<pattern>%d{HH:mm:ss} %highlight(%-5level) %cyan(%logger{36}) - %msg%n</pattern>

<!-- Detallado para archivo -->
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{requestId:-N/A}] %-5level %logger{50} - %msg%n</pattern>

---

3. Appenders

Console Appender

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d{HH:mm:ss.SSS} %highlight(%-5level) %cyan(%logger{36}) - %msg%n</pattern>
    </encoder>
</appender>

File Appender (archivo simple)

<appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <file>logs/application.log</file>
    <append>true</append>
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
    </encoder>
</appender>

Rolling File Appender (con rotación)

<appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>logs/application.log</file>
    
    <!-- Política de rotación -->
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
        <!-- Nombre de los archivos archivados -->
        <fileNamePattern>logs/application.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
        <!-- Tamaño máximo por archivo -->
        <maxFileSize>10MB</maxFileSize>
        <!-- Número de días de retención -->
        <maxHistory>30</maxHistory>
        <!-- Tamaño total máximo -->
        <totalSizeCap>1GB</totalSizeCap>
    </rollingPolicy>
    
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{requestId}] %-5level %logger{50} - %msg%n</pattern>
    </encoder>
</appender>

---

4. Perfiles de Spring

Configuración por Perfil

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    
    <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
    
    <!-- Appender Console (siempre presente) -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} %highlight(%-5level) %cyan(%logger{36}) - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- ===== PERFIL DEV ===== -->
    <springProfile name="dev">
        <root level="INFO">
            <appender-ref ref="CONSOLE"/>
        </root>
        <logger name="com.myapp" level="DEBUG"/>
        <logger name="org.hibernate.SQL" level="DEBUG"/>
    </springProfile>

    <!-- ===== PERFIL PROD ===== -->
    <springProfile name="prod">
        
        <!-- Archivo con rotación -->
        <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
            <file>/var/log/myapp/application.log</file>
            <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                <fileNamePattern>/var/log/myapp/application.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
                <maxFileSize>50MB</maxFileSize>
                <maxHistory>30</maxHistory>
                <totalSizeCap>5GB</totalSizeCap>
            </rollingPolicy>
            <encoder>
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{requestId}] %-5level %logger{50} - %msg%n</pattern>
            </encoder>
        </appender>
        
        <root level="WARN">
            <appender-ref ref="FILE"/>
        </root>
        <logger name="com.myapp" level="INFO"/>
    </springProfile>

    <!-- ===== PERFIL TEST ===== -->
    <springProfile name="test">
        <root level="WARN">
            <appender-ref ref="CONSOLE"/>
        </root>
        <logger name="com.myapp" level="INFO"/>
    </springProfile>

</configuration>

---

5. Logs JSON para Producción

¿Por qué JSON?

Logs de texto:
2024-01-15 10:30:00 INFO UserService - User 42 logged in

Logs JSON (parseables por ELK, Datadog, etc.):
{"timestamp":"2024-01-15T10:30:00.000Z","level":"INFO","logger":"UserService","message":"User logged in","userId":42}

Dependencia

<dependency>
    <groupId>net.logstash.logback</groupId>
    <artifactId>logstash-logback-encoder</artifactId>
    <version>7.4</version>
</dependency>

Configuración JSON

<!-- Appender JSON -->
<appender name="JSON_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>/var/log/myapp/application.json</file>
    
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
        <fileNamePattern>/var/log/myapp/application.%d{yyyy-MM-dd}.%i.json.gz</fileNamePattern>
        <maxFileSize>50MB</maxFileSize>
        <maxHistory>7</maxHistory>
    </rollingPolicy>
    
    <!-- Encoder JSON -->
    <encoder class="net.logstash.logback.encoder.LogstashEncoder">
        <includeMdcKeyName>requestId</includeMdcKeyName>
        <includeMdcKeyName>userId</includeMdcKeyName>
        <customFields>{"app":"myapp","env":"prod"}</customFields>
    </encoder>
</appender>

<springProfile name="prod">
    <root level="INFO">
        <appender-ref ref="JSON_FILE"/>
    </root>
</springProfile>

Salida JSON

{
    "@timestamp": "2024-01-15T10:30:00.000Z",
    "@version": "1",
    "message": "User logged in",
    "logger_name": "com.myapp.service.UserService",
    "thread_name": "http-nio-8080-exec-1",
    "level": "INFO",
    "requestId": "abc-123",
    "userId": "42",
    "app": "myapp",
    "env": "prod"
}

---

6. Configuración Completa Profesional

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="30 seconds">

    <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
    
    <springProperty scope="context" name="APP_NAME" source="spring.application.name" defaultValue="myapp"/>
    <property name="LOG_PATH" value="${LOG_PATH:-logs}"/>

    <!-- ===== CONSOLE APPENDER ===== -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%X{requestId:-}] %highlight(%-5level) %cyan(%logger{36}) - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- ===== FILE APPENDER (Texto) ===== -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/${APP_NAME}.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/archived/${APP_NAME}.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>50MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>5GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{requestId:-N/A}] [%X{userId:-anonymous}] %-5level %logger{50} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- ===== ERROR FILE APPENDER ===== -->
    <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/${APP_NAME}-error.log</file>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERROR</level>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/archived/${APP_NAME}-error.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>50MB</maxFileSize>
            <maxHistory>90</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{requestId}] %-5level %logger{50} - %msg%n%ex</pattern>
        </encoder>
    </appender>

    <!-- ===== ASYNC APPENDER (Performance) ===== -->
    <appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
        <queueSize>512</queueSize>
        <discardingThreshold>0</discardingThreshold>
        <includeCallerData>false</includeCallerData>
        <appender-ref ref="FILE"/>
    </appender>

    <!-- ===== PERFIL DEV ===== -->
    <springProfile name="dev,local">
        <root level="INFO">
            <appender-ref ref="CONSOLE"/>
        </root>
        <logger name="com.myapp" level="DEBUG"/>
        <logger name="org.hibernate.SQL" level="DEBUG"/>
        <logger name="org.springframework.web" level="DEBUG"/>
    </springProfile>

    <!-- ===== PERFIL PROD ===== -->
    <springProfile name="prod">
        <root level="WARN">
            <appender-ref ref="ASYNC_FILE"/>
            <appender-ref ref="ERROR_FILE"/>
        </root>
        <logger name="com.myapp" level="INFO"/>
    </springProfile>

    <!-- ===== PERFIL TEST ===== -->
    <springProfile name="test">
        <root level="WARN">
            <appender-ref ref="CONSOLE"/>
        </root>
        <logger name="com.myapp" level="INFO"/>
    </springProfile>

    <!-- ===== DEFAULT (ningún perfil) ===== -->
    <springProfile name="default">
        <root level="INFO">
            <appender-ref ref="CONSOLE"/>
            <appender-ref ref="FILE"/>
        </root>
        <logger name="com.myapp" level="DEBUG"/>
    </springProfile>

</configuration>

---

7. Loggers Específicos Útiles

<!-- Consultas SQL de Hibernate -->
<logger name="org.hibernate.SQL" level="DEBUG"/>
<logger name="org.hibernate.type.descriptor.sql.BasicBinder" level="TRACE"/>

<!-- Spring Security -->
<logger name="org.springframework.security" level="DEBUG"/>

<!-- Solicitudes HTTP entrantes -->
<logger name="org.springframework.web.filter.CommonsRequestLoggingFilter" level="DEBUG"/>

<!-- Connection Pool -->
<logger name="com.zaxxer.hikari" level="DEBUG"/>

<!-- Transacciones -->
<logger name="org.springframework.transaction" level="DEBUG"/>

<!-- Desactivar logs ruidosos -->
<logger name="org.apache.catalina" level="WARN"/>
<logger name="org.apache.tomcat" level="WARN"/>

---

8. Resumen

Archivos de Configuración

Archivo	Uso
application.properties	Configuración simple
logback-spring.xml	Configuración avanzada
logback.xml	Configuración sin Spring

Appenders Comunes

Appender	Uso
ConsoleAppender	Consola (dev)
FileAppender	Archivo simple
RollingFileAppender	Archivo con rotación
AsyncAppender	Rendimiento (prod)

Patrón Recomendado

%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{requestId}] %-5level %logger{50} - %msg%n

---

🎯 Próximo Paso

¡Hora de la práctica! Implementemos un sistema completo de gestión de errores y logging.

➡️ TP10.1: Gestión Centralizada de Errores

---

⬅️ Volver al Módulo 10