{"meta":{"title":"GitHub CLI 텔레메트리","intro":"GitHub CLI 는 제품을 개선하는 데 도움이 되는 가명 원격 분석을 보냅니다. 수집되는 데이터 및 옵트아웃 방법을 알아봅니다.","product":"GitHub CLI","breadcrumbs":[{"href":"/ko/enterprise-server@3.19/github-cli","title":"GitHub CLI"},{"href":"/ko/enterprise-server@3.19/github-cli/github-cli","title":"GitHub CLI (GitHub 명령줄 인터페이스)"},{"href":"/ko/enterprise-server@3.19/github-cli/github-cli/github-cli-telemetry","title":"GitHub CLI 텔레메트리"}],"documentType":"article"},"body":"# GitHub CLI 텔레메트리\n\nGitHub CLI 는 제품을 개선하는 데 도움이 되는 가명 원격 분석을 보냅니다. 수집되는 데이터 및 옵트아웃 방법을 알아봅니다.\n\n## GitHub CLI에서 원격 분석을 수집하는 이유\n\nGitHub CLI에 대한 에어전트의 도입이 증가하면서, 실제로 기능을 사용하는 방법에 대한 가시성은 GitHub이(가) 제품을 개선하는 데 도움이 됩니다. 원격 분석 데이터는 개발 작업의 우선 순위를 지정하고 기능이 실제 사용자 요구를 충족하는지 여부를 평가하는 데 도움이 됩니다.\n\n예를 들어 새 하위 명령이 제공되면 원격 분석에서 해당 하위 명령이 사용 중인지 여부와 방법을 알 수 있습니다. 채택이 낮으면 기능의 검색 가능성 또는 디자인을 다시 확인해야 한다는 신호입니다. 하위 명령에서 특정 플래그로 높은 사용량을 볼 경우 더 나은 환경에 투자할 위치를 보여 줍니다.\n\n> \\[!IMPORTANT]\n> 대상이 GitHub Enterprise Server이거나 사용자가 GitHub CLI 호스트를 통해 GitHub Enterprise Server 인증한 경우, 원격 분석 데이터가 수집되지 않습니다.\n\n## 원격 분석 데이터 검토\n\nGitHub CLI 오픈 소스입니다.\n[cli/cli](https://github.com/cli/cli) 리포지토리에서 원격 분석 구현을 검토할 수 있습니다. 실제로 전송하지 않고 전송되는 항목을 정확하게 확인하려면 환경 변수 또는 구성 옵션을 사용하여 로깅 모드를 사용하도록 설정할 수 있습니다.\n\n**환경 변수:**\n\n```shell\nexport GH_TELEMETRY=log\n```\n\n**CLI 구성:**\n\n```shell\ngh config set telemetry log\n```\n\n로깅 모드에서는 일반적으로 전송되는 JSON 페이로드가 stderr에 대신 인쇄됩니다. 이렇게 하면 원격 분석을 사용하도록 설정할지 여부를 결정하기 전에 모든 필드를 검사할 수 있습니다. 다음은 그 예입니다.\n\n```shell\nGH_TELEMETRY=log gh skill install github/awesome-copilot git-commit --agent github-copilot --scope project\n```\n\n다음과 같이 출력됩니다.\n\n```text\nTelemetry payload:\n{\n  \"events\": [\n    {\n      \"type\": \"skill_install\",\n      \"dimensions\": {\n        \"agent\": \"\",\n        \"agent_hosts\": \"github-copilot\",\n        \"architecture\": \"arm64\",\n        \"ci\": \"false\",\n        \"device_id\": \"1e9a73a6-c8bd-4e1e-be02-78f4b11de4e1\",\n        \"github_actions\": \"false\",\n        \"invocation_id\": \"96d4862f-26c9-4385-961d-d749ae519c81\",\n        \"is_tty\": \"true\",\n        \"os\": \"darwin\",\n        \"repo_visibility\": \"public\",\n        \"skill_host_type\": \"github.com\",\n        \"skill_names\": \"git-commit\",\n        \"skill_owner\": \"github\",\n        \"skill_repo\": \"awesome-copilot\",\n        \"timestamp\": \"2026-04-24T11:54:51.057Z\",\n        \"upstream_source\": \"none\",\n        \"version\": \"2.91.0\"\n      }\n    },\n    {\n      \"type\": \"command_invocation\",\n      \"dimensions\": {\n        \"agent\": \"\",\n        \"architecture\": \"arm64\",\n        \"ci\": \"false\",\n        \"command\": \"gh skill install\",\n        \"device_id\": \"1e9a73a6-c8bd-4e1e-be02-78f4b11de4e1\",\n        \"flags\": \"agent,scope\",\n        \"github_actions\": \"false\",\n        \"invocation_id\": \"96d4862f-26c9-4385-961d-d749ae519c81\",\n        \"is_tty\": \"true\",\n        \"os\": \"darwin\",\n        \"timestamp\": \"2026-04-24T11:54:51.057Z\",\n        \"version\": \"2.91.0\"\n      }\n    }\n  ]\n}\n```\n\n일부 명령에는 컨텍스트를 기반으로 하는 추가 원격 분석 차원이 포함될 수 있습니다. 이 예제에서는 `skill_` 필드가 포함되어 있는 이유는 `repo_visibility`이 `public`이기 때문입니다.\n\n> \\[!NOTE]\n> 이 명령은 실행된 정확한 명령 및 컨텍스트에 대한 원격 분석만 기록할 수 있습니다. 환경 변수 또는 인증된 계정을 변경하면 페이로드에 포함된 이벤트 및 이벤트 차원이 변경될 수 있습니다.\n\n## 옵트아웃하는 방법\n\n환경 변수나 구성 옵션을 사용하여 위에 설명된 `log` 모드에서 볼 수 있는 원격 분석을 사용하지 않도록 설정할 수 있습니다.\n\n**환경 변수:**\n\n```shell\nexport GH_TELEMETRY=false\n```\n\n모든 거짓 같은 값은 `0`, `false`, `disabled` 또는 빈 문자열로 작동합니다.\n`DO_NOT_TRACK` 규칙을 사용할 수도 있습니다.\n\n```shell\nexport DO_NOT_TRACK=true\n```\n\n**CLI 구성:**\n\n```shell\ngh config set telemetry disabled\n```\n\n> \\[!NOTE]\n> 환경 변수가 구성 값보다 우선합니다.\n\n## 데이터가 전송되는 위치\n\n원격 분석 이벤트는 GitHub의 내부 분석 인프라로 전송됩니다. 데이터를 처리하는 방법에 GitHub 대한 자세한 내용은 [GitHub 일반 개인정보처리방침](/ko/site-policy/privacy-policies/github-general-privacy-statement)을 참조하세요.\n\n## 추가 정보\n\nGitHub CLI를 사용하면 GitHub 제품에 기능을 추가할 수 있으며, 에이전트를 포함하여 사용자가 개발한 확장 및 타사 확장을 설치할 수 있습니다. 이러한 확장은 자체 사용량 현황 데이터를 수집할 수 있으며 옵트아웃을 통해 제어되지 않습니다. 특정 확장 설명서를 참조하여 원격 분석 보고 및 사용하지 않도록 설정할 수 있는지 여부를 알아보세요.\n\n이 페이지에서는 GitHub CLI (`gh`)에 대한 클라이언트 측 데이터 수집을 설명합니다.\nGitHub Copilot 또는 GitHub Copilot 명령 줄 인터페이스 (CLI)에는 적용되지 않으며, 이들은 각각 데이터 수집을 별도로 처리합니다.\nGitHub Copilot 명령 줄 인터페이스 (CLI)\n[GitHub Copilot CLI 정보](/ko/copilot/concepts/agents/copilot-cli/about-copilot-cli)와 [애플리케이션 카드: GitHub Copilot 에이전트](/ko/copilot/responsible-use/agents)를 참조하세요."}