Grafana MCP

Grafana MCP

от grafana
MCP сервер для интеграции с Grafana: управляйте дашбордами, выполняйте запросы к Prometheus, Loki, CloudWatch и другим источникам через MCP. Упрощает мониторинг, анализ метрик и логов — полезен для инженеров и DevOps.

Grafana MCP server

Unit Tests Integration Tests E2E Tests Go Reference MCP Catalog

A [Model Context Protocol][mcp] (MCP) server for Grafana.

This provides access to your Grafana instance and the surrounding ecosystem.

Quick Start

Requires uv. Add the following to your MCP client configuration (e.g. Claude Desktop, Cursor):

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": ["mcp-grafana"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      }
    }
  }
}

For Grafana Cloud, replace GRAFANA_URL with your instance URL (e.g. https://myinstance.grafana.net). See Usage for more installation options including Docker, binary, and Helm.

Requirements

  • Grafana version 9.0 or later is required for full functionality. Some features, particularly datasource-related operations, may not work correctly with earlier versions due to missing API endpoints.

Features

The following features are currently available in MCP server. This list is for informational purposes only and does not represent a roadmap or commitment to future features.

Часто задаваемые вопросы

Инструменты были проиндексированы:
add_activity_to_incident

Добавляет заметку (действие userNote) на временную шкалу существующего инцидента по его ID. Тело заметки может содержать URL-адреса, которые будут прикреплены в качестве контекста. Используйте это, чтобы добавить контекст к инциденту.

Параметры
  • bodystringобязательный

    Основная часть активности. URL-адреса будут проанализированы и прикреплены в качестве контекста.

  • eventTimestring

    Время, когда произошло действие. Если не указано, будет использовано текущее время.

  • incidentIdstringобязательный

    Идентификатор инцидента, к которому нужно добавить активность

alerting_manage_routingтолько чтениеидемпотентный

Управляет конфигурацией маршрутизации оповещений Grafana, включая политики уведомлений, точки контакта и временные интервалы. Политики уведомлений определяют, как группируются и маршрутизируются оповещения и какие точки контакта их получают. Временные интервалы задают периоды активности и отключения уведомлений об оповещениях. Когда использовать: - Понять, как оповещения маршрутизируются к точкам контакта/получателям - Отладить, почему оповещение ушло конкретному получателю - Проверить настройки группировки, времени или интервалов отключения Не показывает конфигурацию или состояние правил оповещений.

Параметры
  • contact_point_titlestring

    Заголовок точки контакта для получения (обязателен для операции get_contact_point)

  • datasource_uidstring

    Необязательный: UID источника данных, совместимого с Alertmanager, для запроса получателей. Если не указан, возвращает точки контакта, управляемые Grafana. Используется только с get_contact_points.

  • limitinteger

    Максимальное количество возвращаемых результатов. По умолчанию — 100. Используется только с get_contact_points.

  • namestring

    Фильтрует контактные точки по имени (точное совпадение). Используется только с get_contact_points.

  • operationenumобязательный

    Выполняемая операция: 'get_notification_policies' — получить дерево политик уведомлений, 'get_contact_points' — получить список всех контактных точек, 'get_contact_point' — получить конкретную контактную точку по имени, 'get_time_intervals' — получить список всех временных интервалов, 'get_time_interval' — получить конкретный временной интервал по имени.

  • time_interval_namestring

    Название временного интервала, который нужно получить (требуется для операции get_time_interval).

alerting_routing_write

Создаёт управляемые Grafana точки контакта для уведомлений об алертах с помощью операции 'create_contact_point'. Требует name, type и настройки, специфичные для интеграции. Возвращает uid, name и type без настроек и секретов. Точки контакта по умолчанию остаются редактируемыми в интерфейсе Grafana. Внешние получатели Alertmanager не поддерживаются. Не перечисляет и не просматривает существующие точки контакта.

Параметры
  • disable_provenanceboolean

    Оставляет точку контакта редактируемой в Grafana UI. По умолчанию true.

  • disable_resolve_messageboolean

    Отключает уведомления о решённых. По умолчанию false.

  • namestringобязательный

    Имя точки контакта. Интеграции с одинаковым именем группируются вместе.

  • operationenumобязательный

    Операция, которую нужно выполнить: 'create_contact_point'

  • settingsobjectобязательный

    Настройки конкретной интеграции в виде JSON-объекта (например, {"addresses":"team@example.com"} для email).

  • typestringобязательный

    Тип интеграции (например, email, slack или webhook).

  • uidstring

    Необязательный UID интеграции. Если его не указать, Grafana создаст его сама.

alerting_rules_readтолько чтениеидемпотентный

Выводит список и просматривает правила оповещений Grafana с возможностью фильтрации. Когда использовать: - Понять, почему оповещение срабатывает или не срабатывает - Проверить конфигурацию правил оповещений (запросы, условия, метки, настройки уведомлений) - Найти правила оповещений по состоянию, папке, группе или имени - Сравнить версии правил, чтобы увидеть, что изменилось Только чтение: не создаёт, не обновляет и не удаляет правила, а также не показывает маршрутизацию уведомлений.

Параметры
  • datasource_uidstring

    Необязательно: UID источника данных Prometheus или Loki для запроса правил алертов, управляемых источником данных. Если не указан, возвращает правила, управляемые Grafana.

  • folder_uidstring

    Фильтрует по точному UID папки (для операции 'list'). Взаимоисключает с search_folder.

  • label_selectorsstring[]

    Селекторы в стиле Prometheus для фильтрации правил оповещений по меткам. Каждая строка - это селектор, например '{severity="critical", team=~"backend.*"}'. Все селекторы должны совпадать (AND).

  • limit_alertsinteger

    Ограничение количества оповещений на правило. Для list: значение 0 исключает оповещения. Для get: значение <=0 по умолчанию равно 200. Максимум 200.

  • matchersstring[]

    Матчеры меток для фильтрации экземпляров алертов. Каждая строка — это матчер в стиле Prometheus, например: 'severity="critical"', 'env!="dev"', 'team=~"backend.*"'. Требуется Grafana 12.4+.

  • operationenumобязательный

    Операция для выполнения: 'list' ищет/фильтрует правила, 'get' получает полную информацию о правиле (состояние + конфигурация) по UID, или 'versions' получает историю версий правила

  • rule_groupstring

    Фильтрует по точному имени группы правил (для операции 'list')

  • rule_limitinteger

    Максимальное количество возвращаемых правил (по умолчанию 200, максимум 200). Требуется Grafana 12.4+ (для операции 'list')

  • rule_typeenum

    Фильтрует по типу правила (для операции 'list').

  • rule_uidstring

    UID правила алерта (обязателен для операций 'get' и 'versions')

  • search_folderstring

    Ищет папки по пути с частичным совпадением (для операции 'list'). Требует Grafana 12.4+. Взаимоисключающе с folder_uid.

  • search_rule_namestring

    Поиск имен/заголовков правил оповещений с использованием частичного совпадения. Требуется Grafana 12.4+ (для операции 'list').

  • statesstring[]

    Фильтр по состоянию оповещения: firing, pending, normal, recovering, nodata, error (для операции 'list')

alerting_rules_write

Создаёт, обновляет и удаляет правила алертов Grafana. Когда использовать: - при создании, обновлении или удалении правил алертов Операция 'update' заменяет правило целиком: она принимает все обязательные поля, а не только изменённые. Не выводит список и не просматривает правила, а также не управляет маршрутизацией уведомлений.

Параметры
  • annotationsobject

    Необязательные аннотации для правила оповещения.

  • conditionstring

    Идентификатор условия запроса, например 'A', 'B' (требуется для 'create', 'update')

  • dataobject[]

    Массив объектов запросов для алертов (обязательно для 'create'/'update'). Каждый объект содержит: datasourceUid (строка, обязательно), model (объект с expr для запросов данных или type/expression/conditions для выражений), refId (строка, назначается автоматически, если не указано), relativeTimeRange ({from, to} в секундах, по умолчанию {from:600,to:0}). Для серверных выражений используйте datasourceUid 'expr'. Пример: [{datasourceUid: 'prometheus', model: {expr: 'up == 0'}}, {datasourceUid: 'expr', model: {type: 'threshold', expression: 'A', conditions: [{evaluator: {type: 'gt', params: [0]}}]}}]

  • datasource_uidstring

    Необязательно: UID источника данных Prometheus или Loki, чтобы запросить правила оповещений, управляемые источником данных (для операции 'list').

  • disable_provenanceboolean

    Если true, оповещение остаётся редактируемым в интерфейсе Grafana (устанавливает заголовок X-Disable-Provenance). По умолчанию — true.

  • exec_err_statestring

    Состояние при ошибке выполнения: NoData, Alerting, OK (обязательно для 'create', 'update')

  • folder_uidstring

    Идентификатор папки. Для 'list': фильтрация по точному идентификатору папки (взаимоисключающе с search_folder). Для 'create'/'update': папка, в которой хранится правило (обязательно).

  • forstring

    Продолжительность до срабатывания оповещения, например '5m' (обязательно для 'create', 'update')

  • is_pausedboolean

    Если true, правило оповещения остается неактивным. По умолчанию — false.

  • keep_firing_forstring

    Включает непрерывное срабатывание оповещения в течение заданного времени, даже если условие больше не выполняется. По умолчанию — 0 (разрешается немедленно).

  • labelsobject

    Необязательные метки для правила оповещения

  • label_selectorsstring[]

    Селекторы в стиле Prometheus для фильтрации правил оповещений по меткам. Каждая строка - это селектор, например '{severity="critical", team=~"backend.*"}'. Все селекторы должны совпадать (AND).

  • limit_alertsinteger

    Ограничение количества оповещений на правило. Для list: значение 0 исключает оповещения. Для get: значение <=0 по умолчанию равно 200. Максимум 200.

  • matchersstring[]

    Матчеры меток для фильтрации экземпляров алертов. Каждая строка — это матчер в стиле Prometheus, например: 'severity="critical"', 'env!="dev"', 'team=~"backend.*"'. Требуется Grafana 12.4+.

  • missing_series_evals_to_resolveinteger

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

  • no_data_statestring

    Состояние при отсутствии данных: NoData, Alerting, OK (требуется для 'create', 'update')

  • notification_settingsobject

    Объект настроек уведомлений. Поля: receiver (string, обязательное), groupBy ([]string), groupWait/groupInterval/repeatInterval (строки длительности), muteTimeIntervals/activeTimeIntervals ([]string).

  • operationenumобязательный

    Операция для выполнения: 'list', 'get', 'versions', 'create', 'update' или 'delete'. Чтобы создать правило, используйте операцию 'create' и укажите все обязательные поля в одном вызове. Чтобы обновить правило, сначала используйте 'get' для получения его полной конфигурации, затем 'update' со всеми обязательными полями и вашими изменениями.

  • org_idinteger

    ID организации (требуется для 'create', 'update')

  • recordobject

    Конфигурация правила записи. Поля: from (string, обязательное - ID ссылки, например 'A'), metric (string, обязательное - имя метрики), targetDatasourceUid (string, необязательное).

  • rule_groupstring

    Имя группы правил (обязательно для 'create', 'update')

  • rule_limitinteger

    Максимальное количество возвращаемых правил (по умолчанию 200, максимум 200). Требуется Grafana 12.4+ (для операции 'list')

  • rule_typeenum

    Фильтрует по типу правила (для операции 'list').

  • rule_uidstring

    UID правила оповещения (обязателен для 'get', 'versions', 'update', 'delete'; необязателен для 'create')

  • search_folderstring

    Ищет папки по пути с частичным совпадением (для операции 'list'). Требует Grafana 12.4+. Взаимоисключающе с folder_uid.

  • search_rule_namestring

    Поиск имен/заголовков правил оповещений с использованием частичного совпадения. Требуется Grafana 12.4+ (для операции 'list').

  • statesstring[]

    Фильтр по состоянию оповещения: firing, pending, normal, recovering, nodata, error (для операции 'list')

  • titlestring

    Название правила оповещения (обязательно для 'create', 'update')

alerting_silences_readтолько чтениеидемпотентный

Перечисляет и просматривает silences оповещений Grafana. Silence временно подавляет уведомления для алертов, метки которых совпадают с набором матчеров. Операции: - 'list': перечисляет существующие silences. При необходимости фильтрует по rule_uid (совпадает с меткой alert_rule_uid) или по матчерам. - 'get': получает один silence по silence_id. Когда использовать: - Просмотр, какие алерты сейчас находятся в silence и почему Только чтение: не создаёт, не обновляет и не удаляет silences, а также не показывает правила алертов или маршрутизацию уведомлений.

Параметры
  • matchersobject[]

    Необязательные матчеры меток, которые фильтруют перечисленные silences. Используются только с 'list'.

  • operationenumобязательный

    Операция для выполнения: 'list' выводит список silences, 'get' получает silence по id.

  • rule_uidstring

    Необязательно: отфильтровать перечисленные тишины до тех, что относятся к этому UID правила оповещения (соответствует метке alert_rule_uid). Используется только с 'list'.

  • silence_idstring

    Идентификатор silence (обязателен для 'get')

alerting_silences_write

Создаёт, обновляет и удаляет silences в Grafana alerting. Silence временно подавляет уведомления для алертов, метки которых совпадают с набором matchers, не меняя сами правила алертов. Операции: - 'create': создаёт новый silence. Требует matchers, starts_at, ends_at (RFC3339) и comment. - 'update': изменяет существующий silence по silence_id. Требует matchers, starts_at, ends_at и comment. id сохраняется только когда переданные matchers и starts_at совпадают с сохранёнными, поэтому необходимо вернуть сохранённый starts_at этого silence; иначе Alertmanager помечает старый silence как истёкший и возвращает новый id. - 'delete': помечает как истёкший или удаляет silence по silence_id. Когда использовать: - Отключение уведомлений по шумным или ожидаемым алертам во время окон обслуживания Не перечисляет и не просматривает silences, не меняет правила алертов и не управляет маршрутизацией уведомлений.

Параметры
  • commentstring

    Понятный человеку комментарий, объясняющий причину молчания (обязателен для 'create' и 'update')

  • created_bystring

    Автор тишины. По умолчанию используется 'grafana-assistant'.

  • ends_atstring

    Время окончания тишины в формате RFC3339, например '2026-07-11T12:00:00Z' (обязательно для 'create' и 'update')

  • matchersobject[]

    Селекторы меток. Обязательны (хотя бы один) для операций 'create' и 'update'. Для 'list' используются как необязательный фильтр.

  • operationenumобязательный

    Выполняемая операция: 'list' для вывода списка тишины, 'get' для получения тишины по идентификатору, 'create' для создания новой тишины, 'update' для обновления существующей тишины по идентификатору, 'delete' для удаления тишины по идентификатору.

  • rule_uidstring

    Необязательно: отфильтровать перечисленные тишины до тех, что относятся к этому UID правила оповещения (соответствует метке alert_rule_uid). Используется только с 'list'.

  • silence_idstring

    Идентификатор (id) обязателен для операций 'get', 'update' и 'delete'.

  • starts_atstring

    Время начала тишины в формате RFC3339, например, '2026-07-11T10:00:00Z' (обязательно для 'create' и 'update'). Grafana ограничивает время начала в прошлом моментом создания, поэтому для 'update' передавайте обратно starts_at, возвращаемый 'get', чтобы идентификатор тишины оставался стабильным.

analyze_loki_labelsтолько чтениеидемпотентный

Аудирует стратегию меток Loki и опционально диагностирует производительность запросов. Возвращает вердикты по каждой метке, отсутствующие базовые метки, проблемы нормализации и рекомендуемый набор. Передайте datasourceUid для оценки мощности в реальном времени или метки для статической оценки; можно комбинировать.

Параметры
  • datasourceUidstring

    UID источника данных (активный режим).

  • endRfc3339string
  • expectedBaseLabelsstring[]
  • labelsobject[]

    Метки, предоставляемые вызывающим (статический режим).

  • maxLabelsinteger
  • perfMetricsobject

    Метрики времени выполнения; их наличие запускает диагностику производительности.

  • selectorstring

    Необязательный селектор LogQL для диагностики статистики и производительности.

  • startRfc3339string
check_datasources_healthтолько чтениеидемпотентный

Проверяет работоспособность источника данных. Фильтрует по типу или UID; если оба не указаны, проверяет все.

Параметры
  • offsetinteger

    Сколько пропустить при пагинации.

  • typestring

    Фильтр по типу плагина; если не указано — проверяет все.

  • uidsstring[]

    UID для проверки

create_annotation

Создает новую аннотацию на дашборде или панели. Устанавливает формат 'graphite' и предоставляет 'what' для аннотаций в формате Graphite.

Параметры
  • dashboardUidstring

    UID дашборда

  • dataobject

    Необязательная JSON-нагрузка

  • formatenum

    Установите значение 'graphite', чтобы создать аннотацию в формате Graphite.

  • graphiteDatastring

    Необязательная строковая полезная нагрузка для формата Graphite.

  • panelIdinteger

    ID панели

  • tagsstring[]

    Необязательный список тегов

  • textstring

    Текст аннотации (обязателен, если только формат не graphite)

  • timeinteger

    Время начала (эпоха, мс)

  • timeEndinteger

    Время окончания в миллисекундах с начала эпохи

  • whatstring

    Текст аннотации для формата Graphite (обязательно, когда формат — graphite)

  • wheninteger

    Временная метка в миллисекундах от эпохи для формата Graphite

create_datasource

Создаёт источник данных в два шага. При вызове только с type возвращает схему полей плагина и ничего не создаёт. При вызове с type, отображаемым именем в аргументе верхнего уровня name, schemaReviewed=true и значениями полей в карте fields создаёт источник данных. Плагин для указанного type уже должен быть установлен. Секреты (пароли, токены) не принимаются. Возвращает UID, проверку работоспособности и ссылку на страницу конфигурации.

Параметры
  • accessstring

    Как Grafana должна обращаться к источнику данных (через прокси или напрямую)

  • basicAuthboolean

    Должен ли Grafana использовать базовую аутентификацию.

  • databasestring

    Необязательное имя базы данных

  • fieldsobject

    Значения полей источника данных для настройки, сгруппированные по ключу поля из схемы, возвращённой при первом вызове. Сервер использует назначение каждого поля (root или jsonData), чтобы правильно разместить значения в YAML. Пример: {"url": "http://prometheus:9090", "httpMethod": "POST"}.

  • isDefaultboolean

    Должно ли это стать источником данных по умолчанию

  • namestringобязательный

    Отображаемое имя источника данных

  • schemaReviewedboolean

    True после получения схемы поля; требуется для создания источника данных на основе схемы.

  • typestringобязательный

    Тип плагина источника данных Grafana, например Prometheus.

  • urlstring

    Базовый URL источника данных, когда он требуется плагину.

  • withCredentialsboolean

    Должен ли Grafana пересылать учётные данные, например файлы cookie?

create_folder

Создаёт папку Grafana. Предоставляет заголовок и необязательный UID. Возвращает созданную папку.

Параметры
  • parentUidstring

    Необязательный UID родительской папки. Если задан, папка будет создана внутри этой родительской папки.

  • titlestringобязательный

    Название папки.

  • uidstring

    Необязательный UID папки. Если не указан, Grafana сгенерирует его.

create_incident

Создаёт новый инцидент Grafana. Требует title, severity и room prefix. Позволяет задавать status, labels и custom fields. Создание инцидента может разослать уведомления многим людям или поднять их по тревоге.

Параметры
  • attachCaptionstring

    Подпись к вложению

  • attachUrlstring

    URL вложения

  • customFieldsobject[]

    Значения настраиваемых полей, которые нужно задать для нового инцидента

  • isDrillboolean

    Является ли инцидент учебной тревогой

  • labelsobject[]

    Метки для добавления к инциденту

  • roomPrefixstringобязательный

    Префикс комнаты, в которой нужно создать инцидент

  • severitystringобязательный

    Серьёзность инцидента

  • statusstring

    Статус инцидента

  • titlestringобязательный

    Название инцидента

create_snapshot

Создаёт снимок Grafana из полной полезной нагрузки панели управления. Поддерживает опциональные поля срока действия и внешнего снимка.

Параметры
  • dashboardobjectобязательный

    Преобразует полную модель панели в снимок (в том виде, в котором возвращается API Grafana).

  • deleteKeystring

    Секретный ключ для удаления внешних снапшотов. Обязателен, когда external имеет значение true.

  • expiresinteger

    Срок действия снимка в секундах (например, 3600 для 1 часа)

  • externalboolean

    Сохраняет снапшот на внешнем сервере. Требует key и deleteKey, когда true.

  • keystring

    Пользовательский ключ снимка. Обязателен, когда external равно true.

  • namestring

    Необязательное имя снимка

delete_annotation

Безвозвратно удаляет аннотацию по ID. После этого аннотацию восстановить невозможно.

Параметры
  • idintegerобязательный

    ID аннотации для удаления.

delete_snapshot

Удаляет снимок Grafana по ключу снимка.

Параметры
  • keystringобязательный

    Ключ снимка для удаления

diff_tempo_tracesтолько чтениеидемпотентный

Сравнивает два полных трейса. Возвращает компактную сводку и включает полный патч на уровне спанов, если его размер не превышает 64 КиБ. Запрашивайте trace-patch-v0 только когда нужны полные детали; полные патчи не ограничены по размеру.

Параметры
  • base_endstring

    Необязательный конец диапазона поиска базового трейса в формате RFC3339. Должен быть указан вместе с base_start.

  • base_startstring

    Необязательное начало диапазона поиска базовых трейсов в формате RFC3339. Должно быть указано вместе с base_end.

  • base_trace_idstringобязательный

    Trace ID для базовой трассировки

  • compare_endstring

    Необязательный конец диапазона поиска трасс сравнения в формате RFC3339. Должен быть указан вместе с compare_start.

  • compare_startstring

    Необязательная начальная точка диапазона поиска по трассе сравнения в формате RFC3339. Обязательно указывается вместе с compare_end.

  • compare_trace_idstringобязательный

    Trace ID для трассировки сравнения

  • datasourceUidstringобязательный

    UID источника данных Tempo, к которому выполняется запрос

  • formatenum

    Формат вывода. Составной формат возвращает компактную сводку и прикрепляет полный патч, только если его размер не превышает 64 КиБ. trace-patch-v0 не даёт гарантий по размеру вывода.

generate_deeplink

Генерирует deeplink URL-адреса для ресурсов Grafana. Поддерживает дашборды (требуется dashboardUid или provisioningPreview), панели (требуется dashboardUid или provisioningPreview, плюс panelId) и запросы Explore (требуется datasourceUid и опционально queries). Для ссылок на дашборды и панели provisioningPreview указывает на дашборд, размещённый на ветке репозитория provisioning (например, предпросмотр PR git-sync). Для ссылок на explore временной диапазон и запросы встраиваются в состояние explore Grafana. Установите shorten=true, чтобы также попробовать короткую ссылку /goto/<uid>; если сокращение не удаётся, возвращается полный deeplink.

Параметры
  • dashboardUidstring

    UID панели (для сохранённых панелей). Взаимоисключающий с provisioningPreview для типов панелей и дашбордов.

  • datasourceUidstring

    Datasource UID (обязательно для типа explore)

  • panelIdinteger

    ID панели (обязательно для типа панели)

  • provisioningPreviewobject

    Идентифицирует дашборд, размещённый в ветке репозитория provisioning (например, предпросмотр PR git-sync). Взаимоисключающ с dashboardUid для типов дашбордов и панелей.

  • queriesobject[]

    Список объектов запроса для ссылок обзора (например, [{"refId":"A","expr":"up"}])

  • queryParamsobject

    Дополнительные параметры запроса URL (для типов дашбордов/панелей)

  • resourceTypestringобязательный

    Тип ресурса: дашборд, панель или исследование

  • shortenboolean

    Если true, попробуйте сократить сгенерированный URL до /goto/<uid>. Если сокращение не удалось, верните исходный диплинк.

  • timeRangeobject

    Временной диапазон для ссылки

get_alert_groupтолько чтениеидемпотентный

Получает конкретную группу оповещений из Grafana OnCall по её ID. Возвращает полные сведения о группе оповещений, включая последнее оповещение и его исходную полезную нагрузку, если API OnCall предоставляет эти данные. Полезные нагрузки оповещений содержат fingerprint'ы, специфичные для интеграции (например, payload.data.event.hashes у Sentry или payload.alerts[].fingerprint у Alertmanager), которые идентифицируют повторяющиеся оповещения в разных группах оповещений.

Параметры
  • alertGroupIdstringобязательный

    Идентификатор группы оповещений для получения.

get_annotationsтолько чтениеидемпотентный

Получает аннотации Grafana по фильтрам, таким как UID панели, временной диапазон и теги.

Параметры
  • alertUidstring

    Фильтр по UID оповещения

  • dashboardUidstring

    Фильтровать по UID дашборда

  • frominteger

    Время начала в миллисекундах от начала эпохи

  • limitinteger

    Максимум результатов, по умолчанию 100.

  • matchAnyboolean

    Если true, сопоставляется любой тег (OR). Если false, сопоставляются все теги (AND). По умолчанию: false

  • panelIdinteger

    Фильтр по ID панели

  • tagsstring[]

    Фильтруйте по тегам. Можно указать несколько тегов; используйте matchAny, чтобы управлять логикой И/ИЛИ.

  • tointeger

    Время окончания в мс от эпохи.

  • typestring

    Аннотация или предупреждение

  • userIdinteger

    Фильтровать по ID пользователя-создателя.

get_annotation_tagsтолько чтениеидемпотентный

Возвращает теги аннотаций с опциональной фильтрацией по имени тега. Применяются только предоставленные фильтры.

Параметры
  • limitinteger

    Максимум результатов, по умолчанию 100.

  • tagstring

    Необязательный фильтр по имени тега.

get_assertionsтолько чтениеидемпотентный

Получает сводку утверждений для заданной сущности с её типом, именем, окружением, сайтом, пространством имён и временным диапазоном.

Параметры
  • endTimestringобязательный

    Время окончания в формате RFC3339 (например, 2024-01-01T00:00:00Z) или в относительном формате (например, now)

  • entityNamestring

    Название сущности для перечисления.

  • entityTypestring

    Тип сущности для вывода списка (например, Service, Node, Pod и т.д.)

  • envstring

    Окружение (env) сущности для вывода списка

  • namespacestring

    Пространство имен сущности для перечисления

  • sitestring

    Сайт сущности для перечисления.

  • startTimestringобязательный

    Время начала в формате RFC3339 (например, 2024-01-01T00:00:00Z) или в относительном формате (например, now-1h)

get_current_oncall_usersтолько чтениеидемпотентный

Получает список пользователей, находящихся на дежурстве в данный момент для конкретного идентификатора расписания Grafana OnCall. Возвращает идентификатор расписания, название и список подробных объектов пользователей для тех, кто сейчас на дежурстве.

Параметры
  • scheduleIdstringобязательный

    Идентификатор расписания для получения текущих дежурных пользователей.

get_dashboard_by_uidтолько чтениеидемпотентный

Получает полный дашборд, включая панели, переменные и настройки, для конкретного дашборда, определяемого по UID. Передаёт необязательный version, чтобы загрузить сохранённый снимок вместо текущего дашборда. Сохранённые снимки загружаются через legacy versions API Grafana, поэтому 'apiVersion' опускается, а 'meta' приходит частично: заполняются только version, createdBy и created. Для текущих (неверсионных) загрузок ответ включает 'apiVersion' и 'isV2': когда 'isV2' имеет значение true, дашборд использует схему v2 (панели лежат в 'elements' с ключами по именам, упорядочены через 'layout'; переменные в 'variables'), иначе это классическая v1 ('panels[]' с 'templating.list'). Полный JSON большого дашборда может быть очень большим.

Параметры
  • uidstringобязательный

    UID дашборда.

  • versioninteger

    Необязательная сохранённая версия. Оставьте пустым для текущей панели управления.

get_dashboard_panel_queriesтолько чтениеидемпотентный

Получает запросы панелей из дашборда Grafana. Поддерживает все типы источников данных (Prometheus, Loki, CloudWatch, SQL и т.д.) и панели, вложенные в строки. Опционально фильтрует по конкретной панели, указывая её ID в panelId. Опционально принимает variables для подстановки переменных шаблона, что заполняет поля processedQuery и requiredVariables. Возвращает массив объектов с полями: title, query (исходное выражение), datasource (объект с uid и type), и опционально processedQuery, refId, requiredVariables и target. Цели, построенные в визуальном редакторе (поиск метрик CloudWatch, конструктор запросов InfluxDB), не имеют строкового выражения: они возвращают пустой query плюс target, исходный JSON запроса панели. Их можно выполнять как запросы панелей, но не как отдельные выражения.

Параметры
  • panelIdinteger

    Необязательный ID панели для фильтрации до конкретной панели.

  • uidstringобязательный

    UID дашборда.

  • variablesobject

    Необязательные подстановки переменных (например, {"job": "api-server"})

get_dashboard_propertyтолько чтениеидемпотентный

Получает отдельные части дашборда с помощью выражений JSONPath, чтобы сократить расход контекстного окна. JSONPath работает с собственной схемой дашборда. Классические пути v1: '$.title' (заголовок), '$.panels[].title' (заголовки всех панелей), '$.panels[0]' (первая панель), '$.templating.list' (переменные), '$.annotations.list' (сохранённые запросы/определения аннотаций дашборда), '$.tags' (теги), '$.panels[].targets[*].expr' (все запросы). Дашборды v2 (isV2 true) используют другие пути: '$.title', '$.elements' (панели, с ключом по имени), '$.variables' (переменные), '$.annotations'.

Параметры
  • jsonPathstringобязательный

    Выражение JSONPath для извлечения конкретных данных (например, '$.panels[0].title' для заголовка первой панели, '$.panels[*].title' для заголовков всех панелей, '$.templating.list' для переменных, '$.annotations.list' для запросов/определений аннотаций сохранённой панели).

  • uidstringобязательный

    UID дашборда.

get_dashboard_summaryтолько чтениеидемпотентный

Получает компактную сводку дашборда, включая заголовок, количество панелей, типы панелей, переменные и другие метаданные, без полного JSON. Используется для обзора дашборда и планирования изменений, не расходуя большие контекстные окна.

Параметры
  • uidstringобязательный

    UID дашборда.

get_datasourceтолько чтениеидемпотентный

Извлекает подробную информацию о конкретном источнике данных по UID или имени. Возвращает полную модель источника данных, включая имя, тип, URL, настройки доступа, JSON-данные и статус защищённого JSON-поля. Укажите uid или имя; uid имеет приоритет, если указаны оба.

Параметры
  • namestring

    Название источника данных. Используется, если UID не указан.

  • uidstring

    UID источника данных. Если указан, имеет приоритет над именем.

get_docтолько чтениеидемпотентныйвнешний мир

Получите страницу документации Grafana. Сначала установите outline_only=true, чтобы получить структуру заголовков, затем вызовите снова с названием раздела для ограниченного получения.

Параметры
  • limitinteger

    Максимальное количество строк для возврата (по умолчанию ~80)

  • offsetinteger

    Смещение строки для пагинации (индексация с нуля).

  • outline_onlyboolean

    Возвращает только план заголовков (используется для определения названий разделов перед получением содержимого).

  • sectionstring

    Заголовок для извлечения (возвращает только этот раздел).

  • urlstringобязательный

    URL-адрес grafana.com/docs/ для получения

get_incidentтолько чтениеидемпотентный
Параметры
  • idstringобязательный

    ID инцидента, который нужно получить.

get_oncall_shiftтолько чтениеидемпотентный

Получает подробную информацию о конкретной смене Grafana OnCall по её ID. Смена означает заданный период времени в расписании, когда пользователи активно дежурят. Возвращает полные детали смены.

Параметры
  • shiftIdstringобязательный

    ID смены, для которой нужно получить подробности.

get_panel_imageтолько чтениеидемпотентный

Отрисовывает панель дашборда Grafana, весь дашборд или представление Explore в виде PNG-изображения. Возвращает изображение в виде данных, закодированных в base64. Требует установленной службы Grafana Image Renderer. Нужно указать ровно один из параметров: dashboardUid (для сохранённых дашбордов), provisioningPreview (для дашбордов, подготовленных в ветке репозитория провижининга, например в PR git-sync) или explore (ad-hoc-запрос к источнику данных, отрисованный в Explore, сохранённый дашборд не нужен). Используйте этот инструмент для создания визуальных снимков дашбордов для отчётов, алертов или презентаций.

Параметры
  • dashboardUidstring

    UID сохранённого dashboard, содержащего panel. Обязателен, если не указан provisioningPreview.

  • exploreobject

    Отображает временное представление Explore для источника данных и запросов вместо сохранённого дашборда. Взаимоисключающий с dashboardUid и provisioningPreview. Требует Grafana 10.2 или новее.

  • heightinteger

    Высота отрисованного изображения в пикселях. По умолчанию: 500 (1000 для explore).

  • panelIdinteger

    ID панели для отображения. Если не указан, отображается вся панель мониторинга.

  • provisioningPreviewobject

    Отрисовывает дашборд из ветки репозитория provisioning (например, превью PR в git-sync). Взаимоисключающе с dashboardUid.

  • scaleinteger

    Коэффициент масштабирования изображения (1-3). По умолчанию равен 1.

  • themestring

    Тема для сгенерированного изображения: light или dark. По умолчанию: dark

  • timeoutinteger

    Таймаут рендеринга в секундах. По умолчанию — 60.

  • timeRangeobject

    Временной диапазон отрендеренного изображения

  • variablesobject

    Применяемые переменные панели. Значения могут быть одной строкой или массивом строк для многозначных переменных (например, {"var-datasource": "prometheus", "var-instance": ["server1", "server2"]}).

  • widthinteger

    Ширина отображаемого изображения в пикселях. По умолчанию — 1000.

get_pluginтолько чтениеидемпотентный

Проверяет, установлен ли плагин Grafana, и получает его сведения (название, версия, тип, статус включения). Возвращает installed=false, когда плагин не найден.

Параметры
  • pluginIdstringобязательный

    Идентификатор плагина для проверки (например, 'prometheus', 'grafana-piechart-panel', 'grafana-oncall-app')

get_snapshotтолько чтениеидемпотентный

Получить Grafana snapshot по ключу, включая метаданные snapshot и полезную нагрузку дашборда.

Параметры
  • keystringобязательный

    Ключ для извлечения снапшота

get_tempo_traceтолько чтениеидемпотентный

Получает конкретный трейс по ID.

Параметры
  • datasourceUidstringобязательный

    UID источника данных Tempo, к которому выполняется запрос

  • focus_span_idstring

    Необязательный 16-символьный шестнадцатеричный span ID для первоначального выбора. Полная трассировка остаётся доступной.

  • trace_idstringобязательный

    Trace ID для получения

get_tempo_traceql_docsтолько чтениеидемпотентный

Получает справочную документацию TraceQL с примерами, охватывающую фильтры атрибутов, агрегаты, структурные операторы и метрические запросы. Обращайтесь к ней перед написанием нетривиального запроса TraceQL или после того, как запрос вернул ошибку или не дал результатов.

Параметры
  • topicenumобязательный

    Какой раздел справочника TraceQL получить: 'basic' для фильтров по атрибутам и длительности, 'aggregates' для группировки count/avg/sum и by(), 'structural' для операторов parent/child и descendant, 'metrics' для метрических запросов rate/quantile_over_time.

grafana_api_request

Выполняет аутентифицированный HTTP-запрос к Grafana API. Аналогично 'gh api' для GitHub. Поддерживает любой эндпоинт Grafana API с опциональной фильтрацией ответа в стиле jq. Используется для эндпоинтов API, для которых нет специального инструмента.

Параметры
  • bodystring

    Тело запроса (JSON-строка). Используется с запросами POST, PUT и PATCH.

  • endpointstringобязательный

    Путь API относительно базового URL Grafana (например, '/api/org', '/api/dashboards/uid/abc123'). Должен начинаться с '/'.

  • headersobject

    Дополнительные HTTP-заголовки, которые нужно включить в запрос.

  • jqstring

    jq-выражение для фильтрации или преобразования JSON-ответа (например, '.dashboards[] | .title').

  • methodenum

    HTTP-метод. По умолчанию используется GET.

install_pluginвнешний мир

Устанавливает плагин Grafana по идентификатору плагина. Если версия не указана, инструмент находит последнюю версию и возвращает её без установки; если версия указана, устанавливает именно её.

Параметры
  • pluginIdstringобязательный

    Идентификатор плагина для установки (например, 'grafana-image-renderer', 'grafana-piechart-panel')

  • versionstring

    Точная версия для установки. Если не указать, инструмент возвращает последнюю доступную версию, ничего не устанавливая.

list_alert_groupsтолько чтениеидемпотентный

Выводит список групп оповещений из Grafana OnCall с возможностью фильтрации. Поддерживает фильтрацию по ID группы оповещений, ID маршрута, ID интеграции, состоянию (new, acknowledged, resolved, silenced), ID команды, временному диапазону, меткам и имени. Для временных диапазонов используйте формат '{start}_{end}': диапазон временных меток ISO 8601 (например, '2025-01-19T00:00:00_2025-01-19T23:59:59' для конкретного дня). Для меток используйте формат 'key:value' (например, ['env:prod', 'severity:high']). Возвращает список объектов групп оповещений с их деталями. Поддерживает пагинацию.

Параметры
  • idstring

    Фильтровать по конкретному ID группы оповещений

  • integrationIdstring

    Фильтр по ID интеграции

  • labelsstring[]

    Фильтрует по меткам в формате ключ:значение (например, ['env:prod', 'severity:high']).

  • namestring

    Фильтровать по имени группы оповещений

  • pageinteger

    Номер страницы для возврата

  • routeIdstring

    Фильтровать по идентификатору маршрута

  • startedAtstring

    Фильтровать по диапазону времени в формате '{start}_{end}' диапазон временных меток ISO 8601 (подразумевается UTC, индикатор часового пояса не нужен) (например, '2025-01-19T00:00:00_2025-01-19T23:59:59')

  • statestring

    Фильтровать по состоянию группы оповещений (одно из: новое, подтверждено, решено, заглушено)

  • teamIdstring

    Фильтрует по ID команды.

list_dashboard_versionsтолько чтениеидемпотентный

Выводит список сохранённых версий дашборда Grafana. Возвращает компактные метаданные: номер версии, автора, метку времени и сообщение о сохранении. Номер версии можно передать в запрос дашборда, чтобы загрузить этот снимок.

Параметры
  • limitinteger

    Максимальное количество возвращаемых версий.

  • startinteger

    Версия, с которой начинать. Возвращаются только версии, не превышающие это число.

  • uidstringобязательный

    UID дашборда.

list_datasourcesтолько чтениеидемпотентный

Перечисляет все настроенные источники данных в Grafana. Позволяет обнаружить доступные источники данных и их UID. Поддерживает фильтрацию по типу и/или имени (совпадение подстроки без учёта регистра) и постраничный вывод.

Параметры
  • limitinteger

    Максимальное число возвращаемых источников данных (не более 100).

  • namestring

    Регистронезависимый поиск подстроки в имени источника данных. Например, 'prod' находит источники данных с именами 'prometheus-prod-eu' и 'loki-prod-us'. Полезно на инстансах с большим количеством источников данных, где фильтрация только по типу возвращает слишком много результатов.

  • offsetinteger

    Сколько источников данных пропустить при пагинации.

  • typestring

    Тип источников данных для поиска. Например, 'prometheus', 'loki', 'tempo' и так далее...

list_incident_custom_fieldsтолько чтениеидемпотентный

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

Параметры
  • includeArchivedboolean

    Включать ли архивные настраиваемые поля. Архивные поля нельзя задать для новых инцидентов, но они могут по-прежнему содержать значения для более старых.

list_incidentsтолько чтениеидемпотентный

Получает список инцидентов Grafana. Позволяет фильтровать по статусу ('active', 'resolved') и опционально включать связанные инциденты. Возвращает предварительный список с основными деталями, а также значения настраиваемых полей по запросу.

Параметры
  • drillboolean

    Включать ли инциденты на учениях

  • includeCustomFieldsboolean

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

  • limitinteger

    Максимальное количество возвращаемых инцидентов.

  • statusstring

    Статус инцидентов для включения. Допустимые значения: 'active', 'resolved'

list_loki_label_namesтолько чтениеидемпотентный

Перечисляет все доступные имена меток/полей (ключи), встречающиеся в логах в указанном источнике данных Loki или VictoriaLogs за указанный временной диапазон. Возвращает список уникальных строк меток (например, ["app", "env", "pod"]). Если временной диапазон не указан, по умолчанию используется последний час. При желании сузьте поиск до подмножества потоков с помощью matcher (например, {namespace="prod"}).

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • endRfc3339string

    Необязательно: время окончания запроса в формате RFC3339 или относительное время (например, 'now') (по умолчанию — now)

  • matcherstring

    Опционально селектор потоков для сужения поиска до соответствующих потоков (Loki: LogQL, например '{namespace="prod"}'; VictoriaLogs: LogsQL). По умолчанию поиск выполняется по всем потокам.

  • startRfc3339string

    Необязательно: время начала запроса в формате RFC3339 или относительное время (например, 'now-1h') (по умолчанию — 1 час назад).

list_loki_label_valuesтолько чтениеидемпотентный

Получает все уникальные значения для конкретного labelName в пределах источника данных Loki или VictoriaLogs и временного диапазона. Возвращает список строковых значений (например, для labelName="env" может вернуть ["prod", "staging", "dev"]). Помогает находить варианты фильтров. По умолчанию использует последний час, если временной диапазон не указан. При желании поиск можно сузить до подмножества потоков с помощью matcher (например, {namespace="prod"}), к примеру, чтобы перечислить значения service, встречающиеся только в конкретном namespace.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • endRfc3339string

    Необязательно: время окончания запроса в формате RFC3339 или относительное время (например, 'now') (по умолчанию — now)

  • labelNamestringобязательный

    Имя метки для получения значений (например, 'app', 'env', 'pod')

  • matcherstring

    Опционально селектор потоков для сужения поиска до соответствующих потоков (Loki: LogQL, например '{namespace="prod"}'; VictoriaLogs: LogsQL). По умолчанию поиск выполняется по всем потокам.

  • startRfc3339string

    Необязательно: время начала запроса в формате RFC3339 или относительное время (например, 'now-1h') (по умолчанию — 1 час назад).

list_oncall_schedulesтолько чтениеидемпотентный

Выводит расписания Grafana OnCall с возможностью фильтрации по ID команды. Если указан конкретный ID расписания, возвращает данные только по нему. Возвращает список сводок расписаний: ID, название, ID команды, часовой пояс и ID смен. Поддерживает постраничную навигацию.

Параметры
  • pageinteger

    Номер страницы для возврата (с отсчётом от 1)

  • scheduleIdstring

    Идентификатор расписания, для которого нужно получить сведения. Если указан, возвращает только сведения об этом расписании.

  • teamIdstring

    Идентификатор команды, для которой нужно получить список расписаний.

list_oncall_teamsтолько чтениеидемпотентный

Выводит список команд, настроенных в Grafana OnCall. Возвращает список объектов команд с их деталями. Поддерживает пагинацию.

Параметры
  • pageinteger

    Номер страницы для возврата

list_oncall_usersтолько чтениеидемпотентный

Выводит список пользователей из Grafana OnCall. Это пользователи OnCall (отдельные от пользователей Grafana). Можно получить всех пользователей в каталоге OnCall, конкретного пользователя по ID или отфильтровать по имени пользователя. Возвращает список объектов пользователей с их деталями. Поддерживает пагинацию.

Параметры
  • pageinteger

    Номер страницы для возврата

  • userIdstring

    Идентификатор пользователя, чьи данные нужно получить. Если указан, возвращает только данные этого пользователя.

  • usernamestring

    Имя пользователя для фильтрации пользователей. Если указано, возвращает только пользователя, соответствующего этому имени пользователя.

list_prometheus_label_namesтолько чтениеидемпотентный

Выводит имена меток (label names) в источнике данных, совместимом с PromQL (Prometheus, Thanos, Mimir, Cloud Monitoring и т.д.). Поддерживает фильтрацию по селекторам рядов и временному диапазону.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • endRfc3339string

    Необязательно. Конечное время временного диапазона для фильтрации результатов. Поддерживает RFC3339 или относительное время (например, 'now').

  • limitinteger

    Необязательно: максимальное количество результатов для возврата.

  • matchesobject[]

    Необязательно: список сопоставителей меток для фильтрации результатов.

  • projectNamestring

    Имя проекта GCP для запроса (только для источников данных Cloud Monitoring). Переопределяет или заменяет defaultProject, настроенный в источнике данных.

  • startRfc3339string

    Указывает время начала диапазона для фильтрации результатов. Поддерживает формат RFC3339 или относительное время (например, 'now-1h').

list_prometheus_label_valuesтолько чтениеидемпотентный

Получает значения для конкретного имени метки в источнике данных, совместимом с PromQL (Prometheus, Thanos, Mimir, Cloud Monitoring и т. д.). Позволяет фильтровать по селекторам серий и временному диапазону.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • endRfc3339string

    Опционально, время окончания запроса. Поддерживает RFC3339 или относительное время (например, 'now').

  • labelNamestringобязательный

    Название метки для запроса.

  • limitinteger

    Необязательно: максимальное количество результатов для возврата.

  • matchesobject[]

    Необязательно, список селекторов для фильтрации результатов.

  • projectNamestring

    Имя проекта GCP для запроса (только для источников данных Cloud Monitoring). Переопределяет или заменяет defaultProject, настроенный в источнике данных.

  • startRfc3339string

    Опционально, время начала запроса. Поддерживает RFC3339 или относительное время (например, 'now-1h').

list_prometheus_metric_metadataтолько чтениеидемпотентный

Выводит метаданные метрик Prometheus. Возвращает метаданные о метриках, которые в данный момент собираются с целей. Примечание: этот endpoint экспериментальный.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • limitinteger

    Максимальное количество возвращаемых метрик

  • limitPerMetricinteger

    Максимальное количество метрик, возвращаемых на метрику.

  • metricstring

    Метрика для запроса

  • projectNamestring

    Имя проекта GCP для запроса (только для источников данных Cloud Monitoring). Переопределяет или заменяет defaultProject, настроенный в источнике данных.

list_prometheus_metric_namesтолько чтениеидемпотентный

Перечисляет имена метрик в источнике данных, совместимом с PromQL (Prometheus, Thanos, Mimir, Cloud Monitoring и т. д.). Фильтрует имена метрик по заданному регулярному выражению. Поддерживает постраничную навигацию (page * limit не должен превышать 10000) и необязательный временной диапазон, чтобы ограничить результаты метриками, активными в этом окне. Cloud Monitoring игнорирует временной диапазон.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • endRfc3339string

    Необязательно. Конечное время временного диапазона для фильтрации результатов. Поддерживает RFC3339 или относительное время (например, 'now').

  • limitinteger

    Максимальное количество возвращаемых результатов

  • pageinteger

    Номер страницы для возврата

  • projectNamestring

    Имя проекта GCP для запроса (только для источников данных Cloud Monitoring). Переопределяет или заменяет defaultProject, настроенный в источнике данных.

  • regexstring

    Регулярное выражение для сопоставления с именами метрик.

  • startRfc3339string

    Указывает время начала диапазона для фильтрации результатов. Поддерживает формат RFC3339 или относительное время (например, 'now-1h').

list_provisioning_repositoriesтолько чтениеидемпотентный

Перечисляет репозитории провижининга (например, источники git-sync), настроенные для этого экземпляра Grafana. Возвращает slug каждого репозитория вместе с URL источника, веткой, путём, состоянием синхронизации и работоспособностью. name - slug, которым рендерятся предпросмотры ещё не применённых дашбордов.

Параметры

Без параметров.

list_pyroscope_label_namesтолько чтениеидемпотентный

Перечисляет все доступные имена меток (ключи), найденные в профилях в указанном источнике данных Pyroscope, временном диапазоне и при наличии — в метках-фильтрах. Метки-фильтры обычно используются для уточнения имени сервиса ({service_name="foo"}). Возвращает список уникальных строк меток (например, ["app", "env", "pod"]). Имена меток с двойным подчёркиванием (например, name) являются внутренними и редко полезны пользователям. Если временной диапазон не указан, по умолчанию берётся последний час.

Параметры
  • data_source_uidstringобязательный

    UID источника данных для запроса

  • end_rfc_3339string

    Необязательно: время окончания запроса в формате RFC3339 или относительное время (например, 'now') (по умолчанию — now)

  • matchersstring
  • start_rfc_3339string

    Необязательно: время начала запроса в формате RFC3339 или относительное время (например, 'now-1h') (по умолчанию — 1 час назад).

list_pyroscope_label_valuesтолько чтениеидемпотентный

Выводит все доступные значения меток для указанного имени метки, найденные в профилях в заданном источнике данных Pyroscope, временном диапазоне и с опциональными фильтрами меток (label matchers). Фильтры меток обычно уточняют имя сервиса ({service_name="foo"}). Возвращает список уникальных строк меток (например, для имени метки "env": ["dev", "staging", "prod"]). Если временной диапазон не указан, по умолчанию используется последний час.

Параметры
  • data_source_uidstringобязательный

    UID источника данных для запроса

  • end_rfc_3339string

    Необязательно: время окончания запроса в формате RFC3339 или относительное время (например, 'now') (по умолчанию — now)

  • matchersstring

    Опционально, матчеры в стиле Prometheus, которые фильтруют набор результатов (по умолчанию: {})

  • namestringобязательный

    Имя метки

  • start_rfc_3339string

    Необязательно: время начала запроса в формате RFC3339 или относительное время (например, 'now-1h') (по умолчанию — 1 час назад).

list_pyroscope_profile_typesтолько чтениеидемпотентный

Перечисляет все доступные типы профилей в указанном источнике данных Pyroscope и временном диапазоне. Возвращает список всех доступных типов профилей (пример типа профиля: "process_cpu:cpu:nanoseconds:cpu:nanoseconds"). Тип профиля имеет следующую структуру: <name>:<sample type>:<sample unit>:<period type>:<period unit>. Не все типы профилей доступны для каждого сервиса. Если временной диапазон не указан, по умолчанию используется последний час.

Параметры
  • data_source_uidstringобязательный

    UID источника данных для запроса

  • end_rfc_3339string

    Необязательно: время окончания запроса в формате RFC3339 или относительное время (например, 'now') (по умолчанию — now)

  • start_rfc_3339string

    Необязательно: время начала запроса в формате RFC3339 или относительное время (например, 'now-1h') (по умолчанию — 1 час назад).

list_snapshotsтолько чтениеидемпотентный

Вывести список снимков дашбордов Grafana с необязательными фильтрами по запросу и лимиту результатов.

Параметры
  • limitinteger

    Максимальное количество возвращаемых снимков (Grafana по умолчанию использует 1000, если параметр не указан)

  • querystring

    Необязательный поисковый запрос по имени снимка.

list_tempo_attribute_namesтолько чтениеидемпотентный

Выводит список доступных имён атрибутов для запросов TraceQL. Без области видимости (resource, span и т.д.) ответ может быть очень большим.

Параметры
  • datasourceUidstringобязательный

    UID источника данных Tempo, к которому выполняется запрос

  • scopestring

    Scope для фильтрации атрибутов по (span, resource, event, link, instrumentation). Настоятельно рекомендуется указывать: если опустить scope, вернутся все атрибуты по всем scope, а это может быть очень большим (100K+ символов).

list_tempo_attribute_valuesтолько чтениеидемпотентный

Выводит список значений для полностью заданного имени атрибута (например, resource.service.name). Помогает выяснить, какие значения существуют для конкретного атрибута.

Параметры
  • datasourceUidstringобязательный

    UID источника данных Tempo, к которому выполняется запрос

  • filter-querystring

    Фильтрующий запрос, применяемый к значениям атрибутов. Он может содержать только один spanset и только условия, объединённые через &&, например { <условие> && <условие> && ... }. Это полезно для фильтрации значений до конкретного набора значений.

  • namestringобязательный

    Имя атрибута, для которого нужно получить значения (например, 'span.http.method', 'resource.service.name')

query_loki_logsтолько чтениеидемпотентный

Выполняет запрос логов к источнику данных Loki или VictoriaLogs и возвращает подходящие записи логов (или сэмплы метрик в Loki). По умолчанию берёт последний час, лимит в 10 записей и направление 'backward' (сначала новые). Параметр logql принимает LogQL в Loki и LogsQL в VictoriaLogs (например, Loki: {app="foo"} |= "error"; VictoriaLogs: {app="foo"} "error"). Чтобы точно посчитать подходящие строки логов, используйте метрический запрос с count_over_time() и queryType='instant'. Для широких запросов, которые захватывают много строк, поставьте format в 'compact', чтобы сгруппировать результаты по потокам и не повторять метаданные меток в каждой строке. Если на этом сервере включён ограничитель затрат Loki, дорогие запросы отклоняются до выполнения: стоимость запроса - это байты SCANNED, и определяют её только селектор потока и временной диапазон. Фильтры по строкам (|=) и парсеры (| json) сокращают то, что возвращается, а не то, что сканируется. Используйте селектор потока хотя бы с одним избирательным положительным сопоставителем метки (никогда {}, =~".*"/=~".+" или сопоставители только с отрицанием), держите временные диапазоны узкими; отклонённые запросы возвращают рекомендации по переписыванию.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • directionstring

    Необязательно: направление запроса: 'forward' (сначала старые) или 'backward' (сначала новые, по умолчанию)

  • endRfc3339string

    Необязательно: время окончания запроса в формате RFC3339 или относительное время (например, 'now')

  • formatenum

    Формат вывода для запросов к журналам (потокам): 'full' (по умолчанию) возвращает каждую запись с собственными метаданными меток; 'compact' группирует строки по потокам, поэтому каждый набор меток выводится только один раз, что существенно уменьшает размер ответа для широких запросов. Ключи структурированных метаданных, постоянные в пределах потока, выводятся один раз в заголовке потока; ключи, различающиеся между строками, выводятся для каждой строки отдельно. Игнорируется для запросов к метрикам.

  • limitinteger

    Опционально, максимальное количество строк журнала для возврата (по умолчанию: 100, настраивается MCP-сервером).

  • logqlstringобязательный

    Запрос LogQL, который нужно выполнить к Loki. Это может быть простой матчер меток или сложный запрос с фильтрами, парсерами и выражениями. Поддерживает полный синтаксис LogQL, включая матчеры меток, операторы фильтрации, паттерн-выражения и конвейерные операции.

  • queryTypestring

    Тип запроса: 'range' (по умолчанию) или 'instant'. Мгновенные запросы возвращают одно значение в конкретный момент времени. Запросы диапазона возвращают значения за временной интервал. Используйте 'instant' для запросов метрик, когда нужно текущее значение.

  • startRfc3339string

    Необязательно: время начала запроса в формате RFC3339 или относительное время (например, 'now-1h').

  • stepSecondsinteger

    Шаг дискретизации в секундах для запросов метрик за диапазон. При выполнении запросов метрик с queryType='range' этот параметр управляет временным разрешением возвращаемых точек данных.

query_loki_patternsтолько чтениеидемпотентный

Получает обнаруженные шаблоны логов из источника данных Loki для указанного селектора потока и временного диапазона. Возвращает список шаблонов, каждый из которых содержит строку шаблона и общее количество вхождений. Шаблоны помогают выявить типичные структуры логов и аномалии. Параметр logql должен быть селектором потока (например, {job="nginx"}) и не поддерживает фильтры строк или агрегации. Если временной диапазон не указан, по умолчанию берётся последний час. Не поддерживается на источниках данных VictoriaLogs: используйте вместо этого конвейер | stats.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • endRfc3339string

    Необязательно: время окончания запроса в формате RFC3339 или относительное время (например, 'now') (по умолчанию — now)

  • logqlstringобязательный

    Селектор потоков LogQL, определяющий логи для анализа на предмет закономерностей (например, {job="foo", namespace="bar"})

  • startRfc3339string

    Необязательно: время начала запроса в формате RFC3339 или относительное время (например, 'now-1h') (по умолчанию — 1 час назад).

  • stepstring

    Опционально, шаг разрешения запроса (например, '5m')

query_loki_statsтолько чтениеидемпотентный

Получает статистику на уровне индекса по потокам логов, соответствующим заданному селектору, в источнике данных Loki или VictoriaLogs и временном диапазоне. Возвращает объект с количеством потоков, чанков, записей и общим числом байт (например, {"streams": 5, "chunks": 50, "entries": 10000, "bytes": 512000}). Важно: значение entries отражает записи индекса на уровне хранилища (метаданные чанков), НЕ количество отдельных строк логов, соответствующих селектору. Чтобы подсчитать фактически совпадающие строки логов, нужен метрический запрос LogQL count_over_time(). В VictoriaLogs заполняется только entries; остальные поля остаются нулевыми. Параметр logql должен быть простым селектором меток (например, {app="nginx", env="prod"}) и не поддерживает фильтры строк, парсеры или агрегации. Если временной диапазон не указан, по умолчанию берётся последний час.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • endRfc3339string

    Необязательно: время окончания запроса в формате RFC3339 или относительное время (например, 'now')

  • logqlstringобязательный

    Выражение сопоставления меток LogQL для выполнения. Этот параметр принимает только выражения сопоставления меток и не поддерживает полные запросы LogQL. Фильтры строк, операции с шаблонами и агрегации метрик не поддерживаются конечной точкой API статистики. Здесь можно использовать только простые селекторы меток.

  • startRfc3339string

    Необязательно: время начала запроса в формате RFC3339 или относительное время (например, 'now-1h').

query_prometheusтолько чтениеидемпотентный

Запрашивает совместимый с PromQL источник данных (Prometheus, Thanos, Mimir, Cloud Monitoring и т. д.) с помощью выражения PromQL. Поддерживает мгновенные запросы (одна точка) и диапазонные запросы (временной диапазон). Время: RFC3339 или относительные выражения вроде 'now', 'now-1h'.

Параметры
  • datasourceUidstringобязательный

    UID источника данных для запроса

  • endTimestringобязательный

    Время окончания. Поддерживаемые форматы: RFC3339 или относительное от текущего момента (например, 'now', 'now-1.5h', 'now-2h45m'). Допустимые единицы времени: 'ns', 'us' (или 'µs'), 'ms', 's', 'm', 'h', 'd'.

  • exprstringобязательный

    Выражение PromQL для запроса

  • projectNamestring

    Имя проекта GCP для запроса (только для источников данных Cloud Monitoring). Переопределяет или заменяет defaultProject, настроенный в источнике данных.

  • queryTypestring

    Тип запроса для использования. Либо 'range', либо 'instant'

  • startTimestring

    Время начала. Обязательно, если queryType имеет значение 'range', игнорируется, если queryType имеет значение 'instant'. Поддерживаемые форматы: RFC3339 или относительное время от текущего момента (например, 'now', 'now-1.5h', 'now-2h45m'). Допустимые единицы времени: 'ns', 'us' (или 'µs'), 'ms', 's', 'm', 'h', 'd'.

  • stepSecondsinteger

    Размер шага временного ряда в секундах. Обязателен, если queryType — 'range', игнорируется, если queryType — 'instant'.

query_prometheus_histogramтолько чтениеидемпотентный

Запрашивает процентили гистограмм Prometheus из классических серий '_bucket'. Генерирует PromQL-выражение histogram_quantile. Пример: metric='http_duration', percentile=95, labels='job="api"' Форматы времени: 'now-1h', '2026-02-02T19:00:00Z', '1738519200000' (Unix ms)

Параметры
  • datasourceUidstringобязательный

    Чтобы узнать UID датасорса Prometheus в Grafana, есть несколько способов: Через API: curl -H "Authorization: Bearer <токен>" http://<grafana>/api/datasources В ответе будет список всех датасорсов с их UID. Через интерфейс Grafana: 1. Зайдите в Configuration → Data Sources 2. Кликните на ваш Prometheus датасорс 3. URL в адресной строке будет вида http://<grafana>/datasources/edit/<uid> — это и есть UID Через provisioning (если настроен через YAML): В файле provisioning (например, datasources.yaml) UID задаётся явно: yaml datasources: - name: Prometheus uid: prometheus type: prometheus Если вы используете UID в дашбордах (например, в переменных или в запросах), обычно это строка вида prometheus или случайный набор символов. Можете уточнить, в каком контексте вам нужен UID — подскажу точнее.

  • endTimestring

    Время окончания (по умолчанию: сейчас). Поддерживает RFC3339, относительное время или Unix в миллисекундах.

  • labelsstring

    Селектор меток (например, job="api", service="gateway")

  • metricstringобязательный

    Имя базовой метрики гистограммы (без суффикса _bucket)

  • percentilenumberобязательный

    Процентиль для расчета (например, 50, 90, 95, 99)

  • projectNamestring

    Имя проекта GCP для запроса (только для источников данных Cloud Monitoring). Переопределяет или заменяет defaultProject, настроенный в источнике данных.

  • rateIntervalstring

    Интервал частоты для запроса (по умолчанию: 5m)

  • startTimestring

    Время начала (по умолчанию: now-1h). Поддерживает RFC3339, относительный формат (now-1h) или Unix-миллисекунды.

  • stepSecondsinteger

    Размер шага в секундах для запроса диапазона (по умолчанию: 60)

query_pyroscopeтолько чтениеидемпотентный

Единый инструмент запросов Pyroscope получает профили или метрики из Pyroscope. Профильные данные показывают, КАКИЕ функции потребляют ресурсы; метрики показывают, КОГДА потребление резко возросло. Используйте query_type="both" для полного анализа за один вызов. Параметры query_type (расширяет Grafana's PyroscopeQueryType): - "profile": возвращает профильные данные (форма задаётся параметром format) - "metrics": возвращает точки временных рядов - "both" (по умолчанию): возвращает и профиль, и метрики в одном ответе Параметры format (форма профильных данных): - "table" (по умолчанию): таблица по функциям с собственными (self) и накопленными значениями, отсортированными по собственным - "dot": граф вызовов в формате Graphviz DOT; узлы соответствуют отдельным строкам исходного кода, поэтому одна функция может быть представлена несколькими узлами

Параметры
  • data_source_uidstringобязательный

    UID источника данных для запроса

  • end_rfc_3339string

    Время окончания в формате RFC3339 или относительное время (например, 'now') (по умолчанию — now)

  • formatstring

    Формат вывода профиля: "table" (по умолчанию) — плоская/кумулятивная таблица по функциям, или "dot" — граф вызовов в формате Graphviz DOT.

  • group_bystring[]

    Метки для группировки рядов метрик

  • matchersstring

    Матчеры в стиле Prometheus (по умолчанию: {})

  • max_node_depthinteger

    Максимум функций в таблице профиля или узлов в графе вызовов; это количество, а не глубина (по умолчанию: 100)

  • profile_typestringобязательный

    Тип профиля (например, process_cpu:cpu:nanoseconds:cpu:nanoseconds)

  • query_typestring

    Тип запроса: «profile» (flamegraph), «metrics» (временные ряды) или «both» (по умолчанию). Используйте «both» для полного анализа.

  • start_rfc_3339string

    Время начала в формате RFC3339 или относительное время (например, 'now-1h') (по умолчанию — 1 час назад)

  • stepnumber

    Секунды между точками данных метрик (по умолчанию: auto)

query_tempo_metricsтолько чтениеидемпотентный

Вычисляет метрики на основе трейсов через запрос метрик TraceQL. Синтаксис отличается от PromQL. Для одного значения используйте тип 'instant', для временного ряда - 'range' (по умолчанию). Мгновенные запросы на больших временных диапазонах могут упасть по таймауту: держите окно в пределах 15 минут для instant либо берите range.

Параметры
  • datasourceUidstringобязательный

    UID источника данных Tempo, к которому выполняется запрос

  • endstring

    Время окончания (формат RFC3339). Если не указано, ищет за последний час.

  • querystringобязательный

    Запрос метрик TraceQL вида '{ <selector> } | <aggregation> [by (<attribute>)]'. Пример: '{ } | quantile_over_time(span:duration, .99) by (span.name)'.

  • startstring

    Start time (формат RFC3339). Если не указано, будет искать за последний час.

  • typeenum

    Тип запроса: 'instant' возвращает одно значение в конце временного диапазона; 'range' возвращает временной ряд. По умолчанию используется 'range'.

search_dashboardsтолько чтениеидемпотентный

Ищет дашборды Grafana по запросу и/или folderUid, тегу и избранному. Возвращает подходящие дашборды с заголовком, UID, папкой, тегами и URL.

Параметры
  • folderUidstring

    Необязательный UID непосредственной папки (не вложенной)

  • limitinteger

    Максимальное количество возвращаемых результатов (макс. 100)

  • pageinteger

    Номер страницы для постраничной разбивки (нумерация с 1)

  • querystring

    Необязательный запрос. Опустите его, чтобы фильтровать по folderUid, tag или starred.

  • starredboolean

    Если true, только избранные дашборды

  • tagstring[]

    Необязательные теги для сопоставления (AND)

search_docsтолько чтениеидемпотентныйвнешний мир
Параметры
  • limitinteger

    Максимум результатов для возврата (по умолчанию: 50)

  • productstring

    Отфильтруйте результаты по конкретному продукту (например, 'Grafana Tempo', 'Grafana Loki')

  • querystring

    Поисковый запрос для документации Grafana. Оставьте пустым, чтобы перечислить все доступные группы продуктов.

search_foldersтолько чтениеидемпотентный

Ищет папки Grafana по строке запроса. Возвращает подходящие папки с деталями: название, UID и URL.

Параметры
  • querystring

    Поисковый запрос

search_plugin_informationтолько чтениеидемпотентныйвнешний мир

Ищет в каталоге плагинов Grafana по ключевому слову, назначению или части названия (например, 'azure monitoring', 'loki', 'database'). Возвращает результаты, отсортированные по уровню доверия: сначала официальные плагины Grafana Labs, затем плагины коммерческих партнёров, потом плагины сообщества, каждый с точным pluginId. Результаты содержат предупреждения для плагинов, доступных только в Enterprise, или для плагинов на Angular.

Параметры
  • querystringобязательный

    Ключевое слово для поиска плагинов (например, «azure», «prometheus», «loki», «database»). Сопоставляется с названием плагина, слагом, описанием и ключевыми словами.

search_tempo_tracesтолько чтениеидемпотентный

Ищет трейсы с помощью запросов TraceQL.

Параметры
  • datasourceUidstringобязательный

    UID источника данных Tempo, к которому выполняется запрос

  • endstring

    Время окончания поиска (формат RFC3339). Если не указано, поиск выполняется за последний 1 час. Если указано, должно быть позже времени начала.

  • querystringобязательный

    Строка запроса TraceQL

  • startstring

    Время начала поиска (формат RFC3339). Если не указано, поиск выполняется за последний 1 час. Если указано, должно быть раньше времени окончания.

suggest_loki_alloy_label_configтолько чтениеидемпотентный

Генерирует фрагмент Alloy loki.process, принудительно применяющий утверждённый набор меток с помощью stage.label_keep, с опциональной нормализацией уровня логирования и заглушками для мягкого принуждения.

Параметры
  • approvedLabelsstring[]обязательный

    Метки, которые нужно сохранить в индексе.

  • componentNamestring
  • forwardTostring
  • normalizeLogLevelboolean
  • requiredLabelsstring[]

    Метки, которые получают заглушку 'unknown', когда отсутствуют.

update_alert_group

Обновляет состояние группы оповещений Grafana OnCall: подтверждает, снимает подтверждение, разрешает или снимает разрешение по ID. Возвращает итоговое состояние группы оповещений OnCall (одно из: new, acknowledged, resolved, silenced) или stateWarning с объяснением, почему состояние не удалось прочитать после успешного обновления.

Параметры
  • alertGroupIdstringобязательный

    Идентификатор группы оповещений для обновления

  • statestringобязательный

    Новое состояние для группы оповещений. Одно из: подтверждено, не подтверждено, решено, не решено

update_annotation

Обновляет указанные свойства аннотации по ID. Изменяются только поля, включенные в запрос; пропущенные поля остаются без изменений.

Параметры
  • dataobject

    Необязательная JSON-нагрузка

  • idinteger

    Идентификатор аннотации для обновления

  • tagsstring[]

    Теги для замены существующих тегов

  • textstring

    Новый текст аннотации

  • timeinteger

    Новое время начала (мс с начала эпохи)

  • timeEndinteger

    Новое время окончания в миллисекундах эпохи

update_dashboard

Создаёт или обновляет дашборд. Возвращает UID сохранённого дашборда и ссылку на дашборд в поле 'url', используя публичный URL инстанса, когда он доступен. Два режима: (1) Полный JSON - укажите 'dashboard' для новых дашбордов или полной замены. (2) Патч - укажите 'uid' + 'operations', чтобы точечно изменить существующий дашборд. Один из этих двух режимов обязателен; 'folderUid', 'message' и 'overwrite' вспомогательные и сами по себе ничего не делают. Советы по созданию дашбордов: если сохранённый запрос должен поддерживать одно, много или Все значения из переменной с множественным выбором внутри regex-выражения или матчера, сохраняйте '${var:regex}', а не просто '$var'. Сохранённые запросы и определения аннотаций дашборда лежат в JSON дашборда в разделе 'annotations.list'; события аннотаций хранятся отдельно и не входят в JSON дашборда. Для панелей stat по текущему диапазону дашборда настраивайте запрос так, чтобы он возвращал результат уровня диапазона, который должна показать панель stat; сокращение на стороне панели только уменьшает возвращённые ряды и не вычисляет за вас семантику пика по диапазону или отношения пиков. Операции патча поддерживают JSONPath вида '$.panels[0].targets[0].expr', '$.panels[1].title', '$.panels[2].targets[0].datasource', '$.templating.list/-' и '$.annotations.list/-'. Добавляйте элементы в массивы синтаксисом '/- ': '$.panels/- '. Удаление по индексу: {"op": "remove", "path": "$.panels[2]"}. Несколько удалений в одном массиве автоматически переупорядочиваются, чтобы избежать проблем со сдвигом индексов. Примечание: в путях патча поддерживаются только числовые индексы массивов; фильтры вида [?(@.id==2)] и подстановочные знаки вида [*] не поддерживаются. Схема: для новых дашбордов предпочитайте v2; если в этой Grafana нет v2, сохранение упадёт с сообщением об этом, тогда отправляйте v1. Существующий дашборд оставляйте в той схеме, в которой он хранится (на это указывают 'isV2'/'apiVersion' в полученном дашборде). Тело с 'elements'/'layout' на верхнем уровне сохраняется как v2. Минимальное тело v2:…

Параметры
  • dashboardobject

    Полный JSON дашборда: classic v1 (panels[]) или v2 (elements/layout; скелет в описании инструмента). Используется для создания новых дашбордов или полного обновления. Сохранённые запросы/определения аннотаций дашборда лежат в 'annotations.list' внутри этого JSON; они отличаются от событий аннотаций, которые хранятся отдельно. Большие дашборды потребляют значительный объём контекста - для небольших изменений лучше использовать патчи.

  • folderUidstring

    UID папки дашборда

  • messagestring

    Установи сообщение коммита для истории версий.

  • operationsobject[]

    Массив операций patch для точечных обновлений. Эффективнее, чем полный JSON дашборда, при небольших изменениях. Типичные пути: '$.templating.list/-' чтобы добавить переменную, '$.annotations.list/-' чтобы добавить сохранённый запрос/определение аннотации дашборда, '$.panels[0].targets[0].expr' чтобы заменить запрос панели. Пути v2: '$.elements.<name>.spec.title', '$.variables/-', '$.layout.spec.items/-'.

  • overwriteboolean

    Перезаписывает панель, если она существует. В противном случае создаёт новую.

  • uidstring

    UID существующего дашборда для обновления. Должен использоваться вместе с 'operations'. Указание 'uid' без 'operations' приведет к ошибке.

  • userIdinteger

    ID пользователя, вносящего изменение

update_datasourceидемпотентный

Обновляет несекретные поля источника данных по UID в два шага. При вызове только с uid возвращает схему полей источника данных и ничего не меняет. При вызове с uid, schemaReviewed=true и изменёнными значениями в карте fields применяет обновление. Пропущенные поля сохраняются. Секреты (пароли, токены) изменить нельзя. Возвращает сообщение об обновлении и проверку работоспособности.

Параметры
  • accessstring

    Прокси или напрямую?

  • basicAuthboolean

    Включить базовую аутентификацию.

  • databasestring

    Имя базы данных

  • fieldsobject

    Значения полей источника данных для изменения, ключом служит ключ поля из схемы, возвращённой при первом вызове. Сервер использует цель каждого поля (root или jsonData) для корректного размещения значений, объединяя изменения jsonData с существующими настройками. Указывайте только те поля, которые хотите изменить. Пример: {"httpMethod": "POST"}.

  • isDefaultboolean

    Делает это источником данных по умолчанию.

  • jsonDataobject

    Несекретные настройки плагина; заменяют существующий jsonData при установке.

  • namestring

    Отображаемое имя

  • schemaReviewedboolean

    True, как только схема поля получена; требуется для применения обновления.

  • uidstringобязательный

    UID источника данных для обновления

  • urlstring

    Базовый URL

update_incidentидемпотентный

Обновляет существующий инцидент Grafana по идентификатору. Позволяет изменять статус ('active' или 'resolved'), серьёзность, заголовок и значения настраиваемых полей. Изменяются только переданные поля. Используйте это для закрытия инцидента, исправления серьёзности или заголовка либо для заполнения настраиваемых полей в рамках рабочего процесса дежурного.

Параметры
  • customFieldsobject[]

    Значения пользовательских полей для установки. Изменяются только перечисленные поля.

  • incidentIdstringобязательный

    Идентификатор инцидента, который нужно обновить

  • severitystring

    Новая степень серьёзности инцидента, например, «незначительная», «крупная», «критическая».

  • statusstring

    Новый статус инцидента. Допустимые значения: 'active', 'resolved'.

  • titlestring

    Новый заголовок инцидента

user_infoтолько чтениеидемпотентный

Получает информацию о текущей учётной записи Grafana: логин, электронную почту, имя, является ли она администратором Grafana (сервера), текущую организацию и организации, к которым она имеет доступ (с ролями). Вызовите этот инструмент, чтобы узнать, какие значения orgId допустимы, прежде чем указывать конкретную организацию, и чтобы понять возможности учётной записи.

Параметры

Без параметров.

validate_provisioning_fileтолько чтениеидемпотентный

Проверяет файл в репозитории provisioning на указанной ветке или коммите, применяя его в режиме dry-run. Возвращает, будет ли файл принят (valid), какое действие с ресурсом произойдёт (create/update), тип целевого ресурса и любые структурированные ошибки валидации. Помогает убедиться, что черновик дашборда или другой ресурс будет принят до слияния или применения PR: это та же поверхность валидации, о которой сообщает PR commenter Grafana.

Параметры
  • pathstringобязательный

    Путь к файлу в репозитории (например, 'folder/dashboard.json').

  • refstring

    Ветка или SHA коммита. По умолчанию используется основная ветка репозитория.

  • repostringобязательный

    Слаг репозитория для провижининга (имя репозитория).

2.1.0основная
2.0.2
2.0.1
2.0.0
1.6.3
1.6.2
1.6.1
1.6.0
1.5.1
1.5.0
1.4.2
1.4.1
1.4.0
1.3.0
1.2.0
1.1.0
1.0.0
0.17.2
0.17.1
0.17.0
0.15.2
0.15.1
0.15.0
0.14.0
0.13.1
0.13.0
0.12.1
0.12.0
0.11.6
0.11.5
0.11.4
0.11.3
0.11.2
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить Grafana MCP:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "grafana-mcp-grafana-u0yva9vc8x": {
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      },
      "args": [
        "mcp-grafana"
      ],
      "command": "uvx"
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "grafana-mcp-grafana-u0yva9vc8x": {
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      },
      "args": [
        "mcp-grafana"
      ],
      "command": "uvx"
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "grafana-mcp-grafana-u0yva9vc8x": {
      "type": "stdio",
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      },
      "args": [
        "mcp-grafana"
      ],
      "command": "uvx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"grafana-mcp-grafana-u0yva9vc8x\",\"type\":\"stdio\",\"env\":{\"GRAFANA_URL\":\"http://localhost:3000\",\"GRAFANA_SERVICE_ACCOUNT_TOKEN\":\"<your service account token>\"},\"args\":[\"mcp-grafana\"],\"command\":\"uvx\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "grafana-mcp-grafana-u0yva9vc8x": {
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      },
      "args": [
        "mcp-grafana"
      ],
      "command": "uvx"
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add grafana-mcp-grafana-u0yva9vc8x --env GRAFANA_URL=http://localhost:3000 --env GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> -- uvx mcp-grafana

Либо через JSON-конфиг:

claude mcp add-json grafana-mcp-grafana-u0yva9vc8x "{\"env\":{\"GRAFANA_URL\":\"http://localhost:3000\",\"GRAFANA_SERVICE_ACCOUNT_TOKEN\":\"<your service account token>\"},\"args\":[\"mcp-grafana\"],\"command\":\"uvx\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add grafana-mcp-grafana-u0yva9vc8x --env GRAFANA_URL=http://localhost:3000 --env GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> -- uvx mcp-grafana

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.grafana-mcp-grafana-u0yva9vc8x]
command = "uvx"
args = ["mcp-grafana"]

[mcp_servers.grafana-mcp-grafana-u0yva9vc8x.env]
GRAFANA_URL = "http://localhost:3000"
GRAFANA_SERVICE_ACCOUNT_TOKEN = "<your service account token>"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите Grafana MCP, а в поле команды запуска — строку ниже:
uvx mcp-grafana

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "grafana-mcp-grafana-u0yva9vc8x": {
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      },
      "args": [
        "mcp-grafana"
      ],
      "command": "uvx"
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "grafana-mcp-grafana-u0yva9vc8x": {
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      },
      "args": [
        "mcp-grafana"
      ],
      "command": "uvx",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например grafana-mcp-grafana-u0yva9vc8x.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: grafana-mcp-grafana-u0yva9vc8x
    command: uvx
    args:
      - "mcp-grafana"
    env:
      GRAFANA_URL: http://localhost:3000
      GRAFANA_SERVICE_ACCOUNT_TOKEN: <your service account token>
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "grafana-mcp-grafana-u0yva9vc8x": {
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      },
      "args": [
        "mcp-grafana"
      ],
      "command": "uvx"
    }
  }
}

Похожие MCP-сервера

tumf/grafana-loki-mcp

tumf/grafana-loki-mcp

от tumf

MCP сервер для запросов логов из Grafana Loki: позволяет выполнять LogQL-запросы, получать метки и значения, форматировать результаты. Полезен разработчикам и DevOps для анализа логов через MCP-инструменты.

Python⭐ 29
alimuratkuslu/byok-observability-mcp

alimuratkuslu/byok-observability-mcp

от alimuratkuslu

MCP сервер для запросов к observability-стекам (Grafana, Prometheus, Kafka UI, Datadog). Данные хранятся локально — ключи не покидают машину. Разработчики и SRE анализируют метрики, алерты и логи прямо из Claude Code, Codex или любого MCP клиента без настройки инфраструктуры.

TypeScript⭐ 4
pab1it0/prometheus-mcp-server

pab1it0/prometheus-mcp-server

от pab1it0

MCP-сервер для прямого доступа к метрикам Prometheus. Позволяет AI-ассистентам выполнять PromQL-запросы, просматривать список метрик и получать их метаданные. Полезен инженерам, работающим с observ...

Python⭐ 519
VictoriaMetrics-Community/mcp-victorialogs

VictoriaMetrics-Community/mcp-victorialogs

официальный

от victoriametrics-community

MCP-сервер для VictoriaLogs. Предоставляет AI-агентам доступ к чтению логов, метрик, полей и встроенной документации через LogsQL-запросы. Упрощает отладку и мониторинг для инженеров.

Go⭐ 103
yshngg/pmcp

yshngg/pmcp

от yshngg

MCP-сервер на Go для Prometheus: через MCP-клиенты можно общаться с метриками на естественном языке. Поддерживает мгновенные и range-запросы, метаданные, управление таргетами, правилами и TSDB — уд...

Go⭐ 4
TANTIOPE/datadog-mcp-server

TANTIOPE/datadog-mcp-server

от tantiope

MCP сервер для AI-ассистентов, открывающий полный доступ к Datadog: поиск логов, фильтрация APM-трейсов, запрос метрик, управление мониторами и дашбордами. Помогает SRE и разработчикам быстро разбирать инциденты, не переключаясь между инструментами.

TypeScript⭐ 6
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин