LoggerEntry

LoggerEntry — логгер с предустановленными полями: при передаче хотя бы одного поля возвращается новый неизменяемый Entry.

Создание

// Из Logger
entry := logger.WithFields(
    dd.String("service", "api"),
    dd.String("env", "prod"),
)

// Через глобальный Logger
entry := dd.Default().WithFields(
    dd.String("service", "api"),
)

// Быстрый способ с одним полем
entry := logger.WithField("request_id", "req-123")

Цепочные вызовы

// Добавление полей (возвращает новый Entry, оригинальный Entry не изменяется)
base := logger.WithFields(dd.String("svc", "api"))
enhanced := base.WithFields(dd.String("env", "prod"))

// Новые поля перекрывают одноимённые старые
entry := base.WithField("svc", "gateway")  // svc становится "gateway"

Неизменяемость

При передаче хотя бы одного поля WithFields / WithField возвращает новый LoggerEntry, оригинальный Entry не затрагивается и безопасен для конкурентного использования. Вызов WithFields() без полей является оптимизацией без действия (no-op) и напрямую возвращает исходный Entry.

Методы логирования

Все методы логирования Logger также доступны на Entry, выводимые логи автоматически несут предустановленные поля:

Базовые логи

Метод	Описание
`Debug(args ...any)`	Уровень Debug
`Info(args ...any)`	Уровень Info
`Warn(args ...any)`	Уровень Warn
`Error(args ...any)`	Уровень Error
`Fatal(args ...any)`	Уровень Fatal (по умолчанию вызывает os.Exit(1), defer не выполняется; можно настроить через FatalHandler)
`Log(level LogLevel, args ...any)`	С указанным уровнем

Форматированные логи

Метод	Описание
`Debugf(format string, args ...any)`	Форматированный Debug
`Infof(format string, args ...any)`	Форматированный Info
`Warnf(format string, args ...any)`	Форматированный Warn
`Errorf(format string, args ...any)`	Форматированный Error
`Fatalf(format string, args ...any)`	Форматированный Fatal (по умолчанию вызывает os.Exit(1), defer не выполняется; можно настроить через FatalHandler)
`Logf(level LogLevel, format string, args ...any)`	Форматированный с указанным уровнем

Структурированные логи

Метод	Описание
`DebugWith(msg string, fields ...Field)`	Структурированный Debug (объединяет предустановленные поля)
`InfoWith(msg string, fields ...Field)`	Структурированный Info
`WarnWith(msg string, fields ...Field)`	Структурированный Warn
`ErrorWith(msg string, fields ...Field)`	Структурированный Error
`FatalWith(msg string, fields ...Field)`	Структурированный Fatal (по умолчанию вызывает os.Exit(1), defer не выполняется; можно настроить через FatalHandler)
`LogWith(level LogLevel, msg string, fields ...Field)`	Структурированный с указанным уровнем

Методы Print

Метод	Описание
`Print(args ...any)`	Вывод в Writer (уровень Info, с фильтрацией безопасности)
`Println(args ...any)`	Аналогично Print
`Printf(format string, args ...any)`	Форматированный вывод (уровень Info, с фильтрацией безопасности)

Цепочки полей

Метод	Описание
`WithFields(fields ...Field) *LoggerEntry`	Добавить поля, возвращает новый Entry
`WithField(key string, value any) *LoggerEntry`	Добавить одно поле, возвращает новый Entry

Примеры использования

Логирование HTTP-запросов

func handleRequest(w http.ResponseWriter, r *http.Request) {
    reqLog := logger.WithFields(
        dd.String("method", r.Method),
        dd.String("path", r.URL.Path),
        dd.String("remote", r.RemoteAddr),
    )

    reqLog.Info("Запрос начат")

    // Логика обработки...

    reqLog.WithField("status", 200).Info("Запрос завершён")
}

Логирование компонентов сервиса

serviceLog := logger.WithFields(
    dd.String("service", "user-service"),
    dd.String("version", "2.1.0"),
)

serviceLog.Info("Сервис запущен")

dbLog := serviceLog.WithField("component", "database")
dbLog.Info("Соединение установлено")
dbLog.ErrorWith("Ошибка запроса", dd.Err(err))

Следующие шаги

Logger -- методы экземпляра Logger
Структурированные поля -- конструкторы Field
Пакетные функции -- глобальные функции логирования

LoggerEntry ​

Создание ​

Цепочные вызовы ​

Методы логирования ​

Базовые логи ​

Форматированные логи ​

Структурированные логи ​

Методы Print ​

Цепочки полей ​

Примеры использования ​

Логирование HTTP-запросов ​

Логирование компонентов сервиса ​

Следующие шаги ​