GitHub CLI에서 원격 분석을 수집하는 이유

GitHub CLI에 대한 에어전트의 도입이 증가하면서, 실제로 기능을 사용하는 방법에 대한 가시성은 GitHub이(가) 제품을 개선하는 데 도움이 됩니다. 원격 분석 데이터는 개발 작업의 우선 순위를 지정하고 기능이 실제 사용자 요구를 충족하는지 여부를 평가하는 데 도움이 됩니다.

예를 들어 새 하위 명령이 제공되면 원격 분석에서 해당 하위 명령이 사용 중인지 여부와 방법을 알 수 있습니다. 채택이 낮으면 기능의 검색 가능성 또는 디자인을 다시 확인해야 한다는 신호입니다. 하위 명령에서 특정 플래그로 높은 사용량을 볼 경우 더 나은 환경에 투자할 위치를 보여 줍니다.

원격 분석 데이터 검토

          GitHub CLI 오픈 소스입니다. 
          [cli/cli](https://github.com/cli/cli) 리포지토리에서 원격 분석 구현을 검토할 수 있습니다. 실제로 전송하지 않고 전송되는 항목을 정확하게 확인하려면 환경 변수 또는 구성 옵션을 사용하여 로깅 모드를 사용하도록 설정할 수 있습니다.

          **환경 변수:**

export GH_TELEMETRY=log

          **CLI 구성:**

gh config set telemetry log

로깅 모드에서는 일반적으로 전송되는 JSON 페이로드가 stderr에 대신 인쇄됩니다. 이렇게 하면 원격 분석을 사용하도록 설정할지 여부를 결정하기 전에 모든 필드를 검사할 수 있습니다. 다음은 그 예입니다.

GH_TELEMETRY=log gh skill install github/awesome-copilot git-commit --agent github-copilot --scope project

다음과 같이 출력됩니다.

Telemetry payload:
{
  "events": [
    {
      "type": "skill_install",
      "dimensions": {
        "agent": "",
        "agent_hosts": "github-copilot",
        "architecture": "arm64",
        "ci": "false",
        "device_id": "1e9a73a6-c8bd-4e1e-be02-78f4b11de4e1",
        "github_actions": "false",
        "invocation_id": "96d4862f-26c9-4385-961d-d749ae519c81",
        "is_tty": "true",
        "os": "darwin",
        "repo_visibility": "public",
        "skill_host_type": "github.com",
        "skill_names": "git-commit",
        "skill_owner": "github",
        "skill_repo": "awesome-copilot",
        "timestamp": "2026-04-24T11:54:51.057Z",
        "upstream_source": "none",
        "version": "2.91.0"
      }
    },
    {
      "type": "command_invocation",
      "dimensions": {
        "agent": "",
        "architecture": "arm64",
        "ci": "false",
        "command": "gh skill install",
        "device_id": "1e9a73a6-c8bd-4e1e-be02-78f4b11de4e1",
        "flags": "agent,scope",
        "github_actions": "false",
        "invocation_id": "96d4862f-26c9-4385-961d-d749ae519c81",
        "is_tty": "true",
        "os": "darwin",
        "timestamp": "2026-04-24T11:54:51.057Z",
        "version": "2.91.0"
      }
    }
  ]
}

일부 명령에는 컨텍스트를 기반으로 하는 추가 원격 분석 차원이 포함될 수 있습니다. 이 예제에서는 skill_ 필드가 포함되어 있는 이유는 repo_visibility이 public이기 때문입니다.

옵트아웃하는 방법

환경 변수나 구성 옵션을 사용하여 위에 설명된 log 모드에서 볼 수 있는 원격 분석을 사용하지 않도록 설정할 수 있습니다.

          **환경 변수:**

export GH_TELEMETRY=false

모든 거짓 같은 값은 0, false, disabled 또는 빈 문자열로 작동합니다. DO_NOT_TRACK 규칙을 사용할 수도 있습니다.

export DO_NOT_TRACK=true

          **CLI 구성:**

gh config set telemetry disabled

데이터가 전송되는 위치

원격 분석 이벤트는 GitHub의 내부 분석 인프라로 전송됩니다. 데이터를 처리하는 방법에 GitHub 대한 자세한 내용은 GitHub 일반 개인정보처리방침을 참조하세요.

추가 정보

          GitHub CLI를 사용하면 GitHub 제품에 기능을 추가할 수 있으며, 에이전트를 포함하여 사용자가 개발한 확장 및 타사 확장을 설치할 수 있습니다. 이러한 확장은 자체 사용량 현황 데이터를 수집할 수 있으며 옵트아웃을 통해 제어되지 않습니다. 특정 확장 설명서를 참조하여 원격 분석 보고 및 사용하지 않도록 설정할 수 있는지 여부를 알아보세요.

이 페이지에서는 GitHub CLI (gh)에 대한 클라이언트 측 데이터 수집을 설명합니다. GitHub Copilot 또는 GitHub Copilot 명령 줄 인터페이스 (CLI)에는 적용되지 않으며, 이들은 각각 데이터 수집을 별도로 처리합니다. GitHub Copilot 명령 줄 인터페이스 (CLI) GitHub Copilot CLI 정보와 GitHub Copilot CLI의 책임 있는 사용를 참조하세요.