転送 logger の作成

転送 logger では、マルチプロセッサ システムでプロジェクトをビルドするときに監視の対象とするイベントを選択できるため、ログの効率を高めることができます。 転送 logger を有効にすることで、不要なイベントによる中心 logger の過負荷、ビルドの低速化、およびログの煩雑化を回避できます。

転送 logger を作成する場合は、IForwardingLogger インターフェイスを実装してそのメソッドを手動で実装するか、ConfigurableForwardingLogger クラスとその定義済みメソッドを使用できます (ほとんどのアプリケーションでは、後者で十分です)。

イベントの登録とイベントへの応答

転送 logger は、セカンダリ ビルド エンジン (マルチプロセッサ システムでのビルド時にメイン ビルド プロセスによって作成されるワーカー プロセス) から報告されるビルド イベントの情報を収集します。 次に、転送 logger は指定された手順に基づいて、中心 logger に転送するイベントを選択します。

監視対象のイベントを処理するには、転送 logger を登録する必要があります。 イベントのために登録するには、logger で Initialize メソッドをオーバーライドする必要があります。 このメソッドには省略可能なパラメーターである nodecount が追加されました。このパラメーターをシステムのプロセッサ数に設定できます (既定値は 1 です)。

監視できるイベントの例として、TargetStarted、ProjectStarted、および ProjectFinished などがあります。

マルチプロセッサ環境では、イベント メッセージが誤った順序で受信される可能性があります。 したがって、転送 logger でイベント ハンドラーを使用してイベントを評価し、どのイベントをリダイレクターに渡して中心 logger に転送するかを判断するためにプログラミングする必要があります。 これを行うために、各メッセージにアタッチされた BuildEventContext クラスを使用します。このクラスによって、転送が必要なイベントを特定し、イベントの名前を ConfigurableForwardingLogger クラス (またはそのサブクラス) に渡すことができます。 このメソッドを使用した場合は、それ以外にイベントを転送するためのコーディングを行う必要はありません。

転送 logger の指定

転送ロガーがアセンブリにコンパイルされたら、ビルド時にそれを使用するように MSBuild に通知する必要があります。 そのためには、MSBuild.exe と共に -FileLogger、-FileLoggerParameters、および -DistributedFileLogger スイッチを使用します。 -FileLogger スイッチは、ロガーが直接アタッチされていることを MSBuild.exe に通知します。 -DistributedFileLogger スイッチは、ノードごとにログ ファイルが存在することを意味します。 転送 logger にパラメーターを設定するには、-FileLoggerParameters スイッチを使用します。 上記およびその他の MSBuild.exe スイッチの詳細については、コマンド ライン リファレンスに関するページを参照してください。

マルチプロセッサ対応のロガー

マルチプロセッサ システムでプロジェクトをビルドする場合、各プロセッサからのビルド メッセージが自動的に一貫した順序でインタリーブされるわけではありません。 したがって、各メッセージにアタッチされる BuildEventContext クラスを使用して、メッセージ グループ化の優先順位を確立する必要があります。 マルチプロセッサ ビルドの詳細については、「マルチプロセッサ環境でのログ」を参照してください。

関連するコンテンツ

• ビルド ログの取得
• ビルド ロガー
• マルチプロセッサ環境でのログ