Een Azure Data Explorer-gegevensbron configureren

Azure Data Explorer is een service voor logboeken en telemetriegegevensverkenning. In deze handleiding leert u hoe u een Azure Data Explorer-gegevensbron toevoegt aan Grafana en hoe u Azure Data Explorer configureert met behulp van elke verificatieoptie die beschikbaar is voor deze gegevensbron.

Vereisten

• Een azure Managed Grafana-exemplaar in het Standard-plan.
• Een Azure Data Explorer-database

Een Azure Data Explorer-gegevensbron toevoegen

Voeg een Azure Data Explorer-gegevensbron toe aan Grafana door de onderstaande stappen te volgen.

1. Open een azure Managed Grafana-exemplaar in Azure Portal.

2. Open in de sectie Overzicht de eindpunt-URL .

3. Implementeer in de Grafana-portal het menu aan de linkerkant en selecteer Verbinding maken ions> Verbinding maken gegevens.

   

4. Selecteer Azure Data Explorer Datasource in de lijst en voeg deze toe aan Grafana door een Azure Data Explorer-gegevensbronbron maken te selecteren.

Een Azure Data Explorer-gegevensbron configureren

Voer de configuratie-instellingen van Azure Data Explorer in.

1. Bewerk eventueel de naam van de gegevensbron op het tabblad Instellingen.

   

2. Voer onder Verbinding maken ion Details de URL van het Azure Data Explorer-databasecluster in.

3. Selecteer de gewenste verificatieoptie tussen beheerde identiteit, app-registratie (service-principal) of huidige gebruiker (verificatie op basis van gebruikers).

   Beheerde identiteit

   Verifiëren met een beheerde identiteit zonder expliciete referenties te gebruiken.

   Een nieuwe machtiging toevoegen

   1. Open uw Azure Data Explorer-cluster in Azure Portal.

   2. Selecteer in de sectie Overzicht de database die uw gegevens bevat.

   3. Selecteer Machtigingen > toevoegen > viewer.

      

   4. Voer in het zoekvak de naam van uw Azure Managed Grafana-werkruimte in, selecteer de werkruimte en kies Selecteren. Er wordt een melding weergegeven dat het is gelukt.

   De gegevensbron configureren in Grafana

   1. Selecteer beheerde identiteit in Grafana, onder Verificatiemethode.
   2. Selecteer Opslaan en testen. De melding 'Geslaagd' geeft aan dat Grafana gegevens kan ophalen uit de database.

   App-registratie

   Verifiëren met app-registratie met behulp van een Microsoft Entra-service-principal.

   Eerste installatie

   1. Volg de stappen in Een toepassing registreren met Microsoft Entra-id en maak een service-principal.
   2. Wijs de rol Lezer toe aan de toepassing in de volgende stap van de handleiding.
   3. Volg de drie eerste stappen van de handleiding Voor het ophalen van toepassingsdetails om de map-id (tenant),toepassings-id (client) en clientgeheim-id te verzamelen die vereist zijn in de volgende stap.

   De gegevensbron configureren in Grafana

   1. Selecteer in Grafana, onder Verificatiemethode, app-registratie.

   2. Selecteer uw Azure Cloud voor Azure Cloud. Bijvoorbeeld Azure.

      

   3. Voer een map-id (tenant), toepassings-id (client) en clientgeheim in

   4. U kunt eventueel ook de secties Queryoptimalisaties, Databaseschema-instellingen en Tracering bewerken.

   5. Selecteer Opslaan en testen om de verbinding te valideren. De melding 'Geslaagd' geeft aan dat Grafana verbinding kan maken met de database.

   Huidige gebruiker

   Gebruik de verificatiemethode op basis van gebruikers, waarbij gebruik wordt gemaakt van de Microsoft Entra ID-referenties van de huidige Grafana-gebruiker in de geconfigureerde gegevensbron.

   Wanneer u een Azure Data Explorer-gegevensbron configureert met de huidige gebruikersverificatiemethode, voert Grafana een query uit op Azure Data Explorer met behulp van de referenties van de gebruiker.

   Let op

   Verificatie op basis van gebruikers in Grafana-gegevensbronnen is experimenteel.

   Let op

   Deze functie is niet compatibel met gebruiksvoorbeelden waarvoor always-on-computertoegang tot de opgevraagde gegevens is vereist, waaronder waarschuwingen, rapportage, querycaching en openbare dashboards. De huidige gebruikersverificatiemethode is afhankelijk van een gebruiker die is aangemeld, in een interactieve sessie, zodat Grafana de database kan bereiken. Wanneer verificatie op basis van gebruikers wordt gebruikt en er geen gebruiker is aangemeld, kunnen geautomatiseerde taken niet op de achtergrond worden uitgevoerd. Als u geautomatiseerde taken voor Azure Data Explorer wilt gebruiken, raden we u aan een andere Azure Data Explorer-gegevensbron in te stellen met behulp van een andere verificatiemethode.

   Een nieuwe machtiging toevoegen

   Voeg een nieuwe machtiging toe voor uw gebruikersaccount voor toegang tot de database.

   1. Open in Azure Portal de Azure Data Explorer-databaseresource en selecteer Machtigingen>toevoegen>viewer.

   2. Voer uw naam of e-mailadres in de zoekbalk in, selecteer uw gebruikersaccount en kies Selecteren.

      

   3. Een melding bevestigt dat de machtiging is toegevoegd aan de database.

   De gegevensbron configureren in Grafana

   1. Selecteer in Grafana onder Verificatiemethode de optie Huidige gebruiker.
   2. Selecteer Opslaan en testen. De melding 'Geslaagd' geeft aan dat Grafana gegevens kan ophalen uit de database.

Een Azure Data Explorer-gegevensbron maken

Voeg in de Azure CLI een Azure Data Explorer-gegevensbron toe en configureer deze door de opdracht az grafana data-source create uit te voeren. Kies uw voorkeursverificatiemethode en raadpleeg het bijbehorende tabblad hieronder voor meer informatie.

Wanneer u deze opdrachten uitvoert, vervangt u alle tijdelijke aanduidingen door uw eigen gegevens.

Beheerde identiteit

Verifiëren met een beheerde identiteit zonder expliciete referenties te gebruiken.

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

App-registratie

Verifiëren met app-registratie met behulp van een Microsoft Entra-service-principal.

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

Huidige gebruiker

Verifiëren met de huidige gebruikersmethode. Deze methode maakt gebruik van de Microsoft Entra ID-referenties van de huidige Grafana-gebruiker in de geconfigureerde gegevensbron.

Wanneer u een Azure Data Explorer-gegevensbron configureert met de huidige gebruikersverificatiemethode, voert Grafana een query uit op Azure Data Explorer met behulp van de referenties van de gebruiker.

Notitie

De implementatie van verificatie op basis van gebruikers in Azure Managed Grafana wordt uitgevoerd en wordt eind 2023 voltooid in alle regio's.

Let op

Verificatie op basis van gebruikers in Grafana-gegevensbronnen is experimenteel.

Let op

Deze functie is niet compatibel met gebruiksvoorbeelden waarvoor always-on-computertoegang tot de opgevraagde gegevens is vereist, waaronder waarschuwingen, rapportage, querycaching en openbare dashboards. De huidige gebruikersverificatiemethode is afhankelijk van een gebruiker die is aangemeld, in een interactieve sessie, zodat Grafana de database kan bereiken. Wanneer verificatie op basis van gebruikers wordt gebruikt en er geen gebruiker is aangemeld, kunnen geautomatiseerde taken niet op de achtergrond worden uitgevoerd. Als u geautomatiseerde taken voor Azure Data Explorer wilt gebruiken, raden we u aan een andere Azure Data Explorer-gegevensbron in te stellen met behulp van een andere verificatiemethode.

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

Een Azure Data Explorer-gegevensbron bijwerken

Volg de onderstaande stappen om een Azure Data Explorer-gegevensbron bij te werken. Wanneer u deze opdrachten uitvoert, vervangt u alle tijdelijke aanduidingen door uw eigen gegevens.

1. Haal de id van de Azure Data Explorer-gegevensbron op om bij te werken met 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. Voer de opdracht az grafana data-source update uit om de gegevensbron bij te werken.

   Werk bijvoorbeeld de naam en cluster-URL van de Azure Data Explorer-gegevensbron bij met de volgende opdracht.

   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>
   

Volgende stap

Een dashboard maken