Samouczek: programowe wywoływanie interfejsów API narzędzia Grafana

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

• Przypisywanie roli zarządzanego narzędzia Grafana platformy Azure do jednostki usługi aplikacji
• Pobieranie szczegółów aplikacji
• Pobranie tokenu dostępu
• Wywoływanie interfejsów API narzędzia Grafana

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Obszar roboczy usługi Azure Managed Grafana. Utwórz wystąpienie usługi Azure Managed Grafana.
• Aplikacja Firmy Microsoft Entra z jednostką usługi. Utwórz aplikację Microsoft Entra i jednostkę usługi. Dla uproszczenia użyj aplikacji znajdującej się w tej samej dzierżawie usługi Microsoft Entra co wystąpienie usługi Azure Managed Grafana.

Logowanie się do platformy Azure

Zaloguj się do witryny Azure Portal pod adresem https://portal.azure.com/ przy użyciu konta platformy Azure.

Przypisywanie roli zarządzanego narzędzia Grafana platformy Azure do jednostki usługi aplikacji

1. W witrynie Azure Portal otwórz wystąpienie zarządzanego narzędzia Grafana.

2. Wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami) w menu nawigacji.

3. Wybierz pozycję Dodaj, a następnie dodaj przypisanie roli.

4. Wybierz rolę Edytor Grafana, a następnie przycisk Dalej.

5. W obszarze Przypisz dostęp do wybierz pozycję Użytkownik, grupa lub jednostka usługi.

6. Wybierz pozycję Wybierz członków, wybierz jednostkę usługi i naciśnij pozycję Wybierz.

7. Wybierz Przejrzyj + przypisz.

   

Pobieranie szczegółów aplikacji

Teraz musisz zebrać pewne informacje, które będą używane do uzyskiwania tokenu dostępu interfejsu API narzędzia Grafana i wywoływania interfejsów API narzędzia Grafana.

1. Znajdź identyfikator dzierżawy:

   1. W witrynie Azure Portal wprowadź wartość Microsoft Entra ID w obszarze Wyszukaj zasoby, usługi i dokumenty (G+ /).
   2. Wybierz Microsoft Entra ID.
   3. Wybierz pozycję Właściwości z menu po lewej stronie.
   4. Znajdź pole Identyfikator dzierżawy i zapisz jego wartość.

   

2. Znajdź identyfikator klienta:

   1. W witrynie Azure Portal w obszarze Microsoft Entra ID wybierz pozycję Rejestracje aplikacji z menu po lewej stronie.
   2. Wybierz aplikację.
   3. W obszarze Przegląd znajdź pole Identyfikator aplikacji (klienta) i zapisz jego wartość.

   

3. Utwórz wpis tajny aplikacji:

   1. W witrynie Azure Portal w obszarze Microsoft Entra ID wybierz pozycję Rejestracje aplikacji z menu po lewej stronie.
   2. Wybierz aplikację.
   3. Wybierz pozycję Certyfikaty i wpisy tajne z menu po lewej stronie.
   4. Wybierz Nowy klucz tajny klienta.
   5. Utwórz nowy klucz tajny klienta i zapisz jego wartość.

   

   Uwaga

   Dostęp do wartości wpisu tajnego można uzyskać bezpośrednio po jego utworzeniu. Skopiuj wartość przed opuszczeniem strony, aby użyć jej w następnym kroku tego samouczka.

4. Znajdź adres URL punktu końcowego narzędzia Grafana:

   1. W witrynie Azure Portal wprowadź ciąg Azure Managed Grafana na pasku Wyszukaj zasoby, usługi i dokumenty (G+ /).
   2. Wybierz pozycję Azure Managed Grafana i otwórz obszar roboczy Zarządzany Grafana.
   3. Wybierz pozycję Przegląd z menu po lewej stronie i zapisz wartość Punkt końcowy .

   

Pobranie tokenu dostępu

Aby uzyskać dostęp do interfejsów API narzędzia Grafana, musisz uzyskać token dostępu. Token dostępu można uzyskać przy użyciu interfejsu wiersza polecenia platformy Azure lub wysłać żądanie POST.

Interfejs wiersza polecenia platformy Azure

Zaloguj się do interfejsu wiersza polecenia platformy Azure, uruchamiając polecenie az login i zastąp <client-id>ciąg , <client-secret>oraz <tenant-id> identyfikatorem aplikacji (klienta), kluczem tajnym klienta i identyfikatorem dzierżawy zebranym w poprzednim kroku:

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

Użyj polecenia az grafana api-key create , aby utworzyć klucz. Oto przykładowe dane wyjściowe:

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

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

Uwaga

Ten klucz można wyświetlić tylko raz. Zapisz go w bezpiecznym miejscu.

Żądanie POST

Postępuj zgodnie z poniższym przykładem, aby wywołać identyfikator Entra firmy Microsoft i pobrać token. Zastąp <tenant-id>wartości , <client-id>i <client-secret> identyfikatorem dzierżawy, identyfikatorem aplikacji (klienta) i wpisem tajnym klienta zebranym w poprzednim 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

Oto przykład odpowiedzi:

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

Wywoływanie interfejsów API narzędzia Grafana

Teraz możesz wywoływać interfejsy API narzędzia Grafana przy użyciu tokenu dostępu pobranego w poprzednim kroku jako nagłówka autoryzacji. Na przykład:

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

Zastąp <access-token> wartości i <grafana-url> tokenem dostępu pobranym w poprzednim kroku i adresem URL punktu końcowego wystąpienia narzędzia Grafana. Na przykład: https://my-grafana-abcd.cuse.grafana.azure.com.

Czyszczenie zasobów

Jeśli nie zamierzasz nadal korzystać z tych zasobów, usuń je, wykonując następujące czynności:

1. Usuń narzędzie Grafana zarządzane przez platformę Azure:

   1. W witrynie Azure Portal w obszarze Azure Managed Grafana wybierz pozycję Przegląd z menu po lewej stronie.
   2. Wybierz Usuń.
   3. Wprowadź nazwę zasobu, aby potwierdzić usunięcie, a następnie wybierz pozycję Usuń.

2. Usuń aplikację Microsoft Entra:

   1. W witrynie Azure Portal w obszarze Microsoft Entra ID wybierz pozycję Rejestracje aplikacji z menu po lewej stronie.
   2. Wybierz aplikację.
   3. Na karcie Przegląd wybierz pozycję Usuń.
   4. Wybierz Usuń.

Następne kroki

Jak skonfigurować źródła danych