Integración de GitHub para Inteligencia para arquitectura de servicios

¿Estás buscando obtener información más valiosa y profunda sobre la arquitectura de tus servicios aprovechando los datos de tu cuenta de GitHub? La integración New Relic GitHub importa repositorios, equipos y datos de usuarios directamente a la plataforma New Relic con capacidades de recuperación selectiva de datos.

Esta integración agiliza el proceso de incorporación de usuarios y equipos al tiempo que simplifica la gestión de roles. También aclara la propiedad de la entidad mapeo, lo que reduce el tiempo y el esfuerzo de configuración. Con la nueva función de obtención selectiva de datos, puede elegir exactamente qué tipos de datos importar, ya sean equipos y usuarios, repositorio y pull requests, o ambos. Esta integración de monitoreo de IA busca mejorar la gestión y visibilidad de catálogos y cuadros de mando dentro de New Relic. Para obtener más información, consulte la capacidad Inteligencia para arquitectura de servicios.

• Plataforma soportada:

  • Nube de GitHub
  • GitHub Enterprise (GHE) Cloud (sin residencia de datos)

• Regiones admitidas: regiones de EE. UU. y la UE

Prerrequisitos:

• Inicie sesión en su cuenta de GitHub que planea integrar con New Relic.

• Debe ser el administrador de la organización o el administrador del dominio de autenticación.

• Derechos requeridos:

  • teams_discount_usage
  • integration_github_discount_usage
  • integration_github_ccu

Requisito de lista blanca de IP

Si su organización emplea IP lista blanca para conexiones salientes, deberá permitir el tráfico desde nuestro recolector de datos extremo.

Consulta la documentación pública oficial de New Relic para obtener la lista completa y más actualizada de direcciones IP permitidas que debes agregar a tu configuración de lista blanca.

¿Qué datos se pueden sincronizar?

La integración de GitHub le permite elegir de forma selectiva qué tipos de datos importar a New Relic, lo que le brinda control sobre qué información se sincroniza:

Tipos de datos disponibles

• Equipos y usuarios: Importe estructuras de equipo de GitHub e información de usuarios para mejorar la gestión y propiedad del equipo mapeo

  Importante

  Requisito de visibilidad del email del usuario: la integración solo importa usuarios de GitHub que configuraron sus direcciones de email como públicas en la configuración de su perfil de GitHub. Los miembros del equipo con configuración de email privado serán excluidos del proceso de sincronización de datos de usuario.

• Repositorio y pull requests: importe datos del repositorio e información de las pull requests para una mejor visibilidad del código y seguimiento de la implementación

• Ambos: Importa todos los tipos de datos disponibles para una integración completa con GitHub

Consideraciones sobre la selección de datos

Podrás configurar tus preferencias de selección de datos durante el proceso de configuración inicial.

Configurar la integración de GitHub

1. Vaya a one.newrelic.com > + Integration & Agents > GitHub integration.

2. En el paso Select an action , seleccione Set up a new integration y haga clic en Continue.

3. En la pantalla Begin integration :

   a. Para conectarse con su cuenta de GitHub, haga clic en Get started in GitHub. La observabilidad de New Relic se abre en GitHub Marketplace. b. Complete la instalación de la aplicación dentro de su organización de GitHub para recuperar datos relacionados con los tipos de datos seleccionados. Una vez completada la instalación, se le redirigirá al paso Select an action una vez más. do. Seleccione Begin integration y haga clic en Continue.

   d. Select your data preferences: Elija qué tipos de datos desea sincronizar:

   • Teams + Users: Importar estructuras de equipos de GitHub e información de usuarios
   • Repositories + Pull Requests: importar datos del repositorio y de pull requests
   • Both: Importar todos los tipos de datos disponibles

   Sugerencia

   Si los equipos ya están integrados desde otra fuente (como equipos de servicio), la opción Teams + Users se deshabilitará para evitar conflictos.

   e. Haga clic en Start first sync para comenzar a importar los tipos de datos seleccionados.

   gramo. Luego de ver el mensaje Sync started , haga clic en Continue. La pantalla Integration status mostrará el recuento de los tipos de datos seleccionados (equipos, repositorio, etc.), actualizar cada 5 segundos. Espere unos minutos para que se complete la importación de todos los datos.

   

4. (Opcional) En la pantalla GitHub integration , acceda a los datos importados:

   • Haga clic en Go to Teams para ver la información de los equipos importados en Teams (si se seleccionaron equipos durante la configuración)
   • Haga clic en Go to Repositories para ver la información del repositorio importado (si se seleccionó el repositorio durante la configuración)

   consejo

   Asignar repositorio automáticamente a equipos: puedes asignar automáticamente un repositorio de GitHub a sus equipos creando una propiedad personalizada teamOwningRepo en GitHub. Cree la propiedad personalizada en el nivel de organización y asigne un valor a la propiedad personalizada en el nivel de repositorio. Además, puede configurar una propiedad personalizada para varios repositorios a nivel de organización simultáneamente. La integración asignará automáticamente el repositorio a los respectivos equipos en función de la propiedad personalizada. Para obtener más información sobre la creación de propiedades personalizadas, consulte la documentación de GitHub.

Habilitar el descubrimiento de propiedad del equipo

La integración de GitHub incluye un servicio de descubrimiento que puede establecer automáticamente la propiedad del equipo del repositorio según la estructura organizacional y las propiedades personalizadas de GitHub.

Cómo funciona la propiedad del equipo

El servicio de descubrimiento emplea varios métodos para establecer la propiedad del repositorio:

1. Propiedades personalizadas de GitHub: emplea la propiedad personalizada teamOwningRepo para asignar directamente el repositorio a los equipos
2. Análisis de membresía del equipo: analiza los patrones de confirmación y las contribuciones de los miembros del equipo para inferir la propiedad.
3. repositorio organización: emplea la estructura organizacional de GitHub y las licencias del equipo para determinar la propiedad

Configurar la propiedad automática del equipo

Para habilitar el descubrimiento automático de propiedad del equipo:

1. Crear propiedades personalizadas en GitHub (recomendado):

   • Navega a la configuración de tu organización de GitHub
   • Crear una propiedad personalizada teamOwningRepo a nivel de organización
   • Asignar valores de equipo al repositorio en el nivel del repositorio
   • La integración mapeará automáticamente estas relaciones durante la sincronización

2. Configurar licencias del equipo:

   • Cerciorar de que los equipos tengan acceso adecuado al repositorio en GitHub
   • El servicio de descubrimiento empleará estas licencias para inferir relaciones de propiedad.

3. Habilitar el descubrimiento automático de propiedad del equipo:

   • Una vez completada la sincronización, habilite el descubrimiento automático de propiedad del equipo en New Relic. Para obtener más información, consulte la documentación de propiedad de Automatización de equipos.
   • Verificar que las relaciones de propiedad estén correctamente establecido

Gestiona tu integración de GitHub

Luego de configurar su integración de GitHub, puede gestionarla a través de la interfaz de New Relic. Esto incluye actualizar datos, editar la configuración y desinstalar cuando sea necesario.

Gestión de integración de acceso

1. Vaya a one.newrelic.com > + Integration & Agents > GitHub integration.

2. En el paso Select an action , seleccione Manage your organization y haga clic en Continue.

   

La pantalla Manage GitHub integration muestra su organización conectada con su estado de sincronización actual y tipos de datos.

Actualizar datos

Al hacer clic en la opción Refresh data , se proporciona una forma simplificada de actualizar sus datos de GitHub en New Relic.

Para actualizar los datos:

1. Desde la pantalla Manage GitHub integration , ubique su organización.

2. Haga clic en Refresh data junto a la organización que desea actualizar y luego haga clic en Continue.

3. En el paso Refresh Data , haga clic en Sync on demand.

Luego, el sistema validará sus licencias de GitHub y el acceso a la organización, obtendrá solo datos nuevos o modificados desde la última sincronización, procesará y mapeará los datos actualizados según los tipos de datos seleccionados y actualizará el estado de integración para reflejar la última timestamp de sincronización y los recuentos de datos.

¿Qué se actualiza?

• Se agregaron nuevos miembros al equipo de GitHub
• cambios de repositorio (repositorio nuevo, repositorio archivado, cambios de licencias)
• Propiedad del equipo actualizada a través de propiedades personalizadas
• Cambios en los perfiles de usuario y estructuras de equipo

Editar la configuración de integración

Emplee la opción Edit para modificar su configuración de integración luego de la configuración inicial. Puede ajustar qué tipos de datos se sincronizan entre GitHub y New Relic, eligiendo entre Teams + Users, Repositories + Pull Requests o Both para tipos de datos según sus necesidades actuales.

Para editar la integración de GitHub:

1. Desde la pantalla Manage GitHub integration , ubique su organización.

2. Haga clic en Edit junto a la organización que desea actualizar y luego haga clic en Continue.

3. En el paso Edit Integration Settings , ajuste las selecciones de tipo de datos según sea necesario.

4. Haga clic en Save changes para aplicar las actualizaciones.

¿Qué sucede durante la edición?

• Los datos actuales permanecen intactos durante los cambios de configuración
• Las nuevas configuraciones se aplican a las sincronizaciones posteriores
• Puede obtener una vista previa de los cambios antes de aplicarlos
• La integración continúa ejecutar con la configuración anterior hasta que almacene los cambios

Desinstalar la integración de GitHub

Al desinstalar la integración de GitHub, se detiene la sincronización de datos de la organización seleccionada, pero se conservan todos los datos importados previamente en New Relic.

Para desinstalar:

1. Desde la pantalla Manage GitHub integration , ubique la organización que desea desinstalar y haga clic en Uninstall.

2. En el cuadro de diálogo de confirmación, revise los detalles de la organización y haga clic en Uninstall organization para confirmar.

3. Verá un mensaje de éxito confirmando la desinstalación.