Intégration GitHub pour Intelligence Architecture de services

Vous cherchez à obtenir des informations plus détaillées sur l'architecture de vos services en exploitant les données de votre compte GitHub ? L'intégration New Relic GitHub importe les données de référence, d'équipes et d'utilisateurs directement dans la plateforme New Relic avec des capacités de récupération de données sélectives.

Cette intégration rationalise le processus d'intégration des utilisateurs et des équipes tout en simplifiant la gestion des rôles. Il clarifie également la modélisation de la propriété des entités, réduisant ainsi le temps et les efforts de configuration. Grâce à la nouvelle fonctionnalité de récupération sélective de données, vous pouvez choisir exactement les types de données à importer, qu'il s'agisse d'équipes et d'utilisateurs, de référentiels et de demandes de tirage, ou des deux. Cette intégration permet d'améliorer la gestion et la visibilité des catalogues et des tableaux de bord au sein de New Relic. Pour plus d'informations, reportez-vous à la fonctionnalité Architecture de services du renseignement.

• Plateformes supportées :

  • GitHub Cloud
  • GitHub Enterprise (GHE) Cloud (sans résidence de données)

• Régions prises en charge : États-Unis et UE

Prérequis :

• Connectez-vous à votre compte GitHub que vous prévoyez d'intégrer à New Relic.

• Vous devez être le gestionnaire de l’organisation ou le gestionnaire du domaine d’authentification.

• Droits requis :

  • teams_discount_usage
  • integration_github_discount_usage
  • integration_github_ccu

Exigence de liste blanche IP

Si votre organisation utilise une liste IP blanche pour les connexions sortantes, vous devez autoriser le trafic provenant de notre point de terminaison collecteur de données.

Veuillez vous référer à la documentation publique officielle de New Relic pour obtenir la liste complète et la plus récente des adresses IP autorisées que vous devez ajouter à votre configuration de liste blanche.

Quelles données peuvent être synchronisées

L'intégration GitHub vous permet de choisir de manière sélective les types de données à importer dans New Relic, vous donnant ainsi le contrôle sur les informations synchronisées :

Types de données disponibles

• Équipes et utilisateur: importez les structures d'équipe et les informations sur les utilisateurs de GitHub pour améliorer la gestion des équipes et la modélisation de la propriété

  Important

  Exigence de visibilité de l'adresse e-mail de l'utilisateur: L'intégration importe uniquement les utilisateurs GitHub qui ont configuré leurs adresses e-mail comme publiques dans les paramètres de leur profil GitHub. Les membres de l'équipe avec une configuration de messagerie privée seront exclus du processus de synchronisation des données utilisateur.

• Référentiels et demandes de tirage: Importez les données du référentiel et les informations sur la demande de tirage pour une meilleure visibilité du code et un suivi de la répartition

• Les deux: importez tous les types de données disponibles pour une intégration GitHub complète

Considérations sur la sélection des données

Vous pourrez configurer vos préférences de sélection de données lors du processus de configuration initiale.

Configurer l'intégration GitHub

1. Accédez à one.newrelic.com > + Integration & Agents > GitHub integration.

2. À l’étape Select an action , sélectionnez Set up a new integration, puis cliquez sur Continue.

3. Sur l’écran Begin integration :

   a. Pour vous connecter à votre compte GitHub, cliquez sur Get started in GitHub. L'observabilité New Relic s'ouvre sur la place de marché GitHub. b. Terminez l’installation de l’application au sein de votre organisation GitHub pour récupérer les données liées à vos types de données sélectionnés. Une fois l’installation terminée, vous serez redirigé une fois de plus vers l’étape Select an action . c. Sélectionnez Begin integration et cliquez sur Continue.

   d. Select your data preferences: choisissez les types de données que vous souhaitez synchroniser :

   • Teams + Users: Importer les structures d'équipe GitHub et les informations utilisateur
   • Repositories + Pull Requests: Importer les données du référentiel et de la demande de tirage
   • Both: Importer tous les types de données disponibles

   Conseil

   Si les équipes sont déjà intégrées à partir d'une autre source (comme les équipes de service), l'option Teams + Users sera désactivée pour éviter les conflits.

   e. Cliquez sur Start first sync pour commencer à importer vos types de données sélectionnés.

   g. Après avoir affiché le message de Sync started , cliquez sur Continue. L'écran Integration status affichera le nombre de vos types de données sélectionnés (équipes, référentiel, etc.), en s'actualisant toutes les 5 secondes. Prévoyez quelques minutes pour l’importation complète de toutes les données.

   

4. (Facultatif) Sur l'écran GitHub integration , accédez à vos données importées :

   • Cliquez sur Go to Teams pour afficher les informations des équipes importées sur Teams (si des équipes ont été sélectionnées lors de la configuration)
   • Cliquez sur Go to Repositories pour afficher les informations de référentiel importées sur le référentiel (si le référentiel a été sélectionné lors de la configuration)

   conseil

   Attribuer automatiquement un référentiel aux équipes: Vous pouvez attribuer automatiquement un référentiel GitHub à leurs équipes en créant une propriété personnalisée teamOwningRepo dans GitHub. Créez la propriété personnalisée au niveau de l’organisation et attribuez une valeur à la propriété personnalisée au niveau du référentiel. De plus, vous pouvez configurer une propriété personnalisée pour plusieurs référentiels au niveau de l'organisation simultanément. L'intégration attribuera automatiquement le référentiel aux équipes respectives en fonction de la propriété personnalisée. Pour plus d'informations sur la création de propriétés personnalisées, reportez-vous à la documentation GitHub.

Activer la découverte de la propriété de l'équipe

L'intégration GitHub inclut un service de découverte qui peut établir automatiquement la propriété de l'équipe du référentiel en fonction de la structure organisationnelle et des propriétés personnalisées de GitHub.

Comment fonctionne la propriété d'une équipe

Le service de découverte utilise plusieurs méthodes pour établir la propriété du référentiel :

1. Propriétés personnalisées GitHub: utilise la propriété personnalisée teamOwningRepo pour attribuer directement un référentiel aux équipes
2. Analyse de l'appartenance à l'équipe: analyse les modèles d'engagement et les contributions des membres de l'équipe pour déduire la propriété
3. référentiel organisation: utilise la structure organisationnelle et les autorisations d'équipe de GitHub pour déterminer la propriété

Configuration de la propriété automatique de l'équipe

Pour activer la découverte automatique de la propriété de l’équipe :

1. Créer des propriétés personnalisées dans GitHub (recommandé) :

   • Accédez aux paramètres de votre organisation GitHub
   • Créer une propriété personnalisée teamOwningRepo au niveau de l'organisation
   • Attribuer des valeurs d'équipe au référentiel au niveau du référentiel
   • L'intégration mappera automatiquement ces relations lors de la synchronisation

2. Configurer les autorisations de l'équipe:

   • Assurez-vous que les équipes disposent d'un accès approprié au référentiel dans GitHub
   • Le service de découverte utilisera ces autorisations pour déduire les relations de propriété

3. Activer la découverte automatique de la propriété de l'équipe:

   • Une fois la synchronisation terminée, activez la découverte automatique de la propriété de l'équipe dans New Relic. Pour plus d'informations, reportez-vous à la documentation sur la propriété d'Automatisation des équipes.
   • Vérifier que les relations de propriété sont correctement établies

Gérez votre intégration GitHub

Après avoir configuré votre intégration GitHub, vous pouvez la gérer via l'interface New Relic. Cela comprend l'actualisation des données, la modification de la configuration et la désinstallation si nécessaire.

Gestion de l'intégration des accès

1. Accédez à one.newrelic.com > + Integration & Agents > GitHub integration.

2. À l’étape Select an action , sélectionnez Manage your organization, puis cliquez sur Continue.

   

L'écran Manage GitHub integration affiche votre organisation connectée avec son état de synchronisation actuel et ses types de données.

Actualiser les données

Lorsque vous cliquez sur l’option Refresh data , vous disposez d’un moyen simplifié de mettre à jour vos données GitHub dans New Relic.

Pour actualiser les données :

1. Depuis l’écran Manage GitHub integration , recherchez votre organisation.

2. Cliquez sur Refresh data à côté de l’organisation que vous souhaitez mettre à jour, puis cliquez sur Continue.

3. À l’étape Refresh data , cliquez sur Sync on demand.

Le système validera ensuite vos autorisations GitHub et l'accès à votre organisation, récupérera uniquement les données nouvelles ou modifiées depuis la dernière synchronisation, traitera et mappera les données mises à jour en fonction des types de données sélectionnés et mettra à jour l'état d'intégration pour refléter le dernier horodatage de synchronisation et le nombre de données.

Ce qui est rafraîchi :

• Nouveaux membres ajoutés aux équipes GitHub
• modifications du référentiel (nouveau référentiel (référentiel), référentiel archivé (référentiel), modifications des autorisations)
• Propriété de l'équipe mise à jour via des propriétés personnalisées
• Modifications des profils d'utilisateurs et des structures d'équipe

Modifier les paramètres d'intégration

Utilisez l’option Edit pour modifier votre configuration d’intégration après la configuration initiale. Vous pouvez ajuster les types de données synchronisés entre GitHub et New Relic, en choisissant entre Teams + Users, Repositories + Pull Requests ou Both pour les types de données en fonction de vos besoins actuels.

Pour modifier l’intégration GitHub :

1. Depuis l’écran Manage GitHub integration , recherchez votre organisation.

2. Cliquez sur Edit à côté de l’organisation que vous souhaitez mettre à jour, puis cliquez sur Continue.

3. À l’étape Edit Integration Settings , ajustez vos sélections de type de données selon vos besoins.

4. Cliquez sur Save changes pour appliquer vos mises à jour.

Que se passe-t-il pendant l'édition :

• Les données actuelles restent intactes lors des modifications de configuration
• Les nouveaux paramètres s'appliquent aux synchronisations ultérieures
• Vous pouvez prévisualiser les modifications avant de les appliquer
• L'intégration continue de fonctionner avec les paramètres précédents jusqu'à ce que vous enregistriez les modifications

Désinstaller l'intégration GitHub

La désinstallation de l'intégration GitHub arrête la synchronisation des données de l'organisation sélectionnée, mais conserve toutes les données précédemment importées dans New Relic.

Pour désinstaller :

1. Depuis l’écran Manage GitHub integration , recherchez l’organisation que vous souhaitez désinstaller et cliquez sur Uninstall.

2. Dans la boîte de dialogue de confirmation, vérifiez les détails de l’organisation et cliquez sur Uninstall organization pour confirmer.

3. Vous verrez un message de réussite confirmant la désinstallation.