Как настроить отправку и ротацию логов в Java-приложении?

Ответ

Настройка логгирования в Java обычно выполняется с помощью фреймворков Logback (по умолчанию в Spring Boot) или Log4j2. Основные задачи — запись в файлы с ротацией и отправка в централизованные системы.

Типичная конфигурация (Logback):

  1. Ротация логов: Создание новых файлов по размеру или дате для предотвращения переполнения диска.
  2. Форматирование: Настройка шаблона вывода (%d{yyyy-MM-dd} %msg%n).
  3. Асинхронность: Использование AsyncAppender для минимизации влияния на производительность приложения.
  4. Направление: Отправка логов в внешние системы (ELK, Splunk) через аппендеры для Logstash, Syslog или Kafka.

Пример logback-spring.xml для ротации по размеру и дате:

<configuration>
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/app.log</file>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>logs/app.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>10MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>3GB</totalSizeCap>
        </rollingPolicy>
    </appender>

    <appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
        <queueSize>512</queueSize>
        <appender-ref ref="FILE" />
    </appender>

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

Почему так? Ротация по размеру и дате (SizeAndTimeBasedRollingPolicy) — лучшая практика, так как она контролирует и размер отдельных файлов, и общий срок хранения. Асинхронная запись защищает поток выполнения приложения от блокировок при проблемах с вводом-выводом.

Ответ 18+ 🔞

О, а вот это, блядь, тема! Логирование в Java — это такая штука, которая либо работает как часы, либо устраивает тебе такой пиздец в продакшене, что волосы дыбом встают. Все эти фреймворки — Logback, Log4j2 — они как инструменты, блядь: можно аккуратно гвоздь забить, а можно себе по пальцам ёбнуть, если не разобрался.

Смотри, в чём обычно засада. Все думают: "А, логи — это же просто System.out.println, нахуй". А потом приложение падает, диск забит 500 гигабайтами одного файла app.log, который читать невозможно, и ты стоишь и думаешь: "Ну что за мудак это писал?". А мудак — это ты, потому что не настроил ротацию, блядь!

Вот смотри на классику жанра — logback-spring.xml. Это как священный текст для спринг-бута. Основная идея — не дать логам сожрать всё свободное место, как голодный хомяк.

<configuration>
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/app.log</file>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>logs/app.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>10MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>3GB</totalSizeCap>
        </rollingPolicy>
    </appender>

Вот это, ёпта, и есть магия. SizeAndTimeBasedRollingPolicy — это как два в одном: и по дате, и по размеру. Файл больше 10 мегов? Хуяк — новый создаётся, а старый архивируется в .gz. maxHistory — это чтобы не хранить логи со времён царя Гороха, только последние 30 дней. А totalSizeCap — это вообще гениально, блядь. Это стоп-кран на случай, если приложение начнёт логгировать как сумасшедшее. Больше 3 гигов — старые архивы начинают удаляться. Чистая профилактика от "ой, диск кончился".

А теперь самое вкусное — асинхронность. Это, блядь, must have в любом мало-мальски серьёзном приложении.

    <appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
        <queueSize>512</queueSize>
        <appender-ref ref="FILE" />
    </appender>

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

Зачем? Да чтобы твоё приложение не вставало в позу "ждуна", пока какой-нибудь медленный диск или сетевая шаражка (типа того же Logstash) принимают твои мегабайты отладочной информации. Логи пишутся в очередь, а отдельный поток их оттуда выгребает и сбрасывает на диск. Приложение даже не почувствует. Главное — queueSize адекватный выставить. Слишком маленький — очередь переполнится, логи начнут теряться. Слишком большой — память жрать начнёт. 512 — обычно золотая середина.

И да, чувак, это только начало. Потом ещё надо это всё в ELK или Splunk затолкать, чтобы не по SSH на сервер лазить, а в красивой веб-морде искать. Но это уже, как говорится, совсем другая история, и терпения ебать ноль её сейчас рассказывать. Сначала базовую конфигурацию сделай, чтобы хотя бы не позориться.