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

Windows Communication Foundation (WCF) には、アプリケーションのパフォーマンス測定に役立つ多数のパフォーマンス カウンターが備わっています。

パフォーマンス カウンターの有効化

次のように、WCF サービスの app.config 構成ファイルを使用して WCF サービスのパフォーマンス カウンターを有効にできます。

<configuration>
    <system.serviceModel>
        <diagnostics performanceCounters="All" />
    </system.serviceModel>
</configuration>

特定の種類のパフォーマンス カウンターを有効にするよう performanceCounters 属性を設定できます。有効な値は次のとおりです。

  • All : すべてのカテゴリ カウンター (ServiceModelService、ServiceModelEndpoint、ServiceModelOperation) を有効にします。

  • ServiceOnly : ServiceModelService カテゴリ カウンターのみを有効にします。

  • Off : ServiceModel* パフォーマンス カウンターを無効にします。これが既定値です。

すべての WCF アプリケーションのパフォーマンス カウンターを有効にする場合は、構成設定を Machine.config ファイルに配置します。コンピューターのパフォーマンス カウンター用に十分なメモリを構成する方法については、後の「パフォーマンス カウンターのメモリ サイズの増加」セクションを参照してください。

WCF 機能拡張ポイント (カスタム操作の呼び出し元など) を使用する場合、独自のパフォーマンス カウンターを出力する必要もあります。これは、機能拡張ポイントを実装すると、WCF が既定のパスに標準のパフォーマンス カウンター データを出力できなくなるためです。手動パフォーマンス カウンターのサポートを実装しない場合、予測したパフォーマンス カウンター データが得られない場合があります。

また次のように、コード内でパフォーマンス カウンターを有効にすることもできます。

using System.Configuration;
using System.ServiceModel.Configuration;
using System.ServiceModel.Diagnostics;
Configuration config = ConfigurationManager.OpenExeConfiguration(
    ConfigurationUserLevel.None);
ServiceModelSectionGroup sg = ServiceModelSectionGroup.GetSectionGroup(config);
sg.Diagnostic.PerformanceCounters = PerformanceCounterScope.All;
config.Save();

パフォーマンス データの表示

Windows に付属のパフォーマンス モニター (Perfmon.exe) を使用して、パフォーマンス カウンターによりキャプチャされたデータを表示できます。このツールを起動するには、[スタート] ボタンをクリックし、[ファイル名を指定して実行] をクリックして、ダイアログ ボックスに**「perfmon.exe」**と入力します。

ms735098.note(ja-jp,VS.100).gif注 :
エンドポイント ディスパッチャーによって最後のメッセージが処理される前に、パフォーマンス カウンター インスタンスが解放される場合があります。その結果、パフォーマンス データに一部のメッセージがキャプチャされない可能性があります。

パフォーマンス カウンターのメモリ サイズの増加

WCF は、パフォーマンス カウンター カテゴリごとに別々の共有メモリを使用します。

既定では、個々の共有メモリは、グローバル パフォーマンス カウンターのメモリ サイズの 4 分の 1 に設定されます。グローバル パフォーマンス カウンターのメモリの既定値は 524,288 バイトです。したがって、WCF の 3 つのパフォーマンス カウンター カテゴリの既定サイズは、それぞれ約 128 KB になります。コンピューター上での WCF アプリケーションの実行時特性によっては、パフォーマンス カウンター メモリが足りなくなる場合があります。メモリ不足が発生すると、WCF により、そのアプリケーションのイベント ログにエラーが書き込まれます。エラーの内容にはパフォーマンス カウンターが読み込まれなかったことが示され、エントリには、"System.InvalidOperationException: カスタム カウンター ファイル ビューのメモリが足りません" という例外が含まれます。このエラー レベルでトレースが有効になっている場合は、さらにこの障害がトレースされます。パフォーマンス カウンターのメモリがなくなった場合、パフォーマンス カウンターを有効にして WCF アプリケーションを続行するとパフォーマンスが低下する可能性があります。コンピューターの管理者は、使用可能なすべてのパフォーマンス カウンターをいつでも読み込めるだけの十分なメモリを割り当てておく必要があります。

レジストリで WCF カテゴリごとにパフォーマンス カウンター メモリの量を変更できます。これを行うには、次の 3 つの場所に FileMappingSize という名前の新しい DWORD 値を追加し、目的の値をバイト単位で設定します。コンピューターを再起動すると、設定した値が有効になります。

  • HKLM\System\CurrentControlSet\Services\ServiceModelEndpoint 4.0.0.0\Performance

  • HKLM\System\CurrentControlSet\Services\ServiceModelOperation 4.0.0.0\Performance

  • HKLM\System\CurrentControlSet\Services\ServiceModelService 4.0.0.0\Performance

膨大な数のオブジェクト (ServiceHost など) が破棄され、ガベージ コレクトされるまで待機している場合、PrivateBytes パフォーマンス カウンターには非常に高い数値が登録されます。この問題を解決するには、アプリケーション固有の独自のカウンターを追加するか、performanceCounters 属性を使用してサービス レベルのカウンターだけを有効にします。

パフォーマンス カウンターの種類

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

WMI を使用してパフォーマンス カウンターのインスタンス名を取得できます。次に例を示します。

  • サービス カウンターのインスタンス名は、WMI サービス インスタンスの "CounterInstanceName" プロパティを使用して取得できます。

  • エンドポイント カウンターのインスタンス名は、WMI エンドポイント インスタンスの "CounterInstanceName" プロパティを使用して取得できます。

  • 操作カウンターのインスタンス名は、WMI エンドポイントインスタンスの "GetOperationCounterInstanceName" メソッドを使用して取得できます。

WMI の詳細については、「診断用の WMI (Windows Management Instrumentation) の使用」を参照してください。

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

サービスのパフォーマンス カウンターはサービス動作全体を測定し、サービス全体のパフォーマンスを診断するために使用できます。パフォーマンス モニターを使用して表示する場合、これらのカウンターは、ServiceModelService 4.0.0.0 パフォーマンス オブジェクトの下にあります。インスタンスには次のパターンの名前が付けられています。

ServiceName@ServiceBaseAddress

サービス スコープ内のカウンターは、エンドポイントのコレクションのカウンターが集計されています。

サービス インスタンス作成のパフォーマンス カウンターは、新しい InstanceContext が作成されるとインクリメントされます。新しい InstanceContext は、非アクティブ化メッセージを (既存のサービスで) 受信した場合でも、あるセッションからインスタンスに接続し、セッションを終了後に別のセッションから再接続した場合でも作成されることに注意してください。

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

エンドポイントのパフォーマンス カウンターにより、エンドポイントでのメッセージの受信状況を表すデータを参照できます。パフォーマンス モニターを使用して表示する場合、これらのカウンターは、ServiceModelEndpoint 4.0.0.0 パフォーマンス オブジェクトの下にあります。インスタンスには次のパターンの名前が付けられています。

(ServiceName).(ContractName)@(endpoint listener address)

このデータは、個々の操作で収集されるデータに似ていますが、エンドポイントから集計されただけのデータです。

エンドポイント スコープ内のカウンターは、操作のコレクションのカウンターから集計されます。

ms735098.note(ja-jp,VS.100).gif注 :
コントラクト名とアドレスが同一の 2 つのエンドポイントは、同じカウンター インスタンスにマップされます。

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

パフォーマンス モニターを使用して表示する場合、操作パフォーマンス カウンターは、ServiceModelOperation 4.0.0.0 パフォーマンス オブジェクトの下にあります。それぞれの操作に個別のインスタンスがあります。つまり、指定したコントラクトに 10 の操作がある場合、10 の操作カウンター インスタンスがそのコントラクトに関連付けられます。オブジェクトのインスタンスには次のパターンの名前が付いています。

(ServiceName).(ContractName).(OperationName)@(first endpoint listener address)

このカウンターにより呼び出しがどのように使用されている、操作がどれほど効率的に実行されているかを調べることができます。

カウンターが複数のスコープで表示される場合、上位のスコープで収集されたデータは、下位のスコープからのデータが集計されています。たとえば、エンドポイントの Calls は、エンドポイント内のすべての操作呼び出しの合計を表します。サービスの Calls は、サービス内のすべての操作呼び出しの合計を表します。

ms735098.note(ja-jp,VS.100).gif注 :
1 つのコントラクトに重複した操作名がある場合は、その両方の操作に対してカウンター インスタンスは 1 つだけ取得されます。

WCF パフォーマンス カウンターのプログラミング

プログラムで WCF パフォーマンス カウンターにアクセスできるよう SDK インストール フォルダーにはいくつかのファイルがインストールされています。そのファイルを次に示します。

  • _ServiceModelEndpointPerfCounters.vrg

  • _ServiceModelOperationPerfCounters.vrg

  • _ServiceModelServicePerfCounters.vrg

  • _SMSvcHostPerfCounters.vrg

  • _TransactionBridgePerfCounters.vrg

プログラムでカウンターにアクセスする方法の詳細ついては、「パフォーマンス カウンターのプログラミング アーキテクチャ」を参照してください。

参照

概念

管理と診断