Telemetria delle richieste: modello di dati di Application InsightsRequest telemetry: Application Insights data model

In Application Insights, un elemento di telemetria delle richieste rappresenta la sequenza logica di esecuzione attivata da una richiesta esterna all'applicazione.A request telemetry item (in Application Insights) represents the logical sequence of execution triggered by an external request to your application. Ogni esecuzione di richiesta è identificato da un ID univoco e un url contenente tutti i parametri di esecuzione.Every request execution is identified by unique ID and url containing all the execution parameters. È possibile raggruppare le richieste in base al name logico e definire il source della richiesta.You can group requests by logical name and define the source of this request. L'esecuzione del codice può restituire un campo success o fail e ha un campo duration specificato.Code execution can result in success or fail and has a certain duration. Le esecuzioni con esito positivo e negativo possono essere ulteriormente raggruppate in base a resultCode.Both success and failure executions may be grouped further by resultCode. L'ora di inizio della telemetria delle richieste è definita a livello di busta.Start time for the request telemetry defined on the envelope level.

La telemetria delle richieste supporta il modello di estendibilità standard usando properties e measurements personalizzate.Request telemetry supports the standard extensibility model using custom properties and measurements.

NomeName

Il nome della richiesta rappresenta il percorso di codice intrapreso per elaborare la richiesta.Name of the request represents code path taken to process the request. Un valore di cardinalità basso consente di raggruppare meglio le richieste.Low cardinality value to allow better grouping of requests. Per le richieste HTTP, rappresenta il metodo HTTP e un modello di percorso URL, ad esempio GET /values/{id}, senza il valore di id effettivo.For HTTP requests it represents the HTTP method and URL path template like GET /values/{id} without the actual id value.

Web Application Insights SDK invia il nome della richiesta "così com'è" per quanto riguarda le maiuscole e minuscole.Application Insights web SDK sends request name "as is" with regards to letter case. Il raggruppamento nell'interfaccia utente considera la distinzione tra maiuscole e minuscole, pertanto GET /Home/Index viene considerato diverso da GET /home/INDEX, anche se spesso riguardano l'esecuzione della stessa azione e dello stesso controller.Grouping on UI is case-sensitive so GET /Home/Index is counted separately from GET /home/INDEX even though often they result in the same controller and action execution. Ciò accade perché gli URL rilevano in genere la distinzione tra maiuscole e minuscole.The reason for that is that urls in general are case-sensitive. Si consiglia di verificare se tutti gli errori 404 si sono verificati per gli URL digitati in maiuscolo.You may want to see if all 404 happened for the urls typed in uppercase. Altre informazioni sulla raccolta di nomi di richiesta da ASP.Net Web SDK sono disponibili nel post di blog.You can read more on request name collection by ASP.Net Web SDK in the blog post.

Lunghezza massima: 1024 caratteriMax length: 1024 characters

IDID

Identificatore dell'istanza di una chiamata di richiesta.Identifier of a request call instance. Usato per la correlazione tra richiesta e altri elementi di telemetria.Used for correlation between request and other telemetry items. L'ID deve essere globalmente univoco.ID should be globally unique. Per altre informazioni vedere la pagina relativa alla correlazione.For more information, see correlation page.

Lunghezza massima: 128 caratteriMax length: 128 characters

UrlUrl

URL della richiesta con tutti i parametri di stringa di query.Request URL with all query string parameters.

Lunghezza massima: 2048 caratteriMax length: 2048 characters

SorgenteSource

Origine della richiesta.Source of the request. Esempi sono la chiave di strumentazione o l'indirizzo IP del chiamante.Examples are the instrumentation key of the caller or the ip address of the caller. Per altre informazioni vedere la pagina relativa alla correlazione.For more information, see correlation page.

Lunghezza massima: 1024 caratteriMax length: 1024 characters

DurataDuration

Durata della richiesta in formato: DD.HH:MM:SS.MMMMMM.Request duration in format: DD.HH:MM:SS.MMMMMM. Deve essere un valore positivo e inferiore a 1000 giorni.Must be positive and less than 1000 days. Questo campo è obbligatorio in quanto la telemetria delle richieste rappresenta l'operazione con un inizio e una fine.This field is required as request telemetry represents the operation with the beginning and the end.

Codice della rispostaResponse code

Risultato dell'esecuzione di una richiesta.Result of a request execution. Codice di stato HTTP per le richieste HTTP.HTTP status code for HTTP requests. Potrebbe essere un valore HRESULT o un tipo di eccezione per altri tipi di richiesta.It may be HRESULT value or exception type for other request types.

Lunghezza massima: 1024 caratteriMax length: 1024 characters

SuccessSuccess

Indicazione di chiamata con esito positivo o con esito negativo.Indication of successful or unsuccessful call. Questo campo è obbligatorio.This field is required. Se non è impostata in modo esplicito su false la richiesta viene considerata con esito positivo.When not set explicitly to false - request considered to be successful. Impostare questo valore su false se l'operazione è stata interrotta da un'eccezione o un codice di errore restituito.Set this value to false if operation was interrupted by exception or returned error result code.

Per le applicazioni Web, Application Insights definisce una richiesta come non riuscita quando il codice di risposta è minore di 400 o uguale a 401.For the web applications, Application Insights define request as failed when the response code is less the 400 or equal to 401. Esistono tuttavia casi in cui questo mapping predefinito non corrisponde alla semantica dell'applicazione.However there are cases when this default mapping does not match the semantic of the application. Il codice di risposta 404 può indicare "Nessun record" e quindi fare parte del normale flusso.Response code 404 may indicate "no records", which can be part of regular flow. Può indicare anche un collegamento interrotto.It also may indicate a broken link. Nel caso di collegamenti interrotti, è anche possibile implementare una logica più avanzata.For the broken links, you can even implement more advanced logic. È possibile contrassegnare i collegamenti interrotti come errori solo se tali collegamenti vengono individuati nello stesso sito analizzando il riferimento dell'URL.You can mark broken links as failures only when those links are located on the same site by analyzing url referrer. È possibile contrassegnarli come errori anche quando l'accesso viene effettuato dall'applicazione per dispositivi mobili dell'azienda.Or mark them as failures when accessed from the company's mobile application. I codici 301 e 302 indicano un errore quando si accede dal client che non supporta il reindirizzamento.Similarly 301 and 302 indicates failure when accessed from the client that doesn't support redirect.

Il codice 206 di contenuto parzialmente accettato può indicare un errore di una richiesta globale.Partially accepted content 206 may indicate a failure of an overall request. L'endpoint di Application Insights riceve, ad esempio, un batch di elementi di telemetria come una singola richiesta.For instance, Application Insights endpoint receives a batch of telemetry items as a single request. Restituisce 206 quando alcuni elementi del batch non sono stati elaborati correttamente.It returns 206 when some items in the batch were not processed successfully. Un aumento della frequenza di 206 indica un problema che richiede attenzione.Increasing rate of 206 indicates a problem that needs to be investigated. Si applica una logica simile a 207 - Multi-Status in cui l'esito positivo può essere il peggiore dei codici di risposta separati.Similar logic applies to 207 Multi-Status where the success may be the worst of separate response codes.

Altre informazioni sui codici di stato e dei risultati della richiesta sono disponibili nel post del blog.You can read more on request result code and status code in the blog post.

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