Service Architecture Intelligenceのための GitHub 統合

GitHub アカウントのデータを活用して、サービス アーキテクチャーにインサイトをさらに深く組み込むことを検討していますか? New Relic GitHub 統合は、選択的なデータ取得機能を使用して、リポジトリ、チーム、およびユーザーのデータをNew Relicプラットフォームに直接インポートします。

この統合により、ユーザーとチームのオンボーディング プロセスが合理化され、役割管理が簡素化されます。 また、エンティティの所有権のマッピングを明確にし、セットアップの時間と労力を削減します。新しい選択的データ取得機能を使用すると、チームとユーザー、リポジトリとプルリクエスト、またはその両方など、どのデータ タイプをインポートするかを正確に選択できます。 この統合 AI モニタリングにより、 New Relic内のカタログとスコアカードの管理と可視性が強化されます。 詳細については、 Service Architecture Intelligence機能を参照してください。

• サポートされているプラットフォーム:

  • GitHubクラウド
  • GitHub Enterprise (GHE) Cloud (データレジデンシーなし)

• サポートされている地域:米国およびEU地域

前提条件:

• New Relic と統合する予定の GitHub アカウントにログインします。

• 組織マネージャーまたは認証ドメイン マネージャーである必要があります。

• 必要な権限:

  • teams_discount_usage
  • integration_github_discount_usage
  • integration_github_ccu

IP ホワイトリスト要件

組織が送信接続に IP ホワイトリストを使用している場合は、データ コレクターのエンドポイントからのトラフィックを許可する必要があります。

ホワイトリスト設定に追加する必要がある、許可された IP アドレスの完全かつ最新のリストについては、New Relic の公式公開ドキュメントを参照してください。

同期できるデータ

GitHub 統合により、 New Relicにインポートするデータ型を選択して、どの情報を同期するかを制御できるようになります。

利用可能なデータタイプ

• チームとユーザー: GitHub チーム構造とユーザー情報をインポートして、チームの管理と所有権を強化します

  重要

  ユーザーの電子メール公開要件: 統合では、GitHub プロファイル設定で電子メール アドレスを公開として構成した GitHub ユーザーのみがインポートされます。 プライベートメール設定を持つチーム メンバーは、ユーザー データの同期プロセスから除外されます。

• リポジトリとプルリクエスト: リポジトリ データとプルリクエスト情報をインポートして、コードの可視性とデプロイメントの追跡を改善します。

• 両方: 包括的な GitHub 統合のために、利用可能なすべてのデータ タイプをインポートします。

データ選択の考慮事項

初期セットアッププロセス中に、データ選択の設定を構成できます。

GitHub 統合のセットアップ

1. one.newrelic.com > + Integration & Agents > GitHub integrationに移動します。

2. Select an action [アクションの選択]ステップで、 Set up a new integration [新しいインテグレーションのセットアップ]を選択し、 Continue [続行]をクリックします。

3. Begin integration [統合の開始]画面で:

   a. GitHub アカウントに接続するには、 Get started in GitHub [GitHub で開始する]をクリックします。New Relicオブザーバビリティが GitHub マーケットプレイスでオープンします。 b.GitHub 組織内でアプリのインストールを完了して、選択したデータ タイプに関連するデータを取得します。 インストレーションが完了すると、もう一度Select an action [アクションの選択]ステップにリダイレクトされます。 紀元前Begin integration [統合の開始]を選択し、 Continue [続行]をクリックします。

   d.Select your data preferences [データ設定を選択]: 同期するデータの種類を選択します。

   • Teams + Users [Teams + ユーザー]: GitHub チーム構造とユーザー情報をインポートします
   • Repositories + Pull Requests [リポジトリ + プルリクエスト]: リポジトリとプルリクエストのデータをインポートします
   • Both [両方]: 利用可能なすべてのデータ型をインポートします

   ヒント

   チームがすでに別のソース (サービス チームなど) から統合されている場合、競合を防ぐためにTeams + Users [チーム + ユーザー]オプションは無効になります。

   e. Start first sync [最初の同期を開始]をクリックして、選択したデータ タイプのインポートを開始します。

   グラム。Sync started [同期が開始されたという]メッセージが表示されたら、 Continue [続行]をクリックします。Integration status [統合ステータス]画面には、選択したデータ タイプ (チーム、リポジトリなど) の数が 5 秒ごとに更新されて表示されます。 すべてのデータが完全にインポートされるまで数分かかります。

   

4. (オプション) GitHub integration [GitHub 統合]画面で、インポートされたデータにアクセスします。

   • Go to Teams [Teams に移動]をクリックすると、 Teamsにインポートされたチーム情報が表示されます (セットアップ時にチームを選択した場合)
   • Go to Repositories [リポジトリに移動]をクリックして、リポジトリにインポートされたリポジトリ情報を表示します (セットアップ中にリポジトリが選択されている場合)

   ヒント

   リポジトリをチームに自動割り当て: GitHub でteamOwningRepoカスタム プロパティを作成すると、GitHub リポジトリをチームに自動的に割り当てることができます。組織レベルでカスタム プロパティを作成し、リポジトリ レベルでカスタム プロパティの値を割り当てます。さらに、組織レベルで複数のリポジトリに対して同時にカスタム プロパティを設定することもできます。インテグレーションは、カスタム プロパティに基づいてリポジトリを各チームに自動的に割り当てます。 カスタム プロパティの作成の詳細については、 GitHub ドキュメントを参照してください。

チームの所有権の検出を有効にする

GitHub 統合には、GitHub の組織構造とカスタム プロパティに基づいてリポジトリのチーム所有権を自動的に確立できる検出サービスが含まれています。

チームの所有権の仕組み

検出サービスでは、リポジトリの所有権を確立するために複数の方法が使用されます。

1. GitHub カスタム プロパティ: teamOwningRepoカスタム プロパティを使用して、リポジトリをチームに直接割り当てます
2. チームメンバーシップ分析: コミットパターンとチームメンバーの貢献を分析して所有権を推測します
3. リポジトリ組織: GitHub の組織構造とチーム権限を使用して所有権を決定します

自動チーム所有権の設定

チーム所有権の自動検出を有効にするには:

1. GitHub でカスタム プロパティを作成します(推奨):

   • GitHub組織の設定に移動します
   • 組織レベルでteamOwningRepoカスタム プロパティを作成します
   • リポジトリレベルでチーム値をリポジトリに割り当てる
   • 統合により、同期中にこれらの関係が自動的にマッピングされます。

2. チームの権限を設定します:

   • チームがGitHubで適切なリポジトリアクセスを持っていることを確認する
   • 検出サービスはこれらの権限を使用して所有権関係を推測します

3. チームの所有権の自動検出を有効にする:

   • 同期が完了したら、New Relic でチーム所有権の自動検出を有効にします。詳細については、 Teams の所有権の自動化に関するドキュメントを参照してください。
   • 所有権関係が正しく確立されていることを確認する

GitHub 統合を管理する

GitHub 統合をセットアップしたら、 New Relicインターフェイスを通じて管理できるようになります。 これには、データの更新、設定の編集、必要に応じてアンインストールが含まれます。

統合管理へのアクセス

1. one.newrelic.com > + Integration & Agents > GitHub integrationに移動します。

2. Select an action [アクションの選択]ステップで、 Manage your organization [組織の管理]を選択し、 Continue [続行]をクリックします。

   

「GitHub 統合の管理」画面には、接続されている組織が現在の同期ステータスとデータ型とともに表示されます。

データを更新

Refresh data [データの更新]オプションをクリックすると、New Relic で GitHub データを効率的に更新できるようになります。

データを更新するには:

1. Manage GitHub integration [GitHub 統合の管理]画面から、組織を見つけます。

2. 更新する組織の横にあるRefresh data [データの更新]をクリックし、 Continue [続行]をクリックします。

3. Refresh Data [データの更新]手順で、Sync on demand [オンデマンドで同期を]クリックします。

その後、システムは GitHub の権限と組織へのアクセスを検証し、最後の同期以降に新規または変更されたデータのみを取得し、選択したデータ タイプに従って更新されたデータを処理およびマッピングし、最新の同期タイムスタンプとデータ数を反映するために統合ステータスを更新します。

更新されるもの:

• GitHub チームに新しいチームメンバーが追加されました
• リポジトリの変更（新規リポジトリ、アーカイブリポジトリ、権限変更）
• カスタムプロパティによるチーム所有権の更新
• ユーザープロフィールとチーム構造の変更

統合設定の編集

初期セットアップ後に統合設定を変更するには、Edit [編集]オプションを使用します。 現在のニーズに基づいて、Teams + ユーザー、リポジトリ + プルリクエスト、または両方のデータ型から選択して、GitHub とNew Relicの間で同期するデータ型を調整できます。

GitHub 統合を編集するには:

1. Manage GitHub integration [GitHub 統合の管理]画面から、組織を見つけます。

2. 更新する組織の横にあるEdit [編集]をクリックし、 Continue [続行]をクリックします。

3. Edit Integration Settings [統合設定の編集]ステップで、必要に応じてデータ タイプの選択を調整します。

4. 更新を適用するには、 Save changes [変更を保存]をクリックします。

編集中に何が起こるか:

• 設定変更中も現在のデータはそのまま残ります
• 新しい設定は以降の同期に適用されます
• 変更を適用する前にプレビューできます
• 変更を保存するまで、統合は以前の設定で実行され続けます。

GitHub 統合をアンインストールする

GitHub インテグレーションをアンインストールすると、選択した組織からのデータ同期が停止しますが、以前にインポートされたデータはすべてNew Relicに保存されます。

アンインストールするには:

1. Manage GitHub integration [GitHub 統合の管理]画面から、アンインストールする組織を見つけて、 Uninstall [アンインストール]をクリックします。

2. 確認ダイアログで組織の詳細を確認し、 Uninstall organization [組織をアンインストール]をクリックして確定します。

3. アンインストールを確認する成功メッセージが表示されます。