AT Grafana

中文

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

Текущая версия: 0.1.0 — V1 с полным набором функций. Автоматизированный набор: проверка типов + 292 теста. Живые Grafana / реальные MCP-клиентские смоук-проверки всё ещё указаны как ожидающие в docs/releases/0.1.0.md.

Возможности

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

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

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

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

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

• Индивидуальный шлюз для агентов — «Allow background Agent access» (по умолчанию выключено); только включённые инстансы видны MCP-инструментам

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

  • Discovery: grafana_list_instances

  • Management: grafana_list_dashboards, grafana_get_dashboard, grafana_list_folders, grafana_list_alert_rules, grafana_get_alert_rule, grafana_get_alert_history

  • Monitoring: grafana_list_datasources, grafana_query_datasource (только GET/POST; path ограничен /api/datasources/proxy/uid/<uid>/, поэтому не может достичь собственных API Grafana; настраиваемые ограничения по временному диапазону / размеру ответа)

• Общий AT Series Hub — одна запись 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.0.vsix

2. В VS Code / Cursor: Extensions → ⋯ → Install from VSIX… и выберите файл.

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

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

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

2. AT Grafana: Add Instance → метка, базовый URL, токен → Test connection → подтвердите TLS-отпечаток → сохраните.

3. Просматривайте Dashboards / Alerts; нажмите на узел, чтобы открыть нативную страницу в Webview.

4. (Необязательно, для агентов) Отредактируйте инстанс и включите Allow background Agent access.

5. (Необязательно) AT Grafana: Install/Repair AT Series MCP Config, затем переподключите ваш 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