# GitHub CLI 텔레메트리

GitHub CLI 는 제품을 개선하는 데 도움이 되는 가명 원격 분석을 보냅니다. 수집되는 데이터 및 옵트아웃 방법을 알아봅니다.

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

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

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

> \[!IMPORTANT]
> 대상이 GitHub Enterprise Server이거나 사용자가 GitHub CLI 호스트를 통해 GitHub Enterprise Server 인증한 경우, 원격 분석 데이터가 수집되지 않습니다.

## 원격 분석 데이터 검토

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

**환경 변수:**

```shell
export GH_TELEMETRY=log
```

**CLI 구성:**

```shell
gh config set telemetry log
```

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

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

다음과 같이 출력됩니다.

```text
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`이기 때문입니다.

> \[!NOTE]
> 이 명령은 실행된 정확한 명령 및 컨텍스트에 대한 원격 분석만 기록할 수 있습니다. 환경 변수 또는 인증된 계정을 변경하면 페이로드에 포함된 이벤트 및 이벤트 차원이 변경될 수 있습니다.

## 옵트아웃하는 방법

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

**환경 변수:**

```shell
export GH_TELEMETRY=false
```

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

```shell
export DO_NOT_TRACK=true
```

**CLI 구성:**

```shell
gh config set telemetry disabled
```

> \[!NOTE]
> 환경 변수가 구성 값보다 우선합니다.

## 데이터가 전송되는 위치

원격 분석 이벤트는 GitHub의 내부 분석 인프라로 전송됩니다. 데이터를 처리하는 방법에 GitHub 대한 자세한 내용은 [GitHub 일반 개인정보처리방침](/ko/site-policy/privacy-policies/github-general-privacy-statement)을 참조하세요.

## 추가 정보

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

이 페이지에서는 GitHub CLI (`gh`)에 대한 클라이언트 측 데이터 수집을 설명합니다.
GitHub Copilot 또는 GitHub Copilot 명령 줄 인터페이스 (CLI)에는 적용되지 않으며, 이들은 각각 데이터 수집을 별도로 처리합니다.
GitHub Copilot 명령 줄 인터페이스 (CLI)
[GitHub Copilot CLI 정보](/ko/copilot/concepts/agents/copilot-cli/about-copilot-cli)와 [애플리케이션 카드: GitHub Copilot 에이전트](/ko/copilot/responsible-use/agents)를 참조하세요.