Procedura: avviare un'applicazione .NET Framework autonoma con il profiler per raccogliere dati di concorrenza 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 .NET Framework e raccogliere dati di concorrenza di thread e processi.

Per raccogliere dati di prestazioni da un'applicazione .NET Framework, è necessario inizializzare le variabili di ambiente appropriate prima dell'avvio dell'applicazione di destinazione. Quando il profiler è connesso all'applicazione, è possibile sospendere e riprendere la raccolta dei dati. Per terminare una sessione di profilo, è necessario che il profiler non sia più connesso all'applicazione e che venga arrestato in modo esplicito. Nella maggior parte dei casi, è consigliabile cancellare le variabili di ambiente di profilo una volta completato il profilo.

Avvio dell'applicazione con il profiler

Per avviare un'applicazione di destinazione .NET Framework con il profiler, utilizzare VSPerfClrEnv.exe per impostare le variabili di profilo di .NET Framework. Utilizzare quindi 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 alla riga di comando per sospendere la raccolta dei dati all'avvio dell'applicazione di destinazione. Utilizzare quindi /globalon in una riga di comando separata per avviare la raccolta dei dati.

Per avviare un'applicazione con il profiler

1. Aprire una finestra del prompt dei comandi.

2. Inizializzare le variabili di ambiente di profilo di .NET Framework. Digitare:

   VSPerfClrEnv /sampleon

   • L'opzione /sampleon consente di inizializzare le variabili di ambiente di profilo della memoria .NET Framework.

3. Avviare il profiler. Tipo:

   VSPerfCmd /start:concurrency[,{ResourceOnly|ThreadOnly}] **/output:**OutputFile [Options]

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

     /start:concurrency	Abilita la raccolta dei dati di esecuzione thread e dei conflitti di risorse.
     /start:concurrency,resourceonly	Abilita la raccolta dei soli dati dei conflitti di risorse.
     /start:concurrency,threadonly	Abilita la raccolta dei soli dati di esecuzione thread.

   • 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:concurrency .

   Opzione	Descrizione
   /user:[domain\]username	Specifica il dominio e il nome utente facoltativi dell'account per ottenere l'accesso al profiler.
   /crosssession	Abilita il profilo dei processi in altre sessioni di accesso.
   /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. Avviare l'applicazione di destinazione. Digitare:

   VSPerfCmd /launch**:**AppName [Options] [Sample Event]

   È possibile utilizzare qualsiasi opzione riportata 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.
   /targetclr:Version	Specifica la versione di Common Language Runtime (CLR) di cui eseguire il profilo quando più di una versione del runtime è caricata in un'applicazione.

Controllo della raccolta di dati

Quando l'applicazione di destinazione è in esecuzione, è possibile controllare la raccolta dei dati avviando e interrompendo la scrittura di dati nel file utilizzando 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'interruzione dell'applicazione.

Per avviare e interrompere la raccolta dei dati

• Le coppie seguenti di opzioni di VSPerfCmd.exe 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 (PID) o da nome processo (ProcName). /detach interrompe la raccolta di dati per il processo specificato o per tutti i processi se non è specificato un processo particolare.

Fine della sessione di profilo

Per terminare una sessione di profilo, non deve essere in corso alcuna raccolta di dati. È possibile interrompere la raccolta dei dati di concorrenza chiudendo l'applicazione profilata o richiamando l'opzione VSPerfCmd /detach. È quindi possibile richiamare 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 profilo.

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

   VSPerfCmd /shutdown

3. Cancellare le variabili di profilo .NET Framework. Digitare

   VSPerfClrEnv /off

Vedere anche

Concetti

Raccolta di dati di concorrenza per applicazioni autonome tramite la riga di comando del profiler