Использование учетных записей служб в Управляемой Grafana в Azure

В этом руководстве описано, как использовать учетные записи служб. Учетные записи служб используются для запуска автоматических операций и проверки подлинности приложений в Grafana с помощью API Grafana.

Типичные примеры такой ситуации:

• Подготовка или настройка панелей мониторинга
• Планирование отчетов
• Определение оповещений
• Настройка внешнего поставщика проверки подлинности SAML
• Взаимодействие с Grafana без входа в качестве пользователя

Необходимые компоненты

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Экземпляр Управляемой Grafana Azure. Если у вас еще нет этого экземпляра, создайте экземпляр Управляемой Grafana Azure.

Включение учетных записей служб

Если у существующей рабочей области Grafana нет учетных записей служб, включите их, обновив параметры предпочтения экземпляра Grafana с помощью портал Azure или Azure CLI.

Портал

1. В портал Azure в разделе "Параметры" выберите "Конфигурация", а затем в разделе "Ключи API" и "Учетные записи службы" нажмите кнопку "Включить".

   

2. Нажмите кнопку "Сохранить ", чтобы убедиться, что вы хотите включить ключи API и учетные записи служб в Управляемой Grafana Azure.

Azure CLI

1. Требуется расширение ИНТЕРФЕЙСА командной строки Azure Managed Grafana 0.3.0 или более поздней версии. Чтобы обновить расширение, выполните команду az extension update --name amg.

2. Выполните команду az grafana update, чтобы включить создание ключей API и учетных записей служб в существующем экземпляре Управляемой Grafana Azure. В приведенной ниже команде замените <azure-managed-grafana-name> имя экземпляра Azure Managed Grafana для обновления.

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

Создание учетной записи службы

Выполните следующие действия, чтобы создать новую учетную запись службы Grafana и перечислить существующие учетные записи службы:

Пользовательский интерфейс Grafana

1. Перейдите к конечной точке экземпляра Grafana, а затем выберите "Пользователи" и перейдите к>учетным записям служб в меню слева и добавьте учетную запись службы.

   

2. Введите отображаемое имя и роль для новой учетной записи службы Grafana из параметров "Нет основной роли", "Просмотр", "Редактор" или "Администратор" и нажмите кнопку "Создать". По умолчанию роль не назначается.

3. После создания учетной записи службы Grafana отображает сведения о новой учетной записи службы, включая дату его создания, существующие маркеры и разрешения, связанные с ним. Вы создадите первый маркер на следующем шаге.

4. При необходимости выберите учетные записи служб в меню слева, чтобы просмотреть список всех учетных записей служб в экземпляре Grafana.

Azure CLI

1. az grafana service-account create Выполните команду, чтобы создать учетную запись службы. Замените заполнители и <role> собственными сведениями.<azure-managed-grafana-name><service-account-name>

   Доступные роли: Admin, Editor, Viewer.

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

2. az grafana service-account list Выполните команду, чтобы получить список всех учетных записей служб, принадлежащих заданному экземпляру Управляемого Grafana Azure. Замените <azure-managed-grafana-name> именем рабочей области Azure Managed Grafana.

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

   Пример выходных данных:

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

3. az grafana service-account show Выполните команду, чтобы получить сведения об учетной записи службы. Замените <azure-managed-grafana-name> и <service-account-name> своими значениями.

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

Добавление маркера учетной записи службы

После создания учетной записи службы добавьте один или несколько маркеров доступа. Маркеры доступа создаются строки, используемые для проверки подлинности с помощью API Grafana без использования имени пользователя и пароля. Каждый маркер связан с определенными разрешениями, позволяя управлять уровнем доступа, предоставленным различным пользователям или приложениям. Маркеры можно создавать, управлять и отменять по мере необходимости.

Пользовательский интерфейс Grafana

В пользовательском интерфейсе Grafana:

1. Чтобы создать маркер учетной записи службы, выберите " Добавить маркер учетной записи службы".

2. Используйте автоматически созданное отображаемое имя или введите выбранное имя. По умолчанию срок действия устанавливается на один день после даты создания. При необходимости обновите указанную дату окончания срока действия или выберите "Нет срока действия".

   

3. Щелкните Создать маркер. Маркер отображается только один раз, поэтому не забудьте скопировать и сохранить его безопасно. Если вы потеряете этот маркер, вам потребуется создать новый.

4. Теперь маркер указан в сведениях учетной записи службы.

Azure CLI

В Azure CLI:

1. Создайте маркер учетной записи службы Grafana с az grafana service-account token createпомощью . Замените заполнители и <token-name> собственными сведениями.<azure-managed-grafana-name><service-account-name>

   При необходимости задайте время истечения срока действия:

   Параметр	Описание	Пример
   --time-to-live	По умолчанию маркеры имеют однодневное время истечения срока действия. При необходимости отключите или измените время истечения срока действия, чтобы отключить маркер после заданного времени. Используется s в течение секунд, m в течение минут, h в течение нескольких часов, d в течение нескольких w недель, M в течение нескольких месяцев или y в течение многих лет.	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. Запишите созданный маркер и сохраните его безопасно. Если вы потеряете этот маркер, вам потребуется создать новый.

3. az grafana service-account token list Выполните команду, чтобы получить список всех маркеров, принадлежащих данной учетной записи службы. Замените заполнители и <service-account-name> собственными сведениями<azure-managed-grafana-name>.

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

   Пример выходных данных:

   Created               Expiration            HasExpired    Name    SecondsUntilExpiration
   --------------------  --------------------  ------------  ------  ------------------------
   2024-11-05T15:09:24Z  2024-11-06T14:48:51Z  False         token1  84388.80530215
   

Изменение учетной записи службы

В этом разделе описано, как обновить учетную запись службы Grafana.

Пользовательский интерфейс Grafana

Действия:

• Чтобы изменить имя, выберите учетную запись службы и в разделе "Сведения " выберите "Изменить".
• Чтобы изменить роль, выберите учетную запись службы и в разделе "Сведения", выберите роль и выберите другое имя роли.
• Чтобы отключить учетную запись службы, выберите учетную запись службы и в верхней части страницы выберите "Отключить учетную запись службы", а затем выберите "Отключить учетную запись службы", чтобы подтвердить. Отключенные учетные записи служб можно повторно включить, выбрав включить учетную запись службы.

Учетная запись службы уведомлений обновляется мгновенно.

Azure CLI

Изменение учетной записи службы с az grafana service-account updateпомощью . Замените заполнители и собственными сведениями <azure-managed-grafana-name>и <service-account-name> используйте один или несколько следующих параметров:

Параметр	Описание
--is-disabled	Введите --is-disabled true отключить учетную запись службы или --is-disabled false включить учетную запись службы.
--name	Введите другое имя учетной записи службы.
--role	Введите другую роль для учетной записи службы. Доступные роли: Admin, Editor, Viewer.

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

Чтобы отключить учетную запись службы, выполните az grafana update команду и используйте этот параметр --is-disabled true. Чтобы включить учетную запись службы, используйте --is-disabled false.

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

Удаление учетной записи службы

Пользовательский интерфейс Grafana

Чтобы удалить учетную запись службы Grafana, выберите учетную запись службы и в верхней части страницы выберите "Удалить учетную запись службы", а затем выберите "Удалить учетную запись службы", чтобы подтвердить. Удаление учетной записи службы является окончательным, а учетная запись службы не может быть восстановлена после удаления.

Azure CLI

Чтобы удалить учетную запись службы, выполните az grafana service-account delete команду. Замените заполнители и <service-account-name> собственными сведениями<azure-managed-grafana-name>.

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

Удаление маркера учетной записи службы

Пользовательский интерфейс Grafana

Чтобы удалить маркер учетной записи службы, выберите учетную запись службы и в разделе "Маркеры", выберите "Удалить( x)". Выберите Удалить, чтобы подтвердить.

Azure CLI

Чтобы удалить учетную запись службы, выполните az grafana service-account token delete команду. Замените заполнители и <token-name> собственными сведениями.<azure-managed-grafana-name><service-account-name>

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

Следующие шаги

В этом руководстве вы узнали, как создавать учетные записи и маркеры служб и управлять ими для выполнения автоматизированных операций в Управляемой Grafana Azure. Когда вы будете готовы, ознакомьтесь с дополнительными статьями:

Включение избыточности зоны