Visualizzare i dati con i dashboard di Esplora dati di Azure

Articolo
03/04/2024

Esplora dati di Azure è un servizio di esplorazione dati rapido e a scalabilità elevata per dati di log e di telemetria. Esplorare i dati dall'applicazione Web end-to-end all'applicazione Web di Azure Esplora dati, a partire dall'inserimento dei dati, dall'esecuzione di query e infine dalla creazione di dashboard.

Un dashboard è una raccolta di riquadri, facoltativamente organizzati in pagine, in cui ogni riquadro ha una query sottostante e una rappresentazione visiva. Usando l'interfaccia utente Web, è possibile esportare in modo nativo le query Linguaggio di query Kusto (KQL) in un dashboard come oggetti visivi e successivamente modificare le query sottostanti e la formattazione visiva in base alle esigenze. Oltre a semplificare l'esplorazione dei dati, questa esperienza di dashboard di Azure Esplora dati completamente integrata offre prestazioni di query e visualizzazione migliorate.

Importante

I dati sono protetti. I dashboard e i metadati correlati al dashboard relativi agli utenti vengono crittografati inattivi usando chiavi gestite da Microsoft.

L'immagine seguente mostra un dashboard di esempio di Azure Esplora dati:

Per esplorare in modo interattivo i dashboard di esempio, vedere Avvio rapido: Visualizzare dashboard di dati di esempio.

Prerequisiti

Un account Microsoft o un'identità utente di Microsoft Entra. Non è necessaria una sottoscrizione di Azure.
Creare un database e un cluster di Esplora dati di Azure.
Accedere all'interfaccia utente Web di Azure Esplora dati e aggiungere una connessione al cluster.

Creare un nuovo dashboard

Nella barra di spostamento selezionare Dashboard>Nuovo dashboard.
Immettere un nome del dashboard e selezionare Crea.

Aggiungere l'origine dati

Un singolo dashboard può visualizzare gli oggetti visivi di uno o più cluster.

Selezionare il menu Altro [...] >Origini dati
Nel riquadro Origini dati selezionare + Nuova origine dati.
Nel riquadro Crea nuova origine dati:
1. Immettere un nome origine dati.
2. Immettere l'area URI cluster e quindi selezionare Connetti.
3. Selezionare il database nell'elenco a discesa.
4. Immettere un valore per Durata massima cache risultati query per abilitare la cache dei risultati delle query in tutte le query di questa origine dati. La validità massima può essere in unità di secondi, ore o giorni.
5. Selezionare Crea.

Aggiungi riquadro

I riquadri del dashboard usano Linguaggio di query Kusto frammenti di codice per recuperare i dati ed eseguire il rendering degli oggetti visivi. Ogni riquadro/query può supportare un singolo oggetto visivo.

Selezionare Aggiungi riquadro nell'area di disegno del dashboard o nella barra dei menu superiore.
Nel riquadro Query:
1. Selezionare l'origine dati dal menu a discesa.
2. Digitare la query e selezionare Esegui. Per altre informazioni sulla generazione di query che usano parametri, vedere Usare i parametri nella query.
3. Selezionare Oggetto visivo.
Nella scheda oggetto visivo selezionare Tipo di oggetto visivo per scegliere il tipo di oggetto visivo.
Selezionare Applica modifiche per aggiungere l'oggetto visivo al dashboard.
È possibile ridimensionare l'oggetto visivo e quindi selezionare l'icona Salva .

Aggiungi riquadro dalla query

È anche possibile aggiungere una query dalla scheda query dell'interfaccia utente Web.

Per aggiungere una query:

Creare ed eseguire la query di cui si vuole visualizzare l'output nel dashboard.
Selezionare Condividi>aggiungi al dashboard.
Nel riquadro Aggiungi al dashboard:
1. Specificare un nome riquadro.
2. Il nome dell'origine dati viene popolato automaticamente dall'origine dati della query.
3. Selezionare Usa origine dati esistente, se possibile.
4. Selezionare Crea nuovo.
5. Immettere Il nome del dashboard.
6. Selezionare la casella di controllo Visualizza il dashboard dopo la creazione (se si tratta di un nuovo dashboard).
7. Selezionare Aggiungi.

Usare i parametri

I parametri migliorano significativamente le prestazioni di rendering del dashboard e consentono di usare i valori di filtro il prima possibile nella query. Il filtro è abilitato quando il parametro è incluso nella query associata ai riquadri. Per altre informazioni su come configurare e usare diversi tipi di parametri, vedere Usare i parametri nei dashboard di Azure Esplora dati.

Visualizzare la query

È possibile visualizzare la query in modalità di modifica o visualizzazione. La modifica della query sottostante di un riquadro è possibile solo in modalità di modifica. In modalità di visualizzazione è possibile modificare la query in una nuova scheda query, senza modificare la query sottostante del riquadro del dashboard.

Passare al dashboard.
Nel riquadro da esplorare selezionare il menu Altro [...]>Visualizzare la query.

Viene aperto un riquadro con la tabella query e risultati.
Selezionare La scheda Nuova query. Continuare a modificare la query nel riquadro query dell'interfaccia utente Web di Azure Esplora dati.

Screenshot del riquadro query di visualizzazione con la query nella parte superiore della schermata e risultati nella metà inferiore.

Nota

Le modifiche apportate alla query con questo flusso non verranno riflesse nel dashboard originale.

Usare il menu condividi per concedere le autorizzazioni per un utente Microsoft Entra o Microsoft Entra gruppo per accedere al dashboard, modificare il livello di autorizzazione di un utente e condividere il collegamento al dashboard.

Importante

Per accedere al dashboard, è necessario avere gli elementi seguenti:

Collegamento al dashboard per l'accesso
Autorizzazioni per il dashboard
Accesso al database sottostante nel cluster di Esplora dati di Azure

Gestione autorizzazioni

Selezionare la voce di menu Condividi sulla barra superiore del dashboard.
Selezionare Gestisci autorizzazioni nell'elenco a discesa.

Concedere le autorizzazioni

Per concedere le autorizzazioni a un utente nel riquadro Dashboard permissions (Autorizzazioni per il dashboard):

Immettere il gruppo Microsoft Entra utente o Microsoft Entra in Aggiungi nuovi membri.
In Livello di autorizzazione selezionare uno dei valori seguenti: Può visualizzare o Può modificare.
Selezionare Aggiungi.

Gestire le autorizzazioni del dashboard.

Cambiare il livello di autorizzazioni di un utente

Per cambiare il livello di autorizzazioni di un utente nel riquadro Dashboard permissions (Autorizzazioni per il dashboard):

Usare la casella di ricerca o scorrere l'elenco utenti per trovare l'utente.
Cambiare il livello di Autorizzazione secondo necessità.

Per condividere il collegamento al dashboard, eseguire una delle operazioni seguenti:

Selezionare Condividi e quindi copia collegamento
Nella finestra Dashboard permissions (Autorizzazioni per il dashboard) selezionare Copia collegamento.

Esportare dashboard

Usare il menu file per esportare un dashboard in un file JSON. L'esportazione del dashboard può essere utile negli scenari seguenti:

Controllo della versione: è possibile usare il file per ripristinare il dashboard in una versione precedente.
Modello di dashboard: è possibile usare il file come modello per la creazione di nuovi dashboard.
Modifica manuale: è possibile modificare il file per modificare il dashboard. Il file può essere importato di nuovo nel dashboard.

Per esportare un dashboard, nel dashboard selezionare Esportazione file>nel file.

Screenshot del dashboard, che mostra l'opzione Esporta in file.

Il file contiene i dati del dashboard in formato JSON, una struttura di cui è illustrato nel frammento di codice seguente.

{
  "id": "{GUID}",
  "eTag": "{TAG}",
  "title": "Dashboard title",
  "tiles": [
    {
      "id": "{GUID}",
      "title": "Tile title",
      "query": "{QUERY}",
      "layout": { "x": 0, "y": 7, "width": 6, "height": 5 },
      "pageId": "{GUID}",
      "visualType": "line",
      "dataSourceId": "{GUID}",
      "visualOptions": {
        "xColumn": { "type": "infer" },
        "yColumns": { "type": "infer" },
        "yAxisMinimumValue": { "type": "infer" },
        "yAxisMaximumValue": { "type": "infer" },
        "seriesColumns": { "type": "infer" },
        "hideLegend": false,
        "xColumnTitle": "",
        "yColumnTitle": "",
        "horizontalLine": "",
        "verticalLine": "",
        "xAxisScale": "linear",
        "yAxisScale": "linear",
        "crossFilterDisabled": false,
        "crossFilter": { "dimensionId": "dragX-timeRange", "parameterId": "{GUID}" },
        "multipleYAxes": {
          "base": { "id": "-1", "columns": [], "label": "", "yAxisMinimumValue": null, "yAxisMaximumValue": null, "yAxisScale": "linear", "horizontalLines": [] },
          "additional": []
        },
        "hideTileTitle": false
      },
      "usedParamVariables": [ "{PARAM}" ]
    }
  ],
  "dataSources": [ {} ],
  "$schema": "https://dataexplorer.azure.com/static/d/schema/20/dashboard.json",
  "autoRefresh": { "enabled": true, "defaultInterval": "15m", "minInterval": "5m" },
  "parameters": [ {} ],
  "pages": [ { "name": "Primary", "id": "{GUID}" } ],
  "schema_version": "20"
}

Per creare un nuovo dashboard da un file

È possibile usare un file di dashboard per creare un nuovo dashboard, come indicato di seguito:

Nella pagina principale del dashboard selezionare Nuovo dashboard>Importa da file.
Selezionare il file da importare.
Immettere un nome del dashboard e quindi selezionare Crea.

Per aggiornare o ripristinare un dashboard esistente da un file

È possibile aggiornare un dashboard esistente o ripristinare una versione precedente, come indicato di seguito:

Nel dashboard selezionareSostituisci file> con file.
Selezionare il file per aggiornare il dashboard.
Selezionare Save changes (Salva modifiche).

Aggiungi pagina

Le pagine sono contenitori facoltativi per i riquadri. È possibile usare le pagine per organizzare i riquadri in gruppi logici, ad esempio per origine dati o per area di interesse. È anche possibile usare le pagine per creare un dashboard con più visualizzazioni, ad esempio un dashboard con un drill-through da una pagina di riepilogo a una pagina dei dettagli.

Nel riquadro Pagine a sinistra selezionare + Aggiungi pagina.
Per denominare la pagina, selezionare il menu Verticale Altro [...]>Rinominare la pagina.
Aggiungere riquadri alla pagina.

Abilitare l'aggiornamento automatico

L'aggiornamento automatico è una funzionalità che consente di aggiornare automaticamente i dati in un dashboard senza ricaricare manualmente la pagina o fare clic su un pulsante di aggiornamento.

La frequenza di aggiornamento automatico predefinita può essere impostata da un editor di database. Sia gli editor che i visualizzatori possono modificare la frequenza effettiva di aggiornamento automatico durante la visualizzazione di un dashboard.

Screenshot dei diversi intervalli di tempo disponibili nell'aggiornamento automatico nei dashboard.

Tuttavia, gli editor di database potrebbero voler limitare la frequenza di aggiornamento minima che qualsiasi visualizzatore può impostare in modo da ridurre il carico del cluster. Quando viene impostata la frequenza di aggiornamento minima, gli utenti del database non possono impostare una frequenza di aggiornamento inferiore al valore minimo.

Selezionare il menu Altro [...]>Aggiornamento automatico.
Spostare l'interruttore in modo da impostare Abilitato per Aggiornamento automatico.
Selezionare i valori di Minimum time interval (Intervallo di tempo minimo) e Default refresh rate (Frequenza di aggiornamento predefinita).
Selezionare Applica e quindi Salvare il dashboard.