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 nativamente le query KQL (Linguaggio di Query Kusto) in un dashboard come elementi visivi e successivamente modificare le query di base e la formattazione visiva in base alle necessità. Questa esperienza di dashboard completamente integrata offre prestazioni di query e visualizzazione migliorate, oltre a permettere un'esplorazione dei dati più semplice. L'integrazione di Copilot nell'esperienza di modifica del dashboard consente di usare il linguaggio naturale per creare e modificare le viste direttamente, senza richiedere competenze KQL.

Questo articolo illustra come creare un nuovo dashboard Real-Time, aggiungere origini dati, aggiungere e modificare riquadri nel dashboard, manualmente o usando Copilot. Si apprenderà anche come abilitare l'aggiornamento live, usare i parametri ed esportare i dashboard.

Importante

I dati sono protetti. I dashboard e i relativi metadati degli utenti vengono crittografati a riposo usando chiavi gestite da Microsoft.

Prerequisiti

Crea un nuovo dashboard

Esistono diversi modi per creare un nuovo dashboard Real-Time, selezionare la scheda corrispondente al metodo di creazione desiderato.

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 quando lo crei.

  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.

    Screenshot della Pagina del nuovo elemento con Real-Time Dashboard selezionato.

  4. Nella finestra popup Nuovo Real-Time Dashboard immettere un nome e un percorso dell'area di lavoro per il dashboard e selezionare Crea.

    Screenshot della pagina della Nuova Dashboard Real-Time con un nome per la dashboard.

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

    Screenshot del dashboard in tempo reale appena creato in Intelligenza in Tempo Reale in Microsoft Fabric.

  1. Completare la configurazione del dashboard aggiungendo un'origine dati al dashboard. Dopo aver connesso il dashboard a un'origine dati, è possibile accedere a tutte le opzioni del dashboard, ad esempio l'aggiunta di nuovi riquadri.

    Screenshot di Real-Time Dashboard con tutte le opzioni abilitate.

Aggiungi origine dati

Le fonti dati sono riferimenti riutilizzabili a un database specifico nella stessa area di lavoro del dashboard Real-Time. I riquadri diversi possono essere basati su origini dati diverse.

Selezionare la scheda corrispondente al tipo di origine dati desiderato.

  1. Aprire il dashboard Real-Time.

  2. Nella barra degli strumenti superiore selezionare Aggiungi origine> datiKQL Database.

    Screenshot del menu origine dati che mostra un elenco di origini dati facoltative con il database eventhouse/kql evidenziato.

  3. Nella finestra Catalogo OneLake selezionare un database KQL per connettersi al set di query KQL e quindi selezionare Connetti.

    In alternativa, chiudere la finestra OneLake Catalog e usare il menu + Aggiungi origine dati per connettersi a un'origine dati diversa.

Modalità di modifica

Per passare alla modalità di modifica, selezionare Modifica nell'angolo superiore destro.

Screenshot che mostra la selezione della visualizzazione di modifica.

Nella scheda Home è possibile aggiungere nuovi oggetti visivi, caselle markdown, avvisi, origini dati e parametri. È anche possibile salvare e aggiornare manualmente il dashboard.

Screenshot delle opzioni della barra degli strumenti nella scheda Home.

Nella scheda Gestisci è possibile gestire i parametri, le query di base, configurare l'impostazione Aggiorna e gestire le origini dati.

Screenshot delle opzioni della barra degli strumenti nella scheda Gestisci.

Aggiungere o modificare il riquadro

I riquadri della dashboard usano query KQL (Kusto Query Language) per recuperare i dati e generare visualizzazioni. Ogni riquadro o query è progettato per supportare una singola rappresentazione visiva. L'editor delle tessere consente di creare e modificare la query e la visualizzazione di una tessera in due modi:

  • Copilot (anteprima): usare il linguaggio naturale per generare la query KQL del riquadro e il visuale del riquadro. Copilot consente agli esperti che non utilizzano KQL, agli analisti aziendali e agli autori di report che comprendono i propri dati, ma non sono fluenti, di creare visualizzazioni per dashboard in modo indipendente.

  • Query KQL - creare manualmente la query e definire il riassunto grafico.

È possibile passare tra le due opzioni in qualsiasi momento.

Schermata dei tre riquadri nella finestra di modifica dei tile: Explorer, Esegui query e Copilot.

Descrivi l'intuizione che stai cercando. Iniziare con una domanda generale e perfezionare in base ai risultati. È possibile iniziare con "Mostra tutti gli eventi di errore" e seguire "Filtra solo errori critici" o "Raggruppa per tipo di errore". Copilot mantiene il contesto all'interno della conversazione, quindi ogni follow-up si basa sulle richieste precedenti. Per altre informazioni, vedere Use Copilot per la scrittura di query KQL.

  1. Nel dashboard passare alla modalità di modifica.

  2. Selezionare il tipo di oggetto visivo che si vuole creare dall'area di disegno del dashboard o Nuovo oggetto visivo dalla barra dei menu in alto.

    Screenshot che mostra la selezione del pulsante

  3. Per modificare un riquadro esistente, selezionare l'icona a forma di matita o aprire le opzioni del riquadro e selezionare Modifica.

  4. Nel riquadro Copilot immettere una descrizione del riquadro in linguaggio naturale. Ad esempio, "Confronta i volumi nelle corsie dei controlli di sicurezza."

    Screenshot del riquadro Copilot con i risultati visualizzati in una tabella.

  5. Visualizzare il risultato. Migliora il risultato chiedendo a Copilot una richiesta di follow-up. In questo esempio, chiedi a Copilot di "Creare un grafico cronologico che confronta le prime cinque corsie di controllo di sicurezza."

    Screenshot del riquadro Copilot con i risultati perfezionati visualizzati in una tabella.

  6. Nella scheda Formattazione visiva è possibile configurare le opzioni rimanenti.

    Screenshot del riquadro di formattazione visiva in Real-Time Dashboard.

    Per altre informazioni su come personalizzare l'oggetto visivo, vedere Personalizzare gli oggetti visivi del dashboard in tempo reale.

  7. Selezionare Applica. È ora possibile visualizzare e modificare la query KQL sottostante o continuare con Copilot. La query viene generata in base alla tua descrizione in linguaggio naturale e a qualsiasi perfezionamento successivo che hai apportato in Copilot.

  8. Per aggiungere il riquadro al dashboard, selezionare Fine.

  9. Nella barra degli strumenti del dashboard selezionare l'icona Salva per salvare il dashboard con l'oggetto visivo nuovo o modificato.

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 Salva nel dashboard.

    Screenshot del pulsante per salvare la query nel dashboard esistente in una query di tipo queryset.

  4. Selezionare il dashboard esistente dall'elenco dei dashboard e quindi selezionare Connetti per creare il riquadro.

  5. Selezionare Apri dashboard nel messaggio popup per visualizzare il nuovo riquadro nel dashboard esistente.

  6. Per assegnare un nome al riquadro, aprire le opzioni del riquadro e selezionare Rinomina.

    Screenshot dell'opzione Rinomina riquadro nel menu riquadro.

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.

    Screenshot dell'aggiunta di una pagina a un dashboard in tempo reale in Intelligenza in tempo reale in Microsoft Fabric.

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

    Screenshot della ridenominazione di una pagina in Real-Time Dashboard.

Utilizzare i parametri

I parametri migliorano significativamente le prestazioni della visualizzazione del dashboard e consentono di utilizzare i valori dei filtri il più presto 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.

Interagisci con i tuoi 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 grigiati.

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.

Screenshot che mostra i pulsanti per usare la legenda per interagire con i dati.

Visualizzare o modificare la query

È possibile visualizzare la query in modalità di visualizzazione o modifica.

  1. Nel riquadro da esplorare selezionare le opzioni Riquadro [...]>Visualizzare la query. Viene aperto un riquadro contenente la query e la tabella dei risultati.

    Screenshot del menu Visualizza query per un riquadro nella dashboard.

  2. Selezionare Modifica in Queryset.

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

    Screenshot dell'editor di query KQL.

    Nota

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

Abilitare l'aggiornamento in tempo reale

L'aggiornamento in tempo reale è una funzionalità che aggiorna gli oggetti visivi del dashboard quando i nuovi dati vengono inseriti nell'origine sottostante, senza ricaricare manualmente la pagina o facendo clic su un pulsante di aggiornamento.

Per abilitare l'aggiornamento in tempo reale per il dashboard:

  1. Selezionare la scheda >Impostazioni di aggiornamento.

  2. Selezionare Aggiornamento attivo per abilitarlo.

  3. Selezionare i valori per Limite di frequenza di aggiornamento e Frequenza fissa per gli oggetti visivi non supportati.

  4. Selezionare Fine e quindi Salva il dashboard.

    Screenshot del riquadro delle impostazioni di aggiornamento attivo.

Per altre informazioni sull'aggiornamento in tempo reale, vedere Aggiornamento in tempo reale nei dashboard di Real-Time.

Condividere il dashboard

Le dashboard in tempo reale possono essere condivise con altri utenti per consentire l'accesso ad analisi e visualizzazioni senza richiedere un'interazione diretta con le origini dati sottostanti. La condivisione consente la collaborazione tra i team consentendo agli utenti di visualizzare e interagire con il contenuto del dashboard tramite un collegamento, semplificando la distribuzione delle visualizzazioni di monitoraggio e dei risultati analitici. Per condividere correttamente i Real-Time Dashboard, assicurarsi che i destinatari dispongano delle necessarie autorizzazioni per Real-Time Dashboard.

È possibile condividere un intero dashboard Real-Time o un oggetto visivo specifico.

Per condividere l'intero dashboard:

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

    Screenshot che mostra il pulsante Condividi nel 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.

    Screenshot che mostra la finestra popup per la condivisione del dashboard.

Per condividere un oggetto visivo specifico:

  1. Nell'angolo in alto a destra di un oggetto visivo selezionare ... per aprire il menu di scelta rapida dell'oggetto visivo.

  2. Selezionare Condividi oggetto visivo.

    Screenshot che mostra l'opzione Condividi oggetto visivo nel menu di scelta rapida dell'oggetto visivo.

  3. Usando le caselle di controllo a selezione multipla, scegliere se il collegamento condivisibile deve includere il collegamento per aprire l'oggetto visivo in Fabric, la visualizzazione stessa e la query che supporta l'oggetto visivo.

  4. Selezionare Copia per copiare il collegamento negli Appunti.

Usare i dashboard nelle applicazioni personalizzate

Oltre a condividere dashboard tramite collegamenti o strumenti di collaborazione, è possibile incorporare un dashboard Real-Time nella propria applicazione Web usando Fabric Embedded. Questo approccio consente di integrare informazioni dettagliate in tempo reale direttamente nell'applicazione, nel portale o nel flusso di lavoro.

Per altre informazioni, vedere Fabric Embedded e la guida introduttiva all'incorporamento.

Esportare il 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 >|-> Scarica file. Screenshot che mostra il pulsante Scarica file nel pulsante Gestisci scheda.

Il file contiene i dati della dashboard in formato JSON, di cui una struttura è riportata nel frammento 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.

    Screenshot che mostra il pulsante Sostituisci con file nel pulsante Gestisci scheda.

  2. Selezionare il file per aggiornare il dashboard.

  3. Nella scheda Home selezionare Salva.