AT Grafana

中文

AT Grafana — это расширение для VS Code / Cursor из серии AT Series (наряду с at-terminal-series и at-jumpserver-series). Оно приносит дашборды Grafana и Unified Alerting в IDE, а также предоставляет Агентам доступ только для чтения к метаданным Grafana и запросам к источникам данных (Prometheus, Loki, …) через общий протокол v1 @at-series/mcp-hub.

Текущая версия: 0.1.3 — каталог MCP выровнен по 17 инструментам только для чтения (типизированные Prom/Loki, обнаружение, аннотации, deeplink). Автоматизированный набор: typecheck + 559 тестов. См. docs/releases/0.1.3.md. Живые smoke-проверки Grafana / реального MCP-клиента по-прежнему перечислены в docs/releases/0.1.0.md.

Возможности

• Конфигурация нескольких экземпляров — метка, URL, токен сервисного аккаунта Grafana (9.1+); токены хранятся в VS Code SecretStorage, никогда не в открытых настройках

• TLS Trust-On-First-Use — при первом подключении запрашивается подтверждение отпечатка сертификата; изменение отпечатка приводит к отказу (fail closed)

• Боковая панель дашбордов — дерево папок Grafana, фильтр по названию, обновление; открытие дашборда во встроенном Webview

• Боковая панель оповещений — правила Unified Alerting с живым состоянием, группировка по папкам, правила Firing отсортированы первыми

• Нативные встроенные страницы — полностью интерактивный дашборд Grafana / детальный интерфейс оповещений через локальный обратный прокси 127.0.0.1, который внедряет Authorization на стороне расширения (токен никогда не виден Webview)

• Шлюз Агента для каждого экземпляра — «Разрешить фоновый доступ Агента» (по умолчанию выключено); только включённые экземпляры видны MCP-инструментам

• 17 MCP-инструментов (risk: read, авто-одобрение после установки AT Series MCP):

  • Обнаружение: grafana_list_instances

  • Управление: grafana_list_dashboards (опционально query / tag / folderUid), grafana_get_dashboard (по умолчанию fields: "targets"; полная модель требует fields: "full"), grafana_list_folders, grafana_list_alert_rules (опционально states), grafana_get_alert_rule, grafana_get_alert_history, grafana_list_annotations, grafana_generate_deeplink (openInIde по умолчанию false)

  • Мониторинг: grafana_list_datasources, grafana_query_prometheus, grafana_query_loki, grafana_list_prometheus_metric_names, grafana_list_prometheus_label_values, grafana_list_loki_label_names, grafana_list_loki_label_values и grafana_query_datasource как запасной вариант. Предпочитайте типизированные инструменты Prom/Loki; универсальный прокси поддерживает только GET/POST, а path ограничен /api/datasources/proxy/uid/<uid>/, поэтому он не может обращаться к собственным API Grafana; результаты сверх лимита включают truncated: true

• Общий хаб AT Series — одна запись MCP AT Series для Cursor / Kiro / Continue; без отдельного MCP-сервера для плагина

Related MCP server: Grafana MCP Server

Не входит в этот релиз

• Детализация одной панели (только полные дашборды)

• Legacy Alerting (только Unified Alerting)

• Любые операции записи / отключения / паузы в отношении Grafana или источников данных

• Поддержка нескольких организаций

• Grafana Live / WebSocket-пуши через встроенный прокси

Установка

1. Соберите VSIX (или используйте готовый артефакт релиза после публикации):

   npm install
   npm run package   # produces at-grafana-0.1.3.vsix

2. В VS Code / Cursor: Расширения → ⋯ → Установить из VSIX… и выберите файл.

3. Откройте представления панели действий AT Grafana, затем выполните AT Grafana: Добавить экземпляр.

Быстрый старт

1. Создайте сервисный аккаунт Grafana с ролью Viewer и скопируйте токен.

2. AT Grafana: Добавить экземпляр → метка, базовый URL, токен → Проверить подключение → подтвердите TLS-отпечаток → сохраните.

3. Просматривайте Дашборды / Оповещения; нажмите на узел, чтобы открыть нативную страницу в Webview.

4. (Опционально, для Агентов) Отредактируйте экземпляр и включите Разрешить фоновый доступ Агента.

5. (Опционально) AT Grafana: Установить/восстановить конфигурацию MCP AT Series, затем переподключите ваш MCP-клиент.

Полное руководство: docs/usage.md · 中文

Навык Агента

Установка с помощью CLI навыков:

npx skills add xwamt/At-grafana --skill at-grafana-mcp

Разработка

npm install
npm run typecheck
npm test
npm run build      # bundles dist/extension.js (+ webview + hub copy via package scripts)
npm run package    # produces at-grafana-<version>.vsix

Нажмите F5 с открытой этой папкой, чтобы запустить хост разработки расширения.

Требуется Node.js 20+ и хост VS Code / Cursor, соответствующий engines.vscode (^1.85.0).

Документация

Создано на основе at-terminal-series (независимая история git; домен SSH/SFTP/терминала удалён) — см. ADR-001.

Лицензия

MIT