CIM_BaseMetricDefinition クラス

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

CIM_MetricInstance オブジェクトのメタデータを含むメトリック定義を表します。

構文

[Abstract, Version("2.22.0"), UMLPackagePath("CIM::Metrics::BaseMetric"), AMENDMENT]
class CIM_BaseMetricDefinition : CIM_ManagedElement
{
  string  Id;
  string  Name;
  uint16  DataType;
  uint16  Calculable;
  string  Units;
  string  BreakdownDimensions[];
  boolean IsContinuous;
  uint16  ChangeType;
  uint16  TimeScope;
  uint16  GatheringType;
  string  ProgrammaticUnits;
};

メンバー

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

Properties

プロパティ

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

BreakdownDimensions

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

特定の次元に沿 ってCIM_BaseMetricValueオブジェクト のクエリを分割するために使用できる自由書式指定文字列を含む配列。文字列は、メトリックデータのエンドユーザーにとって意味がある必要があります。さらに、文字列は、基になるインストルメンテーションによって、メトリック定義でサポートされている分割ディメンションを示す必要があります。

たとえば、すべてのトランザクションの合計値を一連の値 (トランザクション名ごとに 1 つずつ) に分割できるトランザクション名があります。その他の例としては、アプリケーションシステムやユーザーグループ名があります。

微積分

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

計算の実行に使用されるメトリックの特性。

計算不可能 (1)

文字列。算術演算は意味がありません。

合計可能 (2)

この値は、バックアップジョブで処理されたファイルの数など、UnitOfWork などの多くのインスタンスで合計するのが妥当です。たとえば、各バックアップジョブが UnitOfWork で、各ジョブが平均で 27,000 個のファイルをバックアップする場合、100 個のバックアップジョブが 2,700,000 個のファイルを処理したと言うのが理にかなっています。

合計不可 (3)

UnitOfWork の多くのインスタンスに対してこの値を合計しても意味がありません。たとえば、ジョブがサーバーに到着したときのキューの長さを測定するメトリックです。各ジョブが UnitOfWork で、各ジョブが到着したときの平均キュー長が 33 の場合、100 個のジョブのキュー長が 3300 であるとは言えません。平均が 33 であると言うのは理にかなっています。

ChangeType

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: ModelCorrespondence ("CIM_BaseMetricDefinition。IsContinuous")

方向の変化、最小値と最大値、ラップセマンティクスなどの一般的な属性を使用してメトリック値がどのように変化するかを示します。

不明 (0)

メトリックデザイナーが ChangeType を修飾しませんでした。

N/A (2)

"IsContinuous" プロパティが "false" の場合、ChangeType は意味をなせず、"N/A" に設定されている必要があります。

カウンター (3)

メトリックはカウンターメトリックです。これらは負でない整数値を持ち、表現可能な最大数に達するまで単調に増加し、ラップして 0 から増加し始めます。このようなカウンター (ロールオーバーカウンターとも呼ばれます) を使用して、ネットワークエラーの数や処理されたトランザクションの数をカウントできます。クライアントアプリケーションがラップアラウンドを追跡する唯一の方法は、適切に短い間隔でカウンターの値を取得することです。

ゲージ (4)

メトリックはゲージメトリックです。これらには、任意に増減できる整数または浮動小数点値があります。ゲージは、最小または最大の表現可能な数に達したときにラップすることはできません。代わりに、値はその数値に "スティック" します。メトリック値が "スティック" する表現可能な値の範囲内の最小値または最大値は、定義されている場合と定義されていない場合があります。

DMTF 予約済み (5..32767)

ベンダー予約済み (32768..65535)

DataType

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

メトリックのデータ型。

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)

GatheringType

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

基になるインストルメンテーションによってメトリック値がどのように収集されるかを示します。

不明 (0)

GatheringType が不明であることを示します。

OnChange (2)

測定されたリソース内の値が変更されると、CIM メトリック値が直ちに更新されることを示します。 OnChange メトリックの値は、リソース内の現在の状況を常に反映しています。たとえば、ログオンしているユーザーの数は、ユーザーのログオンとオフが切り替わるとすぐに更新されます。

定期的 (3)

": CIM メトリック値が定期的に更新されることを示します。たとえば、クライアントアプリケーションでは、現在の時刻に適用されるメトリック値は、収集間隔ごとに一定に表示され、各収集間隔の最後に新しい値にジャンプします。

OnRequest (4)

CIM メトリック値は、クライアントアプリケーションが読み取るたびに決定されることを示します。 OnRequest メトリックの値は、誰かが要求した場合に、リソース内の現在の状況を本当に返します。ただし、"未観察" は変更されないため、OnRequest メトリックの値の変更をサブスクライブすることは推奨されません。

DMTF 予約済み (5..32767)

ベンダー予約済み (32768..65535)

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

メトリック定義の一意の ID。 Open Software Foundation (OSF) UUID/GUID をお勧めします。

IsContinuous

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

メトリック値が連続している場合は True。それ以外の場合は false。

Name

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

メトリックの名前。この名前は一意である必要はありませんが、わかりやすい名前にする必要があり、空白を含めることができます。

ProgrammaticUnits

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

値の特定の単位。このプロパティの値は、DSP0004 V2.4 以降の付録 C.1 で定義されているプログラム単位修飾子の有効な値である必要があります。

TimeScope

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: ModelCorrespondence ("CIM_BaseMetricValue。TimeStamp", "CIM_BaseMetricValue.期間")

メトリックデザイナーに適用される時間スコープ。

不明 (0)

時間スコープがメトリックデザイナーによって修飾されなかったか、プロバイダーが不明であることを示します。

ポイント (2)

メトリックがポイントインタイムに適用されることを示します。対応する BaseMetricValue インスタンスでは、TimeStamp は時点を指定し、Duration は常に 0 です。

間隔 (3)

メトリックが時間間隔に適用されることを示します。対応する BaseMetricValue インスタンスで、TimeStamp は時間間隔の終了を指定し、Duration はその期間を指定します

StartupInterval (4)

メトリックが、測定されたリソースの起動時に開始された時間間隔 (つまり、MetricDefForMe に関連付けられた ManagedElement) に適用されることを示します。対応する BaseMetricValue インスタンスで、TimeStamp は時間間隔の終了を指定します。 Duration が 0 の場合、これは測定されたリソースの起動時間が不明であることを示します。それ以外の場合、Duration は、リソースの起動と TimeStamp の間の期間を指定します。

DMTF 予約済み (5..32767)

ベンダー予約済み (32768..65535)

ユニット

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

メトリックの単位。たとえば、バイト、パケット、ジョブ、ファイル、ミリ秒、amps などです。

要件

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

こちらもご覧ください

CIM_ManagedElement

次の方法で共有

CIM_BaseMetricDefinition クラス

構文

メンバー

プロパティ

要件

こちらもご覧ください

フィードバック

その他のリソース