Telemetria degli eventi: modello di dati di Application InsightsEvent telemetry: Application Insights data model

È possibile creare elementi di telemetria degli eventi (in Application Insights) per rappresentare un evento che si è verificato nell'applicazione.You can create event telemetry items (in Application Insights) to represent an event that occurred in your application. Si tratta in genere di un'interazione dell'utente, ad esempio il clic su un pulsante o il completamento della transazione di un ordine.Typically it is a user interaction such as button click or order checkout. Può inoltre essere un evento del ciclo di vita dell'applicazione come l'inizializzazione o l'aggiornamento della configurazione.It can also be an application life cycle event like initialization or configuration update.

A livello semantico gli eventi possono essere correlati o meno a richieste.Semantically, events may or may not be correlated to requests. Se usata correttamente, la telemetria degli eventi è tuttavia più importante delle richieste o delle tracce.However, if used properly, event telemetry is more important than requests or traces. Gli eventi rappresentano dati di telemetria business e devono essere oggetto di campionamento separato, meno rigido.Events represent business telemetry and should be a subject to separate, less aggressive sampling.

NomeName

Nome evento.Event name. Per consentire un raggruppamento adeguato e metriche utili, limitare l'applicazione in modo che generi un numero ridotto di nomi di eventi distinti.To allow proper grouping and useful metrics, restrict your application so that it generates a small number of separate event names. Ad esempio, non usare un nome distinto per ogni istanza generata di un evento.For example, don't use a separate name for each generated instance of an event.

Lunghezza massima: 512 caratteriMax length: 512 characters

Proprietà personalizzateCustom properties

Raccolta nome-valore di proprietà personalizzate.Name-value collection of custom properties. Questa raccolta viene usata per estendere la telemetria standard con dimensioni personalizzate,This collection is used to extend standard telemetry with the custom dimensions. 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.Examples are deployment slot that produced telemetry or telemetry-item specific property like order number.

La lunghezza massima della chiave è 150 e quella del valore è 8192.Max key length: 150 Max value length: 8192

Misure personalizzateCustom measurements

Raccolta di misure personalizzate.Collection of custom measurements. Usare questa raccolta per segnalare la misura denominata associata all'elemento di telemetria.Use this collection to report named measurement associated with the telemetry item. Casi d'uso tipici sono i seguenti:Typical use cases are:

  • dimensioni del payload della telemetria di dipendenzathe size of Dependency Telemetry payload
  • numero di elementi in coda elaborati dalla telemetria delle richiestethe number of queue items processed by Request Telemetry
  • tempo impiegato dal cliente per completare il passaggio nella telemetria degli eventi di completamento dei passaggi della procedura guidata.time that customer took to complete the step in wizard step completion Event Telemetry.

È possibile eseguire query sulle misure personalizzate in Analisi applicazione:You can query custom measurements in Application Analytics:

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

Nota

Le misure personalizzate sono associate all'elemento di telemetria a cui appartengonoCustom measurements are associated with the telemetry item they belong to. e sono soggette al campionamento con l'elemento di telemetria contenente tali misurazioni.They are subject to sampling with the telemetry item containing those measurements. Per rilevare una misura che ha un valore indipendente da altri tipi di telemetria, usare Dati di telemetria relativi alle metriche.To track a measurement that has a value independent from other telemetry types, use Metric telemetry.

Lunghezza massima della chiave: 150Max key length: 150

Passaggi successiviNext steps