伐採
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ホストSitecoreログインは、MicrosoftのMicrosoftが提供するAPIを利用するため簡単です。拡張機能、ログ、抽象化、Microsoft。拡張、ログパッケージ、そしてカスタムレイヤーを提供する代わりに。つまり、MicrosoftログAPIを理解していれば、ログインSitecoreの使い方も理解できるということです。
デフォルトでは、Sitecoreホストアプリケーションはコンソールとデバッグロガーにコンテンツをログします。Sitecore.Framework.Runtime.Abstractionsパッケージに含まれるIConfigureSitecoreLoggingインターフェースを実装することで、独自のカスタムログを利用できます。これにより、選択したログ実装を構築し設定するためのエントリーとなり、Sitecoreホストアプリケーションにも利用可能になります。
Serilogはデフォルトのロガー実装です。これはシンプルながら強力なログフレームワークで、ASP .Net Core 2.xおよびMicrosoft Logging APIと互換性があります。
構造化ログおよびイベントデータの利用をサポートし、アプリケーションのニーズに完全にカスタマイズ可能な豊富なプロパティセットを用いてログ情報の詳細な分析を可能にします。
セリログのウィキに追加情報があります。
このトピックでは以下の内容を説明します。
- Sitecore HostアプリケーションでSerilogを構成する
- セリログ沈没
- ロングレベルフィルター
- 追加の物件や丸太強化材を含める
- コンソールロガーフォーマットの設定
- ファイルロガーのフォーマットを設定する
Sitecore HostアプリケーションでSerilogを構成する
sitecorehost.xmlファイルでログを設定するのは、アプリケーションが実行されるとログが早い段階で始まるからです。例えば:
Sitecoreホストアプリケーションは様々なSerilogシン クを使用できます。シンクとは、ログを異なる出力、例えばコンソールへの出力やファイルへの出力にパイプで送るSerilog特有の方法です。
sitecorehost.xmlファイルでアプリケーションのデフォルトシンクを設定します:
アプリケーション内のすべてのログをカバーする最小ログレベルを指定することができます。以下の例では、デフォルトのログレベルをDebugに設定しています:
また、名前空間に基づいてオーバーライドフィルターを指定することもできます。これを使ってシステムの異なる部分ごとに異なるログの重大さを記録します。
特定の名前空間のログを上書きしたい場合は(例えば、Microsoft名前空間内のものをWARNINGのみ出力に設定する)、Override要素を使います。
Serilogではログにさまざまなプロパティを加えてリッチングできます。デフォルトのエンリチャーはEnvironmentで、現在のマシン名が使われます。エンリチャーは以下の方法で含まれますsinks:
コンソールロガーフォーマットの設定
以下は、Serilog構成でコンソールロガーを作成する方法の例です:
ロガーは各ログラインをフォーマットする際にoutputTemplate要素を使用します。テーマ要素はコンソール上のカラー出力を指定します。利用可能なテーマは以下の通りです:
- ConsoleTheme.None- スタイリングなし。
- SystemConsoleTheme.Literate- すべてのWindows/.NETターゲットでサポートされているSystem.Console色モードを使って、Serilog.Sinks.Literateを再現するようにスタイル化。テーマを指定しない場合、これがデフォルトです。
- SystemConsoleTheme.Grayscale- グレー、白、黒の色調のみを使ったテーマ。
- AnsiConsoleTheme.Literate- Literate テーマのANSI16カラーバージョン。
- AnsiConsoleTheme.Grayscale- Grayscale テーマのANSI 256カラー版。
- AnsiConsoleTheme.Code- ANSI 256カラーのVisual Studio Codeにインスパイアされたテーマ。
Serilog Console Sinkにはさらに詳しい情報があります。
ファイルロガーのフォーマットを設定する
pathFormat要素はパスとファイル形式を指定し、outputTemplate要素は各ログラインの形式を指定します。