gcx

(★ 561)

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

파일 탐색기

최종 버전 다운로드 (.zip)

- settings.json
- marketplace.json
- - gcx.rb.tmpl
- - 1-bug-report.yml
  - 3-enhancement.yml
  - 4-feature-request.yml
  - config.yml
- - ci.yaml
  - claude-code-review.yml
  - claude.yml
  - deploy-pr-preview.yml
  - publish-docs.yaml
  - publish-homebrew-formula.yml
  - release.yaml
- CODEOWNERS
- - after-create
- - plugin.json
- - grafana-debugger.md
- assets.go
- README.md
- - main.go
  - main_test.go
  - telemetry.go
  - telemetry_internal_test.go
- - adr.md
  - bugfix-spec.md
  - feature-plan.md
  - feature-spec.md
  - feature-tasks.md
  - refactor-spec.md
  - research.md
- - .gitkeep
  - architecture.md
  - auth-system.md
  - cli-layer.md
  - client-api-layer.md
  - config-system.md
  - data-flows.md
  - login-system.md
  - patterns.md
  - project-structure.md
  - README.md
  - resource-model.md
- - custom.css
  - logo.svg
- - agent-mode.md
  - command-naming.md
  - environment-variables.md
  - errors.md
  - exit-codes.md
  - help-text.md
  - naming.md
  - output.md
  - pipe-awareness.md
  - provider-checklist.md
  - README.md
  - safety.md
- - dashboards-as-code.md
  - explore-modify-resources.md
  - index.md
  - lint-resources.md
  - manage-resources.md
- - 2026-03-31-setup-instrumentation-stage2.md
  - 2026-04-14-ux-consistency-design.md
  - 2026-04-22-homebrew-formula-implementation.md
  - 2026-07-20-config-format-rework.md
  - list-subject-verdicts.md
- - assistant-mcp-servers.md
  - costs.md
  - doc-maintenance.md
  - grafana-cloud-api-tiers.md
  - index.md
  - insecure-log-http-payload.md
  - login.md
  - migration-gap-analysis.md
  - provider-discovery-guide.md
  - provider-guide.md
  - stage-checklist.md
- - 2026-03-27-harness-engineering-gap-analysis.md
  - 2026-03-30-setup-framework.md
  - 2026-05-26-dependency-audit.md
  - 2026-06-26-datasources-management.md
  - 2026-07-17-global-limit-investigation.md
- - .gitignore
- - _index.md
  - anonymous-usage-statistics.md
  - configuration.md
  - installation.md
  - migrate-configuration.md
  - overview.md
- - .gitkeep
- bento_marketing_slide.html
- docs.mk
- index.md
- make-docs
- Makefile
- README.md
- variables.mk
- - agent.go
  - agent_test.go
  - annotations.go
  - availability.go
  - availability_test.go
  - command_annotations.go
  - command_skills.go
  - command_skills_test.go
  - known_resources.go
  - known_resources_test.go
  - validate.go
- - agentlog.go
  - agentlog_test.go
  - trim_test.go
- - api.go
  - api_test.go
  - approval_test.go
  - client.go
  - client_test.go
  - context_validation_test.go
  - conversation_list_codec.go
  - sse.go
  - state.go
  - state_test.go
  - transcript.go
  - transcript_codec.go
  - types.go
  - uuid.go
  - uuid_test.go
- - callback.go
  - exchange_error_test.go
  - export_test.go
  - flow.go
  - flow_test.go
  - flush_bsd.go
  - flush_linux.go
  - flush_other.go
  - gcom.go
  - gcom_test.go
  - manual.go
  - manual_test.go
  - paste.go
  - sanitize_test.go
  - transport.go
  - transport_test.go
- - gcom.go
  - gcom_test.go
- - cli_options.go
  - cli_options_test.go
  - cloud_destination_error_internal_test.go
  - cloud_host_test.go
  - cloud_login.go
  - cloud_login_test.go
  - config_check_keychain_test.go
  - context.go
  - context_test.go
  - credential_rejection.go
  - credential_rejection_internal_test.go
  - editor.go
  - editor_test.go
  - envparse.go
  - envparse_internal_test.go
  - envparse_test.go
  - errors.go
  - export_test.go
  - grafana_auth.go
  - grafana_auth_test.go
  - keychain.go
  - keychain_bound_internal_test.go
  - keychain_test.go
  - loader.go
  - loader_test.go
  - login_mutation.go
  - login_mutation_internal_test.go
  - login_mutation_test.go
  - merge.go
  - merge_test.go
  - migrate.go
  - migrate_internal_test.go
  - migrate_preflight.go
  - migrate_preflight_internal_test.go
  - migrate_verify_internal_test.go
  - path.go
  - path_test.go
  - previous.go
  - previous_test.go
  - resolver.go
  - resolver_test.go
  - rest.go
  - rest_persistence_test.go
  - rest_test.go
  - stack_id.go
  - stack_id_test.go
  - targetkind.go
  - targetkind_test.go
  - tls_test.go
  - types.go
  - types_test.go
  - version.go
  - version_internal_test.go
- - credentials.go
  - credentials_test.go
  - keychain.go
  - keychain_internal_test.go
- - renderer.go
  - renderer_test.go
  - types.go
  - types_test.go
- - apierror.go
  - client.go
  - client_test.go
  - diff.go
  - dualtransport.go
  - dualtransport_test.go
  - k8stransport.go
  - manifest.go
  - manifest_test.go
  - provider.go
  - registry.go
  - registry_test.go
  - schema.go
  - secrets.go
  - servedgroups.go
  - transport.go
- - browser.go
  - browser_test.go
  - deeplink.go
  - deeplink_open_test.go
  - deeplink_test.go
  - export_test.go
- - links.go
  - links_test.go
- - client.go
  - client_test.go
  - config.go
  - errors.go
- - codec.go
  - ordered_yaml.go
  - ordered_yaml_test.go
- - detailed.go
  - detailed_test.go
  - emitted.go
  - emitted_test.go
  - exitcodes.go
  - json.go
  - json_test.go
  - partial.go
  - reported.go
  - reported_test.go
- - client.go
  - client_internal_test.go
  - settings.go
  - settings_test.go
- - azuremonitor.go
  - chart.go
  - cloudmonitoring.go
  - cloudwatch.go
  - cloudwatch_test.go
  - colors.go
  - convert.go
  - elasticsearch.go
  - influxdb.go
  - pyroscope.go
  - pyroscope_test.go
  - tempo.go
  - tempo_test.go
  - types.go
- - callerid.go
  - callerid_test.go
  - client.go
  - client_test.go
  - context.go
  - debug_transport_test.go
  - logger.go
  - read.go
  - read_test.go
  - response.go
  - useragent.go
  - useragent_test.go
- - doc.go
  - export_test.go
  - io.go
  - linter.go
  - linter_test.go
  - report.go
  - reporter.go
  - restricted_capabilities_test.go
  - rules.go
  - tests.go
- - detect.go
  - detect_test.go
  - errors.go
  - errors_test.go
  - login.go
  - login_internal_test.go
  - login_test.go
  - tls_intent_internal_test.go
  - validate.go
  - validate_test.go
- - handler.go
  - minimal.go
- - path.go
  - path_test.go
  - run.go
  - run_test.go
  - skills.go
  - skills_test.go
  - state.go
  - state_test.go
  - version.go
  - version_test.go
- - agents.go
  - agents_test.go
  - artifact.go
  - artifact_test.go
  - encode_json_fields_test.go
  - export_test.go
  - field_select.go
  - field_select_test.go
  - format.go
  - format_options_test.go
  - format_test.go
  - integration_test.go
  - jq.go
  - jq_test.go
  - json_fields_integration_test.go
  - listmeta.go
  - listmeta_selection_test.go
  - listmeta_test.go
  - messages.go
  - mutation.go
  - mutation_test.go
  - pagination.go
  - pagination_test.go
  - stream.go
- - configloader.go
  - configloader_test.go
  - confirm.go
  - env.go
  - env_internal_test.go
  - fileinput.go
  - httperror.go
  - httperror_test.go
  - provider.go
  - provider_test.go
  - redact.go
  - redact_test.go
  - registry.go
- - apierror.go
  - apierror_test.go
- - descriptor.go
  - export_test.go
  - filter.go
  - filter_test.go
  - gvk_normalize.go
  - gvk_normalize_test.go
  - resources.go
  - resources_test.go
  - selector.go
  - selector_test.go
- - export_test.go
  - transport.go
  - transport_test.go
- - redactor.go
  - redactor_test.go
- - export_test.go
  - server.go
  - server_test.go
  - tmpl.go
- - dates.go
  - dates_test.go
- - command.go
  - command_test.go
  - datasource.go
- - describe.go
  - describe_test.go
  - install.go
- - strcase.go
  - strcase_test.go
- - banner.go
  - colors.go
  - colors_test.go
  - help.go
  - help_internal_test.go
  - help_test.go
  - table.go
  - table_test.go
  - theme.go
- - bucket.go
  - bucket_test.go
  - ci.go
  - ci_internal_test.go
  - deviceid.go
  - deviceid_test.go
  - event.go
  - event_test.go
  - export.go
  - export_internal_test.go
  - firstrun.go
  - firstrun_internal_test.go
  - telemetry.go
  - telemetry_internal_test.go
- - remote.go
  - remote_test.go
  - terminal.go
  - terminal_test.go
- - agent.go
  - command.go
  - configsandbox.go
  - factorycontext.go
  - fs.go
- - version.go
  - version_test.go
- - xdg.go
  - xdg_test.go
- .gitkeep
- releasing.md
- - main.go
- - main.go
- - main.go
- - main.go
- - main.go
- install.sh
- install_test.sh
- tag.sh
- tag_test.sh
- default-config.yaml
- folder.yaml
- grafana.ini
- integration-test-config.yaml
.gitignore
.gitmessage
.golangci.yaml
.goreleaser.yaml
.markdownlint.json
.release-notes.md
AGENTS.md
ARCHITECTURE.md
catalog-info.yaml
CHANGELOG.md
CLAUDE.md
CONSTITUTION.md
CONTRIBUTING.md
DESIGN.md
docker-compose.yml
gcx.png
go.mod
go.sum
graph_example.png
LICENSE
mise.toml
mkdocs.yml
README.md
renovate.json
requirements.txt
VISION.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/grafana/gcx

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd gcx

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Homebrew macOS/Linux용 패키지 매니저입니다.
Go go install 명령어를 쓰려면 Go가 필요합니다.

curl -fsSL https://raw.githubusercontent.com/grafana/gcx/main/scripts/install.sh | sh

공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.

brew install gcx

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

brew install grafana/grafana/gcx

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

go install github.com/grafana/gcx/cmd/gcx@latest

지정된 버전을 바로 다운로드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker compose up -d --build

정의된 모든 컨테이너(서버, DB 등)를 한 번에 빌드하고 백그라운드에서 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

4. Python

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install -r requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

5. Go

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go install github.com/grafana/gcx/cmd/gcx@latest

지정된 버전을 바로 다운로드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

go run . && gcx resources push -p ./resources

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

gcx

파일 탐색기

# 설치 가이드

2. 공식 설치 스크립트

3. Docker

4. Python

5. Go

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

gcx

파일 탐색기

# 설치 가이드

2. 공식 설치 스크립트

3. Docker

4. Python

5. Go

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README