VISUALIZAR
Ainda estamos trabalhando neste recurso, mas adoraríamos que você o experimentasse! Este recurso está sendo fornecido atualmente como parte de um programa de pré-visualização, de acordo com nossas políticas de pré-lançamento.
Você busca obter insights mais profundos sobre a arquitetura de seus serviços, aproveitando os dados da sua conta do GitHub? A integração New Relic GitHub importa repositórios e equipes diretamente para a plataforma New Relic com recursos seletivos de busca de dados.
Com o novo recurso de busca seletiva de dados, você pode escolher exatamente quais tipos de dados importar — sejam equipes, recursos e solicitações de pull, ou ambos. Esta integração de Monitoramento de IA aprimora o gerenciamento e a visibilidade de Equipes, Catálogos e Scorecards no New Relic. Para mais informações consulte o recurso Inteligência de Arquitetura de Serviços.
Antes de você começar
Pré-requisitos:
- Você deve ser o gerente da organização ou o gerente do domínio de autenticação.
Plataforma suportada:
- Nuvem GitHub
- GitHub Enterprise (GHE) Cloud (sem residência de dados)
Regiões suportadas: regiões dos EUA e UE
importante
- GHE local e GHE Cloud com residência de dados não são suportados.
- A instalação da integração em contas de usuário do GitHub não é suportada. Embora o GitHub permita instalar o aplicativo em uma conta de usuário, o mecanismo de sincronização não funcionará e nenhum dado será importado para o New Relic.
- Observe que a integração do GitHub não é compatível com FedRAMP.
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: Importe equipes do GitHub e seus membros para aprimorar o gerenciamento de equipes e o mapeamento de responsabilidades.
Importante
Requisito de visibilidade de e-mail do usuário: Para garantir que a participação na equipe esteja alinhada com suas equipes do GitHub, os usuários do GitHub precisam ter configurado seus endereços de e-mail como públicos nas configurações de seus perfis do GitHub. Os 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
Considerações sobre a seleção de dados
Importante
Conflitos de integração de equipes: Se as equipes já tiverem sido integradas ao New Relic a partir de outra fonte (como Okta ou outro provedor de identidade), as equipes do GitHub não poderão ser buscadas e armazenadas para evitar conflitos de dados. Neste caso, você só pode selecionar os dados da solicitação de pull request.
Você poderá configurar suas preferências de seleção de dados durante o processo de configuração inicial.
Configurar a integração do GitHub
Acesse one.newrelic.com > + Integration & Agents > GitHub integration.
Selecione a conta na qual você deseja configurar a integração.
Selecione o seu método de instrumentação.
Selecione Set up a new integration e clique em Continue.
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 a partir de outra fonte (como Okta ou outro provedor de identidade), a opção Teams + Users será desativada para evitar conflitos.
e. Clique em Start first sync para começar a importar os tipos de dados selecionados.
f. Após 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 que a importação de todos os dados seja concluída.
(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)
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
Acesse one.newrelic.com > + Integration & Agents > GitHub integration.
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:
Na tela Manage GitHub integration , localize sua organização.
Clique em Refresh data ao lado da organização que você deseja atualizar e depois clique em Continue.
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:
- Equipes e seus membros
- 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
Dica
Frequência de atualização: você pode atualizar os dados sempre que necessário. O processo normalmente leva alguns minutos, dependendo do tamanho da sua organização e dos tipos de dados selecionados.
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:
Na tela Manage GitHub integration , localize sua organização.
Clique em Edit ao lado da organização que você deseja atualizar e depois clique em Continue.
Na etapa Edit Integration Settings , ajuste suas seleções de tipo de dados conforme necessário.
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
Configure a propriedade automática da equipe.
Você pode atribuir automaticamente o repositório do GitHub às suas equipes adicionando teamOwningRepo como uma propriedade personalizada 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.
Em seguida, no New Relic Teams, habilite o recurso de propriedade automatizada, certificando-se de usar team como chave de tag.
Depois que isso estiver configurado, associaremos automaticamente cada repositório à sua equipe correta.
Para obter mais informações sobre como criar propriedades personalizadas, consulte a documentação do GitHub.
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:
Na tela Manage GitHub integration , localize a organização que você deseja desinstalar e clique em Uninstall.
Na caixa de diálogo de confirmação, revise os detalhes da organização e clique em Uninstall organization para confirmar.
Você verá uma mensagem de sucesso confirmando a desinstalação.
Importante
Retenção de dados após desinstalação: Todos os dados previamente sincronizados (equipes, usuário, repositório, pull request) permanecerão no New Relic após a desinstalação da integração. Se precisar remover esses dados, entre em contato com o suporte da New Relic.