Telemetria degli eventi: modello di dati di Application Insights

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

A livello semantico gli eventi possono essere correlati o meno a richieste. Se usata correttamente, la telemetria degli eventi è tuttavia più importante delle richieste o delle tracce. Gli eventi rappresentano dati di telemetria business e devono essere oggetto di campionamento separato, meno rigido.

Nome

Nome evento. Per consentire un raggruppamento adeguato e metriche utili, limitare l'applicazione in modo che generi un numero ridotto di nomi di eventi distinti. Ad esempio, non usare un nome distinto per ogni istanza generata di un evento.

Lunghezza massima: 512 caratteri

Proprietà personalizzate

Raccolta nome-valore di proprietà personalizzate. Questa raccolta viene usata per estendere la telemetria standard con dimensioni personalizzate, ad esempio uno slot di distribuzione che ha generato dati di telemetria o una proprietà specifica degli elementi di telemetria come il numero d'ordine.

La lunghezza massima della chiave è 150 e quella del valore è 8192.

Misure personalizzate

Raccolta di misure personalizzate. Usare questa raccolta per segnalare la misura denominata associata all'elemento di telemetria. Casi d'uso tipici sono i seguenti:

  • dimensioni del payload della telemetria di dipendenza
  • numero di elementi in coda elaborati dalla telemetria delle richieste
  • tempo impiegato dal cliente per completare il passaggio nella telemetria degli eventi di completamento dei passaggi della procedura guidata.

È 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 e sono soggette al campionamento con l'elemento di telemetria contenente tali misurazioni. Per rilevare una misura che ha un valore indipendente da altri tipi di telemetria, usare Dati di telemetria relativi alle metriche.

Lunghezza massima della chiave: 150

Passaggi successivi