Procedura: avviare un'applicazione autonoma con il profiler e 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 avviare un'applicazione (client) autonoma e raccogliere statistiche sulle prestazioni tramite il metodo di campionamento.

Una sessione di profilo si suddivide in tre parti:

• Avvio dell'applicazione con il profiler.

• Controllo della raccolta dei dati.

• Fine della sessione di profilo.

Avvio dell'applicazione con il profiler

Per avviare un'applicazione di destinazione tramite il profiler, utilizzare le opzioni /start e /launch di VSPerfCmd per inizializzare il profiler e avviare l'applicazione. È possibile specificare /start e /launch 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. Utilizzare quindi /globalon per avviare la raccolta dei dati.

Per avviare un'applicazione con il profiler

1. Aprire una finestra del prompt dei comandi.

2. 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.

   Opzione	Descrizione
   /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.

3. Avviare l'applicazione di destinazione. Digitare:**VSPerfCmd /launch:**appName [Options] [Sample Event]

   È possibile utilizzare una o più opzioni riportate di seguito con l'opzione /launch.

   Opzione	Descrizione
   /args:Arguments	Specifica una stringa che contiene gli argomenti della riga di comando da passare all'applicazione di destinazione.
   /console	Avvia l'applicazione della riga di comando di destinazione in una finestra separata.

   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 GHz. È 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 controllare la raccolta dei dati avviando e interrompendo la scrittura dei dati nel file dei dati del profiler tramite le opzioni di VSPerfCmd.exe. 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 di opzioni seguenti 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 PID o dal nome del processo (ProcName). /detach interrompe la raccolta di dati per il processo specificato o per tutti i processi se non è specificato un processo particolare.

• È 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 facoltativa definita dall'utente. 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 ai processi profilati e che venga arrestato in modo esplicito. È possibile disconnettere il profiler da un'applicazione profilata con il metodo di campionamento chiudendo l'applicazione o richiamando l'opzione VSPerfCmd /detach. Chiamare quindi l'opzione VSPerfCmd /shutdown per disattivare il profiler e chiudere il file dei dati di profilo. Il comando VSPerfClrEnv /off cancella le variabili di ambiente di profilatura.

Per terminare una sessione di profilo

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

   • Chiudere l'applicazione di destinazione.

     oppure

   • Digitare VSPerfCmd /detach

2. Arrestare il profiler. Digitare:

   VSPerfCmd /shutdown

Vedere anche

Concetti

Profilatura della riga di comando di applicazioni autonome

Altre risorse

Visualizzazioni dei dati del metodo di campionamento del profiler