Spécification d’un chemin d’accès au compteur
Le système utilise des compteurs pour collecter des données de performances. Chaque compteur est identifié de manière unique par son nom et son chemin ou son emplacement. La syntaxe d’un chemin d’accès de compteur est la suivante :
\\Computer\PerfObject(ParentInstance/ObjectInstance#InstanceIndex)\Counter
L’élément Ordinateur spécifie le nom ou l’adresse IP de l’ordinateur à partir duquel vous souhaitez interroger les données de performances. Le nom de l’ordinateur est facultatif si le compteur se trouve sur l’ordinateur local.
L’élément PerfObject spécifie l’objet de performance à interroger. Un objet de performance peut être un composant physique, tel que des processeurs, des disques et de la mémoire, ou un objet système, tel que des processus et des threads. Chaque objet système est lié à un élément fonctionnel au sein de l’ordinateur et a un ensemble de compteurs standard qui lui sont attribués. Chaque ordinateur peut avoir un ensemble différent d’objets et de compteurs de performances installés sur celui-ci, car les applications peuvent installer leurs propres objets et compteurs de performances. Pour obtenir la liste des objets et compteurs de performances installés sur votre ordinateur, consultez la boîte de dialogue Ajouter des compteurs dans l’outil Performances de votre ordinateur. Ces objets sont également répertoriés dans la boîte de dialogue De navigation PDH (voir Compteurs de navigation). Pour obtenir la liste des objets et compteurs de performances système, consultez Compteurs par objet.
Les objets ParentInstance, ObjectInstance et InstanceIndex sont inclus dans le chemin d’accès si plusieurs instances de l’objet peuvent exister. Par exemple, les processus et les threads sont plusieurs objets d’instance, car plusieurs processus ou threads peuvent s’exécuter simultanément. Si un objet peut avoir plusieurs instances, le chemin d’accès du compteur doit spécifier une instance d’objet.
Le format des éléments associés à l’instance dépend du type d’objet. Si l’objet a des instances simples, le format est uniquement le nom de l’instance entre parenthèses. Par exemple :
(Explorer)
Si l’instance de cet objet nécessite également un nom d’instance parent, le nom de l’instance parente doit être précédé de l’instance de l’objet et être séparé par un caractère de barre oblique. Par exemple, les threads appartiennent à des processus. Si vous interrogez un objet thread, vous devez également spécifier le processus auquel il appartient, comme indiqué dans l’exemple suivant :
(Explorer/0)
Si l’objet a plusieurs instances qui ont la même chaîne de nom, elles peuvent être indexées séquentiellement en spécifiant l’index d’instance précédé d’un signe dièse. Les index d’instance sont basés sur 0. Si vous souhaitez interroger la première instance, n’incluez pas #0, spécifiez simplement le nom de l’instance. Pour spécifier la deuxième instance, utilisez #1 ; pour spécifier la troisième instance, utilisez #2; et ainsi de suite. Par exemple :
(Explorer/0#1)
L’élément Counter spécifie le compteur de performances que vous souhaitez interroger pour l’objet de performance donné.
PDH utilise les caractères spéciaux suivants dans un chemin de compteur. Les fournisseurs ne doivent pas utiliser ces caractères dans leurs noms. Si un fournisseur utilise ces caractères spéciaux, PDH ne peut pas analyser le chemin d’accès complet du compteur pour obtenir les noms de compteur et d’instances.
| Caractère | Description |
|---|---|
| \ | Séparateur générique pour l’ordinateur, l’objet et le compteur. |
| ( | Début du nom de l’instance. |
| ) | Fin du nom de l’instance. |
| / | Sépare l’instance et l’instance parente. |
| #n | Identifie une occurrence spécifique d’une instance nommée identique. |
| * | Caractère générique. |
Les exemples suivants montrent les formats possibles pour les chemins d’accès de compteur :
- \\computer\object(parent/instance#index)\counter
- \\computer\object(parent/instance)\counter
- \\computer\object(instance#index)\counter
- \\computer\object(instance)\counter
- \\computer\object\counter
- \object(parent/instance#index)\counter
- \object(parent/instance)\counter
- \object(instance#index)\counter
- \object(instance)\counter
- \object\counter
Utilisation de caractères génériques
Les chemins d’accès de compteur peuvent contenir un caractère générique uniquement pour le nom de l’instance, comme indiqué dans l’exemple suivant.
\Process(*)\% Processor Time
Pour développer le caractère générique dans une liste de chemins de compteur qui contiennent des instances trouvées sur l’ordinateur ou dans le fichier journal, appelez PdhExpandWildCardPath.