Configurare un'origine dati Esplora dati di Azure

Azure Esplora dati è un servizio di esplorazione dei dati di log e telemetria. In questa guida si apprenderà come aggiungere un'origine dati di Azure Esplora dati a Grafana e si apprenderà come configurare Azure Esplora dati usando ogni opzione di autenticazione disponibile per questa origine dati.

Prerequisiti

• Un'istanza di Grafana gestita di Azure nel piano Standard.
• Un database Esplora dati di Azure

Aggiungere un'origine dati Esplora dati di Azure

Aggiungere un'origine dati di Azure Esplora dati a Grafana seguendo questa procedura.

1. Aprire un'istanza di Grafana gestita di Azure nel portale di Azure.
2. Nella sezione Panoramica aprire l'URL dell'endpoint.
3. Nel portale di Grafana passare a Connessioni Origini>dati>Aggiungi nuova origine dati, quindi cercare e selezionare Azure Esplora dati Origine dati.

Configurare un'origine dati Esplora dati di Azure

Immettere Le impostazioni di configurazione di Azure Esplora dati.

1. Nella scheda Impostazioni modificare facoltativamente il nome dell'origine dati.

   

2. In Dettagli connessione immettere l'URL del cluster di database di Azure Esplora dati.

3. Selezionare l'opzione di autenticazione preferita tra Identità gestita, Registrazione app (entità servizio) o Utente corrente (autenticazione basata sull'utente).

   Identità gestita

   Eseguire l'autenticazione con un'identità gestita senza usare credenziali esplicite.

   Aggiungere una nuova autorizzazione

   1. Nella portale di Azure aprire il cluster di Azure Esplora dati.
   2. Selezionare Database dati>dal menu a sinistra, quindi selezionare il database che contiene i dati.
   3. Selezionare Autorizzazioni > Aggiungi > visualizzatore.
   4. Nella casella di ricerca immettere il nome dell'area di lavoro Grafana gestita di Azure, selezionare l'area di lavoro e quindi scegliere Seleziona. Viene visualizzata una notifica di esito positivo.

   Configurare l'origine dati in Grafana

   1. Tornare a Grafana, in Metodo di autenticazione selezionare Identità gestita.
   2. Selezionare Salva e test. La notifica "Operazione riuscita" visualizzata indica che Grafana è in grado di recuperare i dati dal database.

   Registrazione app

   Eseguire l'autenticazione con la registrazione dell'app usando un'entità servizio Microsoft Entra.

   Configurazione iniziale

   1. Seguire la procedura per Registrare un'applicazione con Microsoft Entra ID e creare un'entità servizio.
   2. Assegnare il ruolo Lettore all'applicazione nel passaggio successivo della guida.
   3. Seguire i tre primi passaggi della guida Recuperare i dettagli dell'applicazione per raccogliere l'ID directory (tenant), l'ID applicazione (client) e l'ID segreto client necessari nel passaggio successivo.

   Configurare l'origine dati in Grafana

   1. In Grafana, in Metodo di autenticazione selezionare Registrazione app.

   2. Per Cloud di Azure selezionare il cloud di Azure. Ad esempio, Azure.

      

   3. Immettere un ID directory (tenant), un ID applicazione (client) e un segreto client

   4. Facoltativamente, modificare anche le sezioni Ottimizzazioni query, Impostazioni dello schema del database e Rilevamento .

   5. Selezionare Salva e test per convalidare la connessione. La notifica "Operazione riuscita" visualizzata indica che Grafana è in grado di connettersi al database.

   Utente corrente

   Usare il metodo di autenticazione basato sull'utente, sfruttando le credenziali dell'ID Microsoft Entra dell'utente Grafana corrente nell'origine dati configurata.

   Quando si configura un'origine dati di Azure Esplora dati con il metodo di autenticazione utente corrente, Grafana esegue query su Azure Esplora dati usando le credenziali dell'utente.

   Attenzione

   L'autenticazione basata sull'utente nelle origini dati di Grafana è sperimentale.

   Attenzione

   Questa funzionalità non è compatibile con i casi d'uso che richiedono l'accesso sempre attivo ai dati sottoposti a query, inclusi avvisi, creazione di report, memorizzazione nella cache delle query e dashboard pubblici. Il metodo di autenticazione Utente corrente si basa sull'accesso di un utente, in una sessione interattiva, affinché Grafana raggiunga il database. Quando viene usata l'autenticazione basata sull'utente e non viene eseguito alcun utente, le attività automatizzate non possono essere eseguite in background. Per sfruttare le attività automatizzate per Azure Esplora dati, è consigliabile configurare un'altra origine dati Esplora dati di Azure usando un altro metodo di autenticazione.

   Aggiungere una nuova autorizzazione

   Aggiungere una nuova autorizzazione per l'account utente per accedere al database.

   1. Nella portale di Azure aprire la risorsa Database Esplora dati di Azure e selezionare Autorizzazioni>Aggiungi>visualizzatore.

   2. Immettere il nome o l'indirizzo di posta elettronica nella barra di ricerca, selezionare l'account utente e scegliere Seleziona.

      

   3. Una notifica conferma che l'autorizzazione è stata aggiunta al database.

   Configurare l'origine dati in Grafana

   1. In Grafana, in Metodo di autenticazione, selezionare Utente corrente.
   2. Selezionare Salva e test. La notifica "Operazione riuscita" visualizzata indica che Grafana è in grado di recuperare i dati dal database.

Creare un'origine dati di Azure Esplora dati

Nell'interfaccia della riga di comando di Azure aggiungere e configurare un'origine dati di Azure Esplora dati eseguendo il comando az grafana data-source create. Scegliere il metodo di autenticazione preferito e fare riferimento alla scheda corrispondente di seguito per informazioni dettagliate.

Quando si eseguono questi comandi, sostituire tutti i segnaposto con le proprie informazioni.

Identità gestita

Eseguire l'autenticazione con un'identità gestita senza usare credenziali esplicite.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "msi"
    }
  }
}'

Registrazione app

Eseguire l'autenticazione con la registrazione dell'app usando un'entità servizio Microsoft Entra.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "azureCredentials": {
      "authType": "clientsecret",
      "azureCloud": "AzureCloud",
      "tenantId": "<tenant-id>",
      "clientId": "<client-id>"
    }
  },
  "secureJsonData": { "azureClientSecret": "verySecret" }
}'

Utente corrente

Eseguire l'autenticazione con il metodo utente corrente. Questo metodo sfrutta le credenziali dell'ID Microsoft Entra dell'utente corrente nell'origine dati configurata.

Quando si configura un'origine dati di Azure Esplora dati con il metodo di autenticazione utente corrente, Grafana esegue query su Azure Esplora dati usando le credenziali dell'utente.

Nota

L'implementazione dell'autenticazione basata sull'utente in Azure Managed Grafana è in corso e verrà completata in tutte le aree entro la fine del 2023.

Attenzione

L'autenticazione basata sull'utente nelle origini dati di Grafana è sperimentale.

Attenzione

Questa funzionalità non è compatibile con i casi d'uso che richiedono l'accesso sempre attivo ai dati sottoposti a query, inclusi avvisi, creazione di report, memorizzazione nella cache delle query e dashboard pubblici. Il metodo di autenticazione Utente corrente si basa sull'accesso di un utente, in una sessione interattiva, affinché Grafana raggiunga il database. Quando viene usata l'autenticazione basata sull'utente e non viene eseguito alcun utente, le attività automatizzate non possono essere eseguite in background. Per sfruttare le attività automatizzate per Azure Esplora dati, è consigliabile configurare un'altra origine dati Esplora dati di Azure usando un altro metodo di autenticazione.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "currentuser"
    }
  }
}'

Aggiornare un'origine dati di Azure Esplora dati

Per aggiornare un'origine dati di Azure Esplora dati, seguire questa procedura. Quando si eseguono questi comandi, sostituire tutti i segnaposto con le proprie informazioni.

1. Ottenere l'ID dell'origine dati di Azure Esplora dati da aggiornare con az grafana data-source list.

   az grafana data-source list --resource-group <azure-managed-grafana-resource-group> --name <azure-managed-grafana-workspace> --query "[?type=='grafana-azure-data-explorer-datasource'].id"
   

2. Eseguire il comando az grafana data-source update per aggiornare l'origine dati.

   Ad esempio, aggiornare il nome e l'URL del cluster dell'origine dati di Azure Esplora dati con il comando seguente.

   az grafana data-source update --resource-group <azure-managed-grafana-workspace-resource-group> --name <azure-managed-grafana-workspace> --data-source-id <data-source-id> --set name="<new-name>" url="<new-url>
   

Passaggio successivo

Creare un dashboard