Soluzione Connettore di Application Insights (anteprima) in Operations Management Suite (OMS)

Simbolo Application Insights

La soluzione Connettore di Application Insights consente di diagnosticare problemi di prestazioni e comprendere in che modo gli utenti usano le app con il monitoraggio di Application Insights. In OMS sono disponibili alcune viste della stessa telemetria dell'applicazione visualizzate dagli sviluppatori in Application Insights. Tuttavia, quando si integrano le app Application Insights con OMS, la visibilità delle applicazioni aumenta, dal momento che i dati operativi e applicativi si trovano in un'unica posizione. Con le stesse viste è possibile collaborare con gli sviluppatori delle app. Le viste comuni consentono di ridurre il tempo necessario a rilevare e risolvere i problemi delle piattaforme e delle applicazioni.

Quando si usa la soluzione, è possibile:

  • Visualizzare tutte le app Application Insights in un'unica posizione, anche in presenza di sottoscrizioni Azure diverse
  • Correlare i dati di infrastruttura ai dati applicativi
  • Visualizzare i dati applicativi con prospettive nella ricerca log
  • Passare dai dati Log Analytics all'app Application Insights nei portali OMS e Azure

Origini connesse

A differenza della maggior parte delle altre soluzioni Log Analytics, i dati per Connettore di Application Insights non vengono raccolti dagli agenti. Tutti i dati usati dalla soluzione provengono direttamente da Azure.

Origine connessa Supportato Descrizione
Agenti di Windows No La soluzione non raccoglie le informazioni dagli agenti di Windows.
Agenti Linux No La soluzione non raccoglie le informazioni dagli agenti di Linux.
Gruppo di gestione SCOM No La soluzione non raccoglie le informazioni dagli agenti in un gruppo di gestione SCOM connesso.
Account di archiviazione di Azure No La soluzione non raccoglie le informazioni da Archiviazione di Azure.

Prerequisiti

  • Per accedere alle informazioni relative a Connettore di Application Insights, è necessaria una sottoscrizione Azure
  • È necessario disporre di almeno una risorsa Application Insights configurata.
  • È necessario essere il proprietario o un collaboratore della risorsa Application Insights.

Configurazione

  1. Abilitare la soluzione Analisi app Web di Azure da Azure Marketplace o seguendo la procedura illustrata in Aggiungere soluzioni di Log Analytics dalla Raccolta soluzioni.
  2. Nel portale OMS fare clic su Impostazioni > Dati > Application Insights.
  3. In Selezionare una sottoscrizione, selezionare una sottoscrizione con risorse Application Insights e quindi, in Nome applicazione, selezionare una o più applicazioni.
  4. Fare clic su Salva.

Dopo circa 30 minuti, i dati diverranno disponibili e il riquadro Application Insights verrà aggiornato con alcuni dati, come nell'immagine seguente:

Riquadro Application Insights

Altri punti da considerare:

  • È possibile collegare solo app Application Insights a un'area di lavoro OMS.
  • È possibile collegare solo risorse Application Insights standard o premium a OMS Log Analytics. È tuttavia possibile usare il livello gratuito di Log Analytics.

Management Pack

Questa soluzione non installa alcun Management Pack nei gruppi di gestione connessi.

Usare la soluzione

Le sezioni seguenti descrivono come usare i pannelli visualizzati nel dashboard di Application Insights per visualizzare e interagire con i dati delle app.

Visualizzare le informazioni di Connettore di Application Insights

Fare clic sul riquadro Application Insights per aprire il dashboard Application Insights e visualizzare i pannelli seguenti.

Dashboard Application Insights

Dashboard Application Insights

Il dashboard include i pannelli mostrati nella tabella. Ogni panello elenca fino a 10 elementi corrispondenti ai criteri del pannello per lo scope e l'intervallo di tempo specificati. È possibile eseguire una ricerca log per ottenere tutti i record facendo clic su Vedi tutto nella parte inferiore del pannello o facendo clic sull'intestazione del pannello.

Nota

Se l'area di lavoro è stata aggiornata al nuovo linguaggio di query di Log Analytics, è necessario convertire le query seguenti. È possibile usare il convertitore di linguaggio per eseguire questa conversione.

Colonna Descrizione
Applications - Number of applications (Applicazioni - Numero di applicazioni) Mostra il numero di applicazioni nelle risorse Applications (Applicazioni). Sono anche elencati i nomi delle applicazioni e, per ognuna, il numero di record. Fare clic sul numero per eseguire una ricerca log di Type=ApplicationInsights | measure sum(SampledCount) by ApplicationName

Fare clic sul nome di un'applicazione per eseguire una ricerca log dell'applicazione che mostri i record dell'applicazione per host e tipo di telemetria e tutti i dati per tipo (in base all'ultimo giorno).
Data Volume – Hosts sending data (Volume dati - Host che inviano dati) Mostra il numero di host computer che inviano dati. Elenca anche gli host computer e il numero di record per ogni host. Fare clic sul numero per eseguire una ricerca log di Type=ApplicationInsights | measure sum(SampledCount) by Host

Fare clic sul nome di un computer per eseguire una ricerca log dell'host che mostri i record dell'applicazione per host e tipo di telemetria e tutti i dati per tipo (in base all'ultimo giorno).
Availability – Webtest results (Disponibilità - Risultati test Web) Mostra un grafico ad anello per i risultati dei test Web, con indicazione di esito positivo o negativo. Fare clic sul grafico per eseguire una ricerca log di Type=ApplicationInsights TelemetryType=Availability | measure sum(SampledCount) by AvailabilityResult

I risultati indicano il numero di esiti positivi e negativi per tutti i test. Mostra tutte le app Web con traffico nell'ultimo minuto. Fare clic su un nome di applicazione per visualizzare una ricerca log che mostri i dettagli dei test Web non riusciti.
Server Requests – Requests per hour (Richieste server - Richieste per ora) Mostra un grafico a linee delle richieste server per ora per diverse applicazioni. Passare il mouse su una riga nel grafico per visualizzare le prime 3 applicazioni che ricevono richieste per un punto nel tempo. Mostra anche un elenco delle applicazioni che ricevono richieste e il numero di richieste per il periodo selezionato.

Fare clic sul grafo per eseguire una ricerca log di Type=ApplicationInsights TelemetryType=Request | measure sum(SampledCount) by ApplicationName interval 1hour che mostri un grafico a linee più dettagliato delle richieste server per ora per diverse applicazioni.

Fare clic su un'applicazione nell'elenco per eseguire una ricerca log di Type=ApplicationInsights ApplicationName=yourapplicationname TelemetryType=Request che mostri un elenco di richieste, grafici per le richieste nel tempo e durata delle richieste, nonché un elenco dei codici di risposta delle richieste.
Failures – Failed requests per hour (Errori - Richieste non riuscite per ora) Mostra un grafico a linee di richieste di applicazione non riuscite per ora. Passare il mouse sul grafico per visualizzare le prime 3 applicazioni con richieste non riuscite per un punto nel tempo. Mostra anche un elenco di applicazioni con il numero di richieste non riuscite per ognuna. Fare clic sul grafico per eseguire una ricerca log di Type=ApplicationInsights TelemetryType=Request RequestSuccess = false | measure sum(SampledCount) by ApplicationName interval 1hour che mostri un grafico a linee più dettagliato delle richieste di applicazione non riuscite.

Fare clic su un elemento nell'elenco per eseguire una ricerca log di Type=ApplicationInsights ApplicationName=yourapplicationname TelemetryType=Request RequestSuccess=false che mostri richieste non riuscite, grafici per le richieste non riuscite nel tempo e durata delle richieste, nonché un elenco dei codici di risposta delle richieste non riuscite.
Exceptions – Exceptions per hour (Eccezioni - Eccezioni per ora) Mostra un grafico a linee di eccezioni per ora. Passare il mouse sul grafico per visualizzare le prime 3 applicazioni con eccezioni per un punto nel tempo. Mostra anche un elenco di applicazioni con il numero di eccezioni per ognuna. Fare clic sul grafico per eseguire una ricerca log di Type=ApplicationInsights TelemetryType=Exception | measure sum(SampledCount) by ApplicationName interval 1hour che mostri un grafico a linee più dettagliato delle eccezioni.

Fare clic su un elemento nell'elenco per eseguire una ricerca log di Type=ApplicationInsights ApplicationName=yourapplicationname TelemetryType=Exception che mostri un elenco di eccezioni, grafici per le eccezioni nel tempo e richieste non riuscite, nonché un elenco dei tipi di eccezione.

Quando si fa clic su qualsiasi elemento nel dashboard, viene visualizzata una prospettiva di Application Insights nella ricerca. La prospettiva offre una visualizzazione estesa, in base al tipo di telemetria selezionata. Il contenuto della visualizzazione varia pertanto in base a tipi di telemetria diversi.

Quando si fa clic in un punto qualsiasi nel pannello delle applicazioni, viene visualizzata la prospettiva Applications (Applicazioni) predefinita.

Prospettiva Applications (Applicazioni) di Application Insights

La prospettiva mostra una panoramica dell'applicazione selezionata.

Il pannello Availability (Disponibilità) mostra una visualizzazione di prospettiva diversa, in cui è possibile visualizzare i risultati dei test Web e le relative richieste non riuscite.

Prospettiva Availability di Application Insights

Quando si fa clic su un punto qualsiasi nei pannelli Server Requests (Richieste server) o Failures (Errori), i componenti della prospettiva variano per garantire una visualizzazione correlata alle richieste.

Pannello Failures (Errori) di Application Insights

Quando si fa clic su un punto qualsiasi nel pannello Exceptions (Eccezioni), viene aperta una visualizzazione personalizzata in base alle eccezioni.

Pannello Exceptions (Eccezioni) di Application Insights

Indipendentemente dal fatto che si faccia clic su un elemento del dashboard Connettore di Application Insights, all'interno della pagina Search (Cerca), qualsiasi query che restituisce dati di Application Insights mostra la prospettiva di Application Insights. Se ad esempio vengono visualizzati i dati di Application Insights, una query * mostra anche la scheda della prospettiva, come nell'immagine seguente:

Application Insights

I componenti della prospettiva vengono aggiornati a seconda della query di ricerca. In questo modo è possibile filtrare i risultati usando qualsiasi campo di ricerca che consenta di visualizzare i dati da:

  • Tutte le applicazioni
  • Una singola applicazione selezionata
  • Un gruppo di applicazioni

Passare a un'app nel portale di Azure

I pannelli di Connettore di Application Insights sono progettati per consentire di passare all'app Application Insights selezionata quando si usa il portale di OMS. È possibile usare la soluzione come piattaforma di monitoraggio ad alto livello che contribuisce alla risoluzione dei problemi di un'app. Quando viene riscontrato un potenziale problema in una delle applicazioni connesse, è possibile analizzarlo nella ricerca OMS oppure passare direttamente all'app di Application Insights.

A tale scopo, fare clic sui puntini di sospensione (...) visualizzati alla fine di ogni riga e selezionare Apri in Application Insights.

Nota

Apri in Application Insights non è disponibile nel portale di Azure.

Apri in Application Insights

Dati con correzione di campionamento

Application Insights offre dati con correzione di campionamento per ridurre il traffico di telemetria. Quando si abilita il campionamento nell'app di Application Insights, si ottiene un numero ridotto di voci archiviate in Application Insights e in OMS. Sebbene venga mantenuta la coerenza dei dati nella pagina Connettore di Application Insights e nelle prospettive, è consigliabile correggere manualmente i dati campionati per le query personalizzate.

Di seguito è riportato un esempio di correzione di campionamento in una query di ricerca log:

Type=ApplicationInsights | measure sum(SampledCount) by TelemetryType

Il campo SampledCount è presente in tutte le voci e mostra il numero di punti dati rappresentati dalla voce. Se si attiva il campionamento per l'app di Application Insights, SampledCount è maggiore di 1. Per calcolare il numero effettivo di voci generati dall'applicazione, sommare i campi SampledCount.

Il campionamento interessa solo il numero totale di voci generate dall'applicazione. Non è necessario correggere il campionamento per campi di metrica quali RequestDuration o AvailabilityDuration, poiché tali campi mostrano la media per le voci rappresentate.

Dati di input

La soluzione riceve i tipi seguenti di telemetria di dati dalle app Application Insights connesse:

  • Disponibilità
  • Eccezioni
  • Requests
  • Visualizzazioni di pagine: per l'area di lavoro per la ricezione di visualizzazioni di pagina, è necessario configurare le app per raccogliere tali informazioni. Per altre informazioni, vedere PageViews.
  • Eventi personalizzati: per l'area di lavoro per la ricezione di eventi personalizzati, è necessario configurare le app per raccogliere tali informazioni. Per altre informazioni, vedere TrackEvent.

I dati vengono ricevuti da OMS da Application Insights appena disponibili.

Dati di output

Viene creato un record con un tipo di ApplicationInsights per ogni tipo di dati di input. Nei record di ApplicationInsights sono visualizzate proprietà nelle sezioni seguenti:

Campi generici

Proprietà Descrizione
Tipo ApplicationInsights
ClientIP
TimeGenerated Ora del record
ApplicationId Chiave di strumentazione dell'app Application Insights
ApplicationName Nome dell'app Application Insights
RoleInstance ID dell'host server
DeviceType Dispositivo client
ScreenResolution
Continent Continente in cui ha origine la richiesta
Paese Paese in cui ha origine la richiesta
Province Provincia, stato o impostazioni locali in cui ha origine la richiesta
city Città o paese in cui ha origine la richiesta
isSynthetic Indica se la richiesta è stata creata da un utente o dal metodo automatizzato. True = generata dall'utente o false = metodo automatizzato
SamplingRate Percentuale di telemetria generata dall'SDK inviato al portale. L'intervallo è 0,0-100,0.
SampledCount 100/(SamplingRate). Ad esempio, 4 => 25%
IsAuthenticated True o false
OperationID Gli elementi con lo stesso ID operazione vengono visualizzati come elementi correlati nel portale. In genere è l'ID richiesta
ParentOperationID ID dell'operazione padre
OperationName
SessionId GUID per identificare in modo univoco la sessione in cui è stata creata la richiesta
SourceSystem ApplicationInsights

Campi specifici di disponibilità

Proprietà Descrizione
TelemetryType Disponibilità
AvailabilityTestName Nome del test Web
AvailabilityRunLocation Origine geografica della richiesta HTTP
AvailabilityResult Indica l'esito positivo del test Web
AvailabilityMessage Messaggio associato al test Web
AvailabilityCount 100/(SamplingRate). Ad esempio, 4 => 25%
DataSizeMetricValue 1,0 o 0,0
DataSizeMetricValue 100/(SamplingRate). Ad esempio, 4 => 25%
AvailabilityDuration Durata, in millisecondi, del test Web
AvailabilityDurationCount 100/(SamplingRate). Ad esempio, 4 => 25%
AvailabilityValue
AvailabilityMetricCount
AvailabilityTestId GUID univoco per il test Web
AvailabilityTimestamp Timestamp preciso del test di disponibilità
AvailabilityDurationMin Per i record campionati, questo campo mostra la durata minima del test Web (in millisecondi) per i punti dati rappresentati
AvailabilityDurationMax Per i record campionati, questo campo mostra la durata massima del test Web (in millisecondi) per i punti dati rappresentati
AvailabilityDurationStdDev Per i record campionati, questo campo mostra la deviazione standard tra tutte le durate dei test Web (in millisecondi) per i punti dati rappresentati
AvailabilityMin
AvailabilityMax
AvailabilityStdDev  

Campi specifici di eccezione

Tipo ApplicationInsights
TelemetryType Eccezione
ExceptionType Tipo di eccezione
ExceptionMethod Metodo che crea l'eccezione
ExceptionAssembly L'assembly include il framework e la versione, nonché il token di chiave pubblica
ExceptionGroup Tipo di eccezione
ExceptionHandledAt Indica il livello che ha gestito l'eccezione
ExceptionCount 100/(SamplingRate). Ad esempio, 4 => 25%
ExceptionMessage Messaggio di eccezione
ExceptionStack Stack completo dell'eccezione
ExceptionHasStack True se l'eccezione include uno stack

Campi specifici di richiesta

Proprietà Descrizione
Tipo ApplicationInsights
TelemetryType Richiesta
ResponseCode Risposta HTTP inviata al client
RequestSuccess Indica l'esito positivo o negativo. True o false.
RequestID ID che identifica in modo univoco la richiesta
RequestName GET/POST + base URL
RequestDuration Durata, in secondi, della richiesta
URL URL della richiesta che non include l'host
Host Host del server Web
URLBase URL completo della richiesta
ApplicationProtocol Tipo di protocollo usato dall'applicazione
RequestCount 100/(SamplingRate). Ad esempio, 4 => 25%
RequestDurationCount 100/(SamplingRate). Ad esempio, 4 => 25%
RequestDurationMin Per i record campionati, questo campo mostra la durata minima della richiesta (in millisecondi) per i punti dati rappresentati.
RequestDurationMax Per i record campionati, questo campo mostra la durata massima della richiesta (in millisecondi) per i punti dati rappresentati
RequestDurationStdDev Per i record campionati, questo campo mostra la deviazione standard tra tutte le durate delle richieste (in millisecondi) per i punti dati rappresentati

Ricerche di log di esempio

Questa soluzione non include un set di ricerche log di esempio illustrato nel dashboard. Tuttavia, le query delle ricerche log di esempio con le descrizioni vengono visualizzate nella sezione Visualizzare le informazioni di Connettore di Application Insights sezione.

Passaggi successivi

  • Usare la ricerca log per visualizzare informazioni dettagliate per le app Application Insights.