C#入門編（25）ロギングの基本 ～ILoggerの使い方とSerilogでファイル出力する方法～

Console.WriteLine("ここまで来た");
Console.WriteLine($"値: {value}");

ILogger logger = ...; // ロガーを取得（後で詳しく説明）

logger.LogInformation("ユーザーがログインしました");
logger.LogError("データベース接続に失敗しました");

2025-01-15 10:30:00 ユーザー user123 がログインしました

{
  "Timestamp": "2024-01-15T10:30:00",
  "Level": "Information",
  "Message": "ユーザーがログインしました",
  "UserId": "user123",
  "Action": "Login"
}

using Microsoft.Extensions.Logging;

// LoggerFactoryを作成（コンソール出力を設定）
using var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddConsole();  // コンソールへの出力を追加
    builder.SetMinimumLevel(LogLevel.Debug);  // Debugレベル以上を出力
});

// ロガーを取得
var logger = loggerFactory.CreateLogger<Program>();

// ※ <Program> は「どのクラスから出力されたログか」を示すカテゴリ名になります。
//   LoggerFactory.CreateLogger<T>() とすると、
//   ログには T のクラス名が自動的に含まれます。

// 各レベルでログを出力
logger.LogTrace("これはTraceです（表示されない）");
logger.LogDebug("これはDebugです");
logger.LogInformation("これはInformationです");
logger.LogWarning("これはWarningです");
logger.LogError("これはErrorです");

var userId = "user123";
var itemCount = 5;

// プレースホルダーを使用（構造化ログ）
logger.LogInformation("ユーザー {UserId} が {ItemCount} 件の商品を購入しました", userId, itemCount);

public class OrderService
{
    private readonly ILogger<OrderService> _logger;

    // DIでILoggerを受け取る
    public OrderService(ILogger<OrderService> logger)
    {
        _logger = logger;
    }

    public void ProcessOrder(string userId, int itemCount)
    {
        _logger.LogInformation("注文処理を開始します: ユーザー {UserId}", userId);

        // 注文処理...

        _logger.LogInformation("注文処理が完了しました: {ItemCount} 件", itemCount);
    }
}

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;

// DIコンテナの設定
var services = new ServiceCollection();

// ロギングをDIコンテナに登録
// (AddLoggingがロギングライブラリの拡張メソッドであり、内部でログイン関連の配線を行っている)
services.AddLogging(builder =>
{
    builder.AddConsole();
    builder.SetMinimumLevel(LogLevel.Debug);
});

// サービスを登録
services.AddTransient<OrderService>();

using var provider = services.BuildServiceProvider();

// サービスを取得して実行
var orderService = provider.GetRequiredService<OrderService>();
orderService.ProcessOrder("user123", 3);

info: OrderService[0]
      注文処理を開始します: ユーザー user123
info: OrderService[0]
      注文処理が完了しました: 3 件

using Microsoft.Extensions.DependencyInjection;
using Serilog;
using DISample;

// Serilogの設定（この設定がDIで注入される全てのILogger<T>に引き継がれる）
Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Information()  // Informationレベル以上を出力
    .Enrich.WithMachineName()  // ログにマシン名を追加
    .WriteTo.Console(outputTemplate:
        "[{Timestamp:HH:mm:ss} {Level:u3}] {Message:lj}{NewLine}{Exception}")
    .WriteTo.File("logs/app-.log",
        rollingInterval: RollingInterval.Day,  // 日付ごとにファイルを分割
        outputTemplate:
        "{Timestamp:yyyy-MM-dd HH:mm:ss.fff} [{Level:u3}] [Machine: {MachineName}] {Message:lj}{NewLine}{Exception}")
    .CreateLogger();

// DIコンテナの設定
var services = new ServiceCollection();

// ILogger<T>でSerilogが使えるようにDIに登録（Log.Loggerの設定を使用）
services.AddLogging(builder =>
{
    //Dispose:trueでサービスプロバイダDispose時にSerilogもDispose
    builder.AddSerilog(dispose: true);  
});

// サービスの登録
// ここでMockApiClientに変更すれば、実装を簡単に差し替えられる
services.AddSingleton<IApiClient>(sp =>
    new ApiClient("https://api.example.com", 30));

services.AddTransient<DataService>();

// サービスプロバイダーの構築（usingで自動Dispose → Serilogがバッファをフラッシュ）
using var provider = services.BuildServiceProvider();

// サービスの取得と実行
var dataService = provider.GetRequiredService<DataService>();
dataService.Execute();

using Microsoft.Extensions.Logging;

namespace DISample;

public class DataService
{
    private readonly IApiClient _client;
    private readonly ILogger<DataService> _logger;

    // DIでIApiClientとILoggerを受け取る
    public DataService(IApiClient client, ILogger<DataService> logger)
    {
        _client = client;
        _logger = logger;
    }

    public void Execute()
    {
        _logger.LogInformation("データ取得処理を開始します");

        try
        {
            var data = _client.GetData();
            _logger.LogDebug("APIからのレスポンス: {Response}", data);

            // 実際のアプリでは、取得したデータを加工・保存・表示などする
            Console.WriteLine($"[{DateTime.Now:HH:mm:ss}] 取得結果: {data}");

            _logger.LogInformation("データ取得処理が正常に完了しました");
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "データ取得処理でエラーが発生しました");
            throw;
        }
    }
}

[22:43:46 INF] データ取得処理を開始します
[22:43:46] 取得結果: [https://api.example.com] からデータ取得（タイムアウト: 30秒）
[22:43:46 INF] データ取得処理が正常に完了しました

2025-12-29 23:01:47.694 [INF] [Machine: PROTA_MACHINE] データ取得処理を開始します
2025-12-29 23:01:47.758 [INF] [Machine: PROTA_MACHINE] データ取得処理が正常に完了しました