Skip to main content

telemetría de la CLI de GitHub

GitHub CLI envía telemetría seudonimosa para ayudar a mejorar el producto. Obtenga información sobre qué datos se recopilan y cómo rechazarlos.

Copiar como Markdown

En este artículo

¿Por qué GitHub CLI recopila datos de telemetría?

A medida que crece la adopción de GitHub CLI por parte de los agentes, conocer cómo se utilizan las funciones en la práctica ayuda a GitHub a mejorar el producto. Los datos de telemetría nos ayudan a priorizar el trabajo de desarrollo y a evaluar si las características satisfacen las necesidades reales del usuario.

Por ejemplo, cuando se envía un nuevo subcomando, la telemetría revela si alguien lo usa y cómo. Si la adopción es baja, indica que es necesario revisar la visibilidad o el diseño de la función. Si un subcomando registra un uso elevado con determinados indicadores, eso muestra dónde invertir para mejorar la experiencia.

Importante

Los datos de telemetría no se recopilan cuando el destino es GitHub Enterprise Server o el usuario se ha autenticado GitHub CLI con un GitHub Enterprise Server host.

Revisión de la telemetría

GitHub CLI es de código abierto. Puede revisar la implementación de telemetría en el repositorio cli/cli . Si desea ver exactamente lo que se enviaría sin enviarlo realmente, puede habilitar el modo de registro mediante una variable de entorno o una opción de configuración.

Variable de entorno:

export GH_TELEMETRY=log

Configuración de la CLI:

gh config set telemetry log

En el modo de registro, la carga útil JSON que normalmente se enviaría se imprime en stderr. Esto le permite inspeccionar cada campo antes de decidir si desea mantener habilitada la telemetría. Por ejemplo:

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

Esto imprime algo parecido a:

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"
      }
    }
  ]
}

Algunos comandos pueden incluir dimensiones de telemetría adicionales basadas en el contexto. En este ejemplo, los campos skill_ se incluyen porque el repo_visibility es public.

Nota:

Este comando solo puede registrar la telemetría del comando exacto y el contexto en el que se ejecutó. Cambiar las variables de entorno o las cuentas autenticadas puede cambiar los eventos y las dimensiones de evento incluidas en la carga.

Cómo darse de baja

Puede optar por no participar en la telemetría que se muestra en el modo log descrito anteriormente, ya sea mediante una variable de entorno o una opción de configuración.

Variables de entorno:

export GH_TELEMETRY=false

Cualquier valor falso funciona: 0, false, disabledo una cadena vacía. También puede usar la DO_NOT_TRACK convención:

export DO_NOT_TRACK=true

Configuración de la CLI:

gh config set telemetry disabled

Nota:

Las variables de entorno tienen prioridad sobre el valor de configuración.

Dónde se envían los datos

Los eventos de telemetría se envían a la infraestructura interna de análisis de GitHub. Para obtener más información sobre cómo GitHub controla los datos, consulte Declaración de privacidad general de GitHub.

Información adicional

GitHub CLI permite agregar características al producto mediante la instalación de extensiones autorizadas y de terceros, que incluyen agentes. Estas extensiones pueden recopilar sus propios datos de uso y no se controlan al optar por no participar. Consulte la documentación de la extensión específica para obtener información sobre sus informes de telemetría y si se puede deshabilitar.

En esta página se describe la recopilación de datos del lado cliente para GitHub CLI (gh). No se aplica a GitHub Copilot o GitHub Copilot CLI, que controla la recopilación de datos por separado. Para obtener información sobre GitHub Copilot CLI, vea Acerca de GitHub Copilot CLI y Tarjeta de aplicación: agentes de GitHub Copilot.