Справочник API
Библиотека логирования DD предоставляет богатый API, организованный по функциональным модулям:
Основные компоненты
| Модуль | Описание | Документация |
|---|---|---|
| Пакетные функции | Глобальные функции логирования, удобные конструкторы | Пакетные функции |
| Logger | Основной логгер и его методы | Logger |
| LoggerEntry | Запись лога с предустановленными полями | LoggerEntry |
| Config | Структура конфигурации и предустановки | Конфигурация |
| Интерфейсы | CoreLogger, LogProvider и другие интерфейсы | Определения интерфейсов |
Вывод и запись
| Модуль | Описание | Документация |
|---|---|---|
| Writers | FileWriter, BufferedWriter, MultiWriter | Цели вывода |
| Контекст | Интеграция с Context и ContextExtractor | Интеграция с контекстом |
Расширенные возможности
| Модуль | Описание | Документация |
|---|---|---|
| Fields | Конструкторы структурированных полей (20+ типов) | Структурированные поля |
| Hooks | Система хуков жизненного цикла | Система хуков |
| Security | Фильтрация конфиденциальных данных и конфигурация безопасности | Фильтрация безопасности |
| Audit | Аудитные логи и аудитные события | Аудитные логи |
| Integrity | Подписи целостности логов и проверка | Подписи целостности |
Вспомогательные инструменты
| Модуль | Описание | Документация |
|---|---|---|
| Debug Visual | Функции отладки Print/JSON/Text/Exit | Отладочный вывод |
| Recorder | Вспомогательный логгер для тестирования | Тестовые утилиты |
| Constants | Уровни логирования, форматы, коды ошибок | Константы и ошибки |
Быстрая навигация
go
// Базовое использование
dd.Info("message") // → Пакетные функции
dd.InfoWith("msg", dd.String("k", "v")) // → Пакетные функции + Fields
// Создание пользовательского логгера
logger, _ := dd.New(dd.DefaultConfig()) // → Пакетные функции + Config
logger.WithFields(fields).Info("msg") // → Logger + Entry
// Вывод в файл
fw, _ := dd.NewFileWriter("logs/app.log", dd.DefaultFileWriterConfig()) // → Writers
// Безопасность
sec := dd.DefaultSecurityConfig() // → Security
audit, _ := dd.NewAuditLogger(dd.DefaultAuditConfig()) // → AuditСледующие шаги
- Пакетные функции -- глобальные функции и конструкторы
- Logger -- подробное описание основного логгера
- Конфигурация -- параметры конфигурации