Condividi tramite

Procedura: connettere il profiler a un servizio .NET 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 connettere il profiler a un servizio .NET Framework e raccogliere dati di concorrenza di thread e processi tramite il metodo di campionamento.

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 gli strumenti da riga di comando del profiler, è necessario aggiungere il percorso degli strumenti alla variabile di ambiente PATH della finestra del 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.

Per raccogliere dati di prestazioni da un servizio .NET Framework, è necessario inizializzare le variabili di ambiente appropriate e riavviare il computer che ospita il servizio per configurarlo per il profilo.

Connettere il profiler al processo del servizio. 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. Nella maggior parte dei casi, è consigliabile cancellare le variabili di ambiente di profilo alla fine di una sessione.

Connessione del profiler

Per connettere il profiler a un servizio .NET Framework

  1. Installare il servizio.

  2. Aprire una finestra di comando.

  3. Inizializzare le variabili di ambiente di profilo. Tipo:

    VSPerfClrEnv /globalsampleon [/samplelineoff]

    • /globalsampleon abilita il campionamento.

    • /samplelineoff disabilita l'assegnazione dei dati raccolti a righe specifiche del codice sorgente. Quando viene specificata questa opzione, i dati vengono assegnati solo alle funzioni.

  4. Riavviare il computer.

  5. Avviare il profiler. Digitare:

    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.

    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 il servizio è 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.

  6. Se necessario, avviare il servizio.

  7. Connettere il profiler al servizio. Tipo:

    **VSPerfCmd /attach:PID [/targetclr:**Version]

    • PID specifica l'ID o il nome del processo del servizio. È possibile visualizzare gli ID processo di tutti i processi in esecuzione in Gestione attività di Windows.

    • **targetclr:**Version specifica la versione di Common Language Runtime (CLR) da profilare quando più di una versione del runtime è caricata in un'applicazione. Facoltativo.

Controllo della raccolta di dati

Quando il servizio è 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 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 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. 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.

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 da un'applicazione profilata con il metodo di concorrenza interrompendo il servizio oppure richiamando l'opzione VSPerfCmd /detach. Richiamare quindi l'opzione VSPerfCmd /shutdown per disattivare il profiler e chiudere il file dei dati di profilo. Il comando VSPerfClrEnv /globaloff cancella le variabili di ambiente di profilo, ma la configurazione del sistema non viene reimpostata finché non viene riavviato il computer.

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

  3. Facoltativo. Cancellare le variabili di ambiente di profilo. Tipo:

    VSPerfCmd /globaloff

    Riavviare quindi il computer.