Ricerca transazioni e diagnostica

Ricerca transazioni è una funzionalità di Application Insights che consente di individuare ed esplorare i singoli elementi della telemetria, ad esempio visualizzazioni pagine, eccezioni o richieste Web. È anche possibile visualizzare le tracce del log e gli eventi codificati.

Per le query più complesse sui dati, utilizzare Log Analytics.

Dove si trova Ricerca?

La funzione di Ricerca si trova nel portale di Azure o in Visual Studio.

Nel portale di Azure

È possibile aprire la ricerca transazioni dalla scheda Panoramica di Application Insights della propria applicazione. È anche possibile selezionare Cerca in Analizza nel menu di sinistra.

Passare al menu a discesa Tipi di eventi per visualizzare un elenco di elementi di telemetria, ad esempio richieste server, visualizzazioni pagina ed eventi personalizzati codificati. Nella parte superiore dell'elenco dei Risultati è disponibile un grafico di riepilogo che mostra il numero di eventi nel tempo.

Tornare al menu a discesa o selezionare Aggiorna per ottenere nuovi eventi.

In Visual Studio

In Visual Studio è inoltre disponibile una finestra di Ricerca di Application Insights. È più utile per visualizzare gli eventi di telemetria generati dall'applicazione di cui si esegue il debug. È inoltre possibile visualizzare gli eventi raccolti dall'app pubblicata nel portale di Azure.

Aprire la finestra di Ricerca di Application Insights in Visual Studio:

La finestra di Ricerca di Application Insights include funzionalità simili al portale Web:

La scheda Traccia operazione è disponibile quando si apre una richiesta o una visualizzazione pagina. Con "operazione" si intende una sequenza di eventi associata a una singola richiesta o visualizzazione pagina. Ad esempio, chiamate di dipendenza, eccezioni, log di traccia ed eventi personalizzati potrebbero far parte di una singola operazione. La scheda Traccia operazione mostra graficamente l'intervallo e la durata di questi eventi in relazione alla richiesta o alla visualizzazione pagina.

Controllare i singoli elementi

Selezionare qualsiasi elemento di dati di telemetria per visualizzare i campi chiave e gli elementi correlati.

Viene visualizzata la vista dei dettagli delle transazioni end-to-end.

I tipi di eventi sono i seguenti:

Aprire il menu a discesa Tipi di eventi e scegliere i tipi di eventi che si desidera visualizzare. Per ripristinare i filtri in un secondo momento, selezionare Ripristina.

I tipi di eventi sono i seguenti:

• Traccia: Log di diagnostica incluse le chiamate TrackTrace, log4Net, NLog e System.Diagnostic.Trace.
• Richiesta: richieste HTTP ricevute dall'applicazione server, tra cui pagine, script, immagini, file di stile e dati. Questi eventi vengono usati per creare grafici di panoramica di richieste e risposte.
• Visualizzazione pagina:Dati di telemetria inviati al client Web usati per creare report di visualizzazioni pagina.
• Evento personalizzato: se sono state inserite chiamate a TrackEvent() per monitorare l'utilizzo, è possibile cercarle qui.
• Eccezione: eccezioni nel server non rilevate ed eccezioni registrate utilizzando TrackException().
• Dipendenza: Chiamate dall'applicazione server ad altri servizi quali API REST o database e chiamate AJAX dal codice client.
• Disponibilità: risultati dei test di disponibilità

Filtrare in base ai valori delle proprietà

È possibile filtrare gli eventi in base ai valori delle relative proprietà. Le proprietà disponibili dipendono dai tipi di eventi selezionati. Selezionare Filtro per iniziare.

La mancata scelta dei valori di una determinata proprietà ha lo stesso effetto della scelta di tutti i valori. Viene disattivata l'applicazione dei filtri per quella proprietà.

Si noti che il numero a destra dei valori di filtro mostra quante occorrenze sono incluse nel set filtrato corrente.

Trovare gli eventi con la stessa proprietà

Per trovare tutti gli elementi con lo stesso valore di proprietà, immetterlo nella casella Cerca o selezionare la casella di controllo scorrendo le proprietà nella scheda Filtro.

Eseguire ricerche nei dati

È possibile cercare i termini in uno dei valori delle proprietà. Questa funzionalità è utile se si scrivono eventi personalizzati con valori di proprietà.

Si potrebbe voler impostare un intervallo di tempo, infatti le ricerche effettuate in un intervallo più breve sono più veloci.

Cercare parole complete, non sottostringhe. Utilizzare le virgolette per racchiudere i caratteri speciali.

È possibile usare le espressioni di ricerca seguenti:

Campionamento

Se l'app genera dati di telemetria significativi e usa ASP.NET SDK versione 2.0.0-beta3 o successive, essa riduce automaticamente il volume inviato al portale tramite il campionamento adattivo. Questo modulo invia solo una frazione rappresentativa degli eventi. Seleziona o deseleziona gli eventi correlati alla stessa richiesta di un gruppo, consentendo di spostarsi tra eventi correlati.

Informazioni sul campionamento.

Creare un elemento di lavoro

È possibile creare un bug in GitHub o Azure DevOps con i dettagli provenienti da qualsiasi elemento di dati di telemetria.

Passare alla visualizzazione Dettagli della transazione end-to-end selezionando qualsiasi elemento di telemetria. Quindi selezionare Crea elemento di lavoro.

La prima volta che si esegue questo passaggio, verrà richiesto di configurare un collegamento all'organizzazione e al progetto Azure DevOps. È anche possibile configurare il collegamento alla scheda Elementi di lavoro.

Inviare altri dati di telemetria ad Application Insights

Oltre la telemetria predefinita inviata da Application Insights SDK, è possibile:

• Acquisire le tracce del log dal framework di registrazione preferito in .NET o Java. Ciò significa che è possibile cercare le tracce del log e metterle in correlazione con le visualizzazioni pagina, le eccezioni e altri eventi.

• Scrivere codice per inviare eventi personalizzati, visualizzazioni pagina ed eccezioni.

Informazioni relative alla modalità di invio di log e telemetria personalizzata ad Application Insights.

Domande frequenti

Risposte a domande comuni.

Quanti dati vengono conservati?

Vedere il Riepilogo dei limiti.

Come è possibile visualizzare dati POST nelle richieste server?

I dati POST non vengono registrati automaticamente, ma è possibile usare TrackTrace o chiamate di log. Inserire i dati POST nel parametro del messaggio. Non è possibile filtrare in base al messaggio nello stesso modo delle proprietà, ma il limite delle dimensioni è maggiore.

Perché la ricerca di Funzioni di Azure non restituisce risultati?

Funzioni di Azure non registra le stringhe di query URL.

L'esperienza di diagnostica unificata correla automaticamente i dati di telemetria lato server di tutti i componenti monitorati di Application Insights in un'unica vista. Non è importante se sono presenti più risorse. Application Insights rileva la relazione sottostante e consente di diagnosticare facilmente il componente, la dipendenza o l'eccezione dell'applicazione che ha causato un errore o un rallentamento nella transazione.

Che cos'è un componente?

I componenti sono parti che possono essere distribuite autonomamente dell'applicazione distribuita o di microservizi. Gli sviluppatori e i team delle operazioni hanno visibilità o accesso a livello di codice ai dati di telemetria generati dai componenti di queste applicazioni.

• I componenti sono diversi dalle dipendenze esterne "osservate", quali SQL e hub eventi ai quali il team o l'organizzazione potrebbero non avere accesso (codice o dati di telemetria).
• I componenti vengono eseguiti su diverse istanze di ruolo, di server o di contenitore.
• I componenti possono essere chiavi di strumentazione separate di Application Insights, anche se le sottoscrizioni sono diverse. I componenti possono anche essere ruoli diversi che segnalano a una singola chiave di strumentazione di Application Insights. La nuova esperienza mostra i dettagli per tutti i componenti, indipendentemente dalla modalità di configurazione.

Esperienza di diagnostica delle transazioni

Questa vista si suddivide in quattro parti principali:

• un elenco dei risultati
• un grafico delle transazioni tra componenti
• un elenco di sequenze temporali di tutti i dati di telemetria correlati a questa operazione
• il riquadro dei dettagli per qualsiasi elemento di telemetria selezionato

Grafico delle transazioni tra componenti

In questo grafico è riportata una sequenza temporale con barre orizzontali durante le richieste e le dipendenze tra componenti. Anche le eccezioni raccolte vengono contrassegnate sulla sequenza temporale.

• La riga superiore di questo grafico rappresenta il punto di ingresso. Si tratta della richiesta in ingresso al primo componente chiamato all’interno di questa transazione. La durata è il tempo totale impiegato per il completamento della transazione.
• Eventuali chiamate a dipendenze esterne sono rappresentate da semplici righe non comprimibili, con icone che indicano il tipo di dipendenza.
• Le chiamate ad altri componenti sono rappresentate da righe comprimibili. Ogni riga corrisponde a un'operazione specifica richiamata nel componente.
• Per impostazione predefinita, la richiesta, la dipendenza o l'eccezione selezionata viene visualizzata lateralmente. Selezionare una qualsiasi riga per visualizzarne i dettagli.

Tutti i dati di telemetria con questo ID operazione

In questa sezione è illustrata una vista elenco semplice in una sequenza temporale di tutti i dati di telemetria relativi a questa transazione. Inoltre, sono indicati gli eventi personalizzati e le tracce che non sono visualizzate nel grafico delle transazioni. È possibile filtrare questo elenco in base ai dati di telemetria generati da un componente o una chiamata specifici. È possibile selezionare qualsiasi elemento di telemetria di questo elenco per visualizzarne i corrispondenti dettagli lateralmente.

Dettagli dei dati di telemetria selezionati

Questo riquadro comprimibile mostra i dettagli di qualsiasi elemento selezionato dal grafico delle transazioni o dall'elenco. L'opzione Mostra tutti elenca tutti gli attributi standard che vengono raccolti. Eventuali attributi personalizzati sono elencati separatamente nel set standard. Selezionare il pulsante con i puntini di sospensione (...) nella finestra della traccia Stack di chiamate per visualizzare un'opzione per copiare la traccia. Le opzioni Apri tracce profiler e Apri snapshot di debug mostrano la diagnostica a livello di codice nei riquadri dei dettagli corrispondenti.

Risultati della ricerca

Questo riquadro comprimibile mostra altri risultati che soddisfano i criteri del filtro. Selezionare qualsiasi risultato per aggiornare i rispettivi dettagli delle tre sezioni precedenti. Si tenta di trovare esempi che più probabilmente avranno i dettagli disponibili da tutti i componenti, anche se il campionamento è attivo in ognuno di essi. Questi esempi vengono visualizzati come suggerimenti.

Profiler e Snapshot Debugger

Application Insights Profiler o Snapshot Debugger consentono di eseguire la diagnostica a livello di codice dei problemi di prestazioni e degli errori. Grazie a questa esperienza è possibile visualizzare le tracce del profiler o gli snapshot di un componente con un sola selezione.

Se non è possibile far funzionare il Profiler, contattare serviceprofilerhelp@microsoft.com.

Se non è possibile far funzionare Snapshot Debugger, contattare snapshothelp@microsoft.com.

Domande frequenti

Questa sezione fornisce le risposte alle domande comuni.

Perché è visibile un solo componente nel grafico e gli altri componenti sono mostrati soltanto come dipendenze esterne senza dettagli?

Possibili motivi:

• Gli altri componenti sono instrumentati con Application Insights?
• Usano l'SDK di Application Insights più recente e stabile?
• Se questi componenti sono risorse di Application Insights separate, verificare di avere l’accesso. Se si ha l'accesso e i componenti sono instrumentati con gli SDK di Application Insights più recenti, segnalare il problema tramite il canale di feedback nell’angolo in alto a destra.

Il grafico mostra righe duplicate per le dipendenze. Questo comportamento è previsto?

Attualmente la chiamata di dipendenza in uscita viene mostrata separatamente dalla richiesta in ingresso. Solitamente le due chiamate sembrano identiche, ma il valore della durata è diverso per via del round trip di rete. L'icona iniziale e lo stile diverso delle barre della durata consentono di distinguere le chiamate tra loro. Questa organizzazione dei dati crea confusione? Inviare i propri commenti.

Perché ci sono degli sfasamenti di orario tra le diverse istanze del componente?

Le sequenze temporali vengono modificate in base agli sfasamenti di orario nel grafico delle transazioni. È possibile visualizzare i timestamp esatti nel riquadro dei dettagli o tramite Log Analytics.

Perché nella nuova esperienza manca la maggior parte delle query degli elementi correlati?

Questo comportamento è impostato a livello di progettazione. Tutti gli elementi correlati, in tutti i componenti, sono già disponibili sul lato sinistro nelle sezioni superiore e inferiore. La nuova esperienza presenta due elementi correlati che non sono riportati a sinistra: tutti i dati di telemetria generati nei cinque minuti precedenti e successivi a questo evento e la sequenza temporale dell'utente.

Esiste un modo per visualizzare un minor numero di eventi per transazione quando si usa Application Insights JavaScript SDK?

L'esperienza della diagnostica delle transazioni mostra tutti i dati di telemetria in una singola operazione che condivide un ID operazione. Per impostazione predefinita, Application Insights SDK per JavaScript crea una nuova operazione per ogni visualizzazione pagina univoca. In un'applicazione a pagina singola (SPA) viene generato un solo evento di visualizzazione pagina e si usa un singolo ID operazione per tutti i dati di telemetria generati. Di conseguenza, molti eventi potrebbero essere correlati alla stessa operazione.

In questi scenari, è possibile usare il rilevamento automatico delle route per creare automaticamente nuove operazioni per lo spostamento nella SPA. È necessario attivare enableAutoRouteTracking per generare una visualizzazione pagina ogni volta che viene aggiornata la route URL (si verifica la visualizzazione pagina logica). Se si desidera aggiornare manualmente l'ID operazione, chiamare appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId(). L'attivazione manuale di un evento PageView causa anche la reimpostazione dell'ID operazione.

Perché le durate dei dettagli delle transazioni non si sommano alla durata della richiesta superiore?

Il tempo non spiegato nel diagramma di Gantt è il tempo non coperto da una dipendenza rilevata. Questo problema può verificarsi perché le chiamate esterne non sono state instrumentate, né automaticamente, né manualmente. Ciò può anche accadere perché il tempo impiegato era in elaborazione e non a causa di una chiamata esterna.

Se tutte le chiamate sono state instrumentate, in processo è la probabile causa radice per il tempo trascorso. Uno strumento utile per la diagnosi del processo è Application Insights Profiler.

Cosa accade se viene visualizzato il messaggio Errore durante il recupero dei dati durante l'esplorazione di Application Insights nel portale di Azure?

Questo errore indica che il browser non è stato in grado di chiamare un'API necessaria oppure l'API ha restituito una risposta di errore. Per risolvere il problema del comportamento, aprire una finestra InPrivate del browser e disabilitare tutte le estensioni del browser in esecuzione, quindi verificare se è ancora possibile riprodurre il comportamento del portale. Se l'errore del portale si verifica ancora, provare a testare con altri browser o altri computer e analizzare i problemi relativi a DNS o altri problemi di rete dal computer client in cui le chiamate API hanno esito negativo. Se l'errore del portale persiste e richiede altre indagini, raccogliere una traccia di rete del browser riproducendo il comportamento imprevisto del portale; infine, aprire un caso di supporto dal portale di Azure.