Specifying a Counter Path (Especificar una ruta de acceso de contador)
El sistema usa contadores para recopilar datos de rendimiento. Cada contador se identifica de forma única a través de su nombre y su ruta de acceso, o ubicación. La sintaxis de una ruta de acceso de contador es:
\\Computer\PerfObject(ParentInstance/ObjectInstance#InstanceIndex)\Counter
El elemento Computer especifica el nombre o la dirección IP del equipo desde el que desea consultar los datos de rendimiento. El nombre del equipo es opcional si el contador se encuentra en el equipo local.
El elemento PerfObject especifica el objeto de rendimiento que se va a consultar. Un objeto de rendimiento puede ser un componente físico, como procesadores, discos y memoria, o un objeto del sistema, como procesos y subprocesos. Cada objeto del sistema está relacionado con un elemento funcional dentro del equipo y tiene asignado un conjunto de contadores estándar. Cada equipo puede tener un conjunto diferente de objetos de rendimiento y contadores instalados en él porque las aplicaciones pueden instalar sus propios objetos de rendimiento y contadores. Para obtener una lista de los objetos de rendimiento y contadores instalados en el equipo, vea el cuadro de diálogo Agregar contadores en la herramienta Rendimiento del equipo. Estos objetos también se muestran en el cuadro de diálogo Examinar PDH (consulte Contadores de exploración). Para obtener una lista de los contadores y objetos de rendimiento del sistema, vea Contadores por objeto.
ParentInstance, ObjectInstance e InstanceIndex se incluyen en la ruta de acceso si pueden existir varias instancias del objeto. Por ejemplo, los procesos y los subprocesos son varios objetos de instancia porque se puede ejecutar más de un proceso o subproceso al mismo tiempo. Si un objeto puede tener más de una instancia, la ruta de acceso del contador debe especificar una instancia de objeto.
El formato de los elementos relacionados con la instancia depende del tipo de objeto. Si el objeto tiene instancias simples, el formato es solo el nombre de instancia entre paréntesis. Por ejemplo:
(Explorer)
Si la instancia de este objeto también requiere un nombre de instancia principal, el nombre de instancia principal debe venir antes de la instancia del objeto y estar separado por un carácter de barra diagonal. Por ejemplo, los subprocesos pertenecen a procesos. Si consulta un objeto de subproceso, también debe especificar el proceso al que pertenece, como se muestra en el ejemplo siguiente:
(Explorer/0)
Si el objeto tiene varias instancias que tienen la misma cadena de nombre, se pueden indexar secuencialmente especificando el índice de instancia precedido por un signo de libra. Los índices de instancia se basan en 0. Si desea consultar la primera instancia, no incluya #0, solo tiene que especificar el nombre de la instancia. Para especificar la segunda instancia, use #1; para especificar la tercera instancia, use #2; y así sucesivamente. Por ejemplo:
(Explorer/0#1)
El elemento Counter especifica el contador de rendimiento que desea consultar para el determinado objeto de rendimiento.
PDH usa los siguientes caracteres especiales en una ruta de acceso de contador. Los proveedores no deben usar estos caracteres en sus nombres. Si un proveedor usa estos caracteres especiales, PDH no puede analizar la ruta de acceso de contador completa para obtener los nombres de contador e instancias.
| Carácter | Descripción |
|---|---|
| \ | Separador genérico para equipo, objeto y contador. |
| ( | Principio del nombre de instancia. |
| ) | Final del nombre de la instancia. |
| / | Separa la instancia y la instancia primaria. |
| #n | Identifica una aparición específica de una instancia con el mismo nombre. |
| * | Carácter comodín. |
En los ejemplos siguientes se muestran los posibles formatos para las rutas de acceso de contador:
- \\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
Uso de caracteres comodín
Las rutas de acceso de contador pueden contener un carácter comodín solo para el nombre de instancia, como se muestra en el ejemplo siguiente.
\Process(*)\% Processor Time
Para expandir el carácter comodín en una lista de rutas de acceso de contador que contienen instancias que se encuentran en el equipo o en el archivo de registro, llame a PdhExpandWildCardPath.