¿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.

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](https://github.com/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.

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

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 CLI de GitHub Copilot, que controla la recopilación de datos por separado. Para obtener información sobre CLI de GitHub Copilot, vea Acerca de GitHub Copilot CLI y Uso responsable de GitHub Copilot CLI.