ロギング戦略

// オプション付きでロガーコンテキストを作成
ctx := log.Context(context.Background(),
    // トレースとの相関のためにログにスパンIDを含める
    log.WithFunc(log.Span),

    // 機械可読性のためにJSONフォーマットを使用
    log.WithFormat(log.FormatJSON),

    // 標準出力にログを送信
    log.WithOutput(os.Stdout),

    // リクエストがトレースされている場合はバッファリングを無効化
    log.WithDisableBuffering(log.IsTracing))

// すべてのログに含まれる共通フィールドを追加
ctx = log.With(ctx, 
    log.KV{"service", "myservice"},  // フィルタリング用のサービス名
    log.KV{"env", "production"})     // コンテキスト用の環境

// デバッグレベル - 詳細なトラブルシューティング用
// WithDebugを介してデバッグモードが有効な場合のみ出力
log.Debug(ctx, "リクエストの詳細",
    log.KV{"headers", req.Headers},
    log.KV{"body_size", len(req.Body)})

// 情報レベル - 通常の操作用
// これらのログはデフォルトでバッファリングされ、エラー時にフラッシュ
log.Info(ctx, "リクエストを処理中",
    log.KV{"requestID", req.ID},
    log.KV{"method", req.Method})

// 警告レベル - 潜在的な問題用
// これらのログは操作を妨げない問題を示す
log.Warn(ctx, "リソース使用量が高い",
    log.KV{"cpu_usage", cpuUsage},
    log.KV{"memory_usage", memUsage})

// エラーレベル - 失敗条件用
// これらのログは即座に書き込まれ、バッファをフラッシュ
log.Error(ctx, err, "リクエストが失敗",
    log.KV{"requestID", req.ID},
    log.KV{"status", http.StatusInternalServerError})

// 致命的レベル - 回復不可能なエラー用
// これらのログはログ記録後にプログラムを終了
log.Fatal(ctx, err, "サーバーを起動できません",
    log.KV{"port", config.Port},
    log.KV{"error", err.Error()})

// フォーマット付きデバッグ
log.Debugf(ctx, "アイテム %d / %d を処理中", current, total)

// フォーマット付き情報
log.Infof(ctx, "リクエストが %dms で完了", duration.Milliseconds())

// フォーマット付き警告
log.Warnf(ctx, "高レイテンシーを検出: %dms", latency.Milliseconds())

// エラーオブジェクトとフォーマット付きエラー
log.Errorf(ctx, err, "リクエストの処理に失敗: %s", req.ID)

// エラーオブジェクトとフォーマット付き致命的エラー
log.Fatalf(ctx, err, "初期化に失敗: %s", component)

// 順序付きキーと値のペアにlog.KVを使用
// フィールドの順序を維持するため、これが推奨される方法
log.Print(ctx,
    log.KV{"action", "user_login"},      // 何が起きたか
    log.KV{"user_id", user.ID},          // 誰に起きたか
    log.KV{"ip", req.RemoteAddr},        // 追加のコンテキスト
    log.KV{"duration_ms", duration.Milliseconds()})  // パフォーマンスデータ

// マップスタイルのロギングにlog.Fieldsを使用
// 既存のデータマップを扱う場合に有用
log.Print(ctx, log.Fields{
    "action":     "user_login",
    "user_id":    user.ID,
    "ip":         req.RemoteAddr,
    "duration_ms": duration.Milliseconds(),
})

// 以降のすべてのログに含まれるコンテキストフィールドを追加
// リクエストスコープの情報に有用
ctx = log.With(ctx,
    log.KV{"tenant", tenant.ID},     // マルチテナントコンテキスト
    log.KV{"region", "us-west"},     // 地理的コンテキスト
    log.KV{"request_id", reqID})     // リクエストの相関

// プレーンテキストフォーマット（logfmt）
// ローカル開発と人間の可読性に最適
ctx := log.Context(context.Background(),
    log.WithFormat(log.FormatText))
// 出力: time=2024-02-24T12:34:56Z level=info msg="hello world"

// カラー付き端末フォーマット
// ローカル開発とデバッグに最適
ctx := log.Context(context.Background(),
    log.WithFormat(log.FormatTerminal))
// 出力: INFO[0000] msg="hello world"

// JSONフォーマット
// 本番環境とログ集約システムに最適
ctx := log.Context(context.Background(),
    log.WithFormat(log.FormatJSON))
// 出力: {"time":"2024-02-24T12:34:56Z","level":"info","msg":"hello world"}

// カスタムフォーマット
// 特別なフォーマットが必要な場合に使用
ctx := log.Context(context.Background(),
    log.WithFormat(func(entry *log.Entry) []byte {
        return []byte(fmt.Sprintf("[%s] %s: %s\n",
            entry.Time.Format(time.RFC3339),
            entry.Level,
            entry.Message))
    }))
// 出力: [2024-02-24T12:34:56Z] info: hello world