Логирование в Go: Обзор стандартной библиотеки log и альтернатив

Онлайн-тренажер Python для начинающих

Изучайте Python легко и без перегрузки теорией. Решайте практические задачи с автоматической проверкой, получайте подсказки на русском языке и пишите код прямо в браузере — без необходимости что-либо устанавливать.

Начать курс

Что такое логирование в Go?

Логирование — это процесс записи событий, происходящих в программе во время её выполнения. В Go встроенная поддержка логирования реализована через пакет log из стандартной библиотеки. Этот пакет предоставляет простой и эффективный способ выводить сообщения в stdout/stderr, записывать их в файлы и управлять форматом вывода. Логи необходимы для отладки, мониторинга работы приложений, аудита безопасности и анализа ошибок в production-среде.

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

  • Отладка: быстрое обнаружение и исправление ошибок во время разработки.
  • Мониторинг: отслеживание состояния приложения в реальном времени.
  • Аудит: фиксация действий пользователей и системных событий.
  • Анализ производительности: выявление узких мест и проблем с производительностью.

Установка

Пакет log входит в стандартную библиотеку Go, поэтому никаких дополнительных установок не требуется. Просто импортируйте его в свой проект:

import "log"

Для продвинутого логирования существуют популярные сторонние библиотеки, которые устанавливаются через go get:

go get github.com/sirupsen/logrus
# или
go get go.uber.org/zap

Основные функции стандартной библиотеки log

  • log.Print(), log.Printf(), log.Println() — вывод сообщений.
  • log.Fatal(), log.Fatalf(), log.Fatalln() — вывод сообщения и завершение программы с кодом 1.
  • log.Panic(), log.Panicf(), log.Panicln() — вывод сообщения и вызов паники.

Пример кода на Go

package main

import (
	"log"
	"os"
)

func main() {
	// Настройка вывода в файл
	file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
	if err != nil {
		log.Fatal(err)
	}
	defer file.Close()

	// Создание логгера с префиксом и флагами
	logger := log.New(file, "INFO: ", log.Ldate|log.Ltime|log.Lshortfile)

	// Примеры логирования
	logger.Println("Приложение запущено")
	logger.Printf("Пользователь %s вошел в систему", "admin")

	// Использование стандартного логгера
	log.Println("Это сообщение в stdout")
}

Когда использовать

  • Стандартный log: для простых проектов, скриптов, утилит командной строки.
  • Logrus: для продакшен-приложений, где нужны уровни логирования (Info, Warn, Error, Debug), структурированные логи в формате JSON.
  • Zap: для высоконагруженных систем, где критична производительность (минимальное выделение памяти).
  • Zerolog: еще один быстрый логгер с поддержкой zero allocation.

Выбор библиотеки зависит от требований к производительности, сложности проекта и необходимости структурированных логов.

Рекомендаций