How to use Custom Logging in C

なぜIronPDFでカスタムログを使うべきなのでしょうか？

:path=/static-assets/pdf/content-code-examples/how-to/custom-logging-custom-logging.cs

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.Custom;
IronSoftware.Logger.CustomLogger = new CustomLoggerClass("logging");

IronPDFのログはカスタムロガーオブジェクトに送られます。 メッセージはIronPDFロガーのものと同じです； これらの情報は、カスタムロガーにリレーされます。 カスタムロガーの実装は、メッセージを処理する方法を決定します。 次のカスタムロガークラスの例を考えてみましょう。

カスタムロギングは、プロダクションアプリケーションにいくつかの利点をもたらします：

• ログの一元管理: IronPDFのログを既存のロギングインフラストラクチャと統合します。
• 強化されたデバッグ：トラブルシューティングのために PDF 操作の詳細情報をキャプチャします。
• パフォーマンス監視: レンダリング時間とリソースの使用状況を追跡します。
• エラー追跡：PDF 生成の失敗を自動的にキャプチャして報告します。
• コンプライアンス：規制産業における文書生成の監査証跡を維持する。

非同期処理を必要とするアプリケーションでは、カスタムロギングによって、PDFの同時処理を追跡し、潜在的なボトルネックを特定することができます。

カスタム ロガー クラスはどのように見えますか?

:path=/static-assets/pdf/content-code-examples/how-to/custom-logging-custom-logging-class.cs

public class CustomLoggerClass : ILogger
{
    private readonly string categoryName;

    public CustomLoggerClass(string categoryName)
    {
        this.categoryName = categoryName;
    }

    public IDisposable BeginScope<TState>(TState state)
    {
        return null;
    }

    public bool IsEnabled(LogLevel logLevel)
    {
        return true;
    }

    public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception, Func<TState, Exception, string> formatter)
    {
        if (!IsEnabled(logLevel))
        {
            return;
        }

        // Implement your custom logging logic here.
        string logMessage = formatter(state, exception);

        // You can use 'logLevel', 'eventId', 'categoryName', and 'logMessage' to log the message as needed.
        // For example, you can write it to a file, console, or another destination.

        // Example: Writing to the console
        Console.WriteLine($"[{logLevel}] [{categoryName}] - {logMessage}");
    }
}

この実装は標準の Microsoft.Extensions.Logging.ILogger インターフェイスに準拠しており、 .NETログ記録エコシステムと互換性があります。 ロガークラスには以下が含まれます：

• カテゴリ名: ログメッセージのソースを識別するのに役立ちます。
• ログレベルのフィルタリング：キャプチャする重大度レベルを制御する
• 柔軟な出力：任意の宛先(コンソール、ファイル、データベースなど)にログをルーティングします。
• 例外処理：例外の詳細を適切にフォーマットし、ログに記録する -状態管理: BeginScope による構造化ログのサポート

高度なシナリオについては、特に複雑な HTML 変換を扱う場合や、Chromeレンダリングエンジンを使用する場合など、ログ出力に影響するレンダリングオプションを調べてください。

カスタムログ出力はどのように見えますか?

この例では、ログメッセージの前に追加情報を付けています。

コンソール出力は、カスタムロギングがIronPDFの内部操作に対する詳細な洞察をどのように提供するかを示しています。 ご覧いただけます：

• Chromeクライアントの初期化手順
• デプロイメント候補の作成
• ネイティブライブラリのロードシーケンス
• コンポーネント導入の成功確認

PDF生成の問題をデバッグするときや、パフォーマンスを最適化するときに、この詳細レベルは非常に貴重です。 構造化されたフォーマットにより、プログラムによるログの解析や、ログ解析ツールとの統合が容易になります。