Especificar um Caminho do Contador
O sistema usa contadores para coletar dados de desempenho. Cada contador é identificado exclusivamente por meio de seu nome e seu caminho ou local. A sintaxe de um caminho de contador é:
\\Computer\PerfObject(ParentInstance/ObjectInstance#InstanceIndex)\Counter
O elemento Computer especifica o nome ou endereço IP do computador do qual você deseja consultar dados de desempenho. O nome do computador será opcional se o contador estiver localizado no computador local.
O elemento PerfObject especifica o objeto de desempenho a ser consultado. Um objeto de desempenho pode ser um componente físico, como processadores, discos e memória, ou um objeto do sistema, como processos e threads. Cada objeto do sistema está relacionado a um elemento funcional dentro do computador e tem um conjunto de contadores padrão atribuídos a ele. Cada computador pode ter um conjunto diferente de objetos e contadores de desempenho instalados nele porque os aplicativos podem instalar seus próprios objetos e contadores de desempenho. Para obter uma lista dos objetos e contadores de desempenho instalados no computador, consulte a caixa de diálogo Adicionar Contadores na ferramenta Desempenho no computador. Esses objetos também são listados na caixa de diálogo Procurar PDH (consulte Contadores de Navegação). Para obter uma lista de objetos e contadores de desempenho do sistema, consulte Contadores por Objeto.
ParentInstance, ObjectInstance e InstanceIndex serão incluídos no caminho se várias instâncias do objeto puderem existir. Por exemplo, processos e threads são vários objetos de instância porque mais de um processo ou thread pode ser executado ao mesmo tempo. Se um objeto puder ter mais de uma instância, o caminho do contador deverá especificar uma instância de objeto.
O formato dos elementos relacionados à instância depende do tipo de objeto. Se o objeto tiver instâncias simples, o formato será apenas o nome da instância entre parênteses. Por exemplo:
(Explorer)
Se a instância desse objeto também exigir um nome de instância pai, o nome da instância pai deverá vir antes da instância do objeto e ser separado por um caractere de barra de avanço. Por exemplo, os threads pertencem a processos. Se você consultar um objeto thread, também deverá especificar o processo ao qual ele pertence, conforme mostrado no exemplo a seguir:
(Explorer/0)
Se o objeto tiver várias instâncias que têm a mesma cadeia de caracteres de nome, elas poderão ser indexadas sequencialmente especificando o índice de instância prefixado por um sinal de libra. Os índices de instância são baseados em 0. Se você quiser consultar a primeira instância, não inclua #0, apenas especifique o nome da instância. Para especificar a segunda instância, use #1; para especificar a terceira instância, use nº 2; e assim por diante. Por exemplo:
(Explorer/0#1)
O elemento Counter especifica o contador de desempenho que você deseja consultar para o objeto de desempenho fornecido.
O PDH usa os seguintes caracteres especiais em um caminho de contador. Os provedores não devem usar esses caracteres em seus nomes. Se um provedor usar esses caracteres especiais, o PDH não poderá analisar o caminho completo do contador para obter os nomes do contador e das instâncias.
| Caractere | Descrição |
|---|---|
| \ | Separador genérico para computador, objeto e contador. |
| ( | Início do nome da instância. |
| ) | Término do nome da instância. |
| / | Separa a instância e a instância pai. |
| #n | Identifica uma ocorrência específica de uma instância de mesmo nome. |
| * | Caractere curinga. |
Os exemplos a seguir mostram os formatos possíveis para caminhos 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
Usando caracteres curinga
Os caminhos de contador podem conter um caractere curinga somente para o nome da instância, conforme mostrado no exemplo a seguir.
\Process(*)\% Processor Time
Para expandir o curinga em uma lista de caminhos de contador que contêm instâncias encontradas no computador ou no arquivo de log, chame PdhExpandWildCardPath.