AT Grafana

中文

AT Grafana es una extensión de VS Code / Cursor en la Serie AT (junto con at-terminal-series y at-jumpserver-series). Lleva los paneles de Grafana y Unified Alerting al IDE, y expone metadatos de Grafana de solo lectura y consultas de fuentes de datos (Prometheus, Loki, …) a los Agentes a través del Protocolo v1 compartido @at-series/mcp-hub.

Versión actual: 0.1.0 — V1 con todas las funciones. Suite automatizada: typecheck + 292 pruebas. Las comprobaciones de humo con Grafana en vivo / cliente MCP real todavía figuran como pendientes en docs/releases/0.1.0.md.

Características

• Configuración de múltiples instancias — etiqueta, URL, token de cuenta de servicio de Grafana (9.1+); los tokens viven en SecretStorage de VS Code, nunca en configuraciones de texto plano

• TLS Trust-On-First-Use — la primera conexión solicita confirmación de la huella digital del certificado; los cambios de huella digital fallan de forma segura

• Barra lateral de tableros — árbol de carpetas de Grafana, filtro de título, actualizar; abrir un tablero en una Webview integrada

• Barra lateral de alertas — reglas de Unified Alerting con estado en vivo, agrupación por carpetas, reglas en estado Firing ordenadas primero

• Páginas integradas nativas — interfaz de usuario totalmente interactiva de tableros de Grafana / detalles de alertas a través de un proxy inverso local 127.0.0.1 que inyecta Authorization en el lado de la extensión (el token nunca es visible para la Webview)

• Puerta de Agente por instancia — “Permitir acceso de Agente en segundo plano” (desactivado por defecto); solo las instancias habilitadas aparecen en las herramientas MCP

• 9 herramientas MCP (risk: read, aprobadas automáticamente tras la instalación de AT Series MCP):

  • Descubrimiento: grafana_list_instances

  • Gestión: grafana_list_dashboards, grafana_get_dashboard, grafana_list_folders, grafana_list_alert_rules, grafana_get_alert_rule, grafana_get_alert_history

  • Monitoreo: grafana_list_datasources, grafana_query_datasource (solo GET/POST; path confinado a /api/datasources/proxy/uid/<uid>/, por lo que no puede alcanzar las propias API de Grafana; límites configurables de rango de tiempo / tamaño de respuesta)

• Hub compartido de AT Series — una entrada MCP de AT Series para Cursor / Kiro / Continue; sin servidor MCP específico del plugin

Related MCP server: Grafana MCP Server

No incluido en esta versión

• Perforación de un solo panel (solo tableros completos)

• Alertas heredadas (solo Unified Alerting)

• Cualquier escritura / silencio / pausa contra Grafana o fuentes de datos

• Soporte multi-organización

• Grafana Live / push WebSocket a través del proxy integrado

Instalación

1. Construye un VSIX (o usa un archivo de versión una vez publicado):

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

2. En VS Code / Cursor: Extensiones → ⋯ → Instalar desde VSIX… y selecciona el archivo.

3. Abre las vistas de la barra de actividades de AT Grafana y luego ejecuta AT Grafana: Add Instance.

Inicio rápido

1. Crea una cuenta de servicio de Grafana con Viewer y copia un token.

2. AT Grafana: Add Instance → etiqueta, URL base, token → Probar conexión → confirma la huella digital TLS → guardar.

3. Explora Tableros / Alertas; haz clic en un nodo para abrir la página nativa en una Webview.

4. (Opcional, para Agentes) Edita la instancia y habilita Permitir acceso de Agente en segundo plano.

5. (Opcional) AT Grafana: Install/Repair AT Series MCP Config y luego reconecta tu cliente MCP.

Guía completa: docs/usage.md · 中文

Habilidad del Agente

Instala con la CLI de skills:

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

Desarrollo

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

Presiona F5 con esta carpeta abierta para iniciar un Host de Desarrollo de Extensiones.

Requiere Node.js 20+ y un host de VS Code / Cursor que coincida con engines.vscode (^1.85.0).

Documentación

Generado a partir de at-terminal-series (historial de git independiente; dominio SSH/SFTP/terminal eliminado) — ver ADR-001.

Licencia

MIT