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

[アーティクル]
04/07/2023

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」と入力します。

Note

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

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

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)

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

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

Note

コントラクト名とアドレスが同一の 2 つのエンドポイントは、同じカウンターインスタンスにマップされます。

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

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

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

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

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

Note

1 つのコントラクトに重複した操作名がある場合は、その両方の操作に対してカウンターインスタンスは 1 つだけ取得されます。