Grafana
Документация GlaberGraph
Ресурсы для разработчиков
API Grafana
Справочное руководство по HTTP API Grafana
Authentication
Варианты аутентификации для HTTP API
Варианты аутентификации зависят от того, используете ли вы Grafana локально или Grafana Cloud.
О настройке организаций см. раздел Заголовок X-Grafana-Org-Id.
Варианты аутентификации в Grafana OSS/Enterprise
Вы можете аутентифицировать запросы к HTTP API с помощью basic-аутентификации или токена сервисной учётной записи.
Basic-аутентификация
Этот вариант доступен только в Grafana, установленной локально.
Basic-аутентификация включена по умолчанию и позволяет аутентифицировать ваш HTTP-запрос через стандартную basic-аутентификацию. Basic-аутентификация также аутентифицирует пользователей LDAP.
Например:
curl http://admin:admin@localhost:3000/api/org
{"id":1,"name":"Main Org."}Токен сервисной учётной записи
Чтобы создать токен сервисной учётной записи:
- Перейдите в раздел Administration в меню слева
- Нажмите Users and access > Service Accounts.
Дополнительные сведения об использовании токенов сервисных учётных записей см. в документации Сервисные учётные записи.
Этот токен указывается во всех запросах в заголовке Authorization, например:
GET http://your.grafana.com/api/dashboards/db/mydash HTTP/1.1
Accept: application/json
Authorization: Bearer <SERVICE_ACCOUNT_TOKEN>Значение заголовка Authorization должно быть Bearer <YOUR_SERVICE_ACCOUNT_TOKEN>.
Варианты аутентификации в Grafana Cloud
Чтобы использовать HTTP API, предоставляемый экземпляром Grafana Cloud, аутентифицируйте запросы токеном сервисной учётной записи.
Чтобы получить доступ к токенам своих сервисных учётных записей или создать их:
- Перейдите в раздел Administration в меню слева
- Нажмите Users and access > Service Accounts.
Подробности о создании сервисных учётных записей, назначении прав и добавлении токенов см. в разделе Сервисные учётные записи.
Указывайте токен сервисной учётной записи в заголовке Authorization для всех запросов к вашему экземпляру Grafana:
GET http://your.grafana.com/api/dashboards/db/mydash HTTP/1.1
Accept: application/json
Authorization: Bearer <SERVICE_ACCOUNT_TOKEN>Запросы к HTTP API аутентифицируются с помощью заголовка Authorization:
Authorization: Bearer <SERVICE ACCOUNT TOKEN>Заголовок X-Grafana-Org-Id
X-Grafana-Org-Id — это необязательное свойство, задающее организацию, к которой применяется действие. Если оно не задано, созданный ключ принадлежит организации текущего контекста. Используйте этот заголовок во всех запросах, кроме тех, что связаны с администрированием.
Пример запроса:
GET /api/org/ HTTP/1.1
Accept: application/json
Content-Type: application/json
X-Grafana-Org-Id: 2
Authorization: Bearer <SERVICE_ACCOUNT_TOKEN>