GitHub integração para Inteligência de Arquitetura de Serviços

Você deseja obter insights mais profundos sobre sua arquitetura de serviço aproveitando dados da sua conta do GitHub? A integração New Relic GitHub importa dados de repositórios, equipes e usuários diretamente para a plataforma New Relic com recursos seletivos de busca de dados.

Essa integração agiliza o processo de integração de usuários e equipes, ao mesmo tempo em que simplifica o gerenciamento de funções. Ele também esclarece o mapeamento de propriedade da entidade, reduzindo o tempo e o esforço de configuração. Com o novo recurso de busca seletiva de dados, você pode escolher exatamente quais tipos de dados importar — sejam equipes e usuário, repositório e pull requests, ou ambos. Esta integração do AI Monitoring melhora o gerenciamento e a visibilidade de catálogos e scorecards no New Relic. Para mais informações consulte o recurso Inteligência de Arquitetura de Serviços.

• Plataforma suportada:

  • Nuvem GitHub
  • GitHub Enterprise (GHE) Cloud (sem residência de dados)

• Regiões suportadas: regiões dos EUA e UE

Pré-requisitos:

• Efetue login na sua conta do GitHub que você planeja integrar com o New Relic.

• Você deve ser o gerente da organização ou o gerente do domínio de autenticação.

• Direitos necessários:

  • teams_discount_usage
  • integration_github_discount_usage
  • integration_github_ccu

Requisito de lista de permissões de IP

Se a sua organização usa lista de permissões IP para conexões de saída, você deverá permitir o tráfego do nosso terminal coletor de dados.

Consulte a documentação pública oficial do New Relic para obter a lista completa e mais atualizada de endereços IP permitidos que você precisa adicionar à sua configuração de lista de permissões.

Quais dados podem ser sincronizados

A integração com o GitHub permite que você escolha seletivamente quais tipos de dados importar para o New Relic, dando a você controle sobre quais informações são sincronizadas:

Tipos de dados disponíveis

• Equipes e usuário: importe estruturas de equipe do GitHub e informações de usuário para aprimorar o gerenciamento de equipe e mapeamento de propriedade

  Importante

  Requisito de visibilidade de e-mail do usuário: a integração importa apenas usuários do GitHub que configuraram seus endereços de e-mail como públicos nas configurações de perfil do GitHub. Membros da equipe com configuração de e-mail privada serão excluídos do processo de sincronização de dados do usuário.

• Repositórios e pull requests: Importe dados do repositório e informações pull request para melhor visibilidade do código e rastreamento de implantação

• Ambos: Importe todos os tipos de dados disponíveis para integração abrangente com o GitHub

Considerações sobre a seleção de dados

Você poderá configurar suas preferências de seleção de dados durante o processo de configuração inicial.

Configurar a integração do GitHub

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

2. Na etapa Select an action , selecione Set up a new integration e clique em Continue.

3. Na tela Begin integration :

   a. Para se conectar à sua conta do GitHub, clique em Get started in GitHub. A observabilidade New Relic é aberta no GitHub Marketplace. b. Conclua a instalação do aplicativo na sua organização do GitHub para recuperar dados relacionados aos tipos de dados selecionados. Após a conclusão da instalação, você será redirecionado para a etapa Select an action mais uma vez. c. Selecione Begin integration e clique em Continue.

   d. Select your data preferences: Escolha quais tipos de dados você deseja sincronizar:

   • Teams + Users: importa estruturas de equipe do GitHub e informações do usuário
   • Repositories + Pull Requests: Importa repositório e dados pull request
   • Both: Importar todos os tipos de dados disponíveis

   Dica

   Se as equipes já estiverem integradas de outra fonte (como equipes de serviço), a opção Teams + Users será desabilitada para evitar conflitos.

   e. Clique em Start first sync para começar a importar os tipos de dados selecionados.

   g. Depois de visualizar a mensagem Sync started , clique em Continue. A tela Integration status exibirá a contagem dos tipos de dados selecionados (equipes, repositório, etc.), atualizando a cada 5 segundos. Aguarde alguns minutos para a importação completa de todos os dados.

   

4. (Opcional) Na tela de GitHub integration , acesse seus dados importados:

   • Clique em Go to Teams para visualizar as informações das equipes importadas no Teams (se as equipes foram selecionadas durante a configuração)
   • Clique em Go to Repositories para visualizar as informações do repositório importado no repositório (se o repositório tiver sido selecionado durante a configuração)

   dica

   Atribuir repositório automaticamente às equipes: você pode atribuir repositórios do GitHub automaticamente às suas equipes criando uma propriedade personalizada teamOwningRepo no GitHub. Crie a propriedade personalizada no nível da organização e atribua um valor para ela no nível do repositório. Além disso, você pode configurar uma propriedade personalizada para vários repositórios no nível da organização simultaneamente. A integração atribuirá automaticamente o repositório às respectivas equipes com base na propriedade personalizada. Para obter mais informações sobre como criar propriedades personalizadas, consulte a documentação do GitHub.

Habilitar descoberta de propriedade de equipe

A integração do GitHub inclui um serviço de descoberta que pode estabelecer automaticamente a propriedade da equipe do repositório com base na estrutura organizacional e nas propriedades personalizadas do GitHub.

Como funciona a propriedade da equipe

O serviço de descoberta usa vários métodos para estabelecer a propriedade do repositório:

1. Propriedades personalizadas do GitHub: usa a propriedade personalizada teamOwningRepo para atribuir repositório diretamente às equipes
2. Análise de membros da equipe: analisa padrões de comprometimento e contribuições dos membros da equipe para inferir propriedade
3. repositório organização: usa a estrutura organizacional e as permissões da equipe do GitHub para determinar a propriedade

Configurando a propriedade automática da equipe

Para habilitar a descoberta automática de propriedade da equipe:

1. Crie propriedades personalizadas no GitHub (recomendado):

   • Navegue até as configurações da sua organização no GitHub
   • Crie uma propriedade personalizada teamOwningRepo no nível da organização
   • Atribuir valores de equipe ao repositório no nível do repositório
   • A integração mapeará automaticamente esses relacionamentos durante a sincronização

2. Configurar permissões de equipe:

   • Garantir que as equipes tenham acesso apropriado ao repositório no GitHub
   • O serviço de descoberta usará essas permissões para inferir relacionamentos de propriedade

3. Habilitar descoberta automática de propriedade de equipe:

   • Após a conclusão da sincronização, ative a descoberta automática de propriedade da equipe no New Relic. Para obter mais informações, consulte a documentação de propriedade do Automating Teams.
   • Verifique se as relações de propriedade estão estabelecidas corretamente

Gerencie sua integração com o GitHub

Depois de configurar sua integração com o GitHub, você pode gerenciá-la por meio da interface do New Relic. Isso inclui atualizar dados, editar configurações e desinstalar quando necessário.

Gerenciamento de integração de acesso

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

2. Na etapa Select an action , selecione Manage your organization e clique em Continue.

   

A tela Manage GitHub integration exibe sua organização conectada com seu status de sincronização atual e tipos de dados.

Atualizar dados

Ao clicar na opção Refresh data , você obtém uma maneira simplificada de atualizar seus dados do GitHub no New Relic.

Para atualizar dados:

1. Na tela Manage GitHub integration , localize sua organização.

2. Clique em Refresh data ao lado da organização que você deseja atualizar e depois clique em Continue.

3. Na etapa Refresh Data , clique em Sync on demand.

O sistema validará suas permissões do GitHub e o acesso à organização, buscará apenas dados novos ou alterados desde a última sincronização, processará e mapeará os dados atualizados de acordo com os tipos de dados selecionados e atualizará o status da integração para refletir o registro de data timestamp da sincronização mais recente e as contagens de dados.

O que é atualizado:

• Novos membros da equipe adicionados às equipes do GitHub
• alterações no repositório (novo repositório, repositório arquivado, alterações de permissão)
• Propriedade da equipe atualizada por meio de propriedades personalizadas
• Mudanças nos perfis dos usuários e estruturas de equipe

Editar configurações de integração

Use a opção Edit para modificar sua configuração de integração após a configuração inicial. Você pode ajustar quais tipos de dados são sincronizados entre o GitHub e New Relic, escolhendo entre Teams + Users, Repositories + Pull Requests ou Both os tipos de dados, com base em suas necessidades atuais.

Para editar a integração do GitHub:

1. Na tela Manage GitHub integration , localize sua organização.

2. Clique em Edit ao lado da organização que você deseja atualizar e depois clique em Continue.

3. Na etapa Edit Integration Settings , ajuste suas seleções de tipo de dados conforme necessário.

4. Clique em Save changes para aplicar suas atualizações.

O que acontece durante a edição:

• Os dados atuais permanecem intactos durante as alterações de configuração
• Novas configurações se aplicam a sincronizações subsequentes
• Você pode visualizar as alterações antes de aplicá-las
• A integração continua sendo executada com as configurações anteriores até que você salve as alterações

Desinstalar a integração do GitHub

Desinstalar a integração do GitHub interrompe a sincronização de dados da organização selecionada, mas preserva todos os dados importados anteriormente no New Relic.

Para desinstalar:

1. Na tela Manage GitHub integration , localize a organização que você deseja desinstalar e clique em Uninstall.

2. Na caixa de diálogo de confirmação, revise os detalhes da organização e clique em Uninstall organization para confirmar.

3. Você verá uma mensagem de sucesso confirmando a desinstalação.