`gcx` CLI 개요

`gcx` CLI 개요 (Overview of the gcx CLI)

이 문서에서는 Grafana와 Grafana Cloud를 터미널과 AI 코딩 에이전트에서 관리할 수 있는 단일 CLI인 gcx에 대해 소개해요. gcx가 제공하는 이점, 비용, 호환성, 실험 명령어, 그리고 grafanactl에서 마이그레이션하는 방법을 알아봐요.

출처: 문서

본문

gcx는 사용자와 AI 코딩 에이전트가 Grafana(대시보드, 폴더, 알림 규칙, 데이터 소스)와 Synthetic Monitoring, K6, Fleet Management, Incidents, Adaptive Telemetry 같은 Grafana Cloud 제품에 모두 구조적으로 접근할 수 있게 해주는 단일 CLI예요.

gcx는 알림 조사, 근본 원인 분석, 대시보드 생성과 GitOps, SLO 관리, 관찰 가능성 설정 같은 일반적인 워크플로를 위한 에이전트 스킬(skill) 모음을 제공해요. 에이전트 워크플로를 기본적으로 지원하며, Grafana Assistant와 통합되어 이전에 분산되어 있던 사용자 경험을 하나의 도구로 통합해요.

gcx는 지속적으로 개발 중이에요. 지원을 원하거나 문제를 보고하려면 Grafana에 문의하고 이 기능을 개선하는 데 도움을 주세요.

`gcx`의 이점 (Benefits of gcx)

gcx는 무엇보다도 다음 이점을 제공해요:

Grafana OSS/Enterprise와 Grafana Cloud 관리
GitOps
SRE
코드로서의 관찰 가능성(observability as code): gcx
자동화: gcx
다중 환경
AI 에이전트 친화적

비용 (Costs)

참고 gcx 자체는 무료이지만, 일부 명령어는 사용량에 따라 요금이 부과되는 Grafana Cloud 제품을 운영해요.

예를 들어:

자세한 내용은 비용 관리 및 청구 문서와 Grafana Cloud 가격을 참고하세요.

호환성 (Compatibility)

다음 사항이 적용돼요:

gcx는 Grafana Cloud와 Grafana OSS/Enterprise v12 이상에서 사용할 수 있어요. 이전 Grafana 버전은 지원되지 않아요.
gcx는 모든 에이전트 코딩 도구와 호환돼요.
gcx는 넓은 범위의 Grafana 제품에서 작동해요. 기능 가용성은 Grafana 배포 방식에 따라 달라져요. 자세한 내용은 호환성 매트릭스를 참고하세요.

실험 명령어 (Experimental commands)

일부 명령어는 도움말 텍스트에 [experimental]로 표시되며 gcx commands 출력에 experimental이라는 stability 필드를 담고 있어요. 실험 명령어는 일반적인 시맨틱 버전 관리 규칙을 따르지 않고 제거되거나, 하위 명령어·플래그·응답이 변경될 수 있어요. 다른 모든 명령어는 주 버전(major version) 내에서 안정적이에요.

명령어는 아직 안정적이지 않거나, 아직 GA(Generally Available)가 아닌 Grafana Cloud 기능을 운영할 때 실험으로 표시돼요. 자세한 내용은 Grafana Labs 릴리스 수명 주기를 참고하세요.

`grafanactl`에서 마이그레이션 (Migrate from grafanactl)

grafanctl에서 gcx로 마이그레이션하려면 grafanactl을 gcx로 검색·바꾸기(search-and-replace) 해요. grafanactl resources serve의 경우 대신 gcx dev serve를 사용해요.

더 알아보기 (Learn more)

GitHub의 gcx 저장소에서 gcx 문서 전체를 참고하세요. 여기에는 다음에 대한 추가 정보가 포함돼요:

원문 문서