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

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 にサインインし、上部ナビゲーションのメガメニューから データ取り込みとインテグレーション > Integrations を選択します。

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

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

ステップ 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 をより詳細に可視化するために、接続ウィザードではオンボーディング中に任意のセクション Enable enriched data (Copilot seats, Advanced Security) が表示されます。このセクションでは、DoiT GitHub App のセットアップガイドへのリンクを示しつつ、アプリなしで請求接続を継続できます。

GitHub App を有効にすると、次のデータにアクセスできます。

  • Copilot seat assignments — Copilot ライセンスが割り当てられているユーザーを確認
  • Copilot usage metrics — 導入状況とアクティビティをトラッキング
  • GitHub Advanced Security — リポジトリごとの GHAS コミッター数を表示
注意

GitHub App は任意です。これを有効にしなくても、DoiT は OAuth 接続経由ですべての請求および利用データを取り込みます。アプリは Copilot およびセキュリティインサイト向けの補足データを追加します。組織で GitHub App を有効化する際にサポートが必要な場合は、サポートまでお問い合わせください。

ステップ 5: テストと保存​

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

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

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

注意

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

データの更新​

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

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

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

Cloud Analytics ディメンションGitHub の値例
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 にサインインし、上部ナビゲーションのメガメニューから データ取り込みとインテグレーション > Integrations を選択します。

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

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

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

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

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

に最終更新