Szolgáltatásfiókok használata az Azure Managed Grafana-ban

Ebben az útmutatóban megtudhatja, hogyan használhatja a szolgáltatásfiókokat. A szolgáltatásfiókok automatizált műveletek futtatására és alkalmazások hitelesítésére szolgálnak a Grafana API-val.

Gyakori használati esetek a következők:

• Irányítópultok kiépítése vagy konfigurálása
• Jelentések ütemezése
• Riasztások meghatározása
• Külső SAML-hitelesítésszolgáltató beállítása
• A Grafana használata felhasználóként való bejelentkezés nélkül

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
• Egy Azure Managed Grafana-példány. Ha még nem rendelkezik ilyennel, hozzon létre egy Azure Managed Grafana-példányt.

Szolgáltatásfiókok engedélyezése

Ha a meglévő Grafana-munkaterületen nincs engedélyezve szolgáltatásfiók, a Grafana-példány beállítási beállításainak frissítésével engedélyezheti őket.

Portál

1. Az Azure Portal Gépház területén válassza a Konfiguráció lehetőséget, majd az API-kulcsok és szolgáltatásfiókok alatt válassza az Engedélyezés lehetőséget.

   

2. A Mentés gombra kattintva ellenőrizheti, hogy engedélyezni szeretné-e az API-kulcsokat és a szolgáltatásfiókokat az Azure Managed Grafana szolgáltatásban.

Azure CLI

1. Az Azure Managed Grafana CLI 0.3.0-s vagy újabb bővítménye szükséges. A bővítmény frissítéséhez futtassa a következőt az extension update --name amg: .
2. Futtassa az az grafana update parancsot az API-kulcsok és szolgáltatásfiókok létrehozásának engedélyezéséhez egy meglévő Azure Managed Grafana-példányban. Az alábbi parancsban cserélje le <azure-managed-grafana-name> a frissíteni kívánt Azure Managed Grafana-példány nevét.

az grafana update --name <azure-managed-grafana-name> ---service-account Enabled

Szolgáltatásfiók létrehozása

Az alábbi lépéseket követve hozzon létre egy új Grafana szolgáltatásfiókot, és listázhassa a meglévő szolgáltatásfiókokat:

Portál

1. Nyissa meg a Grafana-példány végpontját, és a Konfiguráció területen válassza a Szolgáltatásfiókok lehetőséget.

2. Válassza a Szolgáltatásfiók hozzáadása lehetőséget, és adjon meg egy megjelenítendő nevet és egy szerepkört az új Grafana szolgáltatásfiókhoz: Megtekintő, Szerkesztő vagy Rendszergazda, majd válassza a Létrehozás lehetőséget.

   

3. A lapon megjelenik a sikeresen létrehozott értesítési szolgáltatásfiók, valamint az új szolgáltatásfiókra vonatkozó néhány információ.

4. A vissza nyíl jelre kattintva megtekintheti a Grafana-példány összes szolgáltatásfiókjának listáját.

Azure CLI

Futtassa a az grafana service-account create parancsot egy szolgáltatásfiók létrehozásához. Cserélje le a helyőrzőket <azure-managed-grafana-name>és <service-account-name> <role> a saját adatait.

Elérhető szerepkörök: Admin, Editor. Viewer

az grafana service-account create --name <azure-managed-grafana-name> --service-account <service-account-name> --role <role>

Szolgáltatásfiókok listázása

Futtassa a az grafana service-account list parancsot az adott Azure Managed Grafana-példányhoz tartozó összes szolgáltatásfiók listájának lekéréséhez. Cserélje le <azure-managed-grafana-name> az Azure Managed Grafana-munkaterület nevére.

az grafana service-account list --name <azure-managed-grafana-name> --output table

Példa a kimenetre:

AvatarUrl             IsDisabled    Login        Name        OrgId    Role    Tokens
--------------------  ------------  -----------  ----------  -------  ------  --------
/avatar/abc12345678   False         sa-account1  account1    1        Viewer  0

Szolgáltatásfiók részleteinek megjelenítése

Futtassa a az grafana service-account show parancsot egy szolgáltatásfiók részleteinek lekéréséhez. Cserélje le és <service-account-name> cserélje le <azure-managed-grafana-name> a saját adatait.

az grafana service-account show --name <azure-managed-grafana-name> --service-account <service-account-name>

Szolgáltatásfiók-jogkivonat hozzáadása és jogkivonatok áttekintése

Miután létrehozott egy szolgáltatásfiókot, adjon hozzá egy vagy több hozzáférési jogkivonatot. A hozzáférési jogkivonatok a Grafana API-val való hitelesítéshez használt sztringek.

Portál

1. Szolgáltatásfiók-jogkivonat létrehozásához válassza a Jogkivonat hozzáadása lehetőséget.

2. Használja az automatikusan létrehozott megjelenítendő nevet , vagy adjon meg egy tetszőleges nevet, és opcionálisan válasszon egy lejárati dátumot , vagy hagyja meg az alapértelmezett beállítást a lejárati dátum megadásához.

   

3. Válassza a Jogkivonat létrehozása lehetőséget, és jegyezze fel a létrehozott jogkivonatot. Ez a jogkivonat csak egyszer jelenik meg, ezért ügyeljen arra, hogy mentse, mivel a jogkivonatok kiosztásához létre kell hoznia egy újat.

4. Válassza ki a szolgáltatásfiókot a szolgáltatásfiók adatainak eléréséhez, beleértve az összes társított jogkivonat listáját.

Azure CLI

Új jogkivonat létrehozása

1. Hozzon létre egy Grafana szolgáltatásfiók-jogkivonatot a az grafana service-account token create. Cserélje le a helyőrzőket <azure-managed-grafana-name>és <service-account-name> <token-name> a saját adatait.

   Igény szerint állítsa be a lejárati időt:

   Paraméter	Leírás	Példa
   --time-to-live	A jogkivonatok alapértelmezés szerint korlátlan lejárati dátummal rendelkeznek. Állítson be egy lejárati időt a jogkivonat adott idő utáni letiltásához. Másodpercekre s , percekre, m h órákra, d napokra, w hetekre, M hónapokra vagy y évekre használható.	15d

   az grafana service-account token create --name <azure-managed-grafana-name> --service-account <service-account-name> --token <token-name> --time-to-live 15d
   

2. Jegyezze fel a létrehozott jogkivonatot. Ez a jogkivonat csak egyszer jelenik meg, ezért ügyeljen arra, hogy mentse, mivel a jogkivonatok kiosztásához létre kell hoznia egy újat.

Szolgáltatásfiók-jogkivonatok listázása

Futtassa a az grafana service-account token list parancsot az adott szolgáltatásfiókhoz tartozó összes jogkivonat listájának lekéréséhez. Cserélje le a helyőrzőket <azure-managed-grafana-name> és <service-account-name> a saját adatait.

az grafana service-account token list --name <azure-managed-grafana-name> --service-account <service-account-name> --output table

Példa a kimenetre:

Created               Expiration            HasExpired    Name    SecondsUntilExpiration
--------------------  --------------------  ------------  ------  ------------------------
2022-12-07T11:40:45Z  2022-12-08T11:40:45Z  False         token1  85890.870731556
2022-12-07T11:42:35Z  2022-12-22T11:42:35Z  False         token2  0

Szolgáltatásfiók szerkesztése

Ebben a szakaszban megtudhatja, hogyan frissíthet Grafana szolgáltatásfiókokat a következő módokon:

• Szolgáltatásfiók nevének szerkesztése
• Szolgáltatásfiók szerepkörének szerkesztése
• Szolgáltatásfiók letiltása
• Szolgáltatásfiók engedélyezése

Portál

Műveletek:

• A név szerkesztéséhez válassza ki a szolgáltatásfiókot, majd az Információk területen válassza a Szerkesztés lehetőséget.
• A szerepkör szerkesztéséhez válassza ki a szolgáltatásfiókot, majd az Információk területen válassza ki a szerepkört, és válasszon másik szerepkörnevet.
• Szolgáltatásfiók letiltásához válasszon ki egy szolgáltatásfiókot, majd a lap tetején válassza a Szolgáltatásfiók letiltása lehetőséget, majd válassza a Szolgáltatásfiók letiltása lehetőséget a megerősítéshez. A letiltott szolgáltatásfiókok újra engedélyezhetők a szolgáltatásfiók engedélyezése lehetőség kiválasztásával.

A frissített értesítési szolgáltatásfiók azonnal megjelenik.

Azure CLI

Szolgáltatásfiók szerkesztése a .az grafana service-account update Cserélje le a helyőrzőket <azure-managed-grafana-name>és <service-account-name> a saját adatait, és használjon egy vagy több paramétert a következő paraméterek közül:

Paraméter	Leírás
--is-disabled	Adja meg --is-disabled true a szolgáltatásfiók letiltását vagy --is-disabled false egy szolgáltatásfiók engedélyezését.
--name	Adjon meg egy másik nevet a szolgáltatásfióknak.
--role	Adjon meg egy másik szerepkört a szolgáltatásfiókhoz. Elérhető szerepkörök: Admin, Editor. Viewer

az grafana service-account update --name <azure-managed-grafana-name> --service-account <service-account-name> --role <role> --enabled false

Szolgáltatásfiók letiltásához futtassa a az grafana update parancsot, és használja a lehetőséget --is-disabled true. Szolgáltatásfiók engedélyezéséhez használja --is-disabled falsea következőt: .

az grafana update --service-account Disabled --name <service-account-name>

Szolgáltatásfiók törlése

Portál

A Grafana szolgáltatásfiók törléséhez válasszon ki egy szolgáltatásfiókot, majd a lap tetején válassza a Szolgáltatásfiók törlése lehetőséget, majd válassza a Szolgáltatásfiók törlése lehetőséget a megerősítéshez. A szolgáltatásfiók törlése végleges, és a szolgáltatásfiókok nem állíthatók helyre a törlés után.

Azure CLI

Szolgáltatásfiók törléséhez futtassa a az grafana service-account delete parancsot. Cserélje le a helyőrzőket <azure-managed-grafana-name> és <service-account-name> a saját adatait.

az grafana service-account delete --name <azure-managed-grafana-name> --service-account <service-account-name>

Szolgáltatásfiók jogkivonatának törlése

Portál

Szolgáltatásfiók-jogkivonat törléséhez válasszon ki egy szolgáltatásfiókot, és a Jogkivonatok területen válassza a Törlés (x) lehetőséget. A megerősítéshez válassza a Törlés lehetőséget.

Azure CLI

Szolgáltatásfiók törléséhez futtassa a az grafana service-account token delete parancsot. Cserélje le a helyőrzőket <azure-managed-grafana-name>és <service-account-name> <token-name> a saját adatait.

az grafana service-account token delete --name <azure-managed-grafana-name> --service-account <service-account-name> --token <token-name>

Következő lépések

Ebben az útmutatóban megtanulta, hogyan hozhat létre és kezelhet szolgáltatásfiókokat és jogkivonatokat automatizált műveletek futtatásához az Azure Managed Grafana-ban. Ha készen áll, további cikkeket is megismerhet:

Zónaredundancia engedélyezése