Пишем логи Java в journald: Logback и FFM API

Разворачивая бэкенды на systemd, разработчики часто сталкиваются с проблемой: stdout не интегрируется с journald, а ставить лишний софт для логов не хочется. В статье показано, как писать логи из Java-приложения в journald с помощью Logback и FFM API — просто и без внешних зависимостей.

Если вы разворачиваете Java-бэкенды на серверах с systemd, то наверняка замечали: стандартный вывод приложения плохо интегрируется с journald. Логи попадают в журнал, но теряют структуру, а фильтрация по полям становится невозможной. Устанавливать отдельный софт для сбора логов не хочется, особенно для личных проектов. Решение — писать логи напрямую в journald, используя Logback и FFM API. Это не требует дополнительных библиотек и работает на современных JDK.

Статья, опубликованная на Habr, предлагает простой пример реализации. Автор показывает, как настроить Logback для отправки сообщений в системный журнал через нативный интерфейс systemd. Основная идея — использовать Foreign Function & Memory API (FFM), который появился в Java 22 как preview и стал стабильным в Java 24. С его помощью можно вызывать функции C-библиотеки libsystemd, не прибегая к JNI или JNA.

Как устроен вывод логов в journald

journald — это система журналирования, встроенная в systemd. Она собирает логи от всех сервисов и приложений, работающих на системе. В отличие от простого вывода в stdout, journald добавляет к сообщениям метаданные: время, приоритет, идентификатор сервиса, поля, заданные приложением. Это позволяет эффективно фильтровать и анализировать логи.

Когда Java-приложение выводит сообщение в stdout, systemd перехватывает его и записывает в журнал, но все сообщения получают одинаковый приоритет (info) и не содержат структурированных полей. Чтобы логи были полезными, нужно отправлять их напрямую в journald через нативный интерфейс. Это делается с помощью функции sdjournalsend из библиотеки libsystemd.

FFM API позволяет Java-коду вызывать нативные функции без написания C-кода. В статье автор показывает, как объявить нативный метод, используя java.lang.foreign, и передать в него строки с полями логов. Это изящное решение, которое экономит время и ресурсы.

Реализация с Logback и FFM API

Logback — популярная библиотека логирования для Java. Она поддерживает пользовательские аппендеры, которые определяют, куда отправлять записи. Автор предлагает создать свой аппендер, который вызывает sdjournalsend. В конфигурации logback.xml вы просто указываете этот аппендер, и все логи уровня INFO и выше уходят в journald.

Для работы с FFM API нужно импортировать модуль java.base, который уже включает необходимые классы. В коде вы определяете ссылку на нативную функцию через MethodHandle, затем создаете массив строк, содержащий сообщение и поля (например, уровень, имя логгера, поток), и вызываете функцию. Важно правильно управлять памятью: FFM API требует явного выделения и освобождения памяти для строк, но в статье показано, как это сделать безопасно.

Пример аппендера включает метод append, который получает событие логирования и формирует массив аргументов для sdjournalsend. Формат аргументов: каждая строка — это "ПОЛЕ=значение", а само сообщение передается как "MESSAGE=...". После вызова нативной функции память освобождается. Это всё — никаких внешних библиотек, только стандартные средства JDK.

Чем это отличается от других подходов?

Существуют и другие способы отправки логов в journald из Java. Один из них — использовать JNI и писать обёртку на C, что требует компиляции нативного кода и усложняет сборку. Другой — использовать JNA, но она добавляет зависимость в проект и не всегда удобна. FFM API — это современный подход, который встроен в JDK и не требует дополнительных библиотек.

Кроме того, Logback уже умеет писать в syslog через SyslogAppender, но он работает по UDP и не поддерживает структурированные поля journald. Наш подход использует нативный интерфейс, что даёт полный контроль над метаданными и приоритетом сообщений.

Кого затронет и как

Этот материал будет полезен разработчикам, которые поддерживают Java-сервисы на Linux-серверах с systemd. Если вы используете Docker или Kubernetes, то, скорее всего, логи собираются по-другому, но для личных VPS или домашних серверов этот подход идеален. Он позволяет избавиться от лишних инструментов вроде rsyslog или filebeat и использовать встроенные возможности systemd.

Для тех, кто работает в команде, это решение упрощает мониторинг: логи из разных сервисов собираются в одном месте, их можно фильтровать по полям, а при необходимости — экспортировать. Это особенно актуально для микросервисной архитектуры, где каждый сервис пишет свои логи.

Что будет дальше?

FFM API развивается, и в будущих версиях JDK он станет ещё удобнее. Возможно, появятся готовые библиотеки для интеграции с journald, но пока автор предлагает простое решение, которое можно использовать уже сейчас. Если вы работаете с Java 22 или новее, вы можете попробовать этот подход в своих проектах.

Стоит отметить, что FFM API в Java 24 стал стабильным, так что можно смело использовать его в продакшене. В статье приведён полный код, который легко адаптировать под свои нужды. Это хороший пример того, как современные возможности Java позволяют решать практические задачи элегантно и без лишних зависимостей.

Итог

Использование FFM API для записи логов в journald — это практичное решение для Java-разработчиков, которые хотят навести порядок в логировании на своих серверах. Оно не требует дополнительных библиотек, легко настраивается через Logback и даёт полный контроль над структурой логов. Если вы устали от нечитаемого stdout в journald, попробуйте этот подход — он сэкономит вам время и нервы.