Aperçu
Nous travaillons encore sur cette fonctionnalité, mais nous serions ravis que vous l'essayiez ! Cette fonctionnalité est actuellement proposée dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.
Souhaitez-vous 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 GitHub de New Relic importe directement les référentiels et les équipes dans la plateforme New Relic grâce à des capacités de récupération de données sélectives.
Grâce à la nouvelle fonctionnalité de récupération sélective des données, vous pouvez choisir exactement les types de données à importer, qu'il s'agisse d'équipes, de référentiels et de demandes de tirage, ou des deux. Cette intégration vise à améliorer la gestion et la visibilité des équipes, des catalogues et des tableaux de bord (scorecards) au sein de New Relic. Pour plus d'informations, reportez-vous à la capacité de services d'architecture intelligente.
Avant de commencer
Prérequis :
- Vous devez être le gestionnaire de l’organisation ou le gestionnaire du domaine d’authentification.
Plateformes supportées :
- GitHub Cloud
- GitHub Enterprise (GHE) Cloud (sans résidence de données)
Régions prises en charge : États-Unis et UE
important
- GHE sur site et GHE Cloud avec résidence des données ne sont pas pris en charge.
- L'installation de l'intégration dans les comptes utilisateurs GitHub n'est pas prise en charge. Bien que GitHub permette d'installer l'application dans un compte utilisateur, le mécanisme de synchronisation ne fonctionnera pas et aucune donnée ne sera importée dans New Relic.
- Notez que l'intégration GitHub n'est pas conforme à FedRAMP.
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: Importez les équipes GitHub et leurs membres pour améliorer la modélisation de la gestion et de la propriété des équipes.
Important
Exigence de visibilité de l'adresse e-mail de l'utilisateur: Pour garantir que l'appartenance à l'équipe soit alignée sur vos équipes GitHub, l'utilisateur GitHub devra avoir configuré son adresse e-mail comme publique dans les paramètres de son profil GitHub. Les membres de l'équipe disposant d'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
Considérations sur la sélection des données
Important
Conflits d'intégration d'équipes: Si des équipes ont déjà été intégrées à New Relic à partir d'une autre source (telle qu'Okta ou un autre fournisseur d'identité), les équipes GitHub ne pourront pas être récupérées et stockées afin d'éviter les conflits de données. Dans ce cas, vous ne pouvez sélectionner que les données du référentiel et de la demande de tirage.
Vous pourrez configurer vos préférences de sélection de données lors du processus de configuration initiale.
Configurer l'intégration GitHub
Accédez à one.newrelic.com > + Integration & Agents > GitHub integration.
Sélectionnez le compte sur lequel vous souhaitez configurer l'intégration.
Sélectionnez votre méthode d'instrumentation.
Sélectionnez Set up a new integration, puis cliquez sur Continue.
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 (telle qu'Okta ou un autre fournisseur d'identité), l'option Teams + Users sera désactivée afin d'éviter les conflits.
e. Cliquez sur Start first sync pour commencer à importer vos types de données sélectionnés.
f. Une fois le message Sync started affiché, cliquez sur Continue. L'écran Integration status affichera le nombre de vos types de données sélectionnés (équipes, référentiel, etc.), avec une actualisation toutes les 5 secondes. Veuillez prévoir quelques minutes pour l'importation complète de toutes les données.
(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)
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
Accédez à one.newrelic.com > + Integration & Agents > GitHub integration.
À 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 :
Depuis l’écran Manage GitHub integration , recherchez votre organisation.
Cliquez sur Refresh data à côté de l’organisation que vous souhaitez mettre à jour, puis cliquez sur Continue.
À 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 :
- Les équipes et leurs membres
- 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
Conseil
Fréquence d'actualisation: vous pouvez actualiser les données aussi souvent que nécessaire. Le processus prend généralement quelques minutes en fonction de la taille de votre organisation et des types de données sélectionnés.
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 :
Depuis l’écran Manage GitHub integration , recherchez votre organisation.
Cliquez sur Edit à côté de l’organisation que vous souhaitez mettre à jour, puis cliquez sur Continue.
À l’étape Edit Integration Settings , ajustez vos sélections de type de données selon vos besoins.
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
Configurer l'attribution automatique de la propriété de l'équipe
Vous pouvez attribuer automatiquement le référentiel GitHub à leurs équipes en ajoutant teamOwningRepo comme propriété personnalisée 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.
Ensuite, dans New Relic Teams, activez la fonctionnalité de propriété automatisée, en veillant à utiliser team comme clé de tag.
Une fois cela mis en place, nous ferons correspondre automatiquement chaque référentiel (référentiel) avec son équipe appropriée.
Pour plus d'informations sur la création de propriétés personnalisées, reportez-vous à la documentation GitHub.
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 :
Depuis l’écran Manage GitHub integration , recherchez l’organisation que vous souhaitez désinstaller et cliquez sur Uninstall.
Dans la boîte de dialogue de confirmation, vérifiez les détails de l’organisation et cliquez sur Uninstall organization pour confirmer.
Vous verrez un message de réussite confirmant la désinstallation.
Important
Rétention des données après désinstallation: Toutes les données précédemment synchronisées (équipes, utilisateur, référentiel, demande de tirage) resteront dans New Relic après la désinstallation de l'intégration. Si vous devez supprimer ces données, contactez le support New Relic.