診断トレース

トレースは、アプリケーションの実行中に生成される特定のメッセージの発行です。 トレースを使用する場合は、送信されたメッセージを収集および記録するためのメカニズムが必要です。 トレース メッセージはリスナーによって受信されます。 リスナーの目的は、トレース メッセージを収集、格納、およびルーティングすることです。 リスナーは、ログ、ウィンドウ、テキスト ファイルなどの適切なターゲットにトレース出力を送信します。

このようなリスナーの 1 つである DefaultTraceListenerは、トレースが有効になると自動的に作成され、初期化されます。 トレース出力を追加のソースに送信する場合は、追加のトレース リスナーを作成して初期化する必要があります。 作成するリスナーは、個々のニーズを反映している必要があります。 たとえば、すべてのトレース出力のテキスト レコードが必要な場合があります。 この場合は、有効にすると、すべての出力を新しいテキスト ファイルに書き込むリスナーを作成します。 一方で、アプリケーションの実行中にのみ出力を表示したいかもしれません。 その場合は、すべての出力をコンソール ウィンドウに送信するリスナーを作成できます。 EventLogTraceListenerはトレース出力をイベント ログに送ることができ、TextWriterTraceListenerはトレース出力をストリームに書き込むことができます。

トレースの有効化

トランザクション処理中にトレースを有効にするには、アプリケーションの構成ファイルを編集する必要があります。 以下に例を示します。

<configuration>
<system.diagnostics>
     <sources>
          <source name="System.Transactions" switchValue="Warning">
               <listeners>
                    <add name="tx"
                     type="System.Diagnostics.XmlWriterTraceListener"
                     initializeData= "tx.log" />
               </listeners>
          </source>
     </sources>
</system.diagnostics>
</configuration>

System.Transactions トレースは、"System.Transactions" という名前のソースに書き込まれます。 addを使用して、使用するトレース リスナーの名前と種類を指定できます。 この構成例では、リスナーに "tx" という名前を付け、使用する型として標準の .NET Framework トレース リスナー (XmlWriterTraceListener) を追加しました。 initializeDataを使用して、そのリスナーのログ ファイルの名前を設定します。 さらに、完全修飾パスを単純なファイル名に置き換えることができます。

各トレース メッセージの種類には、重要度を示すレベルが割り当てられます。 アプリ ドメインのトレース レベルがイベントの種類のレベル以下の場合、そのメッセージが生成されます。 トレース レベルは、構成ファイルの switchValue 設定によって制御されます。 診断トレース メッセージに関連付けられているレベルは、次の表で定義されています。

トレース コード

次の表に、 System.Transactions インフラストラクチャによって生成されるトレース コードを示します。 テーブルには、トレース コード識別子、トレースの EventType 列挙レベル、およびトレースの TraceRecord に含まれる追加データが含まれます。 さらに、トレースの対応するトレース レベルも TraceRecord に格納されます。

上記の各追加データ項目の XML スキーマの形式は次のとおりです。

取引トレース識別子

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

< CloneIdentifier >

the clone id number

</CloneIdentifier>

</TransactionTraceIdentifier>

EnlistmentTraceIdentifier (エンリストメントトレースアイデンティファイヤ)

<EnlistmentTraceIdentifier>

<ResourceManagerId>

string form of guid

</ResourceManagerId>

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

<CloneIdentifier >

the clone id number

</CloneIdentifier>

<TransactionTraceIdentifier>

<EnlistmentIdentifier>

the enlistment id number

</EnlistmentIdentifier>

</EnlistmentTraceIdentifier>

Resource Manager 識別子

<ResourceManagerId>

string form of guid

</ResourceManagerId>

トレースに関するセキュリティ問題

管理者がトレースを有効にすると、既定で公開されているトレース ログに機密情報が書き込まれる可能性があります。 セキュリティ上の脅威を軽減するには、共有とファイル システムのアクセス許可によって制御される安全な場所にトレース ログを格納することを検討する必要があります。