Uso di Analytics in Application Insights

L'analisi è lo strumento di ricerca avanzato incluso in Application Insights. Queste pagine descrivono il linguaggio di query di Log Analytics.

Aprire Analytics

Nella home page dell'app in Application Insights fare clic su Analytics.

In portal.azure.com, aprire la risorsa di Application Insights e selezionare Analytics.

L'esercitazione inline fornisce alcune informazioni su come procedere.

È disponibile una panoramica più ampia qui.

Eseguire query sui dati di telemetria

Scrivere una query

Visualizzazione schema

Iniziare con i nomi delle tabelle elencate a sinistra oppure con l'operatore range o union. Usare | per creare una pipeline di operatori.

IntelliSense suggerisce gli operatori e gli elementi delle espressioni che è possibile usare. Fare clic sull'icona informazioni o premere CTRL+BARRA SPAZIATRICE per una descrizione più dettagliata ed esempi di utilizzo di ogni elemento.

Vedere la panoramica del linguaggio di Analytics e le informazioni di riferimento sul linguaggio.

Eseguire una query

Esecuzione di una query

  1. Nelle query è possibile usare interruzioni di riga.
  2. Posizionare il cursore all'interno o alla fine della query da eseguire.
  3. Controllare l'intervallo di tempo della query. È possibile modificarlo o ignorarlo inserendo la propria clausola where...timestamp... nella query.
  4. Fare clic su Vai per eseguire la query.
  5. Non inserire righe vuote nella query. È possibile mantenere più query separate in un'unica scheda di query, separandole con righe vuote. Viene eseguita solo la query con il cursore.

Salvare una query

Salvataggio di una query

  1. Salvare il file di query corrente.
  2. Aprire un file di query salvato.
  3. Creare un nuovo file di query.

Visualizzare i dettagli

Espandere una riga dei risultati per visualizzarne l'elenco completo delle proprietà. È possibile espandere ulteriormente qualsiasi proprietà che sia un valore strutturato, ad esempio le dimensioni personalizzate o l'elenco in pila di un'eccezione.

Espandere una riga

Disporre i risultati

È possibile ordinare, filtrare, impaginare e raggruppare i risultati restituiti dalla query.

Nota

Le operazioni di ordinamento, raggruppamento e filtro nel browser non eseguono nuovamente la query, ma riorganizzano i risultati restituiti dall'ultima query.

Per eseguire queste attività nel server prima che vengano restituiti i risultati, scrivere la query usando gli operatori sort, summarize e where.

Selezionare le colonne da visualizzare, trascinare le intestazioni di colonna per ridisporle e ridimensionare le colonne trascinandone i bordi.

Disporre le colonne

Ordinare e filtrare elementi

Ordinare i risultati facendo clic sull'intestazione di una colonna. Fare clic di nuovo per applicare l'ordinamento opposto. Fare clic una terza volta per ripristinare l'ordine originale restituito dalla query.

Usare l'icona del filtro per perfezionare la ricerca.

Ordinare e filtrare le colonne

Raggruppare elementi

Per ordinare più di una colonna, usare il raggruppamento. Abilitare il raggruppamento e quindi trascinare le intestazioni di colonna nello spazio sopra la tabella.

Gruppo

Mancano alcuni risultati?

Se si ritiene che non siano visualizzati tutti i risultati previsti, esistono un paio di possibili motivi.

  • Filtro intervallo di tempo. Per impostazione predefinita, vengono visualizzati solo i risultati delle ultime 24 ore. È presente un filtro automatico che limita l'intervallo dei risultati recuperati dalle tabelle di origine.

    È possibile tuttavia modificare il filtro intervallo di tempo usando il menu a discesa.

    In alternativa, è possibile ignorare l'intervallo automatico inserendo la propria clausola where ... timestamp ... nella query. Ad esempio:

    requests | where timestamp > ago('2d')

  • Limite dei risultati. È previsto un limite di 10.000 righe di risultati restituiti dal portale. Se il numero di risultati supera il limite, verrà visualizzato un avviso. In tal caso, l'ordinamento dei risultati nella tabella non permette sempre di visualizzare i primo o gli ultimi risultati effettivi.

    È consigliabile evitare di raggiungere il limite. Usare il filtro intervallo di tempo oppure usare gli operatori, ad esempio:

Per visualizzare più di 10.000 righe, è consigliabile usare Esportazione continua. Analytics è progettato per l'analisi e non per il recupero di dati non elaborati.

Diagrammi

Selezionare il tipo di diagramma desiderato:

Selezionare un tipo di diagramma

Se sono presenti più colonne dei tipi corretti, è possibile scegliere gli assi X e Y e una colonna di dimensioni in base alla quale dividere i risultati.

Per impostazione predefinita, i risultati vengono inizialmente visualizzati in una tabella e si seleziona il diagramma manualmente. Per selezionare il diagramma, è possibile usare la direttiva render alla fine di una query.

Diagnostica di Analytics

In un grafico del tempo, se si verifica un picco o una variazione improvvisa dei dati, sulla linea viene evidenziato un punto. Ciò indica che Diagnostica di Analytics ha identificato una combinazione di proprietà che filtrano le variazioni improvvise. Fare clic sul punto per ottenere maggiori dettagli sul filtro e per visualizzare la versione filtrata. Questa opzione consente di identificare la causa della variazione.

Altre informazioni sulla Diagnostica di Analytics

Diagnostica di Analytics

Aggiungi al dashboard

Per aggiungere un diagramma o una tabella a uno dei dashboard condivisi , è sufficiente fare clic sulla puntina.

Fare clic sulla puntina

Ciò significa che, quando si crea un dashboard per monitorare le prestazioni o l'utilizzo dei servizi Web, è possibile includere analisi piuttosto complesse insieme ad altre metriche.

È possibile aggiungere una tabella al dashboard se contiene un massimo di quattro colonne. Verranno visualizzate solo le prime sette righe.

Aggiornamento del dashboard

Il grafico aggiunto al dashboard viene aggiornato automaticamente rieseguendo la query ogni due ore circa. È possibile anche fare clic sul pulsante Aggiorna.

Semplificazioni automatiche

Quando si aggiunge a un grafico al dashboard, vengono applicate al grafico determinate semplificazioni.

Restrizione di orario: le query vengono automaticamente limitate agli ultimi 14 giorni. Si tratta dello stesso effetto che si ottiene quando la query include where timestamp > ago(14d).

Restrizione al numero di bin: se si visualizza un grafico con numerosi bin discreti, in genere un grafico a barre, i bin meno popolati vengono automaticamente raggruppati in un unico bin "altri". Ad esempio, questa query:

requests | summarize count_search = count() by client_CountryOrRegion

ha questo aspetto in Analisi:

Grafico con una lunga coda

ma quando la si aggiunge un dashboard, è simile alla figura seguente:

Grafico con bin limitati

Eseguire l'esportazione in Excel

Dopo aver eseguito una query, è possibile scaricare un file con estensione csv. Fare clic su Esporta in Excel.

Esportare in Power BI

Posizionare il cursore in una query e scegliere Esporta in Power BI.

Esportazione da Analisi a Power BI

Si esegue la query in Power BI. È possibile impostarla in modo che venga aggiornata secondo una pianificazione.

Con Power BI, è possibile creare i dashboard per raggruppare i dati da un'ampia gamma di origini.

Altre informazioni sull'esportazione in Power BI

Ottenere un collegamento in Esporta, Condividi collegamento che è possibile inviare a un altro utente. Purché l'utente abbia accesso al gruppo di risorse, la query verrà aperta nell'interfaccia utente di Analytics.

Nel collegamento, il testo della query appare dopo "?q=", con compressione gzip e codifica in base 64. È possibile scrivere codice per generare collegamenti diretti da fornire agli utenti. Tuttavia il modo consigliato per eseguire Analytics dal codice è tramite l'uso dell'API REST.

Automazione

Usare l'API REST di accesso ai dati per eseguire le query di Analytics. Ad esempio (con PowerShell):

curl "https://api.applicationinsights.io/beta/apps/DEMO_APP/query?query=requests%7C%20where%20timestamp%20%3E%3D%20ago(24h)%7C%20count" -H "x-api-key: DEMO_KEY"

A differenza dell'interfaccia utente di Analytics, l'API REST non aggiunge automaticamente limitazioni di timestamp alle query. Ricordarsi di aggiungere la propria clausola where per evitare di ricevere le risposte di grandi dimensioni.

Importa dati

È possibile importare i dati da un file CSV. Un utilizzo tipico consiste nell'importare i dati statici che è possibile unire alle tabelle dei dati di telemetria.

Ad esempio, se nei dati di telemetria vengono identificati utenti autenticati tramite un alias o un ID offuscato, è possibile importare una tabella che esegue il mapping degli alias sui nomi reali. Eseguendo un join nei dati di telemetria della richiesta, è possibile identificare gli utenti in base ai nomi reali nei report di Analytics.

Definire lo schema dei dati

  1. Fare clic su Impostazioni (in alto a sinistra) e quindi su Origini dati.
  2. Aggiungere un'origine dati, seguendo le istruzioni. Viene chiesto di fornire un esempio dei dati che deve includere almeno dieci righe. È quindi possibile correggere lo schema.

Lo schema definisce un'origine dati che sarà possibile usare per importare le singole tabelle.

Importare una tabella

  1. Aprire la definizione dell'origine dati dall'elenco.
  2. Fare clic su "Carica" e seguire le istruzioni per caricare la tabella. Poiché l'operazione prevede una chiamata a un'API REST risulterà facile da automatizzare.

La tabella è ora disponibile per l'utilizzo nelle query di Analytics. Verrà visualizzata in Analytics

Usare la tabella

Si supponga che la definizione dell'origine dati sia denominata usermap e che abbia due campi, realName e user_AuthenticatedId. Poiché la tabella requests contiene anche un campo denominato user_AuthenticatedId, creare un join risulterà facile:


    requests
    | where notempty(user_AuthenticatedId) | take 10
    | join kind=leftouter ( usermap ) on user_AuthenticatedId 

La tabella di richieste risultante ha una colonna aggiuntiva, realName.

Importare da LogStash

Se si usa LogStash, è possibile usare Analytics per eseguire query nei log. Usare il plug-in che invia pipe dei dati in Analytics.

Video

Analytics