[Go] 실무 환경에서 로그 제대로 남기기(Logging)

 

들어가며

24시간 서버를 운영하는 실무환경에서는 언제 어떤 예외가 발생할지 모릅니다. 이미 이슈가 발생한 상태에서 기술자들이 제일 먼저 확인하는 것들은 "로그"입니다. 모든 시스템에는 이벤트 발생시 로그를 찍게 되기 때문에, 언어와 프레임워크 등 환경이 바뀌더라도 보기 편하게 로그 환경 설정부터 하는 것이 일반적입니다.

 

lorus

go에서는 기본적으로 log패키지가 있기 때문에 토이프로젝트에서는 log패키지만 사용해도 됩니다. 하지만 우리는 실무환경에서 사용해야하기 때문에 조금더 많은 기능을 지원하는 서드파티 패키지를 살펴보겠습니다. logrus는  go의 log 패키지와 호환되면서 상위 집합체라고 볼 수 있습니다.(공식 링크)

go get -u github.com/sirupsen/logrus

아래와 같이 사용 가능합니다.

package main

import (
	"os"
	"github.com/sirupsen/logrus"
)

var log = logrus.New()

func main() {
	// 로그 출력 포맷 설정
	log.SetFormatter(&logrus.TextFormatter{
		FullTimestamp: true,
	})

	// 로그 출력 위치
	log.SetOutput(os.Stdout)

	// 로그 레벨 설정
	log.SetLevel(logrus.DebugLevel)

	log.Debug("디버그 로그입니다.")
	log.Info("정보 로그입니다.")
	log.Warn("경고 로그입니다.")
	log.Error("에러 로그입니다.")
}

 

lumberjack

lumberjack은 로그 파일 저장 기간, 용량, 로그 로테이션, 파일 저장 등의 편의 기능을 제공합니다. (공식 링크)

go get github.com/natefinch/lumberjack

package main

import (
	"github.com/sirupsen/logrus"
	"gopkg.in/natefinch/lumberjack.v2"
)

func main() {
	log := logrus.New()

	// 파일 회전 설정
	log.SetOutput(&lumberjack.Logger{
		Filename:   "logs/app.log",
		MaxSize:    10, // MB
		MaxBackups: 5,
		MaxAge:     7,  // days
		Compress:   true,
	})

	log.SetFormatter(&logrus.JSONFormatter{}) // JSON 포맷
	log.SetLevel(logrus.InfoLevel)

	log.Info("서버 시작")
	log.Warn("메모리 사용량 높음")
	log.Error("DB 연결 실패")
}

 

 

최종 세팅

logger 패키지 내 logger.go 모듈 파일을 생성하고 다음과 같이 작성합니다.

// Package logger
package logger

import (
	"io"
	"os"

	"github.com/sirupsen/logrus"
	"gopkg.in/natefinch/lumberjack.v2"
)

var Log = InitLogger("dev")

func InitLogger(env string) *logrus.Logger {
	log := logrus.New()
	log.SetOutput(io.MultiWriter(
		os.Stdout,
		&lumberjack.Logger{
			Filename:   "logs/myapp.log",
			MaxSize:    10, // MB
			MaxBackups: 5,
			MaxAge:     7, // days
			Compress:   true,
		}))

	log.SetFormatter(&logrus.TextFormatter{
		FullTimestamp:   true,
		TimestampFormat: "2006-01-02 15:04:05",
		ForceColors:     true,
	})
	log.SetReportCaller(true)
	log.SetLevel(logrus.InfoLevel)

	return log
}

func Info(args ...interface{})          { Log.Info(args...) }
func Warn(args ...interface{})          { Log.Warn(args...) }
func Error(args ...interface{})         { Log.Error(args...) }
func Debug(args ...interface{})         { Log.Debug(args...) }
func Infof(f string, a ...interface{})  { Log.Infof(f, a...) }
func Warnf(f string, a ...interface{})  { Log.Warnf(f, a...) }
func Errorf(f string, a ...interface{}) { Log.Errorf(f, a...) }
func Debugf(f string, a ...interface{}) { Log.Debugf(f, a...) }

logrus의 SetFormatter의 인자를 &logrus.JSONFormatter{} 형태로 설정하는 경우도 많습니다. 저는 커스텀 텍스트 포맷으로 진행했습니다. TimestampFormat에 들어가는 값은 Go의 고정된 time layout 패턴이기 때문에 임의로 변경하지 않는 것이 좋습니다(신기).

 

그리고 로거 모듈 하단의 wrapping 함수를 이용하여 외부 패키지에서 logger.Info(...)와 같이 사용해도 되지만, 로그를 호출한 파일 정보를 남기는 SetReportCaller에서 모두 logger.wrapping함수만 가리키고 있어서 저는 logger.Log.Info(...)와 같이 호출할 계획입니다.

 

또, SetOutput의 설정에서 io.MultiWriter에 Stdout과 lumberjack를 같이 넣어서 로그파일 write과 콘솔출력까지 가능하게 했습니다.

 

main에서 loging 테스트를 해봅니다.

package main

import (
	"fmt"
	"runtime"

	"myapp/logger"
)

func main() {
	logger.Log.Infof("=== Go Trading Bot ===")
	logger.Log.Infof("Go Version: %s\n", runtime.Version())
	logger.Log.Infof("OS/Arch: %s/%s\n", runtime.GOOS, runtime.GOARCH)
	logger.Log.Infof("Environment configured successfully!")
}

INFO[2025-11-10 14:44:24]/home/user/myapp/main.go:11 main.main() === Go Trading Bot ===                       
INFO[2025-11-10 14:44:24]/home/user/myapp/main.go:12 main.main() Go Version: go1.24.10                        
INFO[2025-11-10 14:44:24]/home/user/myapp/main.go:13 main.main() OS/Arch: linux/amd64                         
INFO[2025-11-10 14:44:24]/home/user/myapp/main.go:14 main.main() Environment configured successfully!

 

log/myapp에도 로그파일에 내용이 쓰여지면서 콘솔에도 출력됩니다.