Condividi tramite

Procedura: avviare un'applicazione nativa autonoma con il profiler per raccogliere dati di concorrenza tramite la riga di comando

  • Articolo

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 nativa e raccogliere dati di concorrenza di thread e processi.

Una sessione di profilo è costituita dalle parti seguenti:

  • Avvio dell'applicazione con il profiler

  • Controllo della raccolta di dati

  • Fine della sessione di profilo

Nota

Gli strumenti da riga di comando degli strumenti di profilatura sono contenuti nella sottodirectory \Team Tools\Performance Tools della directory di installazione di Visual Studio. Nei computer a 64 bit gli strumenti sono disponibili nelle versioni a 32 e 64 bit. Per utilizzare il profiler a un prompt dei comandi, è necessario aggiungere il percorso degli strumenti alla variabile di ambiente PATH della finestra Prompt dei comandi oppure aggiungerlo al comando stesso. Per ulteriori informazioni, vedere Specifica del percorso degli strumenti da riga di comando degli strumenti di profilatura.

Avvio dell'applicazione con il profiler

Per avviare un'applicazione di destinazione tramite il profiler, utilizzare le opzioni di VSPerfCmd.exe /start e /launch per inizializzare il profiler e avviare l'applicazione. È possibile specificare /start e /launch e le opzioni relative. È 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. Al prompt dei comandi digitare il comando seguente:

    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 nella tabella seguente con l'opzione /start:concurrency .

    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.

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

  2. Avviare l'applicazione di destinazione digitando:

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

    È possibile utilizzare qualsiasi opzione riportata nella tabella seguente 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:CLRVersion

    Specifica la versione di Common Language Runtime (CLR) di cui eseguire il profilo se l'applicazione carica più di una versione del CLR.

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'arresto dell'applicazione.

Per avviare e interrompere la raccolta dei dati

  • Le coppie di opzioni nella tabella seguente 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 alcun 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 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, 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.

Per terminare una sessione di profilo

  1. Dissociare il profiler dall'applicazione di destinazione chiudendolo o digitando il comando seguente a un prompt dei comandi:

    VSPerfCmd /detach

  2. Arrestare il profiler digitando il comando seguente a un prompt dei comandi:

    VSPerfCmd /shutdown