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

GitHub を接続する

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

前提条件​

開始する前に、次のものを用意してください。

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

接続の概要​

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

接続レベルスコープ最適な利用シナリオ
Organization単一の GitHub 組織1 つの組織を管理しているチーム
EnterpriseGitHub エンタープライズ全体（すべての組織を含む）複数の組織を持つエンタープライズ

DoiT は請求データの取得のために OAuth を使用して GitHub に接続します。オプションで、DoiT GitHub App をインストールして、Copilot シート割り当て・Copilot の利用メトリクス・GitHub Advanced Security などの詳細なデータを有効化することもできます。

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

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

  1. DoiT Cloud Intelligence にサインインし、データ取り込みとインテグレーション → Assets に移動してください。

  2. 左側のメニューから GitHub を選択し、新しいアカウントを接続 を選択してください。

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

  1. Connection Level を選択してください。

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

  2. Organization or Enterprise slug を入力してください。これは組織またはエンタープライズの URL 対応名です（例: my-company）。

    ヒント

    組織の slug は、GitHub 組織を表示しているときの URL で確認できます。github.com/ my-company の部分です。エンタープライズ アカウントの場合は、github.com/enterprises/ my-company に移動してください。

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

  1. Authorize を選択して、OAuth フローを開始してください。

  2. GitHub にリダイレクトされ、（まだサインインしていない場合はサインインし）DoiT に請求データへのアクセス権を付与します。

  3. 要求されている権限を確認し、Authorize を選択してください。

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

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

  4. 認可が完了すると、DoiT Cloud Intelligence にリダイレクトされます。

ステップ 4: （オプション）GitHub App で拡張データを有効にする​

Copilot の利用状況や GitHub Advanced Security をより詳細に可視化するには、オプションで DoiT GitHub App をインストールできます。

  1. 接続ウィザードで、Enable enriched data (Copilot seats, Advanced Security) を選択してください。

  2. プロンプトに従って、組織に GitHub App をインストールしてください。

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

    • Copilot seat assignments — Copilot ライセンスを持つユーザーを確認できます。
    • Copilot usage metrics — 採用状況およびアクティビティを追跡できます。
    • GitHub Advanced Security — リポジトリごとの GHAS コミッター数を表示できます。
注意

GitHub App は任意です。インストールしなくても、DoiT は OAuth 接続を通じてすべての請求および使用状況データを取り込みます。このアプリは、Copilot とセキュリティ インサイト向けの補足データを追加します。

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

  1. 接続テスト を選択して、DoiT が GitHub の請求データにアクセスできることを確認してください。

  2. テストが成功したら、保存 を選択してセットアップを完了してください。

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

注意

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

データの更新頻度​

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

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

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

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

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

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

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

GitHub 接続を削除する​

  1. DoiT Cloud Intelligence にサインインし、データ取り込みとインテグレーション → Assets に移動してください。

  2. 左側のメニューから GitHub を選択してください。

  3. 削除したい GitHub アカウントの一番右端にある 3 点メニュー（⋮）を選択し、削除 を選択してください。

  4. 確認のため、再度 削除 を選択してください。

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

に最終更新