Utilizzo della funzionalità Ricerca in Application InsightsUsing Search in Application Insights

Ricerca è una funzionalità di Application Insights che consente di trovare ed esplorare elementi singoli di telemetria, ad esempio visualizzazioni pagine, eccezioni o richieste Web.Search is a feature of Application Insights that you use to find and explore individual telemetry items, such as page views, exceptions, or web requests. È possibile visualizzare le tracce del log e gli eventi codificati.And you can view log traces and events that you have coded.

Per le query più complesse sui dati, utilizzare Analytics.(For more complex queries over your data, use Analytics.)

Nel portale di AzureIn the Azure portal

È possibile aprire la ricerca diagnostica in modo esplicito dal pannello Panoramica di Application Insights dell'applicazione:You can open diagnostic search explicitly from the Application Insights Overview blade of your application:

Aprire la ricerca diagnostica

Viene anche aperta quando si fa clic su alcuni grafici ed elementi della griglia.It also opens when you click through some charts and grid items. In questo caso, i filtri sono preimpostati per concentrarsi sul tipo di elemento selezionato.In this case, its filters are pre-set to focus on the type of item you selected.

Ad esempio, nel pannello Panoramica, è presente un grafico a barre di richieste classificate per tempo di risposta.For example, on the Overview blade, there's a bar chart of requests classified by response time. Fare clic in un intervallo di prestazioni per visualizzare un elenco delle singole richieste nell'intervallo di tempo di risposta:Click through a performance range to see a list of individual requests in that response time range:

Fare clic sulle prestazioni della richiesta

Il corpo principale della Ricerca diagnostica è un elenco di elementi di telemetria: richieste del server, visualizzazioni pagina, eventi personalizzati che sono stati codificati e così via.The main body of Diagnostic Search is a list of telemetry items - server requests, page views, custom events that you have coded, and so on. Nella parte superiore dell'elenco è disponibile un grafico di riepilogo che mostra il numero di eventi nel tempo.At the top of the list is a summary chart showing counts of events over time.

Fare clic su Aggiorna per ottenere nuovi eventi.Click Refresh to get new events.

In Visual StudioIn Visual Studio

In Visual Studio è inoltre disponibile una finestra Ricerca di Application Insights.In Visual Studio, there's also an Application Insights Search window. È più utile per visualizzare gli eventi di telemetria generati dall'applicazione di cui si esegue il debug.It's most useful for displaying telemetry events generated by the application that you're debugging. È inoltre possibile visualizzare gli eventi raccolti dall'app pubblicata nel portale di Azure.But it can also show the events collected from your published app at the Azure portal.

Aprire la finestra Cerca in Visual Studio:Open the Search window in Visual Studio:

Funzionalità di ricerca di Application Insights aperta in Visual Studio

La finestra di ricerca ha funzionalità simili al portale Web:The Search window has features similar to the web portal:

Finestra di ricerca di Application Insights in Visual Studio

La scheda Track Operation (Traccia operazione) è disponibile quando si apre una richiesta o una visualizzazione pagina.The Track Operation tab is available when you open a request or a page view. Con "operazione" si intende una sequenza di eventi associata a una singola richiesta o visualizzazione pagina.An 'operation' is a sequence of events that is associated with to a single request or page view. Ad esempio, chiamate di dipendenza, eccezioni, log di traccia ed eventi personalizzati potrebbero far parte di una singola operazione.For example, dependency calls, exceptions, trace logs, and custom events might be part of a single operation. La scheda Track Operation (Traccia operazione) mostra graficamente l'intervallo e la durata di questi eventi in relazione alla richiesta o alla visualizzazione pagina.The Track Operation tab shows graphically the timing and duration of these events in relation to the request or page view.

Controllare i singoli elementiInspect individual items

Selezionare qualsiasi elemento di dati di telemetria per visualizzare i campi chiave e gli elementi correlati.Select any telemetry item to see key fields and related items. Se si intende visualizzare il set completo di campi, fare clic su "...".If you want to see the full set of fields, click "...".

Fare clic su Nuovo elemento di lavoro, modificare i campi e quindi fare clic su OK.

I tipi di eventi sono i seguenti:Filter event types

Aprire il pannello Filtro e scegliere i tipi di evento che si vuole visualizzare.Open the Filter blade and choose the event types you want to see. Se, in seguito, si vogliono ripristinare i filtri con cui è stato aperto il pannello, fare clic su Reimposta.(If, later, you want to restore the filters with which you opened the blade, click Reset.)

Scegliere il filtro e selezionare i tipi di telemetria

I tipi di eventi sono i seguenti:The event types are:

Filtrare in base ai valori delle proprietàFilter on property values

È possibile filtrare gli eventi in base ai valori delle relative proprietà.You can filter events on the values of their properties. Le proprietà disponibili dipendono dai tipi di eventi selezionati.The available properties depend on the event types you selected.

Ad esempio, selezionare le richieste con un codice di risposta specifico.For example, pick out requests with a specific response code.

Espandere una proprietà e scegliere un valore

La mancata scelta dei valori di una determinata proprietà ha lo stesso effetto della scelta di tutti i valori.Choosing no values of a particular property has the same effect as choosing all values. Viene disattivata l'applicazione dei filtri per quella proprietà.It switches off filtering on that property.

Si noti che il numero a destra dei valori di filtro mostra quante occorrenze sono incluse nel set filtrato corrente.Notice that the counts to the right of the filter values show how many occurrences there are in the current filtered set.

In questo esempio è evidente che la richiesta "Rpt/Employees" produce la maggior parte dei "500" errori:In this example, it's clear that the 'Rpt/Employees' request results in most of the '500' errors:

Espandere una proprietà e scegliere un valore

Trovare gli eventi con la stessa proprietàFind events with the same property

Trovare tutti gli elementi con lo stesso valore della proprietà:Find all the items with the same property value:

Fare clic con il pulsante destro del mouse su una proprietà

Eseguire ricerche nei datiSearch the data

Nota

Per scrivere query più complesse, aprire Analytics nella parte superiore del pannello Ricerca.To write more complex queries, open Analytics from the top of the Search blade.

È possibile cercare i termini in uno dei valori delle proprietà.You can search for terms in any of the property values. Ciò è particolarmente utile se sono stati scritti eventi personalizzati con i valori della proprietà.This is particularly useful if you have written custom events with property values.

È possibile che si voglia impostare un intervallo di tempo, poiché le ricerche di un intervallo più breve sono più veloci.You might want to set a time range, as searches over a shorter range are faster.

Aprire la ricerca diagnostica

Cercare parole complete, non sottostringhe.Search for complete words, not substrings. Utilizzare le virgolette per racchiudere i caratteri speciali.Use quotation marks to enclose special characters.

stringstring non si trova conis not found by ma si trova conbut these do find it
ControllerHome.InfoHomeController.About homehome
controllercontroller
foout
controllerhomehomecontroller
infoabout
"homecontroller.info""homecontroller.about"
Stati UnitiUnited States UniUni
tited
unitiunited
statistates
uniti AND statiunited AND states
"stati uniti""united states"

È possibile usare espressioni di ricerca quali le seguenti:Here are the search expressions you can use:

Query di esempioSample query EffettoEffect
apple Individuazione di tutti gli eventi nell'intervallo di tempo i cui campi includono la parola "mela"Find all events in the time range whose fields include the word "apple"
apple AND banana Individuazione di eventi che contengono entrambe le parole.Find events that contain both words. Usare "AND" in lettere maiuscole, non "and".Use capital "AND", not "and".
apple OR banana
apple banana
Individuazione degli eventi che contengono una delle parole.Find events that contain either word. Usare "OR", non "or".Use "OR", not "or".
Forma breve.Short form.
apple NOT banana Individua eventi che contengono una parola ma non l'altra.Find events that contain one word but not the other.

campionamentoSampling

Se l'app genera molti dati di telemetria (e si usa ASP.NET SDK versione 2.0.0-beta3 o successiva), il modulo di campionamento adattivo riduce automaticamente il volume che viene inviato al portale inviando solo una frazione rappresentativa di eventi.If your app generates a lot of telemetry (and you are using the ASP.NET SDK version 2.0.0-beta3 or later), the adaptive sampling module automatically reduces the volume that is sent to the portal by sending only a representative fraction of events. Tuttavia, gli eventi che fanno parte della stessa richiesta vengono selezionati o deselezionati come gruppo, per rendere possibile lo spostamento tra eventi correlati.However, events that are related to the same request are selected or deselected as a group, so that you can navigate between related events.

Informazioni sul campionamento.Learn about sampling.

Creare un elemento di lavoroCreate work item

È possibile creare un bug in GitHub o Visual Studio Team Services con i dettagli provenienti da qualsiasi elemento di dati di telemetria.You can create a bug in GitHub or Visual Studio Team Services with the details from any telemetry item.

Fare clic su Nuovo elemento di lavoro, modificare i campi e quindi fare clic su OK.

La prima volta che si esegue questa operazione viene chiesto di configurare un collegamento all'account e al progetto di Team Services.The first time you do this, you are asked to configure a link to your Team Services account and project.

Immettere l'URL del server di Team Services e il nome del progetto, quindi fare clic su Autorizza.

(È anche possibile configurare il collegamento al pannello Elementi di lavoro).(You can also configure the link on the Work Items blade.)

Dopo aver impostato tutti i filtri desiderati, è possibile salvare la ricerca come preferita.When you've set all the filters you want, you can save the search as a favorite. Se si usa un account aziendale, è possibile scegliere se condividerlo con altri membri del team.If you work in an organizational account, you can choose whether to share it with other team members.

Fare clic su Preferiti, impostare il nome e fare clic su Salva

Per visualizzare nuovamente la ricerca, andare al pannello Panoramica e aprire Preferiti:To see the search again, go to the overview blade and open Favorites:

Sezione Preferiti

Se è stato salvato con intervallo di tempo Relativo, il pannello riaperto presenterà i dati più recenti.If you saved with Relative time range, the re-opened blade has the latest data. Se è stato salvato con intervallo di tempo Assoluto,verranno visualizzati gli stessi dati ogni volta.If you saved with Absolute time range, you see the same data every time. Se "Relativo" non è disponibile quando si desidera salvare un elemento come preferito, fare clic su Intervallo di tempo nell'intestazione e impostare un intervallo di tempo che non sia personalizzato.(If 'Relative' isn't available when you want to save a favorite, click Time Range in the header, and set a time range that isn't a custom range.)

Inviare altri dati di telemetria ad Application InsightsSend more telemetry to Application Insights

Oltre la telemetria predefinita inviata da Application Insights SDK, è possibile:In addition to the out-of-the-box telemetry sent by Application Insights SDK, you can:

  • Acquisire le tracce del log dal framework di registrazione preferito in .NET o Java.Capture log traces from your favorite logging framework in .NET or Java. Ciò significa che è possibile cercare le tracce del log e metterle in correlazione con le visualizzazioni pagina, le eccezioni e altri eventi.This means you can search through your log traces and correlate them with page views, exceptions, and other events.
  • Scrivere codice per inviare eventi personalizzati, visualizzazioni pagina ed eccezioni.Write code to send custom events, page views, and exceptions.

Informazioni su come inviare log e telemetria personalizzata ad Application Insights.Learn how to send logs and custom telemetry to Application Insights.

Domande e risposteQ & A

Quanti dati vengono conservati?How much data is retained?

Vedere il Riepilogo dei limiti.See the Limits summary.

Come è possibile visualizzare dati POST nelle richieste server?How can I see POST data in my server requests?

I dati POST non vengono registrati automaticamente, ma è possibile usare TrackTrace o chiamate di log.We don't log the POST data automatically, but you can use TrackTrace or log calls. Inserire i dati POST nel parametro del messaggio.Put the POST data in the message parameter. Non è possibile filtrare in base al messaggio nello stesso modo delle proprietà, ma il limite delle dimensioni è maggiore.You can't filter on the message in the same way you can filter on properties, but the size limit is longer.

VideoVideo

Passaggi successiviNext steps