Grafana - Метрики, журналы и панели Grafana для агента

Когда звать

• Когда агенту нужно сопоставить панель Grafana с запросом к метрикам или журналам.
• Когда полный JSON панели слишком велик и нужны краткая сводка или отдельные поля через JSONPath.

Панель, метрика и журнал без ручной пересылки

Grafana MCP выпускается в организации grafana. Сервер подключает агента к экземпляру Grafana и его источникам данных. Можно найти панель по названию, получить краткую сводку, прочитать отдельные свойства или запросы её панелей. Для Prometheus предусмотрены запросы PromQL и метаданные метрик, для Loki - LogQL, метки и сведения о потоках журналов.

Весь JSON большой панели может занять значительную часть контекста. README советует начинать с get_dashboard_summary, а нужные поля получать через get_dashboard_property. Это позволяет сначала понять, какую панель агент нашёл, и только затем читать детали. Полная выгрузка панели не обязательна для проверки подключения.

Транспорт и сервисная учётная запись

Нужны GRAFANA_URL и токен сервисной учётной записи через GRAFANA_SERVICE_ACCOUNT_TOKEN. Права ограничиваются действиями и областями RBAC: доступ к одной панели не равен доступу ко всем источникам данных. Создавать для первого чтения административную учётную запись нет необходимости.

Доступны stdio, SSE и Streamable HTTP. Для локального клиента выбирайте stdio явно; контейнерный образ без переопределения транспорта может запускать SSE. Если сервер выставляют в сеть, аутентификация клиента к MCP задаётся отдельно от токена доступа к Grafana. README рекомендует MCP_GRAFANA_SERVER_TOKEN и TLS. Без настроенного токена текущая редакция может стартовать на сетевом адресе лишь с сообщением об ошибке безопасности, поэтому одного успешного запуска недостаточно.

Для полной функциональности требуется Grafana не ниже 9.0. Наличие источника Prometheus, Loki или другого плагина проверяют отдельно. Сервер не создаёт автоматически отсутствующие хранилища метрик и не превращает журналы в доказанную причину инцидента.

Первый запрос и ловушка SQL

Начните с --disable-write и ограниченной учётной записи. Попросите: «Найди указанную тестовую панель, покажи её краткую сводку и названия источников данных. Ничего не изменяй, не создавай снимки, уведомления и инциденты. Полный JSON панели не запрашивай». В ответе должны быть конкретная панель и её идентификатор, а не общее описание мониторинга.

У сырых SQL-инструментов есть отдельный риск: текст запроса может менять данные, если это позволяют учётные данные источника. Поэтому режим чтения удаляет такие инструменты. Не включайте их обратно через --enable-query, пока не проверены права самой базы. Для PromQL и LogQL действуют другие правила; выборка за большой период всё ещё способна создать нагрузку.

Журналы могут содержать личные данные и секреты приложения. Ограничивайте поток, период и объём ответа. Apache-2.0 лицензирует MCP, но не саму платформу Grafana и не облачный сервис. Источники закреплены и прочитаны 23 октября 2026 года. Установку, подключение к Grafana и реальные MCP-вызовы мы не выполняли.