メインコンテンツへスキップ

GitHub を接続する

GitHub は、ソフトウェア開発・バージョン管理・コラボレーションのための世界有数のプラットフォームです。GitHub インテグレーションは、GitHub Actions・Copilot・Packages などを含む組織またはエンタープライズの請求データを Cloud Intelligence に取り込み、Cloud Analytics（クラウド分析）で GitHub コストを分析できるようにします。

前提条件​

開始する前に、次の条件を満たしていることを確認してください。

  • GitHub の Owner 権限を持つ組織またはエンタープライズアカウント

  • Billing Profiles Admin 権限を持つ DoiT アカウント

接続の概要​

GitHub インテグレーションは、次の 2 つの接続レベルをサポートします。

Connection levelScopeBest for
Organization単一の GitHub 組織1 つの組織を管理するチーム
Enterpriseすべての組織を含む GitHub エンタープライズ全体複数の組織を持つエンタープライズ

DoiT は、請求データに対して OAuth を使用して GitHub に接続します。オプションとして、請求の接続が完了した後に DoiT GitHub App をインストールし、Copilot のシート割り当て・Copilot の利用メトリクス・GitHub Advanced Security などのリッチデータを有効にすることができます。詳しくは、GitHub App でリッチデータを有効にする を参照してください。

GitHub アカウントを接続する​

ステップ 1: 接続ウィザードを開始する​

  1. Cloud Intelligence にサインインし、上部ナビゲーションのメガメニューから データ取り込みとインテグレーション > インテグレーション を選択します。

  2. インテグレーションカタログで GitHub を検索します。

  3. インテグレーションカードで Connect + を選択します。

ステップ 2: 接続レベルを選択する​

  1. Connection Level を選択します。

    • Organization — 単一の GitHub 組織を接続します。
    • Enterprise — GitHub エンタープライズアカウント全体を接続します。

  2. Org or Enterprise Slug を入力します。これは、組織またはエンタープライズの URL フレンドリーな名前です（例: my-company）。

    ヒント

    組織の slug は、GitHub 組織を表示しているときの URL にあります。github.com/ my-company のように表示されます。エンタープライズアカウントの場合は、github.com/enterprises/ my-company に移動します。

ステップ 3: OAuth で承認する​

  1. Connect with GitHub を選択して OAuth フローを開始します。GitHub にリダイレクトされ、（まだサインインしていない場合は）サインインし、DoiT に請求データへのアクセスを許可します。

  2. 要求されている権限を確認し、Authorize を選択します。

    DoiT は次の OAuth スコープを要求します。

    • admin:org — 組織の請求および利用状況データを読み取ります。
    • read:enterprise — エンタープライズの請求データを読み取ります（エンタープライズ接続の場合）。

    承認後、Cloud Intelligence にリダイレクトされます。

ステップ 4: テストして保存する​

  1. Test connection を選択し、DoiT が GitHub の請求データにアクセスできることを確認します。

  2. テストが成功したら、Save を選択してセットアップを完了します。

    テストが失敗した場合や、さらなるサポートが必要な場合は、エキスパートへ問い合わせ を開いてください。

注意

初回接続時、DoiT は最大 90 日間 の過去の請求データを取り込みます。インポート処理には数時間かかることがあります。データが Cloud Analytics で利用可能になると、メールでお知らせします。

オプション: GitHub App でリッチデータを有効にする​

Copilot の利用状況や GitHub Advanced Security をより詳しく可視化するには、請求接続の完了後にオプションの DoiT GitHub App をインストールしてください。

GitHub App によって、次のデータにアクセスできるようになります。

  • Copilot のシート割り当て: Copilot ライセンスを保有しているユーザーを確認できます。
  • Copilot の利用メトリクス: 利用状況やアクティビティを追跡できます。
  • GitHub Advanced Security: リポジトリごとの GHAS コミッター数を確認できます。

  1. Cloud Intelligence にサインインし、上部ナビゲーションのメガメニューから データ取り込みとインテグレーション > インテグレーション を選択します。

  2. インテグレーションカタログで GitHub を検索します。

  3. インテグレーションカードで Manage を選択します。

  4. 接続テーブルで、リッチデータを有効にしたい接続の Supplementary data 列を探します。

  5. Connect を選択し、GitHub App のインストールフローを開始します。

  6. GitHub 上でインストールと承認の手順を完了します。DoiT に戻ると、Supplementary data 列に Connected と表示されます。

データ更新​

DoiT は GitHub の請求データを 6 時間 ごとに更新します。請求データは、GitHub によって生成されてから通常 24〜26 時間以内に利用可能になります。

レポートディメンション​

接続が完了すると、GitHub の請求データは次の標準的な Cloud Analytics（クラウド分析）のディメンション にマッピングされます。

Cloud Analytics dimensionGitHub valueExample
ProviderGitHubGitHub
Billing Account組織またはエンタープライズ名my-company
Project/Account IDリポジトリまたは組織名my-company/api-service
ServiceGitHub のプロダクト名actions, copilot, packages, codespaces
SKUUsage SKUactions_linux_4_core, copilot_business

標準ディメンションに加えて、次の GitHub 固有のラベルを利用できます。

LabelDescription
OrganizationGitHub 組織名
Repositoryコストに関連付けられているリポジトリ
User利用に関連付けられているユーザー（利用可能な場合）
ProductGitHub プロダクト（例: Actions・Copilot・Packages・Codespaces）
Model使用された AI モデル（Copilot プレミアムリクエストの場合）
ヒント

Cloud Analytics レポートを Copilot の支出に絞り込みたい場合は、Product ラベルで値 Copilot を使用してください。

GitHub 接続を削除する​

  1. Cloud Intelligence にサインインし、上部ナビゲーションのメガメニューから データ取り込みとインテグレーション > インテグレーション を選択します。

  2. インテグレーションカタログで GitHub を検索します。

  3. インテグレーションカードで Manage を選択します。

  4. 削除したい GitHub アカウントの一番右端にあるケバブメニュー（⋮）を選択し、Delete を選択します。

  5. 確認のために Delete を選択します。

インテグレーションを削除すると、OAuth トークンも取り消され、GitHub App（インストールされている場合）もアンインストールされます。以前に取り込まれた GitHub コストデータはすべて Cloud Intelligence から削除されます。

に最終更新