Procedura: connettere il profiler a un servizio nativo per raccogliere statistiche dell'applicazione tramite la riga di comando

In questo argomento viene illustrato come utilizzare gli strumenti da riga di comando disponibili negli strumenti di profilatura di Visual Studio per connettere il profiler a un servizio nativo e raccogliere statistiche sulle prestazioni tramite il metodo di campionamento.

Quando il profiler è connesso al servizio, è possibile sospendere e riprendere la raccolta dei dati.

Per terminare una sessione di profilo, è necessario che il profiler non sia più connesso al servizio e che venga arrestato in modo esplicito.

Avvio dell'applicazione con il profiler

Per connettere il profiler a un servizio nativo, utilizzare le opzioni VSPerfCmd.exe /start e /attach per inizializzare il profiler e connetterlo all'applicazione di destinazione. È possibile specificare /start e /attach e le opzioni relative in un'unica riga di comando. È inoltre possibile aggiungere l'opzione /globaloff per sospendere la raccolta dei dati all'avvio dell'applicazione di destinazione. È quindi possibile utilizzare /globalon per avviare la raccolta dei dati.

Per connettere il profiler a un servizio nativo

1. Se necessario, avviare il servizio.

2. Aprire una finestra del prompt dei comandi.

3. Avviare il profiler. Digitare:

   VSPerfCmd /start:sample /output**:**OutputFile [Options]

   • L'opzione /start:sample consente di inizializzare il profiler.

   • L'opzione **/output:**OutputFile è obbligatoria con /start. OutputFile specifica il nome e il percorso del file dei dati di profilo (vsp).

   È possibile utilizzare qualsiasi opzione riportata di seguito con l'opzione /start:sample.

   Nota

   Le opzioni /user e /crosssession sono in genere obbligatorie per i servizi.

   Opzione	Descrizione
   /user:[Domain\]UserName	Specifica il dominio e il nome utente dell'account proprietario del processo profilato. Questa opzione è obbligatoria solo se il processo è in esecuzione come utente diverso dall'utente connesso. Il proprietario del processo è elencato nella colonna Nome utente della scheda Processi di Gestione attività di Windows.
   /crosssession	Abilita il profilo dei processi in altre sessioni. Questa opzione è obbligatoria se l'applicazione è in esecuzione in una sessione diversa. L'ID di sessione è elencato nella colonna ID sessione della scheda Processi di Gestione attività di Windows. È possibile specificare /CS come abbreviazione per /crosssession.
   /wincounter:WinCounterPath	Specifica un contatore delle prestazioni Windows di cui raccogliere i dati durante il profilo.
   /automark:Interval	Utilizzare unicamente con /wincounter. Specifica il numero di millisecondi tra gli eventi di raccolta dati del contatore delle prestazioni Windows. Il valore predefinito è 500 ms.
   /events:Config	Specifica un evento Traccia eventi per Windows (ETW) di cui raccogliere i dati durante il profilo. Gli eventi ETW vengono raccolti in un file separato con estensione etl.

4. Connettere il profiler al servizio. Digitare:

   **VSPerfCmd /attach:**PID [Sample Event]

   PID specifica l'ID processo dell'applicazione di destinazione. È possibile visualizzare gli ID processo di tutti i processi in esecuzione in Gestione attività di Windows.

   Per impostazione predefinita, i dati di prestazioni vengono campionati ogni 10.000.000 cicli di clock del processore non interrotti, ovvero circa una volta ogni 10 secondi su un processore da 1 GH. È possibile specificare una delle opzioni seguenti per modificare l'intervallo dei cicli di clock o per specificare un evento di campionamento diverso.

   Evento di campionamento	Descrizione
   /timer:Interval	Imposta l'intervallo di campionamento sul numero di cicli di clock non interrotti specificato da Interval.
   /pf[:Interval]	Imposta l'evento di campionamento sugli errori di pagina. Se si specifica Interval, imposta il numero di errori di pagina tra campioni. Il valore predefinito è 10.
   /sys [:Interval]	Imposta l'evento di campionamento sulle chiamate di sistema dal processo al kernel del sistema operativo (syscall). Se si specifica Interval, imposta il numero di chiamate tra campioni. Il valore predefinito è 10.
   /counter:Config	Imposta l'evento e l'intervallo di campionamento sul contatore delle prestazioni del processore e sull'intervallo specificati in Config.

Controllo della raccolta di dati

Quando l'applicazione di destinazione è in esecuzione, è possibile utilizzare le opzioni di VSPerfCmd.exe per avviare e interrompere la scrittura dei dati nel file di dati del profiler. Controllando la raccolta dei dati, è possibile raccogliere dati per una parte specifica dell'esecuzione del programma, ad esempio l'avvio o l'arresto dell'applicazione.

Per avviare e interrompere la raccolta dei dati

• Le coppie seguenti di opzioni di VSPerfCmd avviano e interrompono la raccolta dei dati. Specificare ogni opzione in una riga di comando separata. È possibile attivare e disattivare più volte la raccolta dei dati.

  Opzione	Descrizione
  /globalon /globaloff	Avvia (/globalon) o interrompe (/globaloff) la raccolta dei dati per tutti i processi.
  /processon:PID /processoff:PID	Avvia (/processon) o interrompe (/processoff) la raccolta dei dati per il processo specificato dall'ID processo (PID).
  /attach: {PID|ProcName} /detach[:{PID|ProcName}]	/attach avvia la raccolta di dati per il processo specificato da ID processo o da nome processo. /detach interrompe la raccolta di dati per il processo specificato o per tutti i processi se non è specificato un processo.

• È inoltre possibile utilizzare l'opzione VSPerfCmd.exe /mark per inserire un contrassegno di profilo nel file di dati. Il comando /mark aggiunge un identificatore, un timestamp e una stringa di testo definita dall'utente facoltativa. I contrassegni possono essere utilizzati per filtrare i dati nelle visualizzazioni dati e nei rapporti del profiler.

Fine della sessione di profilo

Per terminare una sessione di profilo, è necessario che il profiler non sia più connesso al servizio e che venga arrestato in modo esplicito. È possibile disconnettere un servizio nativo di cui viene eseguito il profilo con il metodo di campionamento interrompendo il servizio oppure chiamando l'opzione VSPerfCmd /detach. Si chiama quindi l'opzione VSPerfCmd /shutdown per disattivare il profiler e chiudere il file dei dati di profilo.

Per terminare una sessione di profilo

1. Effettuare una delle operazioni seguenti per disconnettere il profiler dall'applicazione di destinazione:

   • Arrestare il servizio.

     oppure

   • Digitare VSPerfCmd /detach

2. Arrestare il profiler. Digitare:

   VSPerfCmd /shutdown

Vedere anche

Concetti

Profilatura dei servizi tramite riga di comando

Altre risorse

Visualizzazioni dei dati del metodo di campionamento del profiler