GitHub CLI가 이제 가명 익명 텔레메트리를 수집합니다

Source: Hacker News

Telemetry

GitHub CLI는 제품을 개선하기 위해 가명 텔레메트리를 전송합니다. 어떤 데이터가 전송되는지와 그 이유를 이해하시길 바랍니다.

Why we collect telemetry

GitHub CLI의 에이전시 채택이 증가함에 따라, 우리 팀은 실제 사용 상황에서 기능이 어떻게 사용되는지에 대한 가시성이 필요합니다. 우리는 이 데이터를 다음과 같은 목적에 사용합니다:

• 작업 우선순위 지정
• 기능이 실제 사용자 요구를 충족하는지 평가

예를 들어, 새로운 서브커맨드를 배포했을 때, 누가 사용하고 어떻게 사용하는지 파악하고 싶습니다. 채택률이 낮다면 기능의 발견성이나 설계를 재검토해야 함을 알 수 있습니다. 특정 플래그와 함께 서브커맨드 사용량이 높다면, 더 나은 경험을 제공하기 위해 어디에 투자할지 알려줍니다.

Reviewing telemetry

GitHub CLI는 오픈 소스이며, 텔레메트리 구현은 cli/cli 저장소에서 확인할 수 있습니다. 실제로 전송하지 않고 어떤 데이터가 전송될지 확인하려면 환경 변수나 설정 옵션을 사용해 로깅 모드를 활성화하십시오.

Environment variable

export GH_TELEMETRY=log

CLI config

gh config set telemetry log

로깅 모드에서는 일반적으로 전송되는 JSON 페이로드가 stderr에 출력됩니다. 이를 통해 텔레메트리를 유지할지 결정하기 전에 모든 필드를 검사할 수 있습니다. 예시:

GH_TELEMETRY=log gh repo list --archived

명령은 다음과 유사한 내용을 출력합니다:

Telemetry payload:
{
  "events": [
    {
      "type": "command_invocation",
      "dimensions": {
        "agent": "",
        "architecture": "arm64",
        "command": "gh repo list",
        "device_id": "1e9a73a6-c8bd-4e1e-be02-78f4b11de4e1",
        "flags": "archived",
        "invocation_id": "eda780f5-27f9-433c-a7ae-7a033361e572",
        "is_tty": "true",
        "os": "darwin",
        "timestamp": "2026-04-16T14:55:13.418Z",
        "version": "2.91.0"
      }
    }
  ]
}

Note: 이 명령은 실행된 정확한 명령과 컨텍스트에 대한 텔레메트리만 로그합니다. 환경 변수, 인증된 계정, 기타 요인이 변경되면 이벤트와 차원도 달라질 수 있습니다.

How to opt out

환경 변수나 설정 옵션을 사용해 텔레메트리를 비활성화할 수 있습니다.

Environment variables

export GH_TELEMETRY=false

거짓값이면 모두 동작합니다: 0, false, disabled, 빈 문자열 등. DO_NOT_TRACK 관례를 사용할 수도 있습니다:

export DO_NOT_TRACK=true

CLI config

gh config set telemetry disabled

Note: 환경 변수가 설정값보다 우선합니다.

Where data is sent

텔레메트리 이벤트는 GitHub 내부 분석 인프라로 전송됩니다. GitHub가 데이터를 어떻게 처리하는지에 대한 자세한 내용은 GitHub General Privacy Statement를 참고하십시오.

Additional information

• GitHub CLI는 GitHub 및 서드파티 확장(에이전트 포함)을 설치해 기능을 추가할 수 있습니다. 이러한 확장은 자체 사용 데이터를 수집할 수 있으며, 옵트아웃으로 제어되지 않습니다. 각 확장의 텔레메트리 보고 및 비활성화 방법은 해당 문서를 확인하십시오.
• 이 페이지는 GitHub CLI(gh)의 클라이언트 측 데이터 수집에 대해 설명합니다. GitHub Copilot이나 Copilot CLI에는 적용되지 않으며, 이들은 별도로 데이터 수집을 처리합니다. Copilot CLI에 대한 정보는 다음을 참고하십시오:
  • Using GitHub Copilot CLI
  • Responsible Use of the GitHub Copilot CLI