Msvm_AggregationMetricDefinition classe

Représente les aspects de définition d’une métrique dérivée d’une autre valeur de métrique. L’objet Msvm_AggregationMetricDefinition doit être associé aux éléments managés auxquels il s’applique.

La syntaxe suivante est le code MOF (Managed Object Format) simplifié et inclut toutes les propriétés héritées.

Syntaxe

[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;
};

Membres

La classe Msvm_AggregationMetricDefinition a les types de membres suivants :

• Propriétés

Propriétés

La classe Msvm_AggregationMetricDefinition possède ces propriétés.

BreakdownDimensions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Définit une ou plusieurs chaînes qui peuvent être utilisées pour affiner (décomposer) les requêtes par rapport aux valeurs de métrique le long d’une certaine dimension. Par exemple, un nom de transaction permet de décomposer la valeur totale de toutes les transactions en un ensemble de valeurs, une pour chaque nom de transaction. D’autres exemples peuvent être le nom du système d’application ou du groupe d’utilisateurs. Les chaînes sont au format libre et doivent être significatives pour les utilisateurs finaux des données de métrique. Les chaînes indiquent quelles dimensions de découpage sont prises en charge pour cette définition de métrique par l’instrumentation sous-jacente. Cette propriété est héritée de CIM_BaseMetricDefinition.

Calculable

Type de données : uint16

Type d'accès : Lecture seule

Décrit les caractéristiques de la métrique à des fins d’exécution de calculs. Cette propriété est héritée de CIM_BaseMetricDefinition. Il peut s’agir de Null ou de l’une des valeurs suivantes.

Valeur	Signification
Non calculable 1	La valeur ne peut pas être calculée. Par exemple, une chaîne.
Sommable 2	La valeur peut être additionnée sur de nombreuses instances. Par exemple, si chaque travail de sauvegarde est une unité de travail et que chaque travail sauvegarde 27 000 fichiers en moyenne, 100 travaux de sauvegarde ont traité 2 700 000 fichiers.
Non sommable 3	Cette valeur ne peut pas être additionnée sur de nombreuses instances. Par exemple, une métrique qui mesure la longueur de la file d’attente lorsqu’un travail arrive sur un serveur. Si chaque travail est une unité de travail et que la longueur moyenne de la file d’attente à l’arrivée de chaque travail est de 33, il n’est pas logique de dire que la longueur de la file d’attente pour 100 travaux est de 3300. Il est logique de dire que la moyenne est 33.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Brève description de l’objet. Cette propriété est héritée de CIM_ManagedElement.

ChangeType

Type de données : uint16

Type d'accès : Lecture seule

Indique comment la valeur de la métrique change, sous la forme de combinaisons classiques d’attributs de grain plus fins tels que le changement de direction, les valeurs minimales et maximales et la sémantique d’habillage. Cette propriété est héritée de CIM_BaseMetricDefinition.

Valeur	Signification
Unknown 0	Le concepteur de métriques n’a pas qualifié le ChangeType.
N/A 2	Si la propriété IsContinuous a la valeur « false », ChangeType n’a pas de sens et doit être définie sur « N/A ».
Compteur 3	La métrique est une métrique de compteur. Celles-ci ont des valeurs entières non négatives qui augmentent jusqu’à atteindre le nombre maximal représentable, puis s’encapsulent et commencent à augmenter à partir de 0.
Jauge 4	La métrique est une métrique de jauge. Celles-ci ont des valeurs entières ou float qui peuvent augmenter et diminuer arbitrairement.
DMTF réservé 5..32767
Fournisseur réservé 32768..65535	Les fournisseurs peuvent étendre la propriété ChangeType dans la plage réservée du fournisseur.

DataType

Type de données : uint16

Type d'accès : Lecture seule

Type de données de la métrique. Cette propriété est héritée de CIM_BaseMetricDefinition.

booléen (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 )

Description

Type de données : chaîne

Type d'accès : Lecture seule

Description de l'objet . Cette propriété est héritée de CIM_ManagedElement.

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom d’affichage de l’objet. Cette propriété est héritée de CIM_ManagedElement.

GatheringType

Type de données : uint16

Type d'accès : Lecture seule

Indique comment les valeurs de métrique sont collectées par l’instrumentation sous-jacente. Cela permet à l’application cliente de choisir la métrique appropriée à cet effet. Cette propriété est héritée de CIM_BaseMetricDefinition. Il peut s’agir de Null ou de l’une des valeurs suivantes.

Valeur	Signification
Unknown 0	Le type de collecte n’est pas connu.
OnChange 2	Les valeurs de métrique sont mises à jour immédiatement lorsque les valeurs à l’intérieur de la ressource mesurée changent.
Périodique 3	Les valeurs de métrique sont régulièrement mises à jour. Par instance, pour une application cliente, une valeur de métrique qui s’applique à l’heure actuelle apparaît constante à chaque intervalle de collecte, puis passe à la nouvelle valeur à la fin de chaque intervalle de collecte.
OnRequest 4	La valeur de métrique est déterminée chaque fois qu’une application cliente la lit.
DMTF réservé 5..32767
Fournisseur réservé 32768..65535

Id

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

Chaîne qui identifie de manière unique la définition de métrique. Cette propriété est héritée de CIM_BaseMetricDefinition.

InstanceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

Chaîne qui identifie de manière unique un instance de cette classe. Cette propriété est héritée de CIM_ManagedElement.

IsContinuous

Type de données : booléen

Type d'accès : Lecture seule

Indique si la valeur de la métrique est continue ou scalaire. Les métriques de performances sont un exemple de métrique continue. Les exemples de métriques scalaires incluent les codes d’erreur ou les états opérationnels. Les métriques continues peuvent être comparées à l’aide de la relation « supérieur à ». Cette propriété est héritée de CIM_BaseMetricDefinition.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Nom de la mesure. Cette propriété est héritée de CIM_BaseMetricDefinition.

ProgramUnits

Type de données : chaîne

Type d'accès : Lecture seule

Identifie les unités spécifiques d’une valeur. La valeur de cette propriété est une valeur légale du qualificateur d’unités programmatiques, tel que défini à l’annexe C.1 de DSP0004 V2.4 ou version ultérieure. Cette propriété est héritée de CIM_BaseMetricDefinition.

SimpleFunction

Type de données : uint16

Type d’accès : Lecture/écriture

Identifie le calcul de base effectué sur une métrique sous-jacente pour arriver à la valeur de cette métrique dérivée. Cette propriété est héritée de CIM_AggregationMetricDefinition et sera l’une des valeurs suivantes.

Minimum (2)

Maximum (3)

Moyenne (4)

Médiane (5)

Mode (6)

TimeScope

Type de données : uint16

Type d'accès : Lecture seule

Indique l’étendue de temps à laquelle la valeur de métrique s’applique. Cette propriété est héritée de CIM_BaseMetricDefinition.

Valeur	Signification
Unknown 0	L’étendue de temps n’a pas été qualifiée par le concepteur de métriques ou est inconnue du fournisseur.
Point 2	La métrique s’applique à un point dans le temps. Sur les instances Msvm_BaseMetricValue correspondantes, la propriété TimeStamp spécifie le point dans le temps, et la propriété Duration est toujours 0.
Intervalle 3	La métrique s’applique à un intervalle de temps. Sur les instances Msvm_BaseMetricValue correspondantes, la propriété TimeStamp spécifie la fin de l’intervalle de temps et la propriété Duration spécifie sa durée.
StartupInterval 4	La métrique s’applique à un intervalle de temps qui a commencé au démarrage de la ressource mesurée (c’est-à-dire, l’élément ManagedElement associé par MetricDefForMe). Sur les instances Msvm_BaseMetricValue correspondantes, la propriété TimeStamp spécifie la fin de l’intervalle de temps. Si la propriété Duration est 0, cela indique que le temps de démarrage de la ressource mesurée est inconnu. Sinon, Duration spécifie la durée entre le démarrage de la ressource et TimeStamp.
DMTF réservé 5..32767
Fournisseur réservé 32768..65535

Unités

Type de données : chaîne

Type d'accès : Lecture seule

Identifie les unités d’une valeur, par exemple , « mégaoctets ». Cette propriété est héritée de CIM_BaseMetricDefinition.

Spécifications