AT Grafana

中文

AT Grafana es una extensión de VS Code / Cursor de 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 solo lectura de Grafana, además de consultas a fuentes de datos (Prometheus, Loki, …), a los Agents a través del @at-series/mcp-hub compartido, Protocolo v1.

Versión actual: 0.1.3 — catálogo MCP alineado con 17 herramientas de solo lectura (Prom/Loki tipados, descubrimiento, anotaciones, deeplink). Suite automatizada: typecheck + 559 pruebas. Consulta docs/releases/0.1.3.md. Las comprobaciones de humo con Grafana en vivo / cliente MCP real siguen enumeradas en docs/releases/0.1.0.md.

Funciones

• Configuración multiinstancia — etiqueta, URL, token de cuenta de servicio de Grafana (9.1+); los tokens se guardan en SecretStorage de VS Code, nunca en configuración en texto plano

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

• Barra lateral de Dashboards — árbol de carpetas de Grafana, filtro por título, actualización; abre un panel 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 nativas integradas — interfaz totalmente interactiva de paneles de Grafana / detalles de alertas mediante 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 acceso por instancia para Agents — «Allow background Agent access» (desactivado por defecto); solo las instancias habilitadas aparecen en las herramientas MCP

• 17 herramientas MCP (risk: read, aprobadas automáticamente tras instalar el MCP de AT Series):

  • Descubrimiento: grafana_list_instances

  • Gestión: grafana_list_dashboards (opcional query / tag / folderUid), grafana_get_dashboard (por defecto fields: "targets"; el modelo completo requiere fields: "full"), grafana_list_folders, grafana_list_alert_rules (opcional states), grafana_get_alert_rule, grafana_get_alert_history, grafana_list_annotations, grafana_generate_deeplink (openInIde por defecto false)

  • Monitorización: 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 y grafana_query_datasource como vía de escape. Prefiere las herramientas tipadas Prom/Loki; el proxy genérico solo admite GET/POST, con path limitado a /api/datasources/proxy/uid/<uid>/ para que no pueda alcanzar las APIs propias de Grafana; los resultados que superan el límite incluyen truncated: true

• Hub compartido de AT Series — una única entrada MCP 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

• Desglose de panel único (solo paneles completos)

• Alerting heredado (solo Unified Alerting)

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

• Soporte multi-organización

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

Instalación

1. Compila un VSIX (o usa un asset de release una vez publicado):

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

2. En VS Code / Cursor: Extensions → ⋯ → Install from VSIX… y selecciona el archivo.

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

Inicio rápido

1. Crea una Service Account de Grafana con Viewer y copia un token.

2. AT Grafana: Add Instance → etiqueta, URL base, token → Test connection → confirma la huella TLS → guarda.

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

4. (Opcional, para Agents) Edita la instancia y activa Allow background Agent access.

5. (Opcional) AT Grafana: Install/Repair AT Series MCP Config y vuelve a conectar tu cliente MCP.

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

Habilidad de Agent

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

Pulsa F5 con esta carpeta abierta para iniciar un Extension Development Host.

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) — consulta ADR-001.

Licencia

MIT