Что это
Grafana HTTP API - интерфейс автоматизации Grafana. Через него внешняя программа может работать с панелями, папками и другими доступными ресурсами. Это не самостоятельный ИИ-инструмент: интерпретацию метрик и решения нужно реализовать отдельно.
В документации Grafana 13 начинается переход от старых маршрутов /api к новой структуре /apis. Старые маршруты продолжают работать, но новые интеграции нужно сверять с версией сервера и актуальным справочником. Не все старые методы имеют прямой аналог.
Для ИИ-помощника начните с чтения через отдельную сервисную учетную запись. Получение ссылки на панель безопаснее автоматического изменения alert rules или настроек источников.
Ключевые параметры
- Категория: Оценка, мониторинг и evals
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Позволяет читать ресурсы без автоматизации браузерных кликов.
- Сервисный токен отделяет интеграцию от личного входа пользователя.
- Права учетной записи ограничивают допустимые операции.
- Программные операции можно включить в проверяемый процесс подготовки и применения конфигурации.
Ограничения
- Состав методов и форматы зависят от версии и редакции Grafana.
- Переход /api → /apis требует проверки каждого используемого метода.
- Токен наследует права учетной записи; избыточные права повышают риск изменения системы.
- Для записи и чтения телеметрии Grafana Cloud могут понадобиться другие учетные данные и API.
Как использовать
1. Подготовка. Запишите URL и версию тестового экземпляра Grafana, создайте одну учебную панель. Выберите только чтение, без редактирования правил и источников.
2. Настройка. Создайте отдельную service account с минимальными правами чтения и токеном с ограниченным сроком. Храните токен на сервере интеграции, не в браузерном коде.
3. Первый результат. По справочнику своей версии выберите поиск dashboard. Для совместимого legacy API проверьте GET /api/search?type=dash-db с заголовком Authorization: Bearer TOKEN. Найдите ID и название учебной панели.
4. Проверка. Сверьте найденное с интерфейсом Grafana и проверьте отказ для запрещенной операции. Для версии с /apis изучите новый маршрут, не заменяйте префикс механически. Отзовите учебный токен после теста.
Примеры сценариев
- Найти dashboard и включить внутреннюю ссылку в отчет.
- Прочитать описание панели для диагностики.
- Сверить наличие ожидаемой панели после развертывания.
Доступ и оплата
- Модель оплаты: Self-hosted
- Работа в РФ: Ограниченно
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Отдельной обязательной подписки именно на HTTP API нет для любого экземпляра. Условия определяются используемой Grafana. Токен Grafana service account не заменяет Cloud Access Policy для всех операций с телеметрией Cloud.
Когда не подходит
- Выдать агенту права администратора без необходимости
- Считать API панели полноценным хранилищем телеметрии
- Переносить методы между версиями без проверки
Альтернативы
Prometheus API работает с метриками своего сервера; OpenTelemetry помогает передавать телеметрию; интерфейс Grafana подходит для разовых действий вручную. Это разные способы решить часть задачи мониторинга.
