GitHub CLI가 이제 가명 기반 텔레메트리를 수집함

4 hours ago 2

(cli.github.com/telemetry)

가명 기반 텔레메트리를 GitHub CLI에서 전송하며, 목적은 기능 사용 가시성 확보와 제품 개선 지원
subcommand 채택 여부와 flags 사용 패턴을 바탕으로 작업 우선순위 결정, 사용자 요구 충족 여부 평가, discoverability와 design 재검토에 활용됨
오픈소스 구현으로 cli/cli 저장소에서 텔레메트리 코드를 직접 검토할 수 있으며, logging mode로 실제 전송 전 JSON payload 확인 가능
옵트아웃은 환경 변수 GH_TELEMETRY=false, DO_NOT_TRACK=true 또는 gh config set telemetry disabled로 가능하며, 환경 변수가 config보다 우선 적용됨
텔레메트리 이벤트는 GitHub 내부 분석 인프라로 전송되며, 이 페이지는 gh의 클라이언트 측 데이터 수집만 다루고 extensions와 Copilot CLI는 별도 대상임

텔레메트리

GitHub CLI 기능 사용 가시성 확보 필요성 언급, 특히 agentic adoption 증가에 따라 실제 사용 방식 파악 목적
- 팀이 이 데이터를 사용해 작업 우선순위 결정
- 기능이 실제 사용자 요구를 충족하는지 평가
새 subcommand 출시 후 채택 여부 확인 목적 명시
- 사용자가 거의 없으면 해당 기능의 discoverability 또는 design 재검토 필요
- 특정 flags와 함께 높은 사용량이 확인되면 더 나은 경험에 투자할 지점 파악 가능

GitHub CLI가 오픈소스이며, 텔레메트리 구현을 cli/cli 저장소에서 직접 검토 가능
실제 전송 없이 전송 예정 데이터를 확인하려면 logging mode 사용 가능
- 환경 변수 방식 지원
  - export GH_TELEMETRY=log
- CLI 설정 방식 지원
  - gh config set telemetry log
logging mode에서는 원래 전송될 JSON payload가 stderr에 출력됨
- 텔레메트리를 계속 활성화할지 결정하기 전에 각 필드 점검 가능
- 예시 명령으로 GH_TELEMETRY=log gh repo list --archived 제시
예시 payload에 포함된 이벤트 정보 명시
- 이벤트 타입 command_invocation
- dimensions 항목으로 agent, architecture, command, device_id, flags, invocation_id, is_tty, os, timestamp, version 포함
- 예시 값으로 architecture: arm64, command: gh repo list, flags: archived, os: darwin, version: 2.91.0 표시
해당 명령은 실행된 정확한 명령과 컨텍스트에 대한 텔레메트리만 로그 가능
- 환경 변수 변경 시 payload에 포함되는 events와 event dimensions가 달라질 수 있음
- 인증된 계정 변경 시에도 포함 항목이 달라질 수 있음

logging mode에서 확인한 텔레메트리에 대해 옵트아웃 가능
환경 변수 방식 지원
- export GH_TELEMETRY=false
- falsy 값으로 0, false, disabled, 빈 문자열 사용 가능
- DO_NOT_TRACK 관례도 지원하며 export DO_NOT_TRACK=true 예시 제공
CLI 설정 방식 지원
- gh config set telemetry disabled
환경 변수 우선순위가 config 값보다 높음

GitHub CLI는 GitHub 및 서드파티 extensions 설치를 통한 기능 추가 지원, agents 포함
이 extensions는 자체 사용 데이터 수집 가능성 존재
- 옵트아웃 설정으로 제어되지 않음
- 각 extension 문서를 통해 텔레메트리 보고 방식과 비활성화 가능 여부 확인 필요
이 페이지는 GitHub CLI gh의 클라이언트 측 데이터 수집만 다룸
- GitHub Copilot 및 Copilot CLI에는 적용되지 않음
- Copilot CLI는 별도로 데이터 수집 처리
- 관련 정보 위치로 Using GitHub Copilot CLI, Responsible Use of the GitHub Copilot CLI 안내