AT Grafana

中文

AT Grafana는 AT 시리즈(at-terminal-series 및 at-jumpserver-series와 함께)에 속하는 VS Code / Cursor 확장 프로그램입니다. Grafana 대시보드와 Unified Alerting을 IDE로 가져오며, 공유 @at-series/mcp-hub 프로토콜 v1을 통해 에이전트에 읽기 전용 Grafana 메타데이터와 데이터소스 쿼리(Prometheus, Loki 등)를 제공합니다.

현재 버전: 0.1.0 — V1 기능 완성. 자동화 테스트: 타입체크 + 292개 테스트. 실제 Grafana / 실제 MCP 클라이언트 스모크 테스트는 docs/releases/0.1.0.md에 여전히 미완료로 나열되어 있습니다.

기능

• 다중 인스턴스 구성 — 라벨, URL, Grafana Service Account Token(9.1+); 토큰은 VS Code SecretStorage에 저장되며 일반 텍스트 설정에 절대 남지 않습니다.

• TLS Trust-On-First-Use — 첫 연결 시 인증서 지문 확인을 요청하며, 지문 변경 시 연결이 차단됩니다(fail closed).

• 대시보드 사이드바 — Grafana 폴더 트리, 제목 필터, 새로고침; 임베디드 Webview에서 대시보드 열기.

• 알림 사이드바 — 실시간 상태의 Unified Alerting 규칙, 폴더 그룹화, Firing 규칙 우선 정렬.

• 네이티브 임베디드 페이지 — 로컬 127.0.0.1 리버스 프록시를 통한 완전한 인터랙티브 Grafana 대시보드 / 알림 상세 UI; 확장 프로그램 측에서 Authorization을 주입하므로 토큰이 Webview에 노출되지 않습니다.

• 인스턴스별 에이전트 게이트 — "Allow background Agent access"(기본값: 꺼짐); 활성화된 인스턴스만 MCP 도구에 노출됩니다.

• MCP 도구 9개 (risk: read, AT 시리즈 MCP 설치 시 자동 승인):

  • 검색: grafana_list_instances

  • 관리: grafana_list_dashboards, grafana_get_dashboard, grafana_list_folders, grafana_list_alert_rules, grafana_get_alert_rule, grafana_get_alert_history

  • 모니터링: grafana_list_datasources, grafana_query_datasource (GET/POST만 허용, path는 /api/datasources/proxy/uid/<uid>/로 제한되어 Grafana 자체 API에는 접근 불가; 시간 범위 / 응답 크기 제한 구성 가능)

• 공유 AT 시리즈 허브 — Cursor / Kiro / Continue용 단일 AT Series MCP 항목; 플러그인별 MCP 서버 불필요.

Related MCP server: Grafana MCP Server

이번 릴리스에 포함되지 않은 사항

• 단일 패널 드릴다운(전체 대시보드만 지원)

• 레거시 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. Grafana Service Account를 만들고 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를 눌러 Extension Development Host를 실행합니다.

Node.js 20+ 및 engines.vscode(^1.85.0)와 일치하는 VS Code / Cursor 호스트가 필요합니다.

문서

at-terminal-series에서 스캐폴딩됨(독립 git 히스토리; SSH/SFTP/터미널 도메인 제거) — ADR-001 참조.

라이선스

MIT