Oktatóanyag: Grafana API-k programozott meghívása

Ebben az oktatóanyagban az alábbiakkal fog megismerkedni:

• Azure Managed Grafana-szerepkör hozzárendelése az alkalmazás szolgáltatásnévéhez
• Alkalmazás részleteinek lekérése
• Hozzáférési jogkivonat lekérése
• Grafana API-k meghívása

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
• Azure Managed Grafana-munkaterület. Azure Managed Grafana-példány létrehozása.
• Egy Microsoft Entra-alkalmazás szolgáltatásnévvel. Hozzon létre egy Microsoft Entra-alkalmazást és szolgáltatásnevet. Az egyszerűség kedvéért használjon egy olyan alkalmazást, amely ugyanabban a Microsoft Entra-bérlőben található, mint az Azure Managed Grafana-példány.

Bejelentkezés az Azure-ba

Jelentkezzen be Azure-fiókjával az Azure Portalba a https://portal.azure.com/ webhelyen.

Azure Managed Grafana-szerepkör hozzárendelése az alkalmazás szolgáltatásnévéhez

1. Nyissa meg a felügyelt Grafana-példányt az Azure Portalon.

2. A navigációs menüben válassza a Hozzáférés-vezérlés (IAM) lehetőséget.

3. Válassza a Hozzáadás, majd a Szerepkör-hozzárendelés hozzáadása lehetőséget.

4. Válassza ki a Grafana-szerkesztő szerepkört, majd a Tovább lehetőséget.

5. A Hozzáférés hozzárendelése csoportban válassza a Felhasználó, csoport vagy szolgáltatásnév lehetőséget.

6. Válassza a Tagok kijelölése lehetőséget, válassza ki a szolgáltatásnevet, és nyomja le a Select billentyűt.

7. Válassza az Áttekintés + hozzárendelés lehetőséget.

   

Alkalmazás részleteinek lekérése

Most már össze kell gyűjtenie néhány információt, amelyet a Grafana API hozzáférési jogkivonatának lekéréséhez és a Grafana API-k meghívásához fog használni.

1. Keresse meg a bérlőazonosítót:

   1. Az Azure Portalon adja meg a Microsoft Entra-azonosítót a Keresési erőforrások, szolgáltatások és dokumentumok (G+ /) mezőben.
   2. Válassza ki a Microsoft Entra ID.
   3. Válassza a Tulajdonságok lehetőséget a bal oldali menüben.
   4. Keresse meg a mező bérlőazonosítóját , és mentse az értékét.

   

2. Az ügyfélazonosító megkeresése:

   1. Az Azure Portal Microsoft Entra-azonosítójában válassza Alkalmazásregisztrációk a bal oldali menüből.
   2. Válassza ki az alkalmazást.
   3. Az Áttekintésben keresse meg az Alkalmazás (ügyfél) azonosító mezőjét, és mentse annak értékét.

   

3. Alkalmazáskulcs létrehozása:

   1. Az Azure Portal Microsoft Entra-azonosítójában válassza Alkalmazásregisztrációk a bal oldali menüből.
   2. Válassza ki az alkalmazást.
   3. Válassza a Tanúsítványok > titkos kulcsok lehetőséget a bal oldali menüből.
   4. Válassza az Új titkos ügyfélkód lehetőséget.
   5. Hozzon létre egy új ügyfélkulcsot, és mentse annak értékét.

   

   Feljegyzés

   A titkos kódok értékét csak közvetlenül a létrehozás után érheti el. Másolja ki az értéket, mielőtt elhagyná a lapot, hogy használja az oktatóanyag következő lépésében.

4. Keresse meg a Grafana végpont URL-címét:

   1. Az Azure Portalon adja meg az Azure Managed Grafana kifejezést a Keresési erőforrások, szolgáltatások és dokumentumok (G+ /) sávon.
   2. Válassza az Azure Managed Grafana lehetőséget, és nyissa meg a felügyelt Grafana-munkaterületet.
   3. Válassza az Áttekintés lehetőséget a bal oldali menüből, és mentse a végpont értékét.

   

Hozzáférési jogkivonat lekérése

A Grafana API-k eléréséhez be kell szereznie egy hozzáférési jogkivonatot. A hozzáférési jogkivonatot az Azure CLI használatával vagy POST-kéréssel szerezheti be.

Azure CLI

Jelentkezzen be az Azure CLI-be az az login parancs futtatásával, majd cserélje le <client-id>a , majd <client-secret><tenant-id> az előző lépésben összegyűjtött alkalmazás-(ügyfél-) azonosítót, ügyfélkulcsot és bérlőazonosítót:

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

Kulcs létrehozásához használja az az grafana api-key create parancsot. Íme egy példakimenet:

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

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

Feljegyzés

Ezt a kulcsot csak egyszer tekintheti meg. Mentse biztonságos helyre.

POST kérés

Kövesse az alábbi példát a Microsoft Entra ID meghívásához és egy jogkivonat lekéréséhez. Cserélje le <tenant-id>a bérlőazonosítót<client-id><client-secret>, az alkalmazás (ügyfél) azonosítóját és az előző lépésben összegyűjtött ügyfélkulcsot.

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

Íme egy példa a válaszra:

{
  "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-k meghívása

Most már meghívhatja a Grafana API-kat az előző lépésben az Engedélyezési fejlécként lekért hozzáférési jogkivonat használatával. Példa:

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

Cserélje le <access-token> az <grafana-url> előző lépésben lekért hozzáférési jogkivonatot és a Grafana-példány végponti URL-címét. Például: https://my-grafana-abcd.cuse.grafana.azure.com.

Az erőforrások eltávolítása

Ha nem fogja továbbra is használni ezeket az erőforrásokat, törölje őket az alábbi lépésekkel:

1. Az Azure Managed Grafana törlése:

   1. Az Azure Portalon, az Azure Managed Grafana-ban válassza az Áttekintés lehetőséget a bal oldali menüből.
   2. Válassza a Törlés lehetőséget.
   3. Adja meg az erőforrás nevét a törlés megerősítéséhez, és válassza a Törlés lehetőséget.

2. Törölje a Microsoft Entra alkalmazást:

   1. Az Azure Portal Microsoft Entra-azonosítójában válassza Alkalmazásregisztrációk a bal oldali menüből.
   2. Válassza ki az alkalmazást.
   3. Az Áttekintés lapon válassza a Törlés lehetőséget.
   4. Válassza a Törlés lehetőséget.

Következő lépések

Adatforrások konfigurálása