GitHub CLIがテレメトリを収集する理由

          GitHub CLIのエージェント的な導入が拡大するにつれて、機能がどのように実際に使用されているかを把握することは、製品の改善GitHubに役立ちます。 テレメトリ データは、開発作業に優先順位を付け、機能が実際のユーザーのニーズを満たしているかどうかを評価するのに役立ちます。

たとえば、新しいサブコマンドが出荷されると、テレメトリによって、誰かがそれを使用しているかどうかとその方法が明らかになります。 導入が少ない場合は、機能の検出可能性や設計を見直す必要があることを示します。 サブコマンドが特定のフラグで使用率が高いと見なされる場合は、より優れたエクスペリエンスに投資する場所を示します。

テレメトリの確認

          GitHub CLI はオープンソースです。 
          [cli/cli](https://github.com/cli/cli) リポジトリでテレメトリの実装を確認できます。 実際に送信せずに送信される内容を正確に確認する場合は、環境変数または構成オプションを使用してログ モードを有効にすることができます。

          **環境変数:**

export GH_TELEMETRY=log

          **CLI の構成:**

gh config set telemetry log

ログ モードでは、通常送信される JSON ペイロードが代わりに stderr に出力されます。 これにより、テレメトリを有効にしておくかどうかを決定する前にすべてのフィールドを検査できます。 例えば次が挙げられます。

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

これにより、次のような内容が出力されます。

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

一部のコマンドには、コンテキストに基づく追加のテレメトリ ディメンションが含まれる場合があります。 この例では、repo_visibilityがpublicであるため、skill_ フィールドが含まれています。

オプトアウトする方法

環境変数または構成オプションを使用して、前述の log モードで表示されるテレメトリをオプトアウトできます。

          **環境変数:**

export GH_TELEMETRY=false

          `0`、`false`、`disabled`、または空の文字列など、すべてのファリー値が機能します。 
          `DO_NOT_TRACK`規則を使用することもできます。

export DO_NOT_TRACK=true

          **CLI の構成:**

gh config set telemetry disabled

データが送信される場所

テレメトリ イベントは、 GitHubの内部分析インフラストラクチャに送信されます。 データ GitHub 処理方法の詳細については、「 GitHub の一般プライバシー ステートメント」を参照してください。

追加情報

          GitHub CLI を使用すると、エージェントを含む、 GitHub作成されたサード パーティの拡張機能をインストールすることで、製品に機能を追加できます。 これらの拡張機能は、独自の使用状況データを収集する可能性があり、オプトアウトによって制御されません。特定の拡張機能のドキュメントを参照して、そのテレメトリ レポートと無効にできるかどうかを確認してください。

このページでは、 GitHub CLI (gh) のクライアント側データ収集について説明します。 データ収集を個別に処理する GitHub Copilot または GitHub Copilot CLI（コマンドラインインターフェース）には適用されません。 GitHub Copilot CLI（コマンドラインインターフェース）の詳細については、GITHUB COPILOT CLI について と GitHub Copilot CLI の責任ある使用 を参照してください。