AT Grafana

中文

AT Grafana ist eine VS Code / Cursor-Erweiterung der AT Series (zusammen mit at-terminal-series und at-jumpserver-series). Sie bringt Grafana-Dashboards und Unified Alerting in die IDE und stellt Agenten schreibgeschützte Grafana-Metadaten sowie Datasource-Abfragen (Prometheus, Loki, …) über das gemeinsame @at-series/mcp-hub Protokoll v1 bereit.

Aktuelle Version: 0.1.0 — V1 funktionsvollständig. Automatisierte Suite: Typprüfung + 292 Tests. Live-Grafana-/echte MCP-Client-Smoke-Tests sind weiterhin als ausstehend in docs/releases/0.1.0.md aufgeführt.

Funktionen

• Multi-Instanz-Konfiguration — Bezeichnung, URL, Grafana Service Account Token (9.1+); Tokens liegen in VS Code SecretStorage, niemals in Klartext-Einstellungen

• TLS Trust-On-First-Use — Die erste Verbindung fragt nach Bestätigung des Zertifikat-Fingerprints; Änderungen des Fingerprints führen zu einem Fail-Closed.

• Dashboards-Seitenleiste — Grafana-Ordnerbaum, Titelfilter, Aktualisierung; Dashboard in einem eingebetteten Webview öffnen

• Alerts-Seitenleiste — Unified-Alerting-Regeln mit Live-Status, Ordner gruppiert, Firing-Regeln zuerst sortiert

• Native eingebettete Seiten — vollständig interaktive Grafana-Dashboard-/Alert-Detail-UI über einen lokalen 127.0.0.1-Reverse-Proxy, der Authorization auf der Erweiterungsseite injiziert (Token ist für das Webview nie sichtbar)

• Pro-Instanz-Agenten-Gate — „Allow background Agent access“ (Standard: aus); nur aktivierte Instanzen erscheinen in den MCP-Tools

• 9 MCP-Tools (risk: read, nach AT-Series-MCP-Installation automatisch genehmigt):

  • 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 (nur GET/POST; path auf /api/datasources/proxy/uid/<uid>/ beschränkt, sodass es Grafanas eigene APIs nicht erreichen kann; konfigurierbare Zeitbereichs-/Antwortgrößen-Obergrenzen)

• Gemeinsamer AT-Series-Hub — ein AT Series-MCP-Eintrag für Cursor / Kiro / Continue; kein plugin-spezifischer MCP-Server

Related MCP server: Grafana MCP Server

Nicht in diesem Release

• Einzelpanel-Drilldown (nur vollständige Dashboards)

• Legacy-Alerting (nur Unified Alerting)

• Jegliche Schreib-/Stummschalt-/Pause-Aktionen gegen Grafana oder Datasources

• Multi-Organisations-Unterstützung

• Grafana-Live-/WebSocket-Push über den Embed-Proxy

Installation

1. Erstellen Sie eine VSIX (oder verwenden Sie ein Release-Asset, sobald veröffentlicht):

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

2. In VS Code / Cursor: Erweiterungen → ⋯ → Aus VSIX installieren… und wählen Sie die Datei aus.

3. Öffnen Sie die AT Grafana-Aktivitätsleisten-Ansichten und führen Sie dann AT Grafana: Instanz hinzufügen aus.

Schnellstart

1. Erstellen Sie einen Grafana-Service Account mit Viewer und kopieren Sie ein Token.

2. AT Grafana: Instanz hinzufügen → Bezeichnung, Basis-URL, Token → Verbindung testen → TLS-Fingerprint bestätigen → speichern.

3. Durchsuchen Sie Dashboards / Alerts; klicken Sie auf einen Knoten, um die native Seite in einem Webview zu öffnen.

4. (Optional, für Agenten) Bearbeiten Sie die Instanz und aktivieren Sie Allow background Agent access.

5. (Optional) AT Grafana: AT-Series-MCP-Konfiguration installieren/reparieren und dann Ihren MCP-Client neu verbinden.

Vollständige Anleitung: docs/usage.md · 中文

Agenten-Fähigkeit

Installieren Sie mit der Skills-CLI:

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

Entwicklung

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

Drücken Sie F5 bei geöffnetem Ordner, um einen Extension Development Host zu starten.

Erfordert Node.js 20+ und einen VS Code / Cursor-Host, der engines.vscode (^1.85.0) entspricht.

Dokumentation

Aus at-terminal-series erstellt (unabhängige Git-Historie; SSH/SFTP/Terminal-Domäne entfernt) — siehe ADR-001.

Lizenz

MIT