Modello di dati di Application Insights Telemetry

Application Insights invia dati di telemetria dall'applicazione Web all'portale di Azure in modo da poter analizzare le prestazioni e l'utilizzo dell'applicazione. Il modello di telemetria è standardizzato, quindi è possibile creare monitoraggio indipendente dalla piattaforma e dal linguaggio.

I dati raccolti da Application Insights modellano questo tipico modello di esecuzione dell'applicazione.

Diagram that shows an Application Insights telemetry data model.

Per monitorare l'esecuzione dell'applicazione si usano i tipi di dati di telemetria che seguono. Application Insights SDK dal framework applicazione Web raccoglie automaticamente questi tre tipi:

  • Richiesta: generata per registrare una richiesta ricevuta dall'app. Ad esempio, la versione Web di Application Insights SDK genera automaticamente un elemento di telemetria di tipo richiesta per ogni richiesta HTTP ricevuta dall'app Web.

    Un'operazione è costituita dai thread di esecuzione che elaborano una richiesta. È anche possibile scrivere codice per monitorare altri tipi di operazioni, ad esempio la "riattivazione" di un processo Web o di una funzione che periodicamente elabora i dati. Ogni operazione presenta un ID. L'ID può essere usato per raggruppare tutti i dati di telemetria generati mentre l'app sta elaborando la richiesta. Ogni operazione ha esito positivo o negativo e ha un periodo di tempo.

  • Eccezione: in genere rappresenta un'eccezione che causa un errore di un'operazione.

  • Dipendenza: rappresenta una chiamata dall'app a un servizio esterno o a un'archiviazione, ad esempio un'API REST o SQL. In ASP.NET le chiamate di dipendenza a SQL sono definite da System.Data. Le chiamate agli endpoint HTTP sono definite da System.Net.

Application Insights offre tre tipi di dati per i dati di telemetria personalizzati:

  • Traccia: usato direttamente o tramite un adattatore per implementare la registrazione diagnostica usando un framework di strumentazione familiare, ad esempio Log4Net o System.Diagnostics.
  • Evento: in genere usato per acquisire l'interazione dell'utente con il servizio per analizzare i modelli di utilizzo.
  • Metrica: usata per segnalare misurazioni scalari periodiche.

Ogni elemento di telemetria può definire le informazioni di contesto, ad esempio la versione dell'applicazione o l'ID sessione utente. Il contesto è un set di campi fortemente tipizzati che sblocca determinati scenari. Quando la versione dell'applicazione viene inizializzata correttamente, Application Insights può rilevare nuovi modelli di comportamento dell'applicazione in correlazione con la ridistribuzione.

È possibile usare l'ID sessione per calcolare un'interruzione o un impatto sul problema sugli utenti. Il calcolo del conteggio distinto dei valori ID sessione per una dipendenza non riuscita specifica, una traccia degli errori o un'eccezione critica offre una buona comprensione di un impatto.

Il modello di telemetria di Application Insights definisce un modo per correlare i dati di telemetria al funzionamento di cui fa parte. Ad esempio, una richiesta può effettuare una chiamata database SQL e registrare informazioni di diagnostica. È possibile impostare il contesto di correlazione per gli elementi di telemetria che lo legano di nuovo alla telemetria delle richieste.

Miglioramenti allo schema

Il modello di dati di Application Insights è un modo semplice ma potente per modellare i dati di telemetria dell'applicazione. Microsoft si impegna a mantenere il modello semplice e sottile per supportare scenari essenziali e consentire l'estensione dello schema per l'uso avanzato.

Per segnalare problemi e suggerimenti relativi al modello di dati o allo schema, usare il repository GitHub.

Richiedi

Un elemento di telemetria della richiesta in Application Insights rappresenta la sequenza logica di esecuzione attivata da una richiesta esterna all'applicazione. Ogni esecuzione della richiesta viene identificata da un oggetto univoco id e url che contiene tutti i parametri di esecuzione.

È possibile raggruppare le richieste in base al name logico e definire il source della richiesta. L'esecuzione del codice può restituire un campo success o fail e ha un campo duration specificato. È possibile raggruppare ulteriormente le esecuzioni riuscite e non riuscite usando resultCode. L'ora di inizio per i dati di telemetria della richiesta viene definita a livello di busta.

I dati di telemetria delle richieste supportano il modello di estendibilità standard usando custom properties e measurements.

Nota

Il 31 marzo 2025, il supporto per l'inserimento delle chiavi di strumentazione terminerà. L'inserimento di chiavi di strumentazione continuerà a funzionare, ma non forniamo più aggiornamenti o supporto per la funzionalità. Passare alle stringa di connessione per sfruttare le nuove funzionalità.

Nome

Questo campo è il nome della richiesta e rappresenta il percorso del codice impiegato per elaborare la richiesta. Un valore di cardinalità basso consente un raggruppamento migliore delle richieste. Per le richieste HTTP, rappresenta il metodo HTTP e il modello di percorso URL, ad esempio GET /values/{id} senza il valore effettivo id .

Application Insights Web SDK invia un nome di richiesta "così come è" sul caso lettera. Il raggruppamento nell'interfaccia utente fa distinzione tra maiuscole e minuscole, quindi GET /Home/Index viene conteggiato separatamente da GET /home/INDEX anche se spesso comportano lo stesso controller e l'esecuzione dell'azione. Il motivo è che gli URL in generale fanno distinzione tra maiuscole e minuscole. Potrebbe essere necessario verificare se tutti gli 404 errori si sono verificati per gli URL digitati in lettere maiuscole. Per altre informazioni sulla raccolta dei nomi delle richieste, vedere l'SDK Web ASP.NET nel post di blog.

Lunghezza massima: 1.024 caratteri

ID

ID è l'identificatore di un'istanza di chiamata di richiesta. Viene usato per la correlazione tra la richiesta e altri elementi di telemetria. L'ID deve essere globalmente univoco. Per altre informazioni, vedere Correlazione di dati di telemetria in Application Insights.

Lunghezza massima: 128 caratteri

URL

URL è l'URL della richiesta con tutti i parametri della stringa di query.

Lunghezza massima: 2.048 caratteri

Origine

L'origine è l'origine della richiesta. Gli esempi sono la chiave di strumentazione del chiamante o l'indirizzo IP del chiamante. Per altre informazioni, vedere Correlazione di dati di telemetria in Application Insights.

Lunghezza massima: 1.024 caratteri

Durata

La durata della richiesta viene formattata come DD.HH:MM:SS.MMMMMM. Deve essere positivo e minore di 1000 giorni. Questo campo è obbligatorio perché i dati di telemetria della richiesta rappresentano l'operazione con l'inizio e la fine.

Codice della risposta

Il codice di risposta è il risultato di un'esecuzione della richiesta. Si tratta del codice di stato HTTP per le richieste HTTP. Potrebbe trattarsi di un HRESULT valore o di un tipo di eccezione per altri tipi di richiesta.

Lunghezza massima: 1.024 caratteri

Riuscita

L'esito positivo indica se una chiamata ha avuto esito positivo o negativo. Campo obbligatorio. Quando una richiesta non è impostata in modo esplicito su false, viene considerata corretta. Se un'eccezione o il codice del risultato dell'errore restituito ha interrotto l'operazione, impostare questo valore su false.

Per le applicazioni Web, Application Insights definisce una richiesta con esito positivo quando il codice di risposta è minore 400 o uguale a 401. Tuttavia, esistono casi in cui questo mapping predefinito non corrisponde alla semantica dell'applicazione.

Il codice 404 di risposta potrebbe indicare "nessun record", che può far parte del flusso regolare. Potrebbe anche indicare un collegamento interrotto. Per i collegamenti interrotti, è possibile implementare una logica più avanzata. È possibile contrassegnare i collegamenti interrotti come errori solo quando questi collegamenti si trovano nello stesso sito analizzando il referrer URL. In alternativa, è possibile contrassegnarli come errori quando si accede dall'applicazione per dispositivi mobili dell'azienda. Analogamente, 301 e 302 indicare un errore quando si accede dal client che non supporta il reindirizzamento.

Il contenuto 206 parzialmente accettato potrebbe indicare un errore di una richiesta complessiva. Ad esempio, un endpoint di Application Insights potrebbe ricevere un batch di elementi di telemetria come singola richiesta. Restituisce 206 quando alcuni elementi del batch non sono stati elaborati correttamente. Un tasso crescente di 206 indica un problema da analizzare. Una logica simile si applica a 207 Multi-Status, in cui il successo potrebbe essere il peggiore dei codici di risposta separati.

Custom properties

Raccolta nome-valore di proprietà personalizzate: questa raccolta viene usata per estendere i dati di telemetria standard con le dimensioni personalizzate. Gli esempi sono lo slot di distribuzione che ha prodotto dati di telemetria o la proprietà specifica dell'elemento di telemetria, ad esempio il numero di ordine.

  • Lunghezza massima della chiave: 150
  • Lunghezza massima del valore: 8.192

Misure personalizzate

Raccolta di misurazioni personalizzate: usare questa raccolta per segnalare misurazioni denominate associate all'elemento di telemetria. Casi d'uso tipici sono i seguenti:

  • Dimensioni del payload di telemetria delle dipendenze.
  • Numero di elementi della coda elaborati dai dati di telemetria delle richieste.
  • Tempo impiegato da un cliente per completare il passaggio della procedura guidata completando i dati di telemetria degli eventi.

È possibile eseguire query sulle misure personalizzate in Analisi applicazione:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Nota

  • Le misure personalizzate sono associate all'elemento di telemetria a cui appartengono Sono soggetti al campionamento con l'elemento di telemetria che contiene tali misurazioni. Per tenere traccia di una misura con un valore indipendente da altri tipi di telemetria, usare i dati di telemetria delle metriche.
  • Non usare valori stringa per le misurazioni personalizzate. Sono supportati solo i valori numerici.

Lunghezza massima della chiave: 150

Dependency

La telemetria delle dipendenze (in Application Insights) rappresenta un'interazione del componente monitorato con un componente remoto, ad esempio SQL o un endpoint HTTP.

Nome

Questo campo è il nome del comando avviato con questa chiamata di dipendenza. Ha un valore di cardinalità basso. Esempi sono il nome della stored procedure e il modello di percorso URL.

ID

ID è l'identificatore di un'istanza di chiamata di dipendenza. Viene usato per la correlazione con l'elemento di telemetria della richiesta che corrisponde a questa chiamata di dipendenza. Per altre informazioni, vedere Correlazione di dati di telemetria in Application Insights.

Dati

Questo campo è il comando avviato da questa chiamata di dipendenza. Esempi sono l'istruzione SQL e l'URL HTTP con tutti i parametri di query.

Type

Questo campo è il nome del tipo di dipendenza. Ha un valore di cardinalità basso per il raggruppamento logico delle dipendenze e l'interpretazione di altri campi come commandName e resultCode. Esempi sono SQL, tabelle di Azure e HTTP.

Destinazione

Questo campo è il sito di destinazione di una chiamata di dipendenza. Esempi sono il nome del server e l'indirizzo host. Per altre informazioni, vedere Correlazione di dati di telemetria in Application Insights.

Durata

La durata della richiesta è nel formato DD.HH:MM:SS.MMMMMM. Deve essere minore di 1000 giorni.

Codice risultato

Questo campo è il codice di risultato di una chiamata di dipendenza. Esempi sono il codice di errore SQL e il codice di stato HTTP.

Riuscita

Questo campo indica una chiamata riuscita o non riuscita.

Custom properties

Raccolta nome-valore di proprietà personalizzate: questa raccolta viene usata per estendere i dati di telemetria standard con le dimensioni personalizzate. Gli esempi sono lo slot di distribuzione che ha prodotto dati di telemetria o la proprietà specifica dell'elemento di telemetria, ad esempio il numero di ordine.

  • Lunghezza massima della chiave: 150
  • Lunghezza massima del valore: 8.192

Misure personalizzate

Raccolta di misurazioni personalizzate: usare questa raccolta per segnalare misurazioni denominate associate all'elemento di telemetria. Casi d'uso tipici sono i seguenti:

  • Dimensioni del payload di telemetria delle dipendenze.
  • Numero di elementi della coda elaborati dai dati di telemetria delle richieste.
  • Tempo impiegato da un cliente per completare il passaggio della procedura guidata completando i dati di telemetria degli eventi.

È possibile eseguire query sulle misure personalizzate in Analisi applicazione:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Nota

  • Le misure personalizzate sono associate all'elemento di telemetria a cui appartengono Sono soggetti al campionamento con l'elemento di telemetria che contiene tali misurazioni. Per tenere traccia di una misura con un valore indipendente da altri tipi di telemetria, usare i dati di telemetria delle metriche.
  • Non usare valori stringa per le misurazioni personalizzate. Sono supportati solo i valori numerici.

Lunghezza massima della chiave: 150

Eccezione

In Application Insights un'istanza di eccezione rappresenta un'eccezione gestita o non gestita che si è verificata durante l'esecuzione dell'applicazione monitorata.

ID problema

L'ID del problema identifica la posizione in cui è stata generata l'eccezione nel codice. Viene usato per il raggruppamento delle eccezioni. In genere, si tratta di una combinazione di un tipo di eccezione e di una funzione dallo stack di chiamate.

Lunghezza massima: 1.024 caratteri

Livello di gravità

Questo campo è il livello di gravità della traccia. Il valore può essere Verbose, Information, Warning, Erroro Critical.

Dettagli dell'eccezione

(Da aggiungere)

Custom properties

Raccolta nome-valore di proprietà personalizzate: questa raccolta viene usata per estendere i dati di telemetria standard con le dimensioni personalizzate. Gli esempi sono lo slot di distribuzione che ha prodotto dati di telemetria o la proprietà specifica dell'elemento di telemetria, ad esempio il numero di ordine.

  • Lunghezza massima della chiave: 150
  • Lunghezza massima del valore: 8.192

Misure personalizzate

Raccolta di misurazioni personalizzate: usare questa raccolta per segnalare misurazioni denominate associate all'elemento di telemetria. Casi d'uso tipici sono i seguenti:

  • Dimensioni del payload di telemetria delle dipendenze.
  • Numero di elementi della coda elaborati dai dati di telemetria delle richieste.
  • Tempo impiegato da un cliente per completare il passaggio della procedura guidata completando i dati di telemetria degli eventi.

È possibile eseguire query sulle misure personalizzate in Analisi applicazione:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Nota

  • Le misure personalizzate sono associate all'elemento di telemetria a cui appartengono Sono soggetti al campionamento con l'elemento di telemetria che contiene tali misurazioni. Per tenere traccia di una misura con un valore indipendente da altri tipi di telemetria, usare i dati di telemetria delle metriche.
  • Non usare valori stringa per le misurazioni personalizzate. Sono supportati solo i valori numerici.

Lunghezza massima della chiave: 150

Traccia

I dati di telemetria di traccia in Application Insights rappresentano printfistruzioni di traccia di tipo stile ricercate nel testo. Log4Net, NLog e altre voci del file di log basato su testo vengono convertite in istanze di questo tipo. La traccia non ha misurazioni come estendibilità.

Message

Messaggio di traccia.

Lunghezza massima: 32.768 caratteri

Livello di gravità

Livello di gravità della traccia.

Valori:Verbose, Information, Warning, Errore Critical

Custom properties

Raccolta nome-valore di proprietà personalizzate: questa raccolta viene usata per estendere i dati di telemetria standard con le dimensioni personalizzate. Gli esempi sono lo slot di distribuzione che ha prodotto dati di telemetria o la proprietà specifica dell'elemento di telemetria, ad esempio il numero di ordine.

  • Lunghezza massima della chiave: 150
  • Lunghezza massima del valore: 8.192

Evento

È possibile creare elementi di telemetria degli eventi (in Application Insights) per rappresentare un evento che si è verificato nell'applicazione. In genere, si tratta di un'interazione dell'utente, ad esempio un clic su un pulsante o un checkout dell'ordine. Può anche essere un evento del ciclo di vita dell'applicazione, ad esempio l'inizializzazione o un aggiornamento della configurazione.

Semanticamente, gli eventi potrebbero o non essere correlati alle richieste. Se usata correttamente, i dati di telemetria degli eventi sono più importanti delle richieste o delle tracce. Gli eventi rappresentano i dati di telemetria aziendali e devono essere soggetti a campionamento separato e meno aggressivo.

Nome

Nome evento: per consentire il raggruppamento corretto e le metriche utili, limitare l'applicazione in modo che generi alcuni nomi di eventi separati. Ad esempio, non usare un nome distinto per ogni istanza generata di un evento.

Lunghezza massima: 512 caratteri

Custom properties

Raccolta nome-valore di proprietà personalizzate: questa raccolta viene usata per estendere i dati di telemetria standard con le dimensioni personalizzate. Gli esempi sono lo slot di distribuzione che ha prodotto dati di telemetria o la proprietà specifica dell'elemento di telemetria, ad esempio il numero di ordine.

  • Lunghezza massima della chiave: 150
  • Lunghezza massima del valore: 8.192

Misure personalizzate

Raccolta di misurazioni personalizzate: usare questa raccolta per segnalare misurazioni denominate associate all'elemento di telemetria. Casi d'uso tipici sono i seguenti:

  • Dimensioni del payload di telemetria delle dipendenze.
  • Numero di elementi della coda elaborati dai dati di telemetria delle richieste.
  • Tempo impiegato da un cliente per completare il passaggio della procedura guidata completando i dati di telemetria degli eventi.

È possibile eseguire query sulle misure personalizzate in Analisi applicazione:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Nota

  • Le misure personalizzate sono associate all'elemento di telemetria a cui appartengono Sono soggetti al campionamento con l'elemento di telemetria che contiene tali misurazioni. Per tenere traccia di una misura con un valore indipendente da altri tipi di telemetria, usare i dati di telemetria delle metriche.
  • Non usare valori stringa per le misurazioni personalizzate. Sono supportati solo i valori numerici.

Lunghezza massima della chiave: 150

Metric

Application Insights supporta due tipi di dati di telemetria delle metriche: misurazione singola e metrica preaggregata. La misura singola è costituita semplicemente da un nome e un valore. La metrica preaggregata specifica il valore minimo e massimo della metrica nell'intervallo di aggregazione e la deviazione standard.

I dati di telemetria delle metriche preaggregati presuppongono che il periodo di aggregazione sia stato di un minuto.

Application Insights supporta diversi nomi di metriche noti. Queste metriche vengono inserite nella performanceCounters tabella.

La tabella seguente illustra le metriche che rappresentano i contatori di sistema e di elaborazione.

Nome .NET Nome indipendente dalla piattaforma Descrizione
\Processor(_Total)\% Processor Time Lavoro in corso... CPU totale del computer.
\Memory\Available Bytes Lavoro in corso... Mostra la quantità di memoria fisica, espressa in byte, disponibile per l'esecuzione dei processi nel computer. Viene calcolato sommando la quantità di spazio negli elenchi di memoria zero, liberi e standby. La memoria libera è pronta per l'uso. La memoria con zero è costituita da pagine di memoria riempite con zeri per impedire ai processi successivi di visualizzare i dati usati da un processo precedente. La memoria di standby è la memoria che è stata rimossa dal working set di un processo (la relativa memoria fisica) instradata al disco, ma è ancora disponibile per essere richiamata. Vedere Oggetto Memory.
\Process(??APP_WIN32_PROC??)\% Processor Time Lavoro in corso... CPU del processo che ospita l'applicazione.
\Process(??APP_WIN32_PROC??)\Private Bytes Lavoro in corso... Memoria usata dal processo che ospita l'applicazione.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec Lavoro in corso... Frequenza delle operazioni di I/O eseguite dal processo che ospita l'applicazione.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec Lavoro in corso... Frequenza di richieste elaborate da un'applicazione.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec Lavoro in corso... Frequenza di eccezioni generate da un'applicazione.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time Lavoro in corso... Tempo medio di esecuzione della richiesta.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue Lavoro in corso... Numero di richieste in attesa dell'elaborazione in una coda.

Per altre informazioni sull'API REST delle metriche, vedere Metriche - Get.

Nome

Questo campo è il nome della metrica che si vuole visualizzare nel portale di Application Insights e nell'interfaccia utente.

Valore

Questo campo è il singolo valore per la misurazione. È la somma delle singole misurazioni per l'aggregazione.

Conteggio

Questo campo è il peso della metrica aggregata. Non deve essere impostato per una misura.

Min

Questo campo è il valore minimo della metrica aggregata. Non deve essere impostato per una misura.

Max

Questo campo è il valore massimo della metrica aggregata. Non deve essere impostato per una misura.

Deviazione standard

Questo campo è la deviazione standard della metrica aggregata. Non deve essere impostato per una misura.

Custom properties

La metrica con la proprietà CustomPerfCounter personalizzata impostata su true indica che la metrica rappresenta il contatore delle prestazioni di Windows. Queste metriche vengono inserite nella performanceCounters tabella, non in customMetrics. Inoltre, il nome di questa metrica viene analizzato per estrarre i nomi di categoria, contatore e istanza.

Raccolta nome-valore di proprietà personalizzate: questa raccolta viene usata per estendere i dati di telemetria standard con le dimensioni personalizzate. Gli esempi sono lo slot di distribuzione che ha prodotto dati di telemetria o la proprietà specifica dell'elemento di telemetria, ad esempio il numero di ordine.

  • Lunghezza massima della chiave: 150
  • Lunghezza massima del valore: 8.192

PageView

I dati di telemetria pageView (in Application Insights) vengono registrati quando un utente dell'applicazione apre una nuova pagina di un'applicazione monitorata. Page In questo contesto è un'unità logica definita dallo sviluppatore per essere una scheda dell'applicazione o una schermata e non è necessariamente correlata a un caricamento della pagina Web del browser o a un'azione di aggiornamento. Questa distinzione può essere ulteriormente compresa nel contesto delle applicazioni a pagina singola , in cui il passaggio tra le pagine non è associato alle azioni della pagina del browser. è pageViews.duration il tempo necessario per l'applicazione per presentare la pagina all'utente.

Nota

  • Per impostazione predefinita, gli SDK di Application Insights registrano singoli PageView eventi in ogni azione di caricamento della pagina Web del browser, con pageViews.duration popolamento in base all'intervallo del browser. Gli sviluppatori possono estendere il rilevamento aggiuntivo degli PageView eventi usando la chiamata API trackPageView.
  • La conservazione dei log predefinita è di 30 giorni. Se si desidera visualizzare PageView le statistiche per un periodo di tempo più lungo, è necessario modificare l'impostazione.

Misurare il browserTiming in Application Insights

I browser moderni espongono misurazioni per le azioni di caricamento delle pagine con l'API Prestazioni. Application Insights semplifica queste misurazioni consolidando i tempi correlati in metriche del browser standard, come definito dalle definizioni del tempo di elaborazione seguenti:

  • Client <-> DNS: il client raggiunge il DNS per risolvere il nome host del sito Web e DNS risponde con l'indirizzo IP.

  • Client <-> Server Web: il client crea TCP e quindi handshake TLS con il server Web.

  • Client <-> Server Web: il client invia il payload della richiesta, attende che il server eseseguono la richiesta e riceva il primo pacchetto di risposta.

  • Client <--Web Server: il client riceve il resto dei byte di payload della risposta dal server Web.

  • Client: il client ha ora un payload di risposta completo e deve eseguire il rendering del contenuto nel browser e caricare il DOM.

  • browserTimings/networkDuration = #1 + #2

  • browserTimings/sendDuration = #3

  • browserTimings/receiveDuration = #4

  • browserTimings/processingDuration = #5

  • browsertimings/totalDuration = #1 + #2 + #3 + #4 + #5

  • pageViews/duration

    • La PageView durata è dall'interfaccia di intervallo delle prestazioni del browser, PerformanceNavigationTiming.duration.

    • Se PerformanceNavigationTiming è disponibile, viene utilizzata tale durata.

      In caso contrario, viene usata l'interfaccia deprecataPerformanceTiming e viene calcolato il delta tra NavigationStart e LoadEventEnd .

    • Lo sviluppatore specifica un valore di durata quando si registrano eventi personalizzati PageView usando la chiamata API trackPageView.

Screenshot that shows the Metrics page in Application Insights showing graphic displays of metrics data for a web application.

Contesto

Ogni elemento di telemetria potrebbe avere un campo di contesto fortemente tipizzato. Ogni campo consente uno specifico scenario di monitoraggio. Usare la raccolta di proprietà personalizzate per archiviare informazioni contestuali personalizzate o specifiche dell'applicazione.

Versione dell'applicazione

Le informazioni nei campi del contesto dell'applicazione sono sempre relative all'applicazione che invia i dati di telemetria. La versione dell'applicazione viene usata per analizzare le variazioni di tendenza nel comportamento dell'applicazione e la relativa correlazione con le distribuzioni.

Lunghezza massima: 1.024

Indirizzo IP client

Questo campo è l'indirizzo IP del dispositivo client. Sono supportati i protocolli IPv4 e IPv6. Quando i dati di telemetria vengono inviati da un servizio, il contesto della posizione riguarda l'utente che ha avviato l'operazione nel servizio. Application Insights estrae i dati di geolocalizzazione dall'IP client, per poi troncarli. L'INDIRIZZO IP del client stesso non può essere usato come informazioni identificabili dall'utente.

Lunghezza massima: 46

Tipo di dispositivo

Originariamente, questo campo è stato usato per indicare il tipo di dispositivo usato dall'utente dell'applicazione. Oggi viene usato principalmente per distinguere i dati di telemetria JavaScript con il tipo di Browser dispositivo dai dati di telemetria lato server con il tipo di PCdispositivo .

Lunghezza massima: 64

ID operazione

Questo campo è l'identificatore univoco dell'operazione radice. Questo identificatore consente di raggruppare i dati di telemetria tra più componenti. Per altre informazioni, vedere Correlazione dei dati di telemetria. Una richiesta o una visualizzazione pagina crea l'ID operazione. Tutti gli altri dati di telemetria impostano questo campo sul valore per la richiesta o la visualizzazione pagina che lo contiene.

Lunghezza massima: 128

ID operazione padre

Questo campo è l'identificatore univoco dell'elemento di telemetria padre immediato. Per altre informazioni, vedere Correlazione dei dati di telemetria.

Lunghezza massima: 128

Nome operazione

Questo campo è il nome (gruppo) dell'operazione. Una richiesta o una visualizzazione pagina crea il nome dell'operazione. Tutti gli altri elementi di telemetria impostano questo campo sul valore della richiesta o dalla visualizzazione pagina che lo contiene. Il nome dell'operazione viene usato per trovare tutti gli elementi di telemetria per un gruppo di operazioni , ad esempio GET Home/Index. Questa proprietà di contesto viene usata per rispondere a domande quali Quali sono le eccezioni tipiche generate in questa pagina?

Lunghezza massima: 1.024

Origine sintetica dell'operazione

Questo campo è il nome dell'origine sintetica. Alcuni dati di telemetria dall'applicazione potrebbero rappresentare il traffico sintetico. Potrebbe trattarsi del crawler Web che indicizza il sito Web, i test di disponibilità del sito o le tracce provenienti da librerie di diagnostica come Application Insights SDK stesso.

Lunghezza massima: 1.024

ID sessione

L'ID sessione è l'istanza dell'interazione dell'utente con l'app. Le informazioni nei campi del contesto di sessione sono sempre relative all'utente. Quando i dati di telemetria vengono inviati da un servizio, il contesto della sessione riguarda l'utente che ha avviato l'operazione nel servizio.

Lunghezza massima: 64

ID utente anonimo

L'ID utente anonimo (User.Id) rappresenta l'utente dell'applicazione. Quando i dati di telemetria vengono inviati da un servizio, il contesto utente riguarda l'utente che ha avviato l'operazione nel servizio.

Il campionamento è una delle tecniche usate per ridurre al minimo la quantità di dati di telemetria raccolti. Un algoritmo di campionamento tenta di campionare o escludere tutti i dati di telemetria correlati. Viene usato un ID utente anonimo per la generazione del punteggio di campionamento, quindi un ID utente anonimo deve essere un valore sufficientemente casuale.

Nota

Il numero di ID utente anonimi non corrisponde al numero di utenti univoci dell'applicazione. Il numero di ID utente anonimi è in genere superiore perché ogni volta che l'utente apre l'app in un dispositivo o browser diverso o pulisce i cookie del browser, viene allocato un nuovo ID utente anonimo univoco. Questo calcolo potrebbe comportare il conteggio degli stessi utenti fisici più volte.

Gli ID utente possono essere a cui si fa riferimento incrociato con ID sessione per fornire dimensioni di telemetria univoche e stabilire un'attività utente per una durata di sessione.

L'uso di un ID utente anonimo per archiviare un nome utente è un uso improprio del campo. Usare un ID utente autenticato.

Lunghezza massima: 128

ID utente autenticato

Un ID utente autenticato è l'opposto di un ID utente anonimo. Questo campo rappresenta l'utente con un nome descrittivo. Questo ID viene raccolto solo per impostazione predefinita con l'SDK di AuthenticatedUserIdTelemetryInitializerASP.NET Framework.

Usare Application Insights SDK per inizializzare l'ID utente autenticato con un valore che identifica l'utente in modo permanente tra browser e dispositivi. In questo modo, tutti gli elementi di telemetria vengono attribuiti a tale ID univoco. Questo ID consente l'esecuzione di query per tutti i dati di telemetria raccolti per un utente specifico (soggetti a configurazioni di campionamento e filtri di telemetria).

Gli ID utente possono essere a cui si fa riferimento incrociato con ID sessione per fornire dimensioni di telemetria univoche e stabilire un'attività utente per una durata di sessione.

Lunghezza massima: 1.024

ID conto

L'ID account, nelle applicazioni multi-tenant, è l'ID o il nome dell'account tenant con cui l'utente sta agendo. Viene usato per una segmentazione più utente quando un ID utente e un ID utente autenticato non sono sufficienti. Alcuni esempi possono essere un ID sottoscrizione per il portale di Azure o il nome del blog per una piattaforma di blog.

Lunghezza massima: 1.024

Ruolo del cloud

Questo campo è il nome del ruolo di cui fa parte l'applicazione. Esegue il mapping diretto al nome del ruolo in Azure. Può anche essere usato per distinguere i microservizi, che fanno parte di una singola applicazione.

Lunghezza massima: 256

Istanza del ruolo del cloud

Questo campo è il nome dell'istanza in cui è in esecuzione l'applicazione. Ad esempio, è il nome del computer per l'ambiente locale o il nome dell'istanza per Azure.

Lunghezza massima: 256

Informazione interna: versione dell'SDK

Per altre informazioni, vedere Versione dell'SDK.

Lunghezza massima: 64

Informazione interna: nome del nodo

Questo campo rappresenta il nome del nodo usato a scopi di fatturazione. È possibile usarlo per eseguire l'override del rilevamento standard dei nodi.

Lunghezza massima: 256

Domande frequenti

Questa sezione fornisce le risposte alle domande comuni.

Come misurare l'impatto di una campagna di monitoraggio?

La telemetria di PageView include l'URL ed è possibile analizzare il parametro UTM usando una funzione regex in Kusto.

In alcuni casi, questi dati potrebbero essere mancanti o imprecisi se l'utente o l'organizzazione disabilita l'invio dell'agente utente nelle impostazioni del browser. Le espressioni regolari del parser UA potrebbero non includere tutte le informazioni sul dispositivo. In alternativa, Application Insights potrebbe non aver adottato gli aggiornamenti più recenti.

Perché una misurazione personalizzata ha esito positivo senza errori, ma il log non viene visualizzato?

Questo problema può verificarsi se si usano valori stringa. Solo i valori numerici funzionano con misurazioni personalizzate.

Passaggi successivi

Informazioni su come usare l'API di Application Insights per eventi e metriche personalizzati, tra cui:

Configurare il rilevamento delle dipendenze per:

Per altre informazioni, vedere: