Qualificateurs de propriété pour les classes de compteur de performances

  • Article

Les qualificateurs de propriété spécifient les informations relatives au compteur de performances auquel la propriété est mappée.

Le compteur de performances fait partie d’un objet de performance représenté par une classe de compteur de performances WMI. Les qualificateurs spécifiques aux compteurs de performances sont automatiquement attachés par le fournisseur WbemPerfClass aux propriétés et aux classes Win32_PerfRawData dans Root\CIMv2.

Ces informations s’appliquent à toutes les instances de la classe de performances. Il arrive que certains qualificateurs dont les valeurs booléennes sont toujours false ne soient pas présents pour des classes spécifiques.

Qualificateurs de propriété pour les classes de performances brutes et mises en forme

La liste suivante énumère les qualificateurs qui s’appliquent aux propriétés des classes dérivées de Win32_PerfRawData ou Win32_PerfFormattedData.

CounterType

sint32

Valeur d’entier dans l’énumération de types de compteur, comme défini dans Winperf.h ou Perflib.h. Le qualificateur CounterType indique la formule ou l’algorithme utilisé afin de calculer la valeur affichée dans le Moniteur système pour le compteur représenté par la propriété.

DisplayName

string

Nom du compteur de performances, tel que spécifié par l’application d’assistance PDH (Performance Data Helper).

HelpIndex

sint32

Non utilisé. Contient toujours 0.

PerfIndex

sint32

Non utilisé. Contient toujours 0.

Qualificateurs de propriété pour les classes de performances brutes

La liste suivante énumère les qualificateurs qui s’appliquent à toutes les propriétés des classes dérivées de Win32_PerfRawData.

PerfDefault

boolean

Indique si cette propriété est le compteur par défaut à utiliser dans les zones de liste. La valeur par défaut de ce qualificateur est False pour les compteurs de performances version 6.0, car ils ne fournissent pas de données. Pour plus d’informations, consultez Compteurs de performances.

DefaultScale

sint32

Puissance de 10 à utiliser pour l’affichage du compteur. Pour zéro, la valeur maximale estimée est 10^0, ou 1.

PerfDetail

sint32

Niveau de connaissances de l’audience. Non utilisé. La valeur est toujours 100.

Qualificateurs de propriété pour les classes de performances mises en forme

La liste suivante énumère les qualificateurs qui s’appliquent à toutes les propriétés des classes dérivées de Win32_PerfFormattedData.

CookingType

string

Type de formule utilisé pour produire le résultat. Chaque type de compteur utilise les autres qualificateurs de propriété pour calculer le résultat affiché sous forme de valeur de la propriété actuelle. Les qualificateurs Counter, PerfTimeStamp et PerfTimeFreq sont mappés aux propriétés d’une classe brute qui fournissent les données.

Pour plus d’informations, consultez CounterType, qualificateur.

Counter

string

Nom d’une propriété obligatoire dans la classe brute correspondante à utiliser en tant que valeur de compteur dans la formule de calcul. La valeur doit correspondre au nom de propriété de la propriété de source de données dans la classe brute correspondante.

PerfTimeStamp

string

Nom d’une propriété d’une classe brute à utiliser en tant que fréquence dans la formule de calcul. La valeur par défaut appropriée au niveau de la classe est utilisée si ce qualificateur n’est pas présent pour la propriété. La fréquence représente les cycles par seconde de l’horodatage.

PerfTimeFreq

string

Nom d’une propriété d’une classe brute à utiliser en tant qu’horodatage dans la formule de calcul. La valeur par défaut appropriée au niveau de la classe est utilisée si ce qualificateur n’est pas présent pour la propriété. Un horodatage généré automatiquement peut introduire une erreur dans un calcul, car l’horodatage est une approximation qui ne prend pas en compte la surcharge liée au marshaling et à la collecte de données réelle.

Comment interpréter les qualificateurs de propriété

Les propriétés des classes Win32_PerfFormattedData contiennent les données calculées transmises par le fournisseur de données de performances mises en forme. La valeur de propriété correspond au résultat calculé final. Les qualificateurs fournissent une recette.

Les qualificateurs Counter et Base pointent vers les sources de données, et CookingType spécifie la formule utilisée pour produire le résultat. L’horodatage et la fréquence d’échantillonnage proviennent également de la classe brute correspondante. Ils sont nommés dans PerfTimeStamp et PerfTimeFreq.

Par exemple, l’une des classes mises en forme fournies par WMI, Win32_PerfFormattedData_PerfDisk_LogicalDisk, contient une propriété nommée AvgDiskBytesPerRead. Le nom de la propriété dans la classe mise en forme doit être le même que celui de la propriété dans la classe brute. La propriété AvgDiskBytesPerRead a les qualificateurs suivants.

La liste suivante énumère les qualificateurs de propriété disponibles pour les propriétés de toutes les classes dérivées de Win32_PerfFormattedData.

Qualificateur Valeur
CookingType PERF_AVERAGE_BULK
Compteur AvgDiskBytesPerRead
PerfTimeStamp Timestamp_PerfTime
PerfTimeFreq Frequency_PerfTime
PerfIndex 408
HelpIndex 409
Base AvgDiskBytesPerRead_Base

 

La propriété AvgDiskBytesPerRead indique le nombre moyen d’octets transférés à partir du disque durant les opérations de lecture. La formule pour PERF_AVERAGE_BULK est la suivante :

(Exemple2 - Exemple1) / (Exemple de base2 - Exemple de base1)

L’opération de lecture est échantillonnée à la fréquence spécifiée par PerfTimeFreq, la valeur PerfTimeStamp indiquant l’échantillon le plus récent. Les données de compteur brutes, exprimées en octets, proviennent de la propriété AvgDiskBytesPerRead de la classe Win32_PerfRawData_PerfDisk_LogicalDisk. Le nombre de données d’opérations de base provient de la propriété AvgDiskBytesPerRead_Base de cette même classe.

Pour plus d’informations, consultez Obtention de données de performances statistiques et Monitoring des données de performances.

Supervision des données de performance

Qualificateurs spécifiques aux classes de performances WMI

Classes de compteur de performances

Accès aux classes de performances préinstallées WMI

Tâches WMI : Analyse des performances