Kurz: Volání rozhraní API Grafana prostřednictvím kódu programu

V tomto kurzu se naučíte:

• Přiřazení role Azure Managed Grafana instančnímu objektu vaší aplikace
• Načtení podrobností o aplikaci
• Získání přístupového tokenu
• Volání rozhraní API Grafana

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Pracovní prostor Grafana spravovaný v Azure Vytvořte instanci Azure Managed Grafana.
• Aplikace Microsoft Entra s instančním objektem. Vytvořte aplikaci Microsoft Entra a instanční objekt. Pro zjednodušení použijte aplikaci umístěnou ve stejném tenantovi Microsoft Entra jako vaše instance Azure Managed Grafana.

Přihlášení k Azure

Přihlaste se pomocí svého účtu Azure k webu Azure Portal na adrese https://portal.azure.com/.

Přiřazení role Azure Managed Grafana instančnímu objektu vaší aplikace

1. Na webu Azure Portal otevřete spravovanou instanci Grafany.

2. V navigační nabídce vyberte Řízení přístupu (IAM ).

3. Vyberte Přidat a pak přidejte přiřazení role.

4. Vyberte roli Editor Grafana a pak další.

5. V části Přiřadit přístup vyberte Uživatel, skupina nebo instanční objekt.

6. Vyberte členy, vyberte instanční objekt a stiskněte Vybrat.

7. Vyberte Zkontrolovat + přiřadit.

   

Načtení podrobností o aplikaci

Teď potřebujete shromáždit některé informace, které použijete k získání přístupového tokenu rozhraní Grafana API a volání rozhraní Grafana API.

1. Vyhledejte ID tenanta:

   1. Na webu Azure Portal zadejte ID Microsoft Entra do vyhledávacích prostředků, služeb a dokumentů (G+ /).
   2. Vyberte Microsoft Entra ID.
   3. V nabídce vlevo vyberte Vlastnosti .
   4. Vyhledejte ID tenanta pole a uložte jeho hodnotu.

   

2. Vyhledejte SVÉ ID klienta:

   1. Na webu Azure Portal vyberte v Microsoft Entra ID Registrace aplikací z levé nabídky.
   2. Vyberte aplikaci.
   3. V části Přehled vyhledejte pole ID aplikace (klienta) a uložte jeho hodnotu.

   

3. Vytvoření tajného kódu aplikace:

   1. Na webu Azure Portal vyberte v Microsoft Entra ID Registrace aplikací z levé nabídky.
   2. Vyberte aplikaci.
   3. V nabídce vlevo vyberte Certifikáty a tajné kódy .
   4. Vyberte Nový tajný klíč klienta.
   5. Vytvořte nový tajný klíč klienta a uložte jeho hodnotu.

   

   Poznámka:

   K hodnotě tajného kódu se dostanete jenom hned po jeho vytvoření. Před opuštěním stránky zkopírujte hodnotu, abyste ji mohli použít v dalším kroku tohoto kurzu.

4. Vyhledejte adresu URL koncového bodu Grafana:

   1. Na webu Azure Portal zadejte Azure Managed Grafana do panelu Prohledat prostředky, služby a dokumenty (G+ /).
   2. Vyberte Azure Managed Grafana a otevřete spravovaný pracovní prostor Grafana.
   3. V nabídce vlevo vyberte Přehled a uložte hodnotu koncového bodu .

   

Získání přístupového tokenu

Pokud chcete získat přístup k rozhraním API Grafany, musíte získat přístupový token. Přístupový token můžete získat pomocí Azure CLI nebo vytvořit požadavek POST.

Azure CLI

Přihlaste se k Azure CLI spuštěním příkazu az login a nahrazením <client-id>a <client-secret><tenant-id> ID aplikace (klienta), tajným kódem klienta a ID tenanta shromážděným v předchozím kroku:

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

K vytvoření klíče použijte příkaz az grafana api-key create . Tady je příklad výstupu:

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

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

Poznámka:

Tento klíč tady můžete zobrazit jenom jednou. Uložte ho na bezpečném místě.

Požadavek POST

Podle následujícího příkladu volejte ID Microsoft Entra a načtěte token. Nahraďte a <client-id><client-secret> nahraďte <tenant-id>ID tenanta, ID aplikace (klienta) a tajným kódem klienta shromážděným v předchozím kroku.

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

Tady je příklad odpovědi:

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

Volání rozhraní API Grafana

Rozhraní API Grafana teď můžete volat pomocí přístupového tokenu načteného v předchozím kroku jako autorizační hlavičky. Příklad:

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

Nahraďte <access-token> přístupový <grafana-url> token načtený v předchozím kroku a adresou URL koncového bodu vaší instance Grafany. Příklad: https://my-grafana-abcd.cuse.grafana.azure.com.

Vyčištění prostředků

Pokud tyto prostředky nebudete dál používat, odstraňte je pomocí následujícího postupu:

1. Odstranění spravované grafany Azure:

   1. Na webu Azure Portal ve službě Azure Managed Grafana vyberte v nabídce vlevo přehled .
   2. Vyberte Odstranit.
   3. Zadáním názvu prostředku potvrďte odstranění a vyberte Odstranit.

2. Odstraňte aplikaci Microsoft Entra:

   1. Na webu Azure Portal vyberte v Microsoft Entra ID Registrace aplikací z levé nabídky.
   2. Vyberte aplikaci.
   3. Na kartě Přehled vyberte Odstranit.
   4. Vyberte Odstranit.

Další kroky

Konfigurace zdrojů dat