Serilog .NET (開発者向けの仕組み)

構造化ログ

Serilogの際立った機能の1つは、構造化ログのサポートです。 単にメッセージをプレーンテキストとして記録するのではなく、Serilogは構造化データをログすることを可能にします。 この構造化データは、JSONオブジェクトや辞書など、シリアル化できる任意のタイプにすることができます。 構造化データをログすることで、ElasticsearchやSplunkのようなツールを使用してログイベントを簡単に分析およびクエリできます。

柔軟な設定

Serilogは柔軟な設定オプションを提供し、アプリケーションのニーズに応じたログの動作をカスタマイズすることができます。 プログラムによる設定、または設定ファイルを使用してSerilogを構成できます。 この柔軟性により、アプリケーションの再起動を必要とせずに、ランタイムでログの動作を調整できます。

シンクライブラリ

Serilogは、異なる目的地にログイベントを送信するためのさまざまなシンクライブラリを提供します。 人気のあるシンクライブラリには次のものがあります:

• Serilog.Sinks.Console: ログイベントをコンソールに送信します。
• Serilog.Sinks.File: ログイベントをテキストファイルに書き込みます。
• Serilog.Sinks.Seq: ログイベントをSeqという構造化ログサーバーに送信します。
• Serilog.Sinks.Elasticsearch: ログイベントをElasticsearchに送信します。

これらのシンクライブラリにより、異なるログインフラストラクチャやツールとSerilogを簡単に統合できます。

ログの追加情報

ログの追加情報は、ログイベントに追加のコンテキスト情報を追加できる機能です。 Serilogは、タイムスタンプ、スレッドID、ログレベルなどの情報を自動的に追加できるさまざまなエンリッチャを提供します。 カスタムエンリッチャを作成して、アプリケーション固有の情報を追加することもできます。

ログフィルタリング

Serilogは、さまざまな基準に基づいてログイベントをフィルタリングすることを可能にします。 ログレベル、プロパティ値、その他の条件に基づいてログイベントを除外または含めるフィルタを設定できます。 このフィルタリング機能により、分析またはトラブルシューティングに最も関連するログイベントに集中できます。

これらの機能を理解し活用することで、Serilogの力を利用してログの能力を高め、アプリケーションの動作に関する貴重な洞察を得ることができます。

構造化ログ: A Core Feature

Serilogの主な強みは、ログメッセージを構造化データに変えることにあります。 他のログライブラリがプレーンテキストを出力するのに対し、Serilogは構造化されたJSON形式でログを生成するため、ログデータの解析やクエリが簡単です。 この機能は、運用のインテリジェンスを重視する現代のアプリケーションには不可欠です。 特にログメッセージが高度な分析のためにELK（Elasticsearch、Logstash、Kibana）スタックなどのシステムに取り込まれる場合、構造化ログが有益です。

豊富なログイベント詳細

Serilogは、アプリケーション内部で起こっていることを総合的に示すコンテキスト情報でログイベントを強化します。 各ログイベントは、単なるログメッセージを超えて、タイムスタンプ、ログレベル、例外の詳細、およびカスタムプロパティを含む複数の詳細を含むことができます。 これにより、Serilogはログの深さと明瞭さの点で他のログライブラリを凌ぎ、開発者にアプリケーションの動作とパフォーマンスに関する重要な洞察を提供します。

設定ファイルを使用して

設定JSONファイルを使用して、ログレベル、出力先（ログファイルやコンソールなど）、ログ出力形式を定義します。 設定ファイルのアプローチは、コードを変更することなくログの動作を変更する柔軟性を提供します。 これは、appsettings.jsonファイルに設定を指定することで行われ、コンソール、ファイル、またはクラウドベースのログ管理サービスなどのさまざまなシンクにログ出力を向けることができます。

コードでプログラム的に

または、LoggerConfigurationクラスを使用してコード内で直接Serilogを設定します。 この方法は、例えば動的ログレベルやカスタムログシンクなど、より複雑なログシナリオを設定するためによく使用されます。 例えば、特定の間隔または特定のサイズに達したときに新しいログファイルを作成するローリングログファイルを設定し、効率的なログファイル管理を確保することができます。

// Create a logger instance with a rolling log file that creates a new log file every day
var logger = new LoggerConfiguration()
    .WriteTo.File("logs/myapp.txt", rollingInterval: RollingInterval.Day) 
    .CreateLogger();

// Create a logger instance with a rolling log file that creates a new log file every day
var logger = new LoggerConfiguration()
    .WriteTo.File("logs/myapp.txt", rollingInterval: RollingInterval.Day) 
    .CreateLogger();

' Create a logger instance with a rolling log file that creates a new log file every day
Dim logger = (New LoggerConfiguration()).WriteTo.File("logs/myapp.txt", rollingInterval:= RollingInterval.Day).CreateLogger()

ASP.NET Coreとの統合

SerilogをASP.NET Coreと統合するには、Package Manager Consoleを通じてSerilogパッケージを追加し、Program.csファイルでロガーを設定します。 .NET 6のvar builderとvar appステートメントは、アプリケーションのロギングインフラストラクチャにSerilogをシームレスにプラグインします。 このプロセスは、デフォルトのロガーをSerilogに置き換え、すべてのログメッセージがSerilogパイプラインを通じて処理されることを保証します。

var builder = WebApplication.CreateBuilder(args);

// Configure Serilog to use settings from appsettings.json and write logs to the console
builder.Host.UseSerilog((ctx, lc) => lc
    .WriteTo.Console()
    .ReadFrom.Configuration(ctx.Configuration));

var app = builder.Build();

var builder = WebApplication.CreateBuilder(args);

// Configure Serilog to use settings from appsettings.json and write logs to the console
builder.Host.UseSerilog((ctx, lc) => lc
    .WriteTo.Console()
    .ReadFrom.Configuration(ctx.Configuration));

var app = builder.Build();

Dim builder = WebApplication.CreateBuilder(args)

' Configure Serilog to use settings from appsettings.json and write logs to the console
builder.Host.UseSerilog(Function(ctx, lc) lc.WriteTo.Console().ReadFrom.Configuration(ctx.Configuration))

Dim app = builder.Build()

IronPDF

IronPDFは.NETアプリケーション内でのPDFの作成、読み取り、および編集を可能にします。 これは、ログデータのPDFレポートを生成し、ログ情報を標準化された形式で簡単に配布および表示できるSerilogと組み合わせると特に有用です。

IronOCR

IronOCRは、125の言語で画像をテキストに翻訳できる光学式文字認識（OCR）ライブラリです。 これはテキストデータを画像やスキャンドキュメントから抽出する必要があるログシナリオで利用でき、ログデータにより多くのコンテキスト情報を追加します。

IronXL

IronXLは、Office Interopを必要とせずにExcelと連携する機能を提供します。これは特にログ目的に有益であり、ログデータをExcelにエクスポートしてさらなる分析と報告を行い、データの操作と視覚化のための馴染みのあるインターフェイスを提供します。

IronBarcode

IronBarcodeは、QRコードやバーコードの読み取りと書き込みを容易にします。 このライブラリは、ログファイル内に埋め込まれた情報のセキュリティと追跡性を向上させるために、エンコードされた情報を埋め込んだり抽出したりします。