AVANCE
¡Aún estamos trabajando en esta característica, pero nos encantaría que la probaras! Esta característica se proporciona actualmente como parte de un programa de vista previa de acuerdo con nuestras políticas de prelanzamiento.
¿Busca obtener información más detallada sobre la arquitectura de su servicio aprovechando los datos de su cuenta de GitHub? La integración de New Relic con GitHub importa repositorios y equipos directamente a la plataforma New Relic con capacidades de obtención de datos selectivas.
Con la nueva función de obtención selectiva de datos, puede elegir exactamente qué tipos de datos importar: ya sean equipos, repositorios y solicitudes de extracción, o ambos. Este integración de monitoreo de IA mejora la gestión y visibilidad de equipos, catálogos y cuadros de mando dentro de New Relic. Para obtener más información, consulte la capacidad Inteligencia para arquitectura de servicios.
Antes de que empieces
Prerrequisitos:
- Debe ser el administrador de la organización o el administrador del dominio de autenticación.
Plataforma soportada:
- Nube de GitHub
- GitHub Enterprise (GHE) Cloud (sin residencia de datos)
Regiones admitidas: regiones de EE. UU. y la UE
importante
- No se admiten GHE locales ni GHE Cloud con residencia de datos.
- No se admite la instalación de la integración en cuentas de usuario de GitHub. Aunque GitHub permite instalar la aplicación en una cuenta de usuario, el mecanismo de sincronización no funcionará y no se importarán datos a New Relic.
- Tenga en cuenta que la integración de GitHub no es compatible con FedRAMP.
¿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: Importa los equipos de GitHub y sus miembros para mejorar la gestión y la propiedad de los equipos en Mapeo.
Importante
Requisito de visibilidad del email del usuario: Para garantizar que la pertenencia al equipo esté alineada con sus equipos de GitHub, los usuarios de GitHub deberán configurar 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 privada quedará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
Consideraciones sobre la selección de datos
Importante
Conflictos de integración de equipos: Si los equipos ya se integraron en New Relic desde otra fuente (como Okta u otro proveedor de identidad), no se permitirá recuperar ni almacenar equipos de GitHub para evitar conflictos de datos. En este caso, solo puede seleccionar repositorio y datos pull request.
Podrás configurar tus preferencias de selección de datos durante el proceso de configuración inicial.
Configurar la integración de GitHub
Vaya a one.newrelic.com > + Integration & Agents > GitHub integration.
Seleccione la cuenta en la que desea configurar la integración.
Seleccione su método de instrumentación.
Seleccione Set up a new integration y haga clic en Continue.
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 Okta u otro proveedor de identidad), la opción Teams + Users estará deshabilitada para evitar conflictos.
e. Haga clic en Start first sync para comenzar a importar los tipos de datos seleccionados.
F. 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.
(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)
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
Vaya a one.newrelic.com > + Integration & Agents > GitHub integration.
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:
Desde la pantalla Manage GitHub integration , ubique su organización.
Haga clic en Refresh data junto a la organización que desea actualizar y luego haga clic en Continue.
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?
- Equipos y sus miembros
- cambios de repositorio (repositorio nuevo, repositorio archivado, cambios de licencias)
- Propiedad del equipo actualizada a través de propiedades personalizadas
Sugerencia
Frecuencia de actualización: puede actualizar los datos con tanta frecuencia como sea necesario. El proceso normalmente demora unos minutos dependiendo del tamaño de su organización y los tipos de datos seleccionados.
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:
Desde la pantalla Manage GitHub integration , ubique su organización.
Haga clic en Edit junto a la organización que desea actualizar y luego haga clic en Continue.
En el paso Edit Integration Settings , ajuste las selecciones de tipo de datos según sea necesario.
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
Configurar la propiedad automática del equipo
Puede asignar automáticamente el repositorio de GitHub a sus equipos agregando teamOwningRepo como una propiedad personalizada 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.
Luego, en New Relic Teams, habilite la característica de propiedad automatizada, cerciorar de usar team como clave de etiqueta.
Una vez configurado esto, asociaremos automáticamente cada repositorio con su equipo correcto.
Para obtener más información sobre la creación de propiedades personalizadas, consulte la documentación de GitHub.
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:
Desde la pantalla Manage GitHub integration , ubique la organización que desea desinstalar y haga clic en Uninstall.
En el cuadro de diálogo de confirmación, revise los detalles de la organización y haga clic en Uninstall organization para confirmar.
Verá un mensaje de éxito confirmando la desinstalación.
Importante
Retención de datos luego de la desinstalación: Todos los datos previamente sincronizados (equipos, usuario, repositorio, pull requests) permanecerán en New Relic luego de desinstalar la integración. Si necesita eliminar estos datos, comunicar con el soporte de New Relic.