grafana/gcx

A CLI for managing Grafana and Grafana Cloud resources. Optimized for agentic usage.

gcx는 모니터링 및 관찰 가능성을 위한 플랫폼인 Grafana를 터미널이나 AI 코딩 어시스턴트로 직접 가져오는 명령줄 도구(CLI)입니다. 브라우저 탭을 전환하는 대신, 명령줄이나 셸 명령을 실행하는 AI 에이전트를 통해 실시간 메트릭을 쿼리하고, 알림을 확인하고, 대시보드를 관리하는 등의 작업을 모두 수행할 수 있습니다.

기능:

데이터 쿼리: 터미널에서 직접 PromQL(메트릭), LogQL(로그), 그리고 트레이스 및 프로파일용 유사 쿼리를 실행합니다.
리소스 관리: 대시보드, 폴더, 알림 규칙을 코드로(GitOps 스타일) 가져오고 내보냅니다.
알림 및 SLO 확인: 발생 중인 알림을 나열하고, 서비스 수준 목표를 검토하며, 인시던트를 조사합니다.
Grafana Cloud 제품과 연동: SLO, Synthetic Monitoring, IRM(인시던트 대응), k6 부하 테스트, Fleet Management 등을 위한 명령을 포함하지만, Grafana Cloud에서만 사용할 수 있습니다.
AI 에이전트와 통합: AI 코딩 도구(Claude Code, OpenAI Codex 등)가 gcx 명령을 사용하여 알림을 조사하고, 대시보드를 만들고, 문제를 해결할 수 있게 해주는 "스킬" 번들을 제공합니다.

호환성:

Grafana Cloud, Enterprise, OSS(자체 호스팅) 버전에서 작동합니다.
Grafana 13+를 완전히 지원합니다. Grafana 12는 작동하지만 기능이 제한적입니다. 12 미만 버전은 지원되지 않습니다.
클라우드 전용 제품(SLO, Synthetic Monitoring 등)은 Grafana Cloud가 필요합니다.

설치:

빠른 스크립트: curl -fsSL https://raw.githubusercontent.com/grafana/gcx/main/scripts/install.sh | sh
Homebrew: brew install gcx

사용 예시:

gcx metrics query 'rate(http_requests_total[5m])' --since 1h
gcx alert rules list --state firing
gcx slo definitions list

비용: gcx 자체는 무료이지만, 상호 작용하는 일부 Grafana Cloud 제품(Assistant, Synthetic Monitoring, k6 등)은 사용량에 따라 청구됩니다. 쿼리 및 리소스 푸시/풀은 청구되지 않습니다.

요약하자면, gcx는 Grafana 데이터와 터미널 또는 AI 어시스턴트 사이의 다리 역할을 하여 관찰 가능성 워크플로우를 더 빠르고 스크립트화하기 쉽게 만듭니다.

grafana/gcx

관련