Creare un dashboard Real-Time

Un dashboard è una raccolta di riquadri, organizzati facoltativamente in pagine, in cui ogni riquadro ha una query sottostante e una rappresentazione visiva. È 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. Questa esperienza di dashboard completamente integrata offre prestazioni di query e visualizzazione migliorate, oltre a permettere un'esplorazione dei dati più semplice.

Questo articolo illustra come creare un nuovo dashboard in tempo reale, aggiungere origini dati e aggiungere riquadri al dashboard. Si apprenderà anche come abilitare l'aggiornamento automatico, usare i parametri ed esportare i dashboard.

Importante

I dati sono protetti. I dashboard e i relativi metadati sugli utenti vengono crittografati quando sono inattivi tramite le chiavi gestite da Microsoft.

Prerequisiti

• Un'area di lavoro con una capacità abilitata per Microsoft Fabric
• Un database KQL con dati

Abilitare le impostazioni tenant nel portale di amministrazione

Importante

Questo passaggio deve essere completato dall'amministratore tenant.

1. Accedere al portale amministratore.

2. Nella scheda Impostazioni tenant cercare Dashboard in tempo reale. Per altre informazioni, vedere Informazioni sulle impostazioni del tenant.

3. Impostare il pulsante Crea dashboard in tempo reale su Abilitato. Per altre informazioni, consultare Impostazioni tenant - Microsoft Fabric.

4. Selezionare Applica.

   

Crea un nuovo dashboard

Il Dashboard in tempo reale è presente nel contesto di un'area di lavoro. Un nuovo dashboard in tempo reale è sempre associato all'area di lavoro in uso durante la creazione.

1. Passare all'area di lavoro desiderata.

2. Selezionare + Nuovo elemento.

3. Nella finestra Nuovo elemento selezionare Real-Time Dashboard. Cercare usando la casella di testo, se necessario.

   

4. Nella finestra popup Nuovo Real-Time Dashboard immettere un nome per il dashboard e selezionare Crea.

   

5. Nell'area di lavoro viene creato un nuovo dashboard.

   

Nota

È anche possibile usare Copilot per scrivere query. Per altre informazioni, vedere Usare Copilot in KQL Queryset.

Modalità di modifica

Se non è possibile modificare un dashboard, assicurarsi di essere in modalità di modifica.

Aggiungere un'origine dati

Le origini dati sono riferimenti riutilizzabili a un database specifico nella stessa area di lavoro del dashboard In tempo reale. I riquadri diversi possono essere basati su origini dati diverse.

1. Selezionare Nuova origine dati sulla barra multifunzione nella parte superiore e quindi Selezionare Esplora dati di Azure.

   

2. Nella finestra Connetti cluster di Esplora dati di Azure, seguire questa procedura:

   1. Immettere l'URI di connessione per il cluster di Esplora dati di Azure.

   2. Selezionare un database nel cluster.

   3. Seleziona Crea.

      

3. Nella pagina Crea nuova origine dati immettere un nome visualizzato per l'origine dati e selezionare Aggiungi.

   

Aggiungere riquadro

I riquadri del Dashboard utilizzando il linguaggio di query Kusto per ottenere i dati ed eseguirne il rendering. Ogni riquadro/query supporta un singolo oggetto visivo.

1. Selezionare Aggiungi riquadro nell'area di lavoro del dashboard o sulla barra dei menu superiore.

   

2. Nel riquadro Query:

   1. Selezionare l'origine dati dal menu a discesa.
   2. Digitare la query, quindi selezionare Esegui. Per altre informazioni sulla generazione di query che usano parametri, vedere Usare i parametri nella query.
   3. Selezionare + Aggiungi oggetto visivo sulla barra multifunzione per il riquadro Risultati nella parte inferiore.

   

3. Nel riquadro Formattazione oggetto visivo selezionare Tipo di grafico per scegliere il tipo di oggetto visivo. Per altre informazioni su come personalizzare l'oggetto visivo, vedere Personalizzare gli oggetti visivi del dashboard in tempo reale.

4. Selezionare Applica modifiche per aggiungere l'oggetto visivo al dashboard.

   

5. Seleziona l'icona Salva.

   

Aggiungere un riquadro da un set di query

È possibile aggiungere riquadri al dashboard direttamente dalle query scritte in un set di query KQL.

1. Aprire un set di query KQL esistente.

2. Scrivere una query.

3. Selezionare Aggiungi al dashboard.

   

4. Nella finestra Aggiungi query al dashboard eseguire le operazioni seguenti:

   1. Selezionare un dashboard esistente o crearne uno nuovo.

   2. Assegnare un nome al riquadro del dashboard.

   3. Facoltativamente, selezionare Apri dashboard dopo la creazione del riquadro per visualizzare il dashboard immediatamente dopo la creazione.

   4. Seleziona Crea.

      

Aggiungere una pagina

Le pagine sono contenitori facoltativi per i riquadri. È possibile usare le pagine per organizzare i riquadri in gruppi logici, ad esempio in base all'origine dati o all'area dell'oggetto. È 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.

1. Passare alla modalità di modifica selezionando Modifica nell'angolo superiore destro.

2. Nel riquadro Pagina selezionare + Aggiungi pagina.

   

3. Per denominare la pagina, selezionare il menu Altro [...]>Rinomina pagina.

   

4. Selezionare la nuova pagina nel riquadro Pagine e aggiungere riquadri alla pagina.

Utilizzare i parametri

Migliorano significativamente le prestazioni del dashboard e consentono di usare valori di filtro quanto prima possibile nella query. Il filtro è abilitato quando il parametro è incluso nella query associata ai riquadri. Per ulteriori informazioni sull'uso e sulla configurazione dei diversi tipi di parametri, vedere Usare i parametri nei dashboard in tempo reale.

Legenda dei riquadri

È possibile modificare la posizione della legenda nei riquadri e usare la legenda per interagire con i dati.

Modificare la posizione della legenda

Se si dispone dei diritti di modifica in un dashboard in tempo reale, è possibile modificare la posizione della legenda nel riquadro. Passare alla modalità modifica e selezionare l'icona a forma di matita Modifica . Nel riquadro Formattazione visiva, in Legenda, è possibile selezionare la preferenza per la posizione.

Interagire con i dati

È possibile usare la legenda per interagire con i dati nel riquadro. È possibile modificare i dati visualizzati selezionando l'elemento specifico nella legenda. Usare CTRL per aggiungere o rimuovere elementi dalla selezione, tenere premuto MAIUSC per selezionare un intervallo. Gli elementi non selezionati sono disattivati.

Il pulsante Cerca consente di cercare e filtrare gli elementi.

Usare il pulsante Inverti per invertire la selezione.

Le frecce Su e Giù permettono di spostarsi nell'elenco nei seguenti modi:

• Quando si seleziona un elemento, le frecce su e giù selezionano l'elemento precedente o successivo.
• Quando si selezionano più elementi, le frecce su e giù scorrono nell'elenco di elementi e i dati per gli elementi selezionati a cui si passa sono evidenziati.

Visualizzare una 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.

1. Nel riquadro da esplorare selezionare il menu Altro [...]>Visualizzare la query. Viene aperto un riquadro con la tabella query e risultati.

   

2. Selezionare Modifica query.

3. Scegliere Set di query KQL esistente o Nuovo set di query KQL. Continuare a modificare la query nel set di query KQL.

   

   Nota

   Le modifiche apportate alla query usando questo flusso non verranno riflesse nel dashboard in tempo reale originale.

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 Aggiorna.

Gli autori del dashboard possono configurare le impostazioni di aggiornamento automatico per altri visualizzatori. Per impostazione predefinita, la frequenza di aggiornamento viene impostata usando la frequenza di aggiornamento predefinita, ma i visualizzatori possono modificare questa frequenza per le proprie sessioni.

L'intervallo di tempo minimo definisce la velocità di aggiornamento più veloce consentita e funge da limite inferiore. Ad esempio, se l'autore imposta la frequenza di aggiornamento predefinita su 1 ora e l'intervallo di tempo minimo su 30 minuti, i visualizzatori possono scegliere una frequenza di aggiornamento compresa tra 30 minuti e 1 ora, ma non inferiore a 30 minuti.

Questa impostazione consente agli autori di controllare la frequenza con cui i dashboard possono essere aggiornati, consentendo di gestire il carico e le prestazioni del sistema.

1. Selezionare la scheda Gestisci >Aggiornamento automatico.

2. Spostare l'interruttore in modo da impostare Abilitato per Aggiornamento automatico.

3. Selezionare i valori di Minimum time interval (Intervallo di tempo minimo) e Default refresh rate (Frequenza di aggiornamento predefinita).

4. Selezionare Applica e quindi Salva per salvare il dashboard.

   

Condividere il dashboard

Per condividere il collegamento al dashboard:

1. Selezionare Condividi nell'angolo superiore destro del dashboard.

   

2. Nella finestra Crea e invia collegamento è possibile seguire questa procedura:

   • Per visualizzare un collegamento al dashboard e copiarlo negli Appunti, selezionare Copia collegamento.
   • Per condividere un collegamento al dashboard tramite posta elettronica, selezionare Posta elettronica.
   • Per condividere un collegamento al dashboard tramite Teams, selezionare teams.

Esportare i 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 la scheda >Gestisci|-> Scarica 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"
}

Aggiornare o ripristinare un dashboard esistente da un file

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

1. Nel dashboard selezionare la scheda Gestisci>Sostituisci con file.

   

2. Selezionare il file per aggiornare il dashboard.

3. Nella scheda Home selezionare Salva.

Contenuto correlato

• Usare i parametri nei dashboard in tempo reale
• Oggetti visivi specifici del dashboard in tempo reale
• Applicare la formattazione condizionale negli oggetti visivi del dashboard in tempo reale
• Creare avvisi di attivazione da un dashboard in tempo reale