次の方法で共有

トランザクション アプリケーションの診断

  • [アーティクル]

このトピックでは、トランザクションのアプリケーションをトラブルシューティングするために、Windows Communication Foundation (WCF) に用意されている管理機能および診断機能の使用方法について説明します。

パフォーマンス カウンター

WCF には、トランザクション アプリケーションのパフォーマンスを測定するための、標準のパフォーマンス カウンターが用意されています。詳細については、次のトピックを参照してください。、「WCF パフォーマンス カウンター」を参照してください。

パフォーマンス カウンターには次の表に示すように、サービス、エンドポイント、操作の 3 つのレベルがあります。

サービス パフォーマンス カウンター

パフォーマンス カウンター 説明

トランザクション フロー

このサービスで操作に対して実行されたトランザクションの数です。このカウンターは、サービスに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。

1 秒あたりのトランザクション フロー

このサービスの操作に対して実行された 1 秒あたりのトランザクションの数です。このカウンターは、サービスに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。

コミットされたトランザクション操作

このサービスで、結果がコミットされた状態で完了したトランザクション操作の数です。そのような操作中に実行された作業は完全にコミットされました。リソースは、操作で実行された作業に応じて更新されます。

1 秒あたりのコミットされたトランザクション操作

このサービスで、結果がコミットされた状態で完了したトランザクション操作の 1 秒あたりの数です。そのような操作中に実行された作業は完全にコミットされました。リソースは、操作で実行された作業に応じて更新されます。

中止されたトランザクション操作

このサービスで、結果が中止された状態で完了したトランザクション操作の数です。そのような操作中に実行された作業はロールバックされました。リソースは、それぞれの直前の状態に復元されました。

1 秒あたりの中止されたトランザクション操作

このサービスで、結果が中止された状態で完了したトランザクション操作の 1 秒あたりの数です。そのような操作中に実行された作業はロールバックされました。リソースは、それぞれの直前の状態に復元されました。

不明なトランザクション操作

このサービスで、結果が不明な状態で完了したトランザクション操作の数です。結果が不明な作業は中間状態になります。リソースは、保留中となります。

1 秒あたりの不明なトランザクション操作

このサービスで、結果が不明な状態で完了したトランザクション操作の 1 秒あたりの数です。結果が不明な作業は中間状態になります。リソースは、保留中となります。

エンドポイントのパフォーマンス カウンター

パフォーマンス カウンター 説明

トランザクション フロー

このエンドポイントでの操作に対して実行されたトランザクションの数。このカウンターは、エンドポイントに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。

1 秒あたりのトランザクション フロー

毎秒ごとにこのエンドポイントでの操作に対して実行されたトランザクションの数。このカウンターは、エンドポイントに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。

操作パフォーマンス カウンター

パフォーマンス カウンター 説明

トランザクション フロー

このエンドポイントでの操作に対して実行されたトランザクションの数。このカウンターは、エンドポイントに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。

1 秒あたりのトランザクション フロー

毎秒ごとにこのエンドポイントでの操作に対して実行されたトランザクションの数。このカウンターは、エンドポイントに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。

WMI (Windows Management Instrumentation)

WCF は WCF WMI (Windows Management Instrumentation) プロバイダーを介して実行時のサービスの検査データを公開します。WMI データへのアクセス詳細情報、「診断用の WMI (Windows Management Instrumentation) の使用」を参照してください。

WMI プロパティには、サービスに適用されるトランザクション設定を示す読み取り専用のプロパティが多数あります。次の表にこれらの設定をすべて示します。

サービスの ServiceBehaviorAttribute には、次のプロパティがあります。

名前 型 説明

ReleaseServiceInstanceOnTransactionComplete

Boolean

現在のトランザクションの完了時に、サービス オブジェクトをリサイクルするかどうかを指定します。

TransactionAutoCompleteOnSessionClose

Boolean

現在のセッションの終了時に、保留中のトランザクションを完了するかどうかを指定します。

TransactionIsolationLevel

IsolationLevel 列挙体の有効な値を含む文字列。

このサービスがサポートするトランザクションの分離レベルを指定します。

TransactionTimeout

DateTime

トランザクションを完了しなければならない期間を指定します。

ServiceTimeoutsBehavior には、次のプロパティがあります。

名前 型 説明

TransactionTimeout

DateTime

トランザクションを完了しなければならない期間を指定します。

バインディングの TransactionFlowBindingElement には、次のプロパティがあります。

名前 型 説明

TransactionProtocol

TransactionProtocol 型の有効な値を含む文字列。

トランザクションをフローさせるために使用するトランザクション プロトコルを指定します。

TransactionFlow

Boolean

受信トランザクション フローを有効にするかどうかを指定します。

操作の OperationBehaviorAttribute には、次のプロパティがあります。

名前 型 説明

TransactionAutoComplete

Boolean

未処理の例外が発生しなかった場合に、現在のトランザクションを自動的にコミットするかどうかを指定します。

TransactionScopeRequired

Boolean

操作がトランザクションを必要とするかどうかを指定します。

操作の TransactionFlowAttribute には、次のプロパティがあります。

名前 型 説明

TransactionFlowOption

TransactionFlowOption 列挙体の有効な値を含む文字列。

トランザクション フローが要求される範囲を指定します。

トレース

トレースを使用すると、トランザクション アプリケーションにおけるエラーを監視および分析できます。トレースは次の方法を使用して有効にできます。

  • WCF の標準トレース

    このトレースは、通常の WCF アプリケーションのトレースと同じものです。詳細については、次のトピックを参照してください。、「トレースの構成」を参照してください。

  • WS-AtomicTransaction トレース

    WS-AtomicTransaction トレースは、WS-AtomicTransaction 構成ユーティリティ (wsatConfig.exe) を使用して有効にできます。このトレースでは、トランザクションの状態とシステム内の参加要素を把握できます。内部のサービス モデル トレースも有効にするには、HKLM\SOFTWARE\Microsoft\WSAT\3.0\ServiceModelDiagnosticTracing レジストリ キーを SourceLevels 列挙体の有効な値に設定します。メッセージ ログは、他の WCF アプリケーションと同じ方法で有効にできます。

  • System.Transactions トレース

    OleTransactions プロトコルを使用する場合、プロトコル メッセージはトレースできません。System.Transactions インフラストラクチャではトレースがサポートされるため (OleTransactions を使用)、ユーザーはトランザクションで発生したイベントを確認できます。System.Transactions アプリケーションのトレースを有効にするには、App.config 構成ファイルに次のコードを含めます。

    <configuration>
  <system.diagnostics>
     <sources>
        <source name="System.Transactions" switchValue="Verbose, ActivityTracing">
           <listeners>
              <add name="Text"
                 type="System.Diagnostics.XmlWriterTraceListener"
                 initializeData="SysTx.log"
                 traceOutputOptions="Callstack" />
           </listeners>
        </source>
     </sources>
     <trace autoflush="true" indentsize="4">
     </trace>
  </system.diagnostics>
</configuration>

    System.Transactions インフラストラクチャは WCF でも使用されるので、このコードにより、WCF のトレースも有効になります。

参照

リファレンス

WS-AtomicTransaction 構成ユーティリティ (wsatConfig.exe)

概念

管理と診断
トレースの構成