Specifying a Counter Path (Specifica di un percorso di contatore)
Il sistema usa i contatori per raccogliere i dati sulle prestazioni. Ogni contatore viene identificato in modo univoco tramite il nome e il relativo percorso o posizione. La sintassi di un percorso del contatore è:
\\Computer\PerfObject(ParentInstance/ObjectInstance#InstanceIndex)\Counter
L'elemento Computer specifica il nome o l'indirizzo IP del computer da cui si desidera eseguire query sui dati sulle prestazioni. Il nome del computer è facoltativo se il contatore si trova nel computer locale.
L'elemento PerfObject specifica l'oggetto prestazioni su cui eseguire la query. Un oggetto prestazioni può essere un componente fisico, ad esempio processori, dischi e memoria, o un oggetto di sistema, ad esempio processi e thread. Ogni oggetto di sistema è correlato a un elemento funzionale all'interno del computer e dispone di un set di contatori standard assegnati. Ogni computer può avere un set diverso di oggetti prestazioni e contatori installati in esso, perché le applicazioni possono installare i propri oggetti prestazioni e contatori. Per un elenco degli oggetti prestazioni e dei contatori installati nel computer, vedere la finestra di dialogo Aggiungi contatori nello strumento Prestazioni nel computer. Questi oggetti sono elencati anche nella finestra di dialogo Sfoglia PDH (vedere Esplora contatori). Per un elenco di oggetti e contatori delle prestazioni di sistema, vedere Contatori per oggetto.
ParentInstance, ObjectInstance e InstanceIndex sono inclusi nel percorso se possono esistere più istanze dell'oggetto. Ad esempio, i processi e i thread sono più oggetti di istanza perché più processi o thread possono essere eseguiti contemporaneamente. Se un oggetto può avere più di un'istanza, il percorso del contatore deve specificare un'istanza dell'oggetto.
Il formato degli elementi correlati all'istanza dipende dal tipo di oggetto. Se l'oggetto ha istanze semplici, il formato è solo il nome dell'istanza racchiuso tra parentesi. Ad esempio:
(Explorer)
Se l'istanza di questo oggetto richiede anche un nome di istanza padre, il nome dell'istanza padre deve precedere l'istanza dell'oggetto e essere separato da un carattere barra. Ad esempio, i thread appartengono ai processi. Se si esegue una query su un oggetto thread, è necessario specificare anche il processo a cui appartiene, come illustrato nell'esempio seguente:
(Explorer/0)
Se l'oggetto ha più istanze con la stessa stringa di nome, possono essere indicizzate in sequenza specificando l'indice dell'istanza preceduto da un segno di cancelletto. Gli indici dell'istanza sono basati su 0. Se si vuole eseguire una query sulla prima istanza, non includere #0, specificare solo il nome dell'istanza. Per specificare la seconda istanza, usare #1; per specificare la terza istanza, usare #2; E così via. Ad esempio:
(Explorer/0#1)
L'elemento Counter specifica il contatore delle prestazioni su cui si desidera eseguire una query per l'oggetto prestazioni specificato.
PDH usa i caratteri speciali seguenti in un percorso del contatore. I provider non devono usare questi caratteri nei nomi. Se un provider utilizza questi caratteri speciali, PDH non può analizzare il percorso completo del contatore per ottenere i nomi dei contatori e delle istanze.
| Carattere | Descrizione |
|---|---|
| \ | Separatore generico per computer, oggetto e contatore. |
| ( | Inizio del nome dell'istanza. |
| ) | Fine del nome dell'istanza. |
| / | Separa l'istanza e l'istanza padre. |
| #n | Identifica un'occorrenza specifica di un'istanza con lo stesso nome. |
| * | Carattere jolly. |
Gli esempi seguenti illustrano i possibili formati per i percorsi dei contatori:
- \\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 dei caratteri jolly
I percorsi dei contatori possono contenere un carattere jolly solo per il nome dell'istanza, come illustrato nell'esempio seguente.
\Process(*)\% Processor Time
Per espandere il carattere jolly in un elenco di percorsi dei contatori che contengono istanze presenti nel computer o nel file di log, chiamare PdhExpandWildCardPath.