{"meta":{"title":"telemetria da CLI GitHub","intro":"GitHub CLI envia telemetria pseudônima para ajudar a melhorar o produto. Saiba quais dados são coletados e como recusar.","product":"GitHub CLI","breadcrumbs":[{"href":"/pt/enterprise-server@3.17/github-cli","title":"GitHub CLI"},{"href":"/pt/enterprise-server@3.17/github-cli/github-cli","title":"CLI GitHub"},{"href":"/pt/enterprise-server@3.17/github-cli/github-cli/github-cli-telemetry","title":"telemetria da CLI GitHub"}],"documentType":"article"},"body":"# telemetria da CLI GitHub\n\nGitHub CLI envia telemetria pseudônima para ajudar a melhorar o produto. Saiba quais dados são coletados e como recusar.\n\n## Por que GitHub CLI coleta telemetria\n\nÀ medida que a adoção ativa de GitHub CLI aumenta, a visibilidade de como os recursos são usados ​​na prática ajuda GitHub a aprimorar o produto. Os dados de telemetria nos ajudam a priorizar o trabalho de desenvolvimento e avaliar se os recursos atendem às necessidades reais do usuário.\n\nPor exemplo, quando um novo subcomando é enviado, a telemetria revela se alguém está usando e como. Se a adoção for baixa, isso sinalizará a necessidade de revisitar a descoberta ou o design do recurso. Se um subcomando apresentar alta taxa de uso com determinadas opções, isso indica onde investir para uma melhor experiência.\n\n> \\[!IMPORTANT]\n> Os dados de telemetria não são coletados quando o destino é GitHub Enterprise Server ou o usuário autenticou-se GitHub CLI com um host GitHub Enterprise Server.\n\n## Revisão da telemetria\n\nGitHub CLI é código aberto. Você pode examinar a implementação de telemetria no repositório [cli/cli](https://github.com/cli/cli) . Se você quiser ver exatamente o que seria enviado sem realmente enviá-lo, poderá habilitar o modo de registro em log usando uma variável de ambiente ou uma opção de configuração.\n\n**Variável de ambiente:**\n\n```shell\nexport GH_TELEMETRY=log\n```\n\n**Configuração da CLI:**\n\n```shell\ngh config set telemetry log\n```\n\nNo modo de registro, o payload JSON que normalmente seria enviada é impressa no stderr. Isso permite inspecionar todos os campos antes de decidir se deseja manter a telemetria habilitada. Por exemplo:\n\n```shell\nGH_TELEMETRY=log gh skill install github/awesome-copilot git-commit --agent github-copilot --scope project\n```\n\nIsso imprime algo como:\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\nAlguns comandos podem incluir dimensões de telemetria adicionais com base no contexto. Neste exemplo, os `skill_` campos são incluídos porque o `repo_visibility` é `public`.\n\n> \\[!NOTE]\n> Esse comando só pode registrar a telemetria para o comando exato e o contexto no qual ele foi executado. Alterar variáveis de ambiente ou contas autenticadas pode alterar os eventos e as dimensões de evento incluídas no conteúdo.\n\n## Como recusar\n\nVocê pode desativar a telemetria exibida no modo `log` descrito acima usando uma variável de ambiente ou uma opção de configuração.\n\n**Variáveis de ambiente:**\n\n```shell\nexport GH_TELEMETRY=false\n```\n\nQualquer valor falso funciona: `0`, , `false`ou `disabled`uma cadeia de caracteres vazia. Você também pode usar a `DO_NOT_TRACK` convenção:\n\n```shell\nexport DO_NOT_TRACK=true\n```\n\n**Configuração da CLI:**\n\n```shell\ngh config set telemetry disabled\n```\n\n> \\[!NOTE]\n> As variáveis de ambiente têm precedência sobre o valor de configuração.\n\n## Para onde os dados são enviados\n\nOs eventos de telemetria são enviados para a GitHubinfraestrutura de análise interna. Para obter mais informações sobre como GitHub lida com seus dados, consulte [Declaração Geral de Privacidade do GitHub](/pt/site-policy/privacy-policies/github-general-privacy-statement).\n\n## Informações adicionais\n\nGitHub CLI permite adicionar recursos ao produto instalando extensões de autoria de GitHub e de terceiros, incluindo agentes. Essas extensões podem coletar seus próprios dados de uso e não são controladas pela recusa. Consulte a documentação da extensão específica para saber mais sobre seus relatórios de telemetria e se ela pode ser desabilitada.\n\nEsta página descreve a coleta de dados do lado do cliente para GitHub CLI (`gh`). Ele não se aplica a GitHub Copilot ou CLI do GitHub Copilot, que manipula a coleta de dados separadamente. Para obter informações sobre o CLI do GitHub Copilot[, consulte AUTOTITLE](/pt/copilot/concepts/agents/copilot-cli/about-copilot-cli) e [Cartão de aplicativo: GitHub Copilot Agents](/pt/copilot/responsible-use/agents)."}