Konfigurera en Azure Data Explorer-datakälla

Azure Data Explorer är en logg- och telemetritjänst för datautforskning. I den här guiden lär du dig hur du lägger till en Azure Data Explorer-datakälla i Grafana och lär dig hur du konfigurerar Azure Data Explorer med varje autentiseringsalternativ som är tillgängligt för den här datakällan.

Förutsättningar

• En Azure Managed Grafana-instans i Standard-planen.
• En Azure Data Explorer-databas

Lägga till en Azure Data Explorer-datakälla

Lägg till en Azure Data Explorer-datakälla i Grafana genom att följa stegen nedan.

1. Öppna en Azure Managed Grafana-instans i Azure-portalen.

2. I avsnittet Översikt öppnar du slutpunkts-URL:en.

3. I Grafana-portalen distribuerar du menyn till vänster och väljer Anslut ions> Anslut data.

   

4. Välj Azure Data Explorer Datasource i listan och lägg till den i Grafana genom att välja Skapa en Azure Data Explorer-datakälla.

Konfigurera en Azure Data Explorer-datakälla

Ange konfigurationsinställningar för Azure Data Explorer.

1. På fliken Inställningar kan du redigera datakällans namn.

   

2. Under Anslut ionsinformation anger du Azure Data Explorer-databasens kluster-URL.

3. Välj önskat autentiseringsalternativ mellan Hanterad identitet, Appregistrering (tjänstens huvudnamn) eller Aktuell användare (användarbaserad autentisering).

   Hanterade identiteter

   Autentisera med en hanterad identitet utan att använda explicita autentiseringsuppgifter.

   Lägga till en ny behörighet

   1. Öppna Azure Data Explorer-klustret i Azure-portalen.

   2. I avsnittet Översikt väljer du den databas som innehåller dina data.

   3. Välj Behörigheter > Lägg till > visningsprogram.

      

   4. I sökrutan anger du namnet på din Azure Managed Grafana-arbetsyta, väljer arbetsytan och väljer sedan Välj. Ett meddelande visas.

   Konfigurera datakällan i Grafana

   1. I Grafana går du till Autentiseringsmetod och väljer Hanterad identitet.
   2. Välj Spara och testa. Meddelandet "Lyckades" visar att Grafana kan hämta data från databasen.

   Appregistrering

   Autentisera med appregistrering med hjälp av tjänstens huvudnamn för Microsoft Entra.

   Inledande konfiguration

   1. Följ stegen i Registrera ett program med Microsoft Entra-ID och skapa ett huvudnamn för tjänsten.
   2. Tilldela rollen Läsare till programmet i nästa steg i guiden.
   3. Följ de tre första stegen i guiden Hämta programinformation för att samla in katalog-ID,program-ID (klient)-ID och klienthemlighets-ID som krävs i nästa steg.

   Konfigurera datakällan i Grafana

   1. Under Autentiseringsmetod i Grafana väljer du Appregistrering.

   2. För Azure Cloud väljer du ditt Azure Cloud. Till exempel Azure.

      

   3. Ange ett katalog-ID (klient)-ID, program-ID (klient)-ID och klienthemlighet

   4. Du kan också redigera avsnitten Frågeoptimeringar, Databasschemainställningar och Spårning.

   5. Välj Spara och testa för att verifiera anslutningen. Meddelandet "Lyckades" visar att Grafana kan ansluta till databasen.

   Aktuell användare

   Använd den användarbaserade autentiseringsmetoden och använd den aktuella Grafana-användarens Microsoft Entra-ID-autentiseringsuppgifter i den konfigurerade datakällan.

   När du konfigurerar en Azure Data Explorer-datakälla med autentiseringsmetoden Aktuell användare frågar Grafana Azure Data Explorer med hjälp av användarens autentiseringsuppgifter.

   Varning

   Användarbaserad autentisering i Grafana-datakällor är experimentell.

   Varning

   Den här funktionen är inte kompatibel med användningsfall som kräver åtkomst till efterfrågade data, inklusive aviseringar, rapportering, cachelagring av frågor och offentliga instrumentpaneler. Autentiseringsmetoden Aktuell användare förlitar sig på att en användare loggas in, i en interaktiv session, för att Grafana ska kunna nå databasen. När användarbaserad autentisering används och ingen användare är inloggad kan automatiserade uppgifter inte köras i bakgrunden. Om du vill använda automatiserade uppgifter för Azure Data Explorer rekommenderar vi att du konfigurerar en annan Azure Data Explorer-datakälla med en annan autentiseringsmetod.

   Lägga till en ny behörighet

   Lägg till en ny behörighet för ditt användarkonto för att få åtkomst till databasen.

   1. Öppna Azure Data Explorer Database-resursen i Azure-portalen och välj Behörigheter>Lägg till>visningsprogram.

   2. Ange ditt namn eller din e-postadress i sökfältet, välj ditt användarkonto och välj Välj.

      

   3. Ett meddelande bekräftar att behörigheten har lagts till i databasen.

   Konfigurera datakällan i Grafana

   1. Under Autentiseringsmetod i Grafana väljer du Aktuell användare.
   2. Välj Spara och testa. Meddelandet "Lyckades" visar att Grafana kan hämta data från databasen.

Skapa en Azure Data Explorer-datakälla

I Azure CLI lägger du till och konfigurerar en Azure Data Explorer-datakälla genom att köra kommandot az grafana data-source create . Välj önskad autentiseringsmetod och se motsvarande flik nedan för mer information.

När du kör dessa kommandon ersätter du alla platshållare med din egen information.

Hanterade identiteter

Autentisera med en hanterad identitet utan att använda explicita autentiseringsuppgifter.

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"
    }
  }
}'

Appregistrering

Autentisera med appregistrering med hjälp av tjänstens huvudnamn för 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" }
}'

Aktuell användare

Autentisera med den aktuella användarmetoden. Den här metoden utnyttjar den aktuella Grafana-användarens Microsoft Entra-ID-autentiseringsuppgifter i den konfigurerade datakällan.

När du konfigurerar en Azure Data Explorer-datakälla med autentiseringsmetoden Aktuell användare frågar Grafana Azure Data Explorer med hjälp av användarens autentiseringsuppgifter.

Kommentar

Distributionen av den användarbaserade autentiseringen i Azure Managed Grafana pågår och kommer att slutföras i alla regioner i slutet av 2023.

Varning

Användarbaserad autentisering i Grafana-datakällor är experimentell.

Varning

Den här funktionen är inte kompatibel med användningsfall som kräver åtkomst till efterfrågade data, inklusive aviseringar, rapportering, cachelagring av frågor och offentliga instrumentpaneler. Autentiseringsmetoden Aktuell användare förlitar sig på att en användare loggas in, i en interaktiv session, för att Grafana ska kunna nå databasen. När användarbaserad autentisering används och ingen användare är inloggad kan automatiserade uppgifter inte köras i bakgrunden. Om du vill använda automatiserade uppgifter för Azure Data Explorer rekommenderar vi att du konfigurerar en annan Azure Data Explorer-datakälla med en annan autentiseringsmetod.

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"
    }
  }
}'

Uppdatera en Azure Data Explorer-datakälla

Följ stegen nedan om du vill uppdatera en Azure Data Explorer-datakälla. När du kör dessa kommandon ersätter du alla platshållare med din egen information.

1. Hämta ID:t för Azure Data Explorer-datakällan som ska uppdateras med az grafana-datakälllistan.

   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. Kör kommandot az grafana data-source update för att uppdatera datakällan.

   Du kan till exempel uppdatera namnet och kluster-URL:en för Azure Data Explorer-datakällan med följande kommando.

   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>
   

Gå vidare

Skapa en instrumentpanel