Zelfstudie: Grafana-API's programmatisch aanroepen

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-exemplaar.
• Een Microsoft Entra-toepassing met een service-principal. Maak een Microsoft Entra-toepassing en service-principal. Gebruik voor het gemak een toepassing die zich in dezelfde Microsoft Entra-tenant bevindt als uw Azure Managed Grafana-exemplaar.

Aanmelden bij Azure

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

1. Open uw exemplaar van Managed Grafana in Azure Portal.

2. Selecteer Toegangsbeheer (IAM) in het navigatiemenu.

3. Selecteer Toevoegen en vervolgens Roltoewijzing toevoegen.

4. Selecteer de rol Grafana Editor en vervolgens Volgende.

5. Selecteer onder Toegang toewijzen de optie Gebruiker, groep of service-principal.

6. Selecteer Leden selecteren, selecteer uw service-principal en druk op Selecteren.

7. Selecteer Controleren + 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.

1. Uw tenant-id zoeken:

   1. Voer in Azure Portal de 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.

   

2. Zoek uw client-id:

   1. Selecteer in Azure Portal in Microsoft Entra ID App-registraties in het menu links.
   2. Selecteer uw app.
   3. Zoek in Overzicht het veld Toepassings-id (client) en sla de waarde op.

   

3. Maak een toepassingsgeheim:

   1. Selecteer in Azure Portal in Microsoft Entra ID App-registraties in het menu links.
   2. Selecteer uw app.
   3. Selecteer Certificaten en geheimen in het linkermenu.
   4. Selecteer Nieuw clientgeheim.
   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.

4. Zoek de Grafana-eindpunt-URL:

   1. Voer in Azure Portal Azure Managed Grafana in de balk Resources, services en documenten (G+ /) zoeken in.
   2. Selecteer Azure Managed Grafana en open uw beheerde 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

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 volgt een voorbeeld van uitvoer:

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.

POST-aanvraag

Volg het onderstaande voorbeeld om Microsoft Entra-id aan te roepen en een token op te halen. Vervang , <client-id>en <client-secret> door <tenant-id>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-exemplaar. Bijvoorbeeld https://my-grafana-abcd.cuse.grafana.azure.com.

Resources opschonen

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

1. Azure Managed Grafana verwijderen:

   1. Selecteer In Azure Portal in Azure Managed Grafana overzicht in het linkermenu.
   2. Selecteer Verwijderen.
   3. Voer de resourcenaam in om het verwijderen te bevestigen en selecteer Verwijderen.

2. Verwijder de Microsoft Entra-toepassing:

   1. Selecteer in Azure Portal in Microsoft Entra ID App-registraties in het menu links.
   2. Selecteer uw app.
   3. Selecteer Verwijderen op het tabblad Overzicht.
   4. Selecteer Verwijderen.

Volgende stappen

Gegevensbronnen configureren