LoggerEntry

LoggerEntry はプリセットフィールド付きのロガーで、少なくとも 1 つのフィールドを渡した場合に新しい不変 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" になる

不変性

少なくとも 1 つのフィールドを渡した場合、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 に出力（LevelInfo、セキュリティフィルタリング対象）
Println(args ...any)	Print と同じ動作
Printf(format string, args ...any)	フォーマット出力（LevelInfo、セキュリティフィルタリング対象）

フィールドチェーン

メソッド	説明
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 コンストラクタ
• パッケージ関数 -- グローバルログ関数