Руководство по вызову API Grafana программным способом

В этом руководстве описано следующее:

• Назначение роли Управляемой Grafana Azure субъекту-службе приложения
• Получение сведений о приложении
• Получение маркера доступа.
• Вызов API Grafana

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

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Рабочая область Azure Managed Grafana. Создайте экземпляр Azure Managed Grafana.
• Приложение Microsoft Entra с субъектом-службой. Создайте приложение Microsoft Entra и субъект-службу. Для простоты используйте приложение, расположенное в том же клиенте Microsoft Entra, что и экземпляр Управляемой Grafana Azure.

Вход в Azure

Войдите на портал Azure по адресу https://portal.azure.com/ с помощью учетной записи Azure.

Назначение роли Управляемой Grafana Azure субъекту-службе приложения

1. В портал Azure откройте управляемый экземпляр Grafana.

2. Выберите элемент управления доступом (IAM) в меню навигации.

3. Щелкните Добавить и Добавить назначение роли.

4. Выберите роль редактора Grafana и нажмите кнопку "Далее".

5. В разделе "Назначение доступа" выберите "Пользователь", "Группа" или "Субъект-служба".

6. Выберите участников, выберите субъект-службу и нажмите кнопку "Выбрать".

7. Выберите Проверить + назначить.

   

Получение сведений о приложении

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

1. Найдите идентификатор клиента:

   1. В портал Azure введите идентификатор Microsoft Entra в ресурсах поиска, службах и документах (G+ /).
   2. Выберите Microsoft Entra ID.
   3. Выберите "Свойства " в меню слева.
   4. Найдите идентификатор клиента поля и сохраните его значение.

   

2. Найдите идентификатор клиента:

   1. В портал Azure в идентификаторе Microsoft Entra выберите Регистрация приложений в меню слева.
   2. Выберите приложение.
   3. В обзоре найдите поле идентификатора приложения (клиента) и сохраните его значение.

   

3. Создайте секрет приложения:

   1. В портал Azure в идентификаторе Microsoft Entra выберите Регистрация приложений в меню слева.
   2. Выберите приложение.
   3. Выберите сертификаты и секреты в меню слева.
   4. Щелкните Создать секрет клиента.
   5. Создайте секрет клиента и сохраните его значение.

   

   Примечание.

   Доступ к значению секрета можно получить только сразу после его создания. Скопируйте значение перед выходом страницы, чтобы использовать ее на следующем шаге этого руководства.

4. Найдите URL-адрес конечной точки Grafana:

   1. В портал Azure введите Управляемый Grafana Azure в строке поиска, служб и документов (G+ /).
   2. Выберите Azure Managed Grafana и откройте рабочую область Managed Grafana.
   3. Выберите "Обзор" в меню слева и сохраните значение конечной точки .

   

Получение маркера доступа.

Чтобы получить доступ к API Grafana, необходимо получить маркер доступа. Маркер доступа можно получить с помощью Azure CLI или запроса POST.

Azure CLI

Войдите в Azure CLI, выполнив команду az login и замените <client-id>, <client-secret>а также <tenant-id> идентификатором приложения (клиента), секретом клиента и идентификатором клиента, собранным на предыдущем шаге:

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

Используйте команду az grafana api-key create для создания ключа. Ниже представлен пример результата.

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

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

Примечание.

Этот ключ можно просмотреть только один раз. Сохраните его в безопасном месте.

ЗАПРОС POST

Выполните приведенный ниже пример, чтобы вызвать идентификатор Microsoft Entra и получить маркер. Замените <tenant-id>идентификатор <client-id><client-secret> клиента, идентификатор приложения (клиента) и секрет клиента, собранный на предыдущем шаге.

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

Ниже приведен пример ответа:

{
  "token_type": "Bearer",
  "expires_in": "599",
  "ext_expires_in": "599",
  "expires_on": "1575500555",
  "not_before": "1575499766",
  "resource": "ce34...1e4f",
  "access_token": "eyJ0eXAiOiJ......AARUQ"
}

Вызов API Grafana

Теперь вы можете вызвать API Grafana с помощью маркера доступа, полученного на предыдущем шаге в качестве заголовка авторизации. Например:

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

Замените <access-token> маркер доступа, <grafana-url> полученный на предыдущем шаге, и URL-адрес конечной точки экземпляра Grafana. Например, https://my-grafana-abcd.cuse.grafana.azure.com.

Очистка ресурсов

Если вы не собираетесь продолжать использовать эти ресурсы, удалите их с помощью следующих действий:

1. Удаление Управляемой Grafana Azure:

   1. В портал Azure в Управляемой Grafana Azure выберите "Обзор" в меню слева.
   2. Выберите команду Удалить.
   3. Введите имя ресурса, чтобы подтвердить удаление и нажмите кнопку "Удалить".

2. Удалите приложение Microsoft Entra:

   1. В портал Azure в идентификаторе Microsoft Entra выберите Регистрация приложений в меню слева.
   2. Выберите приложение.
   3. На вкладке "Обзор" нажмите кнопку "Удалить".
   4. Выберите команду Удалить.

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

Настройка источников данных