Msvm_AggregationMetricDefinition クラス

[アーティクル]
06/13/2023

別のメトリック値から派生したメトリックの定義の側面を表します。 Msvm_AggregationMetricDefinition オブジェクトは、適用先のマネージド要素に関連付ける必要があります。

次の構文は、簡略化されたマネージドオブジェクト形式 (MOF) コードであり、継承されたすべてのプロパティが含まれています。

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_AggregationMetricDefinition : CIM_AggregationMetricDefinition
{
  string  InstanceID;
  string  Caption;
  string  Description;
  string  ElementName;
  string  Id;
  string  Name;
  uint16  DataType;
  uint16  Calculable;
  string  Units;
  string  BreakdownDimensions[];
  boolean IsContinuous;
  uint16  ChangeType;
  uint16  TimeScope;
  uint16  GatheringType;
  string  ProgrammaticUnits;
  uint16  SimpleFunction;
};

メンバー

Msvm_AggregationMetricDefinition クラスには、次の種類のメンバーがあります。

Properties

プロパティ

Msvm_AggregationMetricDefinition クラスには、これらのプロパティがあります。

BreakdownDimensions

データ型: 文字列 配列
アクセスの種類: 読み取り専用

特定のディメンションに沿ってメトリック値に対してクエリを絞り込む (分割する) ための 1 つ以上の文字列を定義します。たとえば、トランザクション名を使用すると、すべてのトランザクションの合計値を一連の値 (トランザクション名ごとに 1 つずつ) に分割できます。その他の例としては、アプリケーションシステム名やユーザーグループ名があります。文字列は自由形式であり、メトリックデータのエンドユーザーにとって意味がある必要があります。この文字列は、基になるインストルメンテーションによってこのメトリック定義でサポートされている分割ディメンションを示します。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

微積分

データ型: uint16
アクセスの種類: 読み取り専用

計算を実行するためのメトリックの特性について説明します。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。 Null または次のいずれかの値を指定できます。

値	説明
計算不可能 1	値を計算できません。たとえば、文字列です。
Summable 2	値は、多くのインスタンスで合計できます。たとえば、各バックアップジョブが作業単位であり、各ジョブが平均で 27,000 ファイルをバックアップする場合、100 個のバックアップジョブで 2,700,000 個のファイルが処理されます。
合計不可 3	この値は、多くのインスタンスで合計することはできません。たとえば、ジョブがサーバーに到着したときのキューの長さを測定するメトリックです。各ジョブが作業単位であり、各ジョブが到着したときの平均キュー長が 33 である場合、100 個のジョブのキュー長が 3300 であるとは言えません。平均が 33 であると言うのは理にかなっています。

Caption

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの簡単な説明。このプロパティは、 CIM_ManagedElementから継承されます。

ChangeType

データ型: uint16
アクセスの種類: 読み取り専用

方向の変化、最小値と最大値、ラップセマンティクスなど、より細かいグレイン属性の一般的な組み合わせの形式で、メトリック値がどのように変化するかを示します。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

値	説明
Unknown 0	メトリックデザイナーが ChangeType を修飾しませんでした。
N/A 2	IsContinuous プロパティが "false" の場合、ChangeType は意味をなさないため、"N/A" に設定する必要があります。
カウンター 3	メトリックはカウンターメトリックです。これらは負でない整数値を持ち、表現可能な最大数に達するまで増加し、ラップして 0 から増加を開始します。
ゲージ 4	メトリックはゲージメトリックです。これらには、任意に増減できる整数または浮動小数点値があります。
DMTF 予約済み 5..32767
ベンダー予約済み 32768..65535	ベンダーは、ベンダーの予約範囲内で ChangeType プロパティを拡張できます。

DataType

データ型: uint16
アクセスの種類: 読み取り専用

メトリックのデータ型。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

boolean (1)
char16 (2)
datetime (3)
real32 (4)
real64 (5)
sint16 (6)
sint32 (7)
sint64 (8)
sint8 (9)
string (10)
uint16 (11)
uint32 (12)
uint64 (13)
uint8 (14 )

説明

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの説明。このプロパティは、 CIM_ManagedElementから継承されます。

ElementName

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの表示名。このプロパティは、 CIM_ManagedElementから継承されます。

GatheringType

データ型: uint16
アクセスの種類: 読み取り専用

基になるインストルメンテーションによってメトリック値がどのように収集されるかを示します。これにより、クライアントアプリケーションは目的に適したメトリックを選択できます。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。 Null または次 のいずれかの値を指定できます。

値	説明
Unknown 0	収集の種類が不明です。
Onchange 2	メトリック値は、測定されたリソース内の値が変更されると直ちに更新されます。
定期的 3	メトリック値は定期的に更新されます。たとえば、クライアントアプリケーションでは、現在の時刻に適用されるメトリック値は、収集間隔ごとに一定に表示され、各収集間隔の最後に新しい値にジャンプします。
OnRequest 4	メトリック値は、クライアントアプリケーションが読み取るたびに決定されます。
DMTF 予約済み 5..32767
ベンダー予約済み 32768..65535

Id

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

メトリック定義を一意に識別する文字列。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

InstanceID

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

このクラスのインスタンスを一意に識別する文字列。このプロパティは、 CIM_ManagedElementから継承されます。

IsContinuous

データ型: boolean
アクセスの種類: 読み取り専用

メトリック値が連続かスカラーかを示します。パフォーマンスメトリックは、継続的メトリックの例です。スカラーメトリックの例としては、エラーコードや操作状態があります。連続メトリックは、"より大きい" 関係を使用して比較できます。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

名前

データ型: string
アクセスの種類: 読み取り専用

メトリックの名前。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

ProgrammaticUnits

データ型: string
アクセスの種類: 読み取り専用

値の特定の単位を識別します。このプロパティの値は、 DSP0004 V2.4 以降の付録 C.1 で定義されているプログラム単位修飾子の有効な値になります。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

SimpleFunction

データ型: uint16
アクセスの種類: 読み取り/書き込み

この派生メトリックの値に到達するために基になるメトリックに対して実行される基本的な計算を識別します。このプロパティは CIM_AggregationMetricDefinition から継承され、次のいずれかの値になります。

最小 (2)
最大 (3)
平均 (4)
Median (5)
モード (6)

TimeScope

データ型: uint16
アクセスの種類: 読み取り専用

メトリック値が適用される時間スコープを示します。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

値	説明
Unknown 0	時間スコープがメトリックデザイナーによって修飾されていないか、プロバイダーが不明です。
Point 2	メトリックは、ある時点に適用されます。対応する Msvm_BaseMetricValue インスタンスでは、 TimeStamp プロパティは特定の時点を指定し、 Duration プロパティは常に 0 です。
間隔 3	メトリックは時間間隔に適用されます。対応する Msvm_BaseMetricValue インスタンスでは、 TimeStamp プロパティは時間間隔の終了を指定し、 Duration プロパティはその期間を指定します。
StartupInterval 4	メトリックは、測定されたリソースの起動時に開始された時間間隔 (つまり、MetricDefForMe に関連付けられた ManagedElement) に適用されます。対応する Msvm_BaseMetricValue インスタンスで、 TimeStamp プロパティは時間間隔の終了を指定します。 Duration プロパティが 0 の場合、測定されたリソースの起動時間が不明であることを示します。それ以外の場合、 Duration は、リソースの起動と TimeStamp の間の期間を指定します。
DMTF 予約済み 5..32767
ベンダー予約済み 32768..65535

ユニット

データ型: string
アクセスの種類: 読み取り専用

値の単位 ("メガバイト" など) を識別します。このプロパティは、 CIM_BaseMetricDefinitionから継承されます。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
名前空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
[DLL]	Vmms.exe

次の方法で共有

Msvm_AggregationMetricDefinition クラス

構文

メンバー

プロパティ

要件

フィードバック

その他のリソース