Go言語でのログ管理には多くのライブラリが存在しますが、その中でもzapは高性能で柔軟性のあるロギングライブラリとして知られています。zapは特に高速で、構造化されたログをサポートし、カスタマイズ可能なログレベルを持つことを可能にします。
ログレベル
-
Debug: 開発中や問題解決時に役立つ、詳細な情報を出力するために使用します。本番環境では通常無効にされます。
-
Info: 実行中のプログラムの正常な動作に関する情報的なメッセージを出力するために使用します。
-
Warn: 潜在的な問題を示す可能性があるが、アプリケーションの動作には直接的な影響を与えない情報を出力するために使用します。
-
Error: 実行時にエラーが発生したことを示すために使用します。これはアプリケーションの正常な動作に影響を与える問題です。
-
DPanic: 開発環境ではパニックを引き起こし、本番環境ではエラーログとして記録されるメッセージを出力するために使用します。これは、非常に深刻な問題を示すもので、可能な限り早急に対処すべきです。
-
Panic: システムがパニック状態に陥り、アプリケーションはそのポイントでクラッシュすることを示します。ログメッセージは記録され、その後パニックが発生します。
-
Fatal: 最も重大な問題を示します。ログメッセージが記録された後、アプリケーションは直ちに終了します。
デフォルト例
package main
import (
"time"
"go.uber.org/zap"
)
func main() {
// ロガーの初期化
logger, _ := zap.NewProduction()
defer logger.Sync() // バッファリングされたログをフラッシュ
// 異なるログレベルでのログ記録
logger.Info("これは情報ログです",
// 構造化されたデータをログに追加
zap.String("url", "http://example.com"),
zap.Int("attempt", 3),
zap.Duration("backoff", time.Second),
)
logger.Error("これはエラーログです")
}
このサンプルでは、zap.NewProduction()を使用して本番用のロガーを作成しています。これにより、パフォーマンスに最適化された設定でロガーが初期化されます。logger.Infoとlogger.Errorメソッドを使用して、それぞれ情報とエラーログを記録しています。ログメッセージには、zap.Stringやzap.Intなどの関数を使用して構造化されたデータを追加できます。
{"level":"info","ts":1257894000,"caller":"sandbox557547676/prog.go:15","msg":"これは情報ログです","url":"http://example.com","attempt":3,"backoff":1}
{"level":"error","ts":1257894000,"caller":"sandbox557547676/prog.go:22","msg":"これはエラーログです","stacktrace":"main.main\n\t/tmp/sandbox557547676/prog.go:22\nruntime.main\n\t/usr/local/go-faketime/src/runtime/proc.go:271"}
カスタマイズログ例
デフォルトの設定に加えて、ログの出力形式や挙動をカスタマイズすることが可能です。
package main
import (
"os"
"go.uber.org/zap"
"go.uber.org/zap/zapcore"
)
func main() {
// カスタムのエンコーダ設定
encoderConfig := zapcore.EncoderConfig{
TimeKey: "time",
LevelKey: "level",
NameKey: "logger",
CallerKey: "caller",
MessageKey: "msg",
StacktraceKey: "stacktrace",
LineEnding: zapcore.DefaultLineEnding,
EncodeLevel: zapcore.LowercaseLevelEncoder, // ログレベルを小文字で
EncodeTime: zapcore.ISO8601TimeEncoder, // 時間をISO8601形式で
EncodeDuration: zapcore.SecondsDurationEncoder,
EncodeCaller: zapcore.ShortCallerEncoder, // 短いファイルパスと行数
}
// カスタムのログレベル設定
atomicLevel := zap.NewAtomicLevel()
atomicLevel.SetLevel(zap.InfoLevel) // Info以上のログを記録
// ロガーの作成
logger := zap.New(zapcore.NewCore(
zapcore.NewJSONEncoder(encoderConfig), // JSONエンコーダを使用
zapcore.Lock(os.Stdout), // 標準出力にログを出力
atomicLevel, // 設定したログレベルを適用
), zap.AddCaller(), zap.AddStacktrace(zap.ErrorLevel)) // 呼び出し元とエラーレベルのスタックトレースを追加
defer logger.Sync()
// ログの記録
logger.Info("カスタムログのテスト", zap.String("type", "custom"), zap.Int("value", 42))
logger.Error("エラー発生")
}
この例では、zapcore.EncoderConfigをカスタマイズして、ログの形式や出力される情報を細かく設定しています。例えば、ログレベルを小文字で出力したり、時間をISO8601形式で記録したりしています。また、zap.NewAtomicLevel()を使用してログレベルを動的に変更可能なatomicLevelを作成し、これをロガーの設定として適用しています。
{"level":"info","time":"2009-11-10T23:00:00.000Z","caller":"sandbox2595078369/prog.go:40","msg":"カスタムログのテスト","type":"custom","value":42}
{"level":"error","time":"2009-11-10T23:00:00.000Z","caller":"sandbox2595078369/prog.go:41","msg":"エラー発生","stacktrace":"main.main\n\t/tmp/sandbox2595078369/prog.go:41\nruntime.main\n\t/usr/local/go-faketime/src/runtime/proc.go:271"}
最後
zapはGo言語での効率的なロギングに優れた選択肢です。その高速性と柔軟性により、大規模なアプリケーションやパフォーマンスが重要な場面での使用に特に適しています。
オンラインデバッグツール