Zelfstudie: Grafana-API's programmatisch aanroepen

2025-04-05

In deze zelfstudie leert u het volgende:

Een door Azure beheerde Grafana-rol toewijzen aan de service-principal van uw toepassing
Toepassingsgegevens ophalen
Een toegangstoken opvragen
Grafana-API's aanroepen

Vereisten

Een Azure-account met een actief abonnement. Gratis een account maken
Een azure Managed Grafana-werkruimte. Maak een azure Managed Grafana-werkruimte.
Een Microsoft Entra-toepassing met een service-principal. Maak een Microsoft Entra-toepassing en servicehoofdgebruiker. Gebruik voor het gemak een toepassing die zich in dezelfde Microsoft Entra-tenant bevindt als uw Azure Managed Grafana-werkruimte.

Meld u met uw Azure-account aan bij de Azure-portal op https://portal.azure.com/.

Een door Azure beheerde Grafana-rol toewijzen aan de service-principal van uw toepassing

Open uw Azure Managed Grafana-werkruimte in Azure Portal.
Selecteer Toegangsbeheer (IAM) in het navigatiemenu.
Selecteer Toevoegen en vervolgens Roltoewijzing toevoegen.
Selecteer de rol Grafana Editor en vervolgens Volgende.
Selecteer onder Toegang toewijzen de optie Gebruiker, groep of service-principal.
Selecteer leden, selecteer uw service-principal en klik op selecteren.
Selecteer Beoordelen + toewijzen.

Toepassingsgegevens ophalen

U moet nu enkele gegevens verzamelen, die u gaat gebruiken om een Grafana API-toegangstoken op te halen en Grafana-API's aan te roepen.

Uw tenant-id zoeken:
1. In de Azure-portal voert u Microsoft Entra ID in de zoekbronnen, -services en -documenten (G+ /) in.
2. Selecteer Microsoft Entra ID.
3. Selecteer Eigenschappen in het linkermenu.
4. Zoek het veld Tenant-id en sla de waarde op.
Zoek uw client-id:
1. In de Azure-portal, in Microsoft Entra ID, selecteer je App-registraties in het menu aan de linkerkant.
2. Selecteer uw app.
3. Zoek in Overzicht het veld Toepassings-id (client) en sla de waarde op.
Maak een toepassingsgeheim:
1. In het Azure portal, in Microsoft Entra ID, selecteer je App-registraties in het menu aan de linkerkant.
2. Selecteer uw app.
3. Selecteer Certificaten en geheimen in het linkermenu.
4. Selecteer Nieuwe clientsleutel.
5. Maak een nieuw clientgeheim en sla de waarde op.
Notitie

U hebt alleen direct na het maken toegang tot de waarde van een geheim. Kopieer de waarde voordat u de pagina verlaat om deze te gebruiken in de volgende stap van deze zelfstudie.
Zoek de Grafana-eindpunt-URL:
1. In de Azure-portal, voer Azure Managed Grafana in de zoekbalk resources, services en documenten (G+ /) in.
2. Selecteer Azure Managed Grafana en open uw Azure Managed Grafana-werkruimte.
3. Selecteer Overzicht in het linkermenu en sla de waarde van het eindpunt op.

Een toegangstoken opvragen

Voor toegang tot Grafana-API's moet u een toegangstoken ophalen. U kunt het toegangstoken ophalen met behulp van de Azure CLI of een POST-aanvraag indienen.

Azure-CLI
POST-aanvraag

Meld u aan bij de Azure CLI door de az login-opdracht uit te voeren en vervang <client-id>, <client-secret>en <tenant-id> door de toepassings-id (client), het clientgeheim en de tenant-id die in de vorige stap is verzameld:

az login --service-principal --username "<client-id>" --password "<client-secret>" --tenant "<tenant-id>"

Gebruik de opdracht az grafana api-key create om een sleutel te maken. Hier is een voorbeeldoutput:

az grafana api-key create --key keyname --name <name> --resource-group <rg> --role editor --output json

{
  "id": 3,
  "key": "<redacted>",
  "name": "keyname"
}

Notitie

U kunt deze sleutel hier slechts één keer bekijken. Sla het op een veilige plaats op.

Volg het onderstaande voorbeeld om Microsoft Entra-id aan te roepen en een token op te halen. Vervang , <tenant-id>en <client-id> door <client-secret>de tenant-id, de toepassings-id (client) en het clientgeheim dat in de vorige stap is verzameld.

curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id=<client-id>&client_secret=<client-secret>&resource=ce34e7e5-485f-4d76-964f-b3d2b16d1e4f' \
https://login.microsoftonline.com/<tenant-id>/oauth2/token

Hier volgt een voorbeeld van een antwoord:

{
  "token_type": "Bearer",
  "expires_in": "599",
  "ext_expires_in": "599",
  "expires_on": "1575500555",
  "not_before": "1575499766",
  "resource": "ce34...1e4f",
  "access_token": "eyJ0eXAiOiJ......AARUQ"
}

Grafana-API's aanroepen

U kunt nu Grafana-API's aanroepen met behulp van het toegangstoken dat in de vorige stap is opgehaald als autorisatieheader. Voorbeeld:

curl -X GET \
-H 'Authorization: Bearer <access-token>' \
https://<grafana-url>/api/user

Vervang <access-token> en <grafana-url> door het toegangstoken dat is opgehaald in de vorige stap en de eindpunt-URL van uw Grafana-werkruimte. Bijvoorbeeld https://my-grafana-abcd.cuse.grafana.azure.com.

Middelen opschonen

Als u deze resources niet meer gaat gebruiken, verwijdert u deze met de volgende stappen:

Azure Managed Grafana verwijderen:
1. In het Azure-portaal, in Azure Managed Grafana, selecteer Overzicht in het linkermenu.
2. Selecteer Verwijderen.
3. Voer de resourcenaam in om het verwijderen te bevestigen en selecteer Verwijderen.
Verwijder de Microsoft Entra-toepassing:
1. Selecteer App-registraties in de Azure-portal, binnen Microsoft Entra ID, uit het linkermenu.
2. Selecteer uw app.
3. Selecteer Verwijderen op het tabblad Overzicht.
4. Selecteer Verwijderen.

Volgende stappen

Gegevensbronnen configureren

Delen via