Логирование в Rust: лучшие библиотеки

Логирование для Rust: лучшие решения

Логирование — критически важный компонент любого серьезного приложения на Rust. Оно помогает отслеживать выполнение кода, выявлять ошибки, мониторить производительность и анализировать поведение системы в продакшне. В этой статье мы рассмотрим основные библиотеки для логирования в экосистеме Rust, их особенности, преимущества и примеры использования.

Почему логирование важно в Rust?

Rust, будучи системным языком, предъявляет высокие требования к надежности и предсказуемости. Логирование позволяет:

Отслеживать поток выполнения в многопоточных приложениях.
Фиксировать неожиданные состояния и паники.
Проводить аудит безопасности.
Собирать метрики для оптимизации производительности.

Основные библиотеки для логирования

1. `log` — фасад для логирования

log — это стандартный фасад (абстрактный слой) для логирования в Rust. Он определяет макросы info!, warn!, error!, debug!, trace! и трейт Log. Сам по себе он не выводит логи — для этого нужен бэкенд (например, env_logger или slog).

// Cargo.toml
[dependencies]
log = "0.4"

// main.rs
use log::{info, warn, error};

fn main() {
    // Инициализация бэкенда обязательна
    env_logger::init();
    info!("Приложение запущено");
    warn!("Низкий уровень памяти: {}%", 15);
    error!("Критическая ошибка: {}", "отказ соединения");
}

2. `env_logger` — простой и быстрый бэкенд

env_logger — самый популярный бэкенд для log. Настраивается через переменную окружения RUST_LOG. Поддерживает фильтрацию по модулям и уровням.

// Установка
// cargo add env_logger

// Пример настройки
use log::LevelFilter;

fn main() {
    env_logger::Builder::from_env(
        env_logger::Env::default().default_filter_or("info")
    ).init();

    log::info!("Запуск с уровнем INFO");
    log::debug!("Это сообщение не будет выведено");
}

// Запуск с переменной:
// RUST_LOG=debug cargo run

3. `slog` — структурированное логирование

slog — мощная библиотека для структурированного логирования. Поддерживает ключ-значение, цепочки логгеров, асинхронную запись и кастомные драйверы. Идеально подходит для сложных систем, где важен контекст.

// Cargo.toml
[dependencies]
slog = "2.7"
slog-term = "2.9"
slog-json = "2.6"

// main.rs
use slog::{o, Drain, Logger, info};

fn main() {
    let decorator = slog_term::TermDecorator::new().build();
    let drain = slog_term::FullFormat::new(decorator).build().fuse();
    let drain = slog_async::Async::new(drain).build().fuse();

    let logger = Logger::root(drain, o!("version" => "1.0"));

    info!(logger, "Сервер запущен"; "port" => 8080, "env" => "production");
}

4. `tracing` — инструментирование и трассировка

tracing — современная библиотека от команды Tokio, предназначенная для структурированного логирования и трассировки. Позволяет создавать спаны (span) — временные интервалы с контекстом, что незаменимо для асинхронных и многопоточных приложений.

// Cargo.toml
[dependencies]
tracing = "0.1"
tracing-subscriber = "0.3"

// main.rs
use tracing::{info, span, Level};
use tracing_subscriber::fmt;

fn main() {
    // Инициализация подписчика
    fmt::init();

    let span = span!(Level::INFO, "main", "app" = "my_service");
    let _guard = span.enter();

    info!("Обработка запроса");
    // Логи внутри спана автоматически содержат контекст
}

Сравнение библиотек

log + env_logger: Простота, минимализм, подходит для небольших проектов и утилит.
slog: Гибкость, структурированные данные, поддержка асинхронности — выбор для средних и крупных проектов.
tracing: Лучший выбор для асинхронных приложений на Tokio, трейсинг запросов и профилирование.