Partager via


classe CIM_BaseMetricDefinition

Représente une définition de métrique qui contient les métadonnées d’un objet CIM_MetricInstance .

Syntaxe

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

Membres

La classe CIM_BaseMetricDefinition a ces types de membres :

Propriétés

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

BreakdownDimensions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Tableau qui contient des chaînes de format libre qui peuvent être utilisées pour décomposer les requêtes d’objets CIM_BaseMetricValue le long d’une certaine dimension. Les chaînes doivent être significatives pour les utilisateurs finaux des données de métrique. En outre, les chaînes doivent indiquer quelles dimensions décomposent sont prises en charge pour la définition de métrique, par l’instrumentation sous-jacente.

Un exemple est un nom de transaction qui permet de décomposer la valeur totale de toutes les transactions dans un ensemble de valeurs, une pour chaque nom de transaction. D’autres exemples sont un système d’application ou un nom de groupe d’utilisateurs.

Calculable

Type de données : uint16

Type d'accès : Lecture seule

Caractéristiques de la métrique utilisée pour effectuer des calculs.

Non calculable (1)

Chaîne. L’arithmétique n’a aucun sens.

Somme ( 2)

Il est raisonnable de sommer cette valeur sur de nombreuses instances de p. ex., UnitOfWork, telles que le nombre de fichiers traités dans un travail de sauvegarde. Par exemple, si chaque travail de sauvegarde est un UnitOfWork et que chaque travail sauvegarde 27 000 fichiers en moyenne, il est judicieux de dire que 100 travaux de sauvegarde ont traité 2 700 000 fichiers.

Non additionable (3)

Il n’est pas judicieux de sommer cette valeur sur de nombreuses instances d’UnitOfWork. Un exemple serait une métrique qui mesure la longueur de la file d’attente lorsqu’un travail arrive sur un serveur. Si chaque travail est un UnitOfWork et que la longueur moyenne de la file d’attente lorsque chaque travail arrive est 33, il n’est pas judicieux de dire que la longueur de la file d’attente pour 100 travaux est de 3300. Il est judicieux de dire que la moyenne est 33.

ChangeType

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_BaseMetricDefinition. IsContinuous »)

Indique comment la valeur de métrique change à l’aide d’attributs courants tels que la modification de direction, les valeurs minimales et maximales, et la sémantique de création de wrapper.

Inconnu (0)

Le concepteur de métriques n’a pas qualifié le ChangeType.

N/A (2)

Si la propriété « IsContinuous » est « false », ChangeType n’est pas logique 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 monotoniquement jusqu’à atteindre le nombre représentant maximal, puis encapsulent et commencent à augmenter à partir de 0. Ces compteurs, également appelés compteurs de substitution, peuvent être utilisés par exemple pour compter le nombre d’erreurs réseau ou le nombre de transactions traitées. La seule façon pour une application cliente d’effectuer le suivi des contours est de récupérer la valeur du compteur dans des intervalles suffisamment courts.

Jauge (4)

La métrique est une métrique de jauge. Ces valeurs ont des valeurs entières ou flottantes qui peuvent augmenter et diminuer arbitrairement. Une jauge ne doit pas être encapsulable lorsqu’elle atteint le nombre minimal ou maximal représenté, à la place, la valeur « sticks » à ce nombre. Valeurs minimales ou maximales à l’intérieur de la plage de valeurs représentées à laquelle la valeur de métrique « sticks » peut ou non être définie.

DMTF Réservé (5..32767)

Fournisseur réservé (32768..65535)

DataType

Type de données : uint16

Type d'accès : Lecture seule

Type de données de la métrique.

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

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.

Inconnu (0)

Indique que le CollectionType n’est pas connu.

OnChange (2)

Indique que les valeurs de métrique CIM sont mises à jour immédiatement lorsque les valeurs à l’intérieur de la ressource mesurée changent. Les valeurs des métriques OnChange reflètent réellement la situation actuelle dans la ressource à tout moment. Par exemple, le nombre d’utilisateurs connectés qui sont mis à jour immédiatement lorsque les utilisateurs se connectent et se désactivent.

Périodique (3)

« : indique que les valeurs de métrique CIM sont mises à jour régulièrement. Par exemple, dans une application cliente, une valeur de métrique s’appliquant à l’heure actuelle apparaît constante pendant chaque intervalle de collecte, puis passe à la nouvelle valeur à la fin de chaque intervalle de collecte.

OnRequest (4)

Indique que la valeur de métrique CIM est déterminée chaque fois qu’une application cliente l’lit. Les valeurs des métriques OnRequest retournent réellement la situation actuelle dans la ressource si quelqu’un le demande. Toutefois, ils ne changent pas « non recommandés », et par conséquent, l’abonnement aux modifications de valeur des métriques OnRequest n’est PAS RECOMMANDÉ.

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é

ID unique de la définition de métrique. Open Software Foundation (OSF) UUID/GUID sont recommandés.

IsContinuous

Type de données : booléen

Type d'accès : Lecture seule

True si la valeur de métrique est continue ; sinon, false.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Nom de la mesure. Ce nom n’a pas besoin d’être unique, mais doit être descriptif et peut contenir des espaces vides.

ProgramUnits

Type de données : chaîne

Type d'accès : Lecture seule

Unités spécifiques d’une valeur. La valeur de cette propriété doit être une valeur légale du qualificateur DSP0004 V2.4 ou version ultérieure, comme défini dans l’annexe C.1 de DSP0004 V2.4 ou ultérieure.

TimeScope

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_BaseMetricValue. TimeStamp " CIM_BaseMetricValue. Durée »)

Étendue de temps qui s’applique au concepteur de métriques.

Inconnu (0)

Indique que l’étendue de temps n’a pas été qualifiée par le concepteur de métriques ou qu’elle n’est pas connue du fournisseur.

Point (2)

Indique que la métrique s’applique à un point dans le temps. Dans les instances BaseMetricValue correspondantes, TimeStamp spécifie le point dans le temps et la durée est toujours 0.

Intervalle (3)

Indique que la métrique s’applique à un intervalle de temps. Dans les instances BaseMetricValue correspondantes, TimeStamp spécifie la fin de l’intervalle de temps et la durée spécifie sa durée

StartupInterval (4)

Indique que la métrique s’applique à un intervalle de temps qui a commencé au démarrage de la ressource mesurée (par exemple, ManagedElement associé par MetricDefForMe). Dans les instances BaseMetricValue correspondantes, TimeStamp spécifie la fin de l’intervalle de temps. Si la durée est 0, cela indique que l’heure de démarrage de la ressource mesurée est inconnue. Sinon, Durée spécifie la durée entre le démarrage de la ressource et le 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

Unités de la métrique. Voici des octets, des paquets, des travaux, des fichiers, des millisecondes et des amplis.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 8
Serveur minimal pris en charge
Windows Server 2012
Espace de noms
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Voir aussi

CIM_ManagedElement