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

GitHub を接続

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

前提条件​

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

  • Owner 権限を持つ GitHub の Organization または Enterprise アカウント

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

接続の概要​

GitHub 連携は、次の 2 種類の接続レベルに対応しています。

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

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 Organization を接続
    • Enterprise — GitHub Enterprise アカウント全体を接続

  2. Organization or Enterprise slug を入力してください。これは、組織またはエンタープライズの URL フレンドリーな名前です（例：my-company）。

    ヒント

    Organization の slug は、GitHub Organization を表示しているときの URL で確認できます：github.com/ my-company。Enterprise アカウントの場合は github.com/enterprises/ my-company に移動してください。

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

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

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

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

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

    • admin:org — 組織の請求および利用状況データの読み取り
    • read:enterprise — Enterprise の請求データの読み取り（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 接続を通じてすべての請求および利用状況データを取り込みます。App は Copilot とセキュリティインサイト向けの補足データを追加します。

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

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

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

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

注意

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

データの更新頻度​

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

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

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

Cloud Analytics dimensionGitHub valueExample
ProviderGitHubGitHub
Billing AccountOrganization または Enterprise 名my-company
Project/Account IDリポジトリまたは Organization 名my-company/api-service
ServiceGitHub プロダクト名actions、copilot、packages、codespaces
SKUUsage SKUactions_linux_4_core、copilot_business

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

LabelDescription
OrganizationGitHub Organization 名
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 から削除されます。

に最終更新