Szolgáltatásfiókok használata az Azure Managed Grafana-ban
Cikk
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
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.
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.
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.
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: .
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:
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.
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.
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ó.
A vissza nyíl jelre kattintva megtekintheti a Grafana-példány összes szolgáltatásfiókjának listáját.
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
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.
Szolgáltatásfiók-jogkivonat létrehozásához válassza a Jogkivonat hozzáadása lehetőséget.
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.
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.
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.
Új jogkivonat létrehozása
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, mh órákra, d napokra, w hetekre, M hónapokra vagy y évekre használható.
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:
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.
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
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>
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.
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 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.
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.
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:
