Megosztás a következőn keresztül:


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

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.

    Képernyőkép: Szerepkör-hozzárendelés hozzáadása az Azure-platformon.

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.

    Képernyőkép az Azure Portalról, a bérlőazonosító lekéréséről.

  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.

    Képernyőkép az Azure Portalról, az ügyfél-azonosító lekéréséről.

  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.

    Képernyőkép az Azure Portalról, amely létrehoz egy titkos kulcsot.

    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.

    Képernyőkép az Azure-platformról. Az Áttekintés lapon megjelenő végpont.

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.

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.

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