Logback là một framework ghi log mạnh mẽ dành cho hệ sinh thái Java, được thiết kế để kế thừa và cải tiến từ Log4j. Nó cung cấp tốc độ thực thi nhanh hơn và khả năng cấu hình linh hoạt hơn.

1. Các thành phần cốt lõi của Logback

Logback được chia thành ba module chính, mỗi module đảm nhận một vai trò riêng biệt trong hệ thống:

• logback-core: Nền tảng cơ bản nhất, cung cấp các tính năng thiết yếu cho việc ghi nhật ký.
• logback-classic: Phiên bản cải tiến xây dựng dựa trên logback-core, tương thích hoàn toàn với SLF4J API, cho phép chuyển đổi dễ dàng giữa các framework log khác nhau.
• logback-access: Một module tích hợp với các Servlet container (như Tomcat hoặc Jetty) để cung cấp tính năng ghi log truy cập HTTP.

2. Ưu điểm nổi bật

• Hiệu năng tối ưu: Được tối ưu hóa để giảm thiểu độ trễ khi ghi log, đặc biệt là thông qua cơ chế ghi log bất đồng bộ.
• Cấu hình linh hoạt: Sử dụng định dạng XML giúp dễ dàng thay đổi các tham số mà không cần biên dịch lại mã nguồn.
• Hỗ trợ Appender đa dạng: Cho phép xuất log ra console, file, database hoặc gửi qua socket.
• Khả năng lọc mạnh mẽ: Hỗ trợ bộ lọc dựa trên cấp độ log (Level) hoặc các điều kiện tùy chỉnh.

3. Ví dụ cấu hình ghi log đồng bộ (Synchronous)

Dưới đây là cấu hình cơ bản giúp ghi log ra cả Console và File theo thời gian thực.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- Định nghĩa các biến môi trường -->
    <property name="LOG_DIR" value="./logs" />
    <property name="MSG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n" />

    <!-- Appender cho Console -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${MSG_PATTERN}</pattern>
        </encoder>
    </appender>

    <!-- Appender cho File với chính sách cuộn theo ngày -->
    <appender name="DAILY_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/application.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/history/app.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>${MSG_PATTERN}</pattern>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>INFO</level>
        </filter>
    </appender>

    <!-- Cấu hình mức log cho các package cụ thể -->
    <logger name="com.myapp.service" level="DEBUG" />
    <logger name="org.hibernate" level="WARN" />

    <root level="INFO">
        <appender-ref ref="STDOUT" />
        <appender-ref ref="DAILY_FILE" />
    </root>
</configuration>

4. Ví dụ cấu hình ghi log bất đồng bộ (Asynchronous)

Đối với các ứng dụng yêu cầu thông lượng cao, việc ghi log bất đồng bộ giúp tránh việc chặn (blocking) luồng xử lý chính của ứng dụng.

<configuration>
    <!-- Giả sử đã định nghĩa STDOUT và DAILY_FILE như trên -->

    <appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
        <!-- Kích thước hàng đợi -->
        <queueSize>512</queueSize>
        <!-- Không bỏ lỡ log khi hàng đợi đầy -->
        <discardingThreshold>0</discardingThreshold>
        <!-- Bao gồm thông tin class/method -->
        <includeCallerData>true</includeCallerData>
        <appender-ref ref="DAILY_FILE" />
    </appender>

    <root level="INFO">
        <appender-ref ref="STDOUT" />
        <appender-ref ref="ASYNC_FILE" />
    </root>
</configuration>

5. Giải thích chi tiết các thẻ cấu hình

Thẻ Property

Dùng để khai báo các hằng số dùng chung trong toàn bộ file cấu hình như đường dẫn thư mục log (log.path) hoặc định dạng hiển thị log (log.pattern).

Định dạng Pattern (%d, %thread, %level...)

Logback cung cấp các biến thay thế để định dạng dòng log đầu ra:

Các loại Appender phổ biến

• ConsoleAppender: Đưa log trực tiếp lên màn hình Console của IDE hoặc Terminal.
• RollingFileAppender: Ghi log vào file và tự động chuyển (roll) sang file mới dựa trên các tiêu chí như:
  • TimeBasedRollingPolicy: Chuyển file theo thời gian (ngày, tháng, giờ).
  • SizeAndTimeBasedRollingPolicy: Chuyển file khi đạt kích thước tối đa hoặc theo thời gian.
• AsyncAppender: Bao bọc các appender khác để xử lý việc ghi log trong một luồng riêng biệt, tăng hiệu suất cho ứng dụng chính.

Các cấp độ Log (Log Levels)

Logback hỗ trợ các cấp độ sau theo thứ tự ưu tiên tăng dần:

1. TRACE: Thông tin chi tiết nhất, dùng để theo dõi luồng code cực kỳ tỉ mỉ.
2. DEBUG: Thông tin hỗ trợ tìm lỗi trong quá trình phát triển.
3. INFO: Các sự kiện thông thường trong quá trình ứng dụng chạy ổn định.
4. WARN: Các tình huống bất thường nhưng không làm ứng dụng dừng hoạt động.
5. ERROR: Lỗi nghiêm trọng khiến một chức năng hoặc toàn bộ hệ thống gặp vấn đề.

Logger và Root

Thẻ <logger> cho phép bạn kiểm soát cấp độ log cho từng package cụ thể. Trong khi đó, thẻ <root> là cấu hình mặc định cho toàn bộ ứng dụng nếu không có logger con nào được định nghĩa.