パフォーマンス カウンター クラスのプロパティ修飾子
プロパティ修飾子を使って、プロパティがマップするパフォーマンス カウンターに関する情報を指定できます。
- 生と書式設定されたパフォーマンス クラスのプロパティ修飾子
- 生パフォーマンス クラスのプロパティ修飾子
- 書式設定されたパフォーマンス クラスのプロパティ修飾子
- プロパティ修飾子を解釈する方法
- 関連トピック
パフォーマンス カウンターは、WMI パフォーマンス カウンター クラスで表されるパフォーマンス オブジェクトの一部です。パフォーマンス カウンター固有の修飾子は、WbemPerfClass プロバイダーによって Root\CIMv2 にある Win32_PerfRawData クラスとプロパティに自動的にアタッチされます。
この情報は、パフォーマンス クラスのすべてのインスタンスに適用されます。 常に false であるブール値を持つ一部の修飾子は、特定のクラスに存在しない場合があります。
生と書式設定されたパフォーマンス クラスのプロパティ修飾子
次の一覧は、Win32_PerfRawData または Win32_PerfFormattedData から派生するクラスのプロパティに適用する修飾子をまとめたものです。
-
sint32
Winperf.h または Perflib.h で定義されているカウンター型列挙の整数値です。 CounterType 修飾子は、プロパティが表すカウンターのシステム モニターに表示される値を計算するために使われる数式またはアルゴリズムを示します。
-
DisplayName
-
string
パフォーマンス データ ヘルパー (PDH) で指定されたパフォーマンス カウンター名。
-
HelpIndex
-
sint32
使用されていません。 常に 0 が格納されています。
-
PerfIndex
-
sint32
使用されていません。 常に 0 が格納されています。
生パフォーマンス クラスのプロパティ修飾子
次の一覧は、Win32_PerfRawData から派生したクラスのすべてのプロパティに適用される修飾子の一覧です。
-
PerfDefault
-
boolean
このプロパティが、リスト ボックスで使う既定のカウンターであるかどうかを示します。 パフォーマンス カウンター バージョン 6.0 の場合、データは提供されないため、この修飾子の既定値は False です。 これらのパフォーマンス カウンターの詳細については、「 パフォーマンス カウンター」を参照してください。
-
DefaultScale
-
sint32
カウンターの表示に使う 10 の累乗。 0 の場合、推定最大値は 10^0、つまり 1 です。
-
sint32
対象ユーザーの知識レベル。 使用されていません。 この値は常に 100 です。
書式設定されたパフォーマンス クラスのプロパティ修飾子
次の一覧は、Win32_PerfFormattedData から派生したクラスのすべてのプロパティに適用される修飾子の一覧です。
-
CookingType
-
string
結果を生成するために使われる数式の型。 各カウンターの型には他のプロパティ修飾子を使い、現在のプロパティの値として表示される結果を計算します。 Counter、PerfTimeStamp、PerfTimeFreq 修飾子を使って、データを提供する生クラスのプロパティにマップします。
詳細については、「CounterType 修飾子」を参照してください。
-
Counter
-
string
料理の数式でカウンター値として使う、対応する生クラス内の必須プロパティの名前。 値は、対応する生クラスのデータ ソース プロパティのプロパティ名にする必要があります。
-
PerfTimeStamp
-
string
料理の数式で頻度として使う、生クラス内のプロパティの名前。 この修飾子がプロパティに存在しない場合、クラス レベルの適切な既定値が使われます。 頻度は、タイム スタンプの 1 秒あたりのティック数を表します。
-
PerfTimeFreq
-
string
料理の数式でタイムスタンプとして使う、生クラス内のプロパティの名前。 この修飾子がプロパティに存在しない場合、クラス レベルの適切な既定値が使われます。 自動生成されたタイム スタンプは、タイムスタンプは近似値であり、マーシャリングや実際のデータ収集で発生するオーバーヘッドを考慮していないため、計算に誤差が生じることがあります。
プロパティ修飾子を解釈する方法
Win32_PerfFormattedData クラスのプロパティには、書式設定されたパフォーマンス データ プロバイダーによって提供される計算データが含まれています。 プロパティ値は最終的な計算結果です。 修飾子はレシピを提供します。
Counter 修飾子と Base 修飾子はデータのソースを指し、CookingType は結果を生成するために使われる数式を指定します。 タイムスタンプとサンプル頻度も、対応する生のクラスに由来し、PerfTimeStamp と PerfTimeFreq で名前が付けられます。
たとえば、WMI が提供する書式設定されたクラスの 1 つ Win32_PerfFormattedData_PerfDisk_LogicalDisk には、AvgDiskBytesPerRead というプロパティがあります。 書式設定されたクラスのプロパティ名は、生クラスのプロパティと同じにする必要があります。 AvgDiskBytesPerRead プロパティには次の修飾子があります。
次の一覧は、Win32_PerfFormattedData から派生したすべてのクラスのプロパティに使用できるプロパティ修飾子をまとめたものです。
| 修飾子 | 値 |
|---|---|
| CookingType | PERF_AVERAGE_BULK |
| カウンター | AvgDiskBytesPerRead |
| PerfTimeStamp | Timestamp_PerfTime |
| PerfTimeFreq | Frequency_PerfTime |
| PerfIndex | 408 |
| HelpIndex | 409 |
| Base | AvgDiskBytesPerRead_Base |
AvgDiskBytesPerRead プロパティは、読み取り操作中にディスクから転送される平均バイト数を報告します。 PERF_AVERAGE_BULK の数式は次のとおりです。
(Sample2 - Sample1) / (Base Sample2 - Base Sample1)
読み取り操作は PerfTimeFreq に指定した頻度でサンプリングされ、PerfTimeStamp 値は最新のサンプルを示します。 バイト単位の生カウンター データは、Win32_PerfRawData_PerfDisk_LogicalDisk クラスの AvgDiskBytesPerRead プロパティから取得されます。 演算データの基数は、それと同じクラスの AvgDiskBytesPerRead_Base プロパティから取得されます。
詳細については、「統計パフォーマンス データの取得」と「パフォーマンス データの監視」を参照してください。
関連トピック