Eseguire il debug dell'app con file di log di IntelliTrace (.iTrace)

Articolo
03/12/2013

È possibile avviare una sessione di debug di IntelliTrace direttamente da un file (con estensione .iTrace) di log IntelliTrace.Questo file contiene eccezioni, richieste web, thread, passi del test, moduli e altre informazioni di sistema che IntelliTrace ha raccolto durante l'esecuzione dell'applicazione.

Funzionamento di IntelliTrace:

Requisiti

Un file .iTrace da una delle seguenti origini:
- Una sessione di IntelliTrace in Visual Studio Ultimate.Vedere Registrare l'esecuzione del codice con IntelliTrace per il debug in Visual Studio.
- Una sessione di test in Microsoft Test Manager.Ciò consente di associare un file .iTrace a un elemento di lavoro di Team Foundation Server.Vedere Procedura: raccogliere dati di IntelliTrace per agevolare il debug di problemi complessi.
- L'agente di raccolta autonomo per le applicazioni che vengono eseguite all'esterno di Visual Studio.Vedere Raccogliere dati di IntelliTrace all'esterno di Visual Studio con lo strumento di raccolta indipendente.
- Visual Studio 2012.1: Applicazioni monitorate da System Center 2012 Service Pack 1 (SP1) - Operations Manager con il Profiling Management Pack di IntelliTrace.Vedere la pagina relativa a come configurare l'integrazione con IntelliTrace in System Center 2012.
Visual Studio Ultimate in un computer di sviluppo o in un altro computer per aprire i file .iTrace

[!NOTA]

Per eseguire il debug con IntelliTrace e per scorrere il codice, è necessario disporre dei file sorgenti e dei file di simboli corrispondenti.Assicurarsi che i file dei simboli si trovino nel percorso dei simboli di Visual Studio.In caso contrario, Visual Studio non è in grado di risolvere i percorsi di origine e visualizza il messaggio "Simboli non trovati nel server dei simboli". Vedere Trovare file di simboli (.pdb), di origine e binari.

Scegliere l'argomento con cui si desidera procedere

Aprire un file di log IntelliTrace
Leggere il file di log IntelliTrace
Avviare il debug da un file di log IntelliTrace

Aprire un file di log IntelliTrace

Aprire il file .iTrace su un computer con Visual Studio Ultimate.

Fare doppio clic sul file .iTrace all'esterno di Visual Studio, oppure aprire il file da Visual Studio.

- oppure -
Se il file .iTrace viene associato ad un elemento di lavoro di Team Foundation Server, seguire questi passaggi nell'elemento di lavoro:
- In Tutti i collegamenti individuare il file .iTrace.Aprirlo.
  
  - oppure -
- In Passaggi ripetizione bug, scegliere il collegamento IntelliTrace.

Suggerimento
Se si chiude il file .iTrace durante il debug, è possibile riaprirlo facilmente.Scegliere IntelliTrace dal menu Debug, quindi scegliere Mostra riepilogo log.È anche possibile scegliere Mostra riepilogo log nella finestra IntelliTrace.Questo comando è disponibile solo mentre si esegue il debug con IntelliTrace.

Leggere il file di log IntelliTrace

Alcune delle seguenti sezioni del file .iTrace vengono visualizzate solo se si raccolgono dati da una determinata origine, ad esempio applicazioni Test Manager o SharePoint 2010 con l'agente di raccolta autonomo.

Sezione	Contiene	Origine della raccolta (Visual Studio Ultimate, Test Manager, agente di raccolta autonomo)
Analisi	Solo per le applicazioni SharePoint 2010.Questa sezione consente di esaminare gli eventi SharePoint e IntelliTrace, ad esempio gli eventi del debugger, gli eventi ULS, le eccezioni e gli altri dati che l'agente di raccolta ha registrato.	Agente di raccolta autonomo per Visual Studio 2012.1
Elenco dei thread	Thread eseguiti durante la raccolta	Tutte le origini
Richieste Web	Le richieste Web inviate a un pool di applicazioni IIS.Questi dati sono simili a quelli raccolti nei file di log IIS W3C.	Agente di raccolta autonomo: solo applicazioni Web ospitate in IIS
Dati eccezione	Eccezioni generate dall'applicazione durante la raccolta, incluso lo stack di chiamate completo per ogni eccezione	Tutte le origini
Dati di test	Passi del test e risultati di una sessione di test	Test Manager
System Info	Impostazioni e specifiche del sistema host	Tutte le origini
Moduli	Moduli caricati durante la raccolta	Tutte le origini

Avviare il debug da un file di log IntelliTrace

Nella maggior parte delle sezioni, è possibile rivedere gli eventi o gli altri elementi, scegliere un elemento e quindi scegliere Avvia debug.Ciò consente di avviare una sessione di debug di IntelliTrace nel punto e nel momento in cui un evento si è verificato.

Suggerimento
Per ordinare i dati, selezionare le intestazioni delle colonne.Per filtrare i dati, utilizzare la casella di ricerca.La ricerca di testo normale funziona su tutte le colonne ad eccezione di quelle del tempo.Nella sezione Richieste Web è possibile filtrare le ricerche in base a una colonna specifica.

Analisi

Questa sezione viene visualizzata per le applicazioni SharePoint 2010 solo se si registrano i dati con l'agente di raccolta in Visual Studio 2012.1.Vedere Raccogliere dati di IntelliTrace all'esterno di Visual Studio con lo strumento di raccolta indipendente.

Questa sezione consente di effettuare le seguenti attività:

Utilizzare un ID di correlazione di SharePoint per trovare le richieste e gli eventi web corrispondenti.È possibile scegliere un evento e quindi avviare il debug nel punto e nel momento in cui si è verificato l'evento.
Esaminare ogni eccezione non gestita che l'agente di raccolta ha trovato.È possibile scegliere un eccezione e quindi avviare il debug nel punto e nel momento in cui si è verificata l'eccezione.

[!NOTA]

Se viene visualizzato il messaggio "Simboli non trovati", Visual Studio non è in grado di risolvere i percorsi di origine.Assicurarsi che i file dei simboli (.pdb) dell'applicazione si trovino nel percorso dei simboli di Visual Studio.Vedere Trovare file di simboli (.pdb), di origine e binari.

Avviare il debug con un ID di correlazione di SharePoint

Copiare l'ID di correlazione di SharePoint dalla relativa origine.

Ad esempio:
Nel file .iTrace, in Analisi, è possibile immettere l'ID di correlazione di SharePoint.Ciò consente di trovare la richiesta corrispondente e di visualizzare i relativi eventi registrati.
In Eventi richiesta, esaminare gli eventi.Partendo dall'alto, gli eventi vengono visualizzati nell'ordine in cui si sono verificati.
1. Scegliere un evento per visualizzare i relativi dettagli.
2. Scegliere Avvia debug per avviare il debug nel punto in cui si è verificato l'evento.

È possibile visualizzare questi tipi di eventi SharePoint insieme agli eventi IntelliTrace:

Eventi di un profilo utente

Questi eventi si verificano quando SharePoint carica un profilo utente e quando le proprietà di un profilo utente vengono lette o modificate.

Eventi del sistema di registrazione unificato (ULS)

L'agente di raccolta autonomo registra un sottoinsieme degli eventi ULS di SharePoint e questi campi:

Campo IntelliTrace	Campo ULS di SharePoint
Id	EventID
Livello	Livello
Category Id	Category Id
Category	Category
Area	Prodotto
Output	Messaggio
ID di correlazione	ID di correlazione

Iniziare il debug da un'eccezione non gestita

Scegliere un ID di correlazione di SharePoint per un'eccezione.Le eccezioni vengono raggruppate per tipo e per stack di chiamate.
(Facoltativo) Espandere Stack di chiamate per visualizzare lo stack di chiamate per un gruppo di eccezioni.
Scegliere Debug eccezione per avviare il debug nel punto e nel momento in cui si è verificata l'eccezione.

Per una procedura dettagliata, vedere la pagina Procedura dettagliata: debug di un'applicazione di SharePoint tramite IntelliTrace.Per i tipi di dati che l'agente di raccolta registra, vedere la pagina Registrare l'esecuzione del codice con IntelliTrace per il debug in Visual Studio.

Elenco dei thread

In questa sezione viene illustrato come registrare i thread eseguiti nel processo di destinazione.È possibile avviare il debug dal primo evento IntelliTrace valido in un thread selezionato.

Per avviare il debug da un thread specifico

In Elenco dei thread scegliere un thread.
Nella parte inferiore di Elenco dei thread scegliere Avvia debug.È inoltre possibile fare doppio clic su un thread.

Per avviare il debug dall'inizio dell'applicazione, fare doppio clic su Thread principale.Vedere Registrare l'esecuzione del codice con IntelliTrace per il debug in Visual Studio.

I dati dei thread che l'utente crea potrebbero essere più utili dei thread che un server crea e gestisce per applicazioni web ospitate in IIS.

Colonna	Mostra
ID	Numero ID del thread
Nome	Nome del thread.I thread senza nome vengono visualizzati come "<Nessun nome>".
Ora di inizio	Ora in cui è stato creato il thread
Ora di fine	Ora in cui è stato completato il thread

Richieste Web

In questa sezione vengono illustrate le richieste web registrate che sono state inviate a un pool di applicazioni IIS.È possibile scegliere una richiesta web per esaminare gli eventi registrati per tale richiesta.È quindi possibile avviare il debug da un evento specifico.

Per impostazione predefinita, le richieste web appaiono dall'alto verso il basso nell'ordine di arrivo al server.

Per visualizzare gli eventi registrati per una specifica richiesta web

Scegliere una richiesta web in Richieste web.

Nella parte inferiore di Richieste Web scegliere Dettagli richiesta.È inoltre possibile fare doppio clic sulla richiesta web.

Viene aperta la pagina Dettagli richiesta per la richiesta web selezionata e vengono mostrati gli eventi IntelliTrace registrati per quella richiesta.Partendo dall'alto, gli eventi vengono visualizzati nell'ordine in cui si sono verificati.Si possono filtrare gli eventi scegliendo dall'elenco di categorie o utilizzando la casella di ricerca.Vedere Registrare l'esecuzione del codice con IntelliTrace per il debug in Visual Studio.

Suggerimento
La pagina Dettagli richiesta verrà visualizzata in una scheda di anteprima.Questa scheda viene sostituita con una nuova pagina Dettagli richiesta quando si sceglie un'altra richiesta web.Per mantenere la scheda di anteprima, scegliere Alza di livello nella scheda.La seguente richiesta web verrà aperta in una nuova scheda di anteprima.

Per avviare il debug da un evento specifico

Scegliere un evento in Eventi richiesta.

Nella parte inferiore di Eventi richiesta scegliere Avvia debug.È possibile anche fare doppio clic su un evento.

Suggerimento
Se il file .iTrace include informazioni sulle chiamate di funzione, è possibile avanzare nel codice a partire dalla posizione dell'evento.Si possono inoltre visualizzare i valori dei parametri e i valori restituiti. Per raccogliere informazioni sulle chiamate: In Visual Studio Ultimate, configurare IntelliTrace per raccogliere informazioni sulle chiamate.Vedere Registrare l'esecuzione del codice con IntelliTrace per il debug in Visual Studio. Per l'agente di raccolta autonomo di IntelliTrace, utilizzare il piano di raccolta collection_plan.ASP.NET.trace.xml o un piano di raccolta personalizzato.Vedere Raccogliere dati di IntelliTrace all'esterno di Visual Studio con lo strumento di raccolta indipendente. Se viene visualizzato il messaggio "Simboli non trovati", Visual Studio non è in grado di risolvere i percorsi di origine.Assicurarsi che i file dei simboli (.pdb) dell'applicazione Web si trovino nel percorso dei simboli di Visual Studio.Vedere Trovare file di simboli (.pdb), di origine e binari.

Se il file .iTrace include informazioni sulle chiamate di funzione, è possibile avanzare nel codice a partire dalla posizione dell'evento.Si possono inoltre visualizzare i valori dei parametri e i valori restituiti.

Per raccogliere informazioni sulle chiamate:

In Visual Studio Ultimate, configurare IntelliTrace per raccogliere informazioni sulle chiamate.Vedere Registrare l'esecuzione del codice con IntelliTrace per il debug in Visual Studio.
Per l'agente di raccolta autonomo di IntelliTrace, utilizzare il piano di raccolta collection_plan.ASP.NET.trace.xml o un piano di raccolta personalizzato.Vedere Raccogliere dati di IntelliTrace all'esterno di Visual Studio con lo strumento di raccolta indipendente.

Se viene visualizzato il messaggio "Simboli non trovati", Visual Studio non è in grado di risolvere i percorsi di origine.Assicurarsi che i file dei simboli (.pdb) dell'applicazione Web si trovino nel percorso dei simboli di Visual Studio.Vedere Trovare file di simboli (.pdb), di origine e binari.

Colonna	Mostra
Metodo	Metodo HTTP inviato con la richiesta
URL di destinazione	URL di destinazione inviato con la richiesta
Tempo impiegato (ms)	Tempo in millisecondi tra la ricezione della richiesta da parte del server e la restituzione del risultato
Stato	Codice di stato HTTP restituito
ID sessione	ID sessione utilizzato da IIS per distinguere gli utenti. Il valore ID sessione è solo un Integer crescente utilizzato per distinguere gli utenti della sessione e non è correlato al concetto di ASP.NET di SessionID.Pertanto, le richieste web che hanno lo stesso ID sessione appartengono alla stessa sessione utente.
IP client	Indirizzo IP registrato da IIS per la richiesta inviata
Agente utente	Valore della stringa dell'agente utente inviata con la richiesta HTTP
Ora di inizio	Ora in cui il server ha ricevuto la richiesta
Ora di fine	Ora in cui il server ha risposto al client

Per visualizzare i dati da una prospettiva dell'utente, filtrare e raggruppare le richieste web.Ad esempio:
- Per individuare gli errori, filtrare le richieste in base allo Stato.
- Per visualizzare le tendenze o il comportamento dell'utente, raggruppare gli errori in base all'URL di destinazione o all'ID sessione.
È inoltre possibile filtrare le ricerche in base a una colonna specifica.Digitare il nome della colonna senza spazi, due punti e il valore di ricerca.

Ad esempio, per trovare le richieste web che utilizzano il metodo GET con un ID sessione specifico, digitare:

Method:GET;SessionId:2

È possibile utilizzare un filtro per colonna.Per identificare le colonne che è possibile filtrare, esaminare la descrizione comando della casella di ricerca Richieste Web.

Dati eccezione

Questa sezione consente di esaminare le eccezioni registrate che sono state generate dall'applicazione.Per impostazione predefinita, le eccezioni più recenti compaiono nella parte superiore poiché le eccezioni vengono mostrate in base all'Ora evento in ordine decrescente.

Per avviare il debug da un'eccezione specifica

Scegliere un'eccezione in Dati eccezione.
Nella parte inferiore di Dati eccezione scegliere Avvia debug.È anche possibile fare doppio clic su un'eccezione.

Verrà avviato il debug nel momento in cui l'eccezione è stata generata.

Suggerimento
Cercare più eccezioni che hanno lo stesso Tipo e ID thread e compaiono in sequenza.Spesso sono dovute al fatto che un'eccezione generata e rilevata viene generata di nuovo. Per verificare se sono presenti eccezioni di questo tipo, selezionare ciascuna di esse ed esaminare lo stack di chiamate.per vedere se aumenta o diminuisce.Se lo stack più breve è identico all'inizio dello stack di chiamate più lungo e gli ID thread sono gli stessi, è possibile che la stessa eccezione sia stata generata di nuovo.Si consiglia di cercare l'origine del problema nell'eccezione con lo stack di chiamate più lungo.

Cercare più eccezioni che hanno lo stesso Tipo e ID thread e compaiono in sequenza.Spesso sono dovute al fatto che un'eccezione generata e rilevata viene generata di nuovo.

Per verificare se sono presenti eccezioni di questo tipo, selezionare ciascuna di esse ed esaminare lo stack di chiamate.per vedere se aumenta o diminuisce.Se lo stack più breve è identico all'inizio dello stack di chiamate più lungo e gli ID thread sono gli stessi, è possibile che la stessa eccezione sia stata generata di nuovo.Si consiglia di cercare l'origine del problema nell'eccezione con lo stack di chiamate più lungo.

Colonna	Mostra
Type	Tipo .NET dell'eccezione
Messaggio	Messaggio fornito dall'eccezione
ID thread	ID del thread che ha generato l'eccezione
HResult	Il codice di errore specificato nell'eccezione.Disponibile se questo valore è stato impostato nell'eccezione.
Ora evento	Timestamp registrato quando è stata generata l'eccezione
Stack di chiamate	Stack di chiamate per un'eccezione. Per visualizzare lo stack di chiamate, scegliere un'eccezione dall'elenco.Lo stack di chiamate viene visualizzato sotto l'elenco di eccezioni.

Dati di test

Questa sezione consente di esaminare i dati raccolti da Test Manager durante il test dell'applicazione.

Per avviare il debug da un passo di test specifico

Espandere Griglia passaggi test.Scegliere un passo del test.
Nella parte inferiore di Griglia passaggi test scegliere Avvia debug.È possibile anche fare doppio clic su un passo del test.

Verrà avviato il debug dal primo evento IntelliTrace valido dopo il passo di test selezionato.

Se sono presenti dati di test, IntelliTrace tenta di risolvere la compilazione di Team Foundation Server associata utilizzata per eseguire i test.Se la compilazione viene trovata, i simboli associati per l'applicazione vengono risolti automaticamente.

Campo	Mostra
Sessione test	Sessioni di test registrate.In genere, ne è presente solo una.Questo elenco è vuoto se i dati di test sono stati creati utilizzando un test esplorativo manuale.
Test case	Test case della sessione di test selezionata.Questo elenco è vuoto se i dati di test sono stati creati utilizzando un test esplorativo manuale.
Griglia passaggi test	Passi di test registrati con il risultato del test superato o non superato

System Info

In questa sezione vengono mostrati i dettagli sul sistema che ha ospitato l'applicazione, ad esempio informazioni sull'hardware, sul sistema operativo, sull'ambiente e informazioni specifiche del processo.

Moduli

In questa sezione vengono mostrati i moduli che il processo di destinazione ha caricato.I moduli vengono visualizzati in ordine di caricamento.

Colonna	Mostra
Module Name	Nome file del modulo
Percorso modulo	Percorso sul disco in cui è stato caricato il modulo
ID modulo	Identificatore univoco del modulo che è specifico della versione e contribuisce ai file dei simboli (PDB) corrispondenti.Vedere [OBSOLETO] Procedura: specificare percorsi di simboli e comportamento di caricamento.

Condividi tramite