Contesto dei dati di telemetria: modello di dati di Application InsightsTelemetry context: Application Insights data model

Ogni elemento di telemetria può contenere campi di contesto fortemente tipizzati.Every telemetry item may have a strongly typed context fields. Ogni campo consente uno specifico scenario di monitoraggio.Every field enables a specific monitoring scenario. Usare la raccolta di proprietà personalizzate per archiviare informazioni contestuali personalizzate o specifiche dell'applicazione.Use the custom properties collection to store custom or application-specific contextual information.

Versione dell'applicazioneApplication version

Le informazioni contenute nei campi di contesto dell'applicazione si riferiscono sempre all'applicazione che invia i dati di telemetria.Information in the application context fields is always about the application that is sending the telemetry. La versione dell'applicazione viene usata per analizzare i cambiamenti nei trend di comportamento dell'applicazione e la correlazione con le distribuzioni.Application version is used to analyze trend changes in the application behavior and its correlation to the deployments.

Lunghezza massima: 1024Max length: 1024

Indirizzo IP clientClient IP address

L'indirizzo IP del dispositivo client.The IP address of the client device. Sono supportati sia IPv4 che IPv6.IPv4 and IPv6 are supported. Quando i dati di telemetria vengono inviati da un servizio, il contesto della posizione si riferisce all'utente che ha avviato l'operazione del servizio.When telemetry is sent from a service, the location context is about the user that initiated the operation in the service. Application Insights estrae i dati di geolocalizzazione dall'IP client, per poi troncarli.Application Insights extract the geo-location information from the client IP and then truncate it. L'IP client da solo non può quindi essere usato come informazione personale dell'utente finale.So client IP by itself cannot be used as end-user identifiable information.

Lunghezza massima: 46Max length: 46

Tipo di dispositivoDevice type

In origine questo campo serviva a indicare il tipo di dispositivo usato dall'utente finale dell'applicazione.Originally this field was used to indicate the type of the device the end user of the application is using. Oggi viene usato principalmente per distinguere i dati di telemetria JavaScript con tipo di dispositivo "Browser" dai dati di telemetria lato server con tipo di dispositivo "PC".Today used primarily to distinguish JavaScript telemetry with the device type 'Browser' from server-side telemetry with the device type 'PC'.

Lunghezza massima: 64Max length: 64

ID operazioneOperation id

Un identificatore univoco dell'operazione di root.A unique identifier of the root operation. Questo identificatore univoco consente di raggruppare i dati di telemetria tra componenti multipli.This identifier allows to group telemetry across multiple components. Per informazioni dettagliate, vedere Correlazione di dati di telemetria.See telemetry correlation for details. L'ID operazione viene creato da una richiesta o da una visualizzazione pagina.The operation id is created by either a request or a page view. Tutti gli altri dati di telemetria impostano questo campo sul valore per la richiesta o la visualizzazione pagina che lo contiene.All other telemetry sets this field to the value for the containing request or page view.

Lunghezza massima: 128Max length: 128

ID operazione padreParent operation ID

L'identificatore univoco dell'elemento padre diretto dell'elemento di telemetria.The unique identifier of the telemetry item's immediate parent. Per informazioni dettagliate, vedere Correlazione di dati di telemetria.See telemetry correlation for details.

Lunghezza massima: 128Max length: 128

Nome operazioneOperation name

Il nome (gruppo) dell'operazione.The name (group) of the operation. Il nome dell'operazione viene creato da una richiesta o da una visualizzazione pagina.The operation name is created by either a request or a page view. Tutti gli altri elementi di telemetria impostano questo campo sul valore della richiesta o dalla visualizzazione pagina che lo contiene.All other telemetry items set this field to the value for the containing request or page view. Il nome dell'operazione è usato per individuare tutti gli elementi di telemetria per un gruppo di operazioni (ad esempio "GET Home/Index").Operation name is used for finding all the telemetry items for a group of operations (for example 'GET Home/Index'). Questa proprietà di contesto viene usata per rispondere a domande come "Quali sono le eccezioni tipiche generate in questa pagina?".This context property is used to answer questions like "what are the typical exceptions thrown on this page."

Lunghezza massima: 1024Max length: 1024

Origine sintetica dell'operazioneSynthetic source of the operation

Il nome dell'origine sintetica.Name of synthetic source. Alcuni dati di telemetria generati dall'applicazione possono rappresentare traffico sintetico.Some telemetry from the application may represent synthetic traffic. Potrebbe trattarsi di agenti di ricerca Web che indicizzano il sito Web, test di disponibilità del sito o tracce di librerie di diagnostica come Application Insights SDK stesso.It may be web crawler indexing the web site, site availability tests, or traces from diagnostic libraries like Application Insights SDK itself.

Lunghezza massima: 1024Max length: 1024

ID sessioneSession id

L'ID sessione, cioè l'istanza di interazione dell'utente con l'app.Session ID - the instance of the user's interaction with the app. Le informazioni contenute nei campi di contesto della sessione si riferiscono sempre all'utente finale.Information in the session context fields is always about the end user. Quando i dati di telemetria vengono inviati da un servizio, il contesto di sessione si riferisce all'utente che ha avviato l'operazione nel servizio.When telemetry is sent from a service, the session context is about the user that initiated the operation in the service.

Lunghezza massima: 64Max length: 64

ID utente anonimoAnonymous user id

L'ID utente anonimo. Rappresenta l'utente finale dell'applicazione.Anonymous user id. Represents the end user of the application. Quando i dati di telemetria vengono inviati da un servizio, il contesto utente si riferisce all'utente che ha avviato l'operazione nel servizio.When telemetry is sent from a service, the user context is about the user that initiated the operation in the service.

Il campionamento è una delle tecniche usate per ridurre al minimo la quantità di dati di telemetria raccolti.Sampling is one of the techniques to minimize the amount of collected telemetry. L'algoritmo di campionamento tenta di sondare tutti i dati di telemetria correlati in ingresso o in uscita.Sampling algorithm attempts to either sample in or out all the correlated telemetry. L'ID utente anonimo viene usato per generare un punteggio di campionamento.Anonymous user id is used for sampling score generation. L'ID utente anonimo deve essere quindi un valore sufficientemente casuale.So anonymous user id should be a random enough value.

L'uso di un ID utente anonimo per archiviare il nome utente rappresenta un uso improprio del campo.Using anonymous user id to store user name is a misuse of the field. Usare un ID utente autenticato.Use Authenticated user id.

Lunghezza massima: 128Max length: 128

ID utente autenticatoAuthenticated user id

L'ID utente autenticato. Al contrario dell'ID utente anonimo, questo campo rappresenta l'utente con un nome descrittivo.Authenticated user id. The opposite of anonymous user id, this field represents the user with a friendly name. Le sue informazioni personali non vengono infatti raccolte per impostazione predefinita dalla maggior parte degli SDK.Since its PII information it is not collected by default by most SDK.

Lunghezza massima: 1024Max length: 1024

ID accountAccount id

In applicazioni multi-tenant, rappresenta l'ID o il nome dell'account con cui l'utente opera.In multi-tenant applications this is the account ID or name, which the user is acting with. Esempi possono essere gli ID sottoscrizione al portale di Azure, il nome del blog o la piattaforma di blogging.Examples may be subscription ID for Azure portal or blog name blogging platform.

Lunghezza massima: 1024Max length: 1024

Ruolo del cloudCloud role

Il nome del ruolo di cui l'applicazione fa parte.Name of the role the application is a part of. Esegue direttamente il mapping al nome del ruolo in Azure.Maps directly to the role name in azure. Consente anche di distinguere i micro servizi che fanno parte di una singola applicazione.Can also be used to distinguish micro services, which are part of a single application.

Lunghezza massima: 256Max length: 256

Istanza del ruolo del cloudCloud role instance

Il nome dell'istanza in cui l'applicazione è in esecuzione.Name of the instance where the application is running. Il nome computer in locale, il nome dell'istanza in Azure.Computer name for on-premises, instance name for Azure.

Lunghezza massima: 256Max length: 256

Informazione interna: versione dell'SDKInternal: SDK version

La versione dell'SDK.SDK version. Per informazioni vedere https://github.com/Microsoft/ApplicationInsights-Home/blob/master/SDK-AUTHORING.md#sdk-version-specification.See https://github.com/Microsoft/ApplicationInsights-Home/blob/master/SDK-AUTHORING.md#sdk-version-specification for information.

Lunghezza massima: 64Max length: 64

Informazione interna: nome del nodoInternal: Node name

Questo campo rappresenta il nome del nodo usato a scopi di fatturazione.This field represents the node name used for billing purposes. È possibile usarlo per eseguire l'override del rilevamento standard dei nodi.Use it to override the standard detection of nodes.

Lunghezza massima: 256Max length: 256

Passaggi successiviNext steps