Configurar Controle de Agentes

Este guia fornece o caminho mais rápido para começar a usar o Controle de Agentes. Nós o guiaremos pelo fluxo de trabalho essencial do "caminho feliz" para criar sua primeira frota e executar uma implantação básica.

Visão geral do fluxo de trabalho

O processo de configuração do Controle de Agentes tem uma ordem específica. Você deve criar uma frota antes de instalar o Agente Control, porque o processo de instalação requer uma frota para associar. Depois que o agente Control é instalado, a entidade é automaticamente atribuída àquela frota. Portanto, o fluxo de trabalho é:

1. Crie uma frota na plataforma New Relic.
2. Instale o agente Control na sua entidade. O assistente de instalação usa os detalhes da sua frota para atribuir cada entidade, tornando-a uma "Entidade gerenciada atribuída".
3. Execute uma implantação para instalar e configurar agentes nas entidades que agora fazem parte da sua frota.

Pré-requisitos

Você precisará da função de Organization Manager ou de uma função personalizada com permissões equivalentes de gerenciamento de frota para executar essas ações.

Etapa 1: Crie sua primeira frota

O primeiro passo é criar uma frota. No Controle de Agentes, uma frota é uma coleção homogênea de entidades gerenciadas (como cluster do Kubernetes) que compartilham configuração de instrumentação idêntica. As frotas atuam como agrupamentos lógicos, permitindo que você gerencie versões de agentes e configurações de forma consistente em todo o seu ambiente em escala, evitando desvios de configuração e lacunas de observabilidade.

1. Entre na plataforma New Relic com a conta apropriada.

2. Navegue até All capabilities → New Relic Control.

   • Dica: você pode fixar o New Relic Control na barra de navegação à esquerda para facilitar o acesso clicando no ícone de fixação.

3. No menu New Relic Control, selecione Fleets na seção Fleet Control.

4. Na página principal Frotas, clique no botão Create a fleet.

5. No modal:

   • Dê à sua frota um Name significativo (por exemplo, prod-us-east-1-platform-k8s) e uma Description opcional.
   • Selecione o Type of Fleet. Para este guia, selecionaremos o Kubernetes, que está geralmente disponível. O suporte ao host está atualmente em versão prévia pública.
   • Deixe o Access management como padrão. Esta é uma configuração opcional para FGA (controle de acesso refinado).

6. Clique em Create Fleet.

Com a frota criada, você agora tem o componente necessário para prosseguir com a instalação do Agente Control.

Etapa 2: instalar o controle do agente

Agora que sua frota existe, instale o agente Control na entidade que você deseja associar a ela.

Siga as instruções na documentação de configuração do agente Control. O assistente fornece um arquivo values.yaml e um comando Helm que instala o agente Control e atribui a entidade gerenciada à frota que você acabou de criar. Após a conclusão, sua entidade aparecerá como Assigned Managed Entities dentro da sua frota.

Etapa 3: Criar uma configuração de agente

Antes de implantar o agente da New Relic Infrastructure, você precisa criar uma configuração para ele. Qualquer configuração que você criar será salva globalmente e ficará disponível para uso em sua conta New Relic.

1. No menu esquerdo New Relic Control, clique em Configurations.

2. Clique no botão Create configuration.

3. No modal:

   • Para Environnement, selecione Kubernetes.
   • Para Agent type, selecione New Relic Infrastructure.
   • Dê à configuração um nome significativo e exclusivo. Como as configurações são globais, é importante ter um nome claro. Por exemplo: New Relic default infra config.

4. Clique em Continue.

5. Você verá dois painéis. O painel direito contém um modelo padrão. Clique no botão Copy para copiar o modelo inteiro.

6. Cole o texto copiado no painel de configuração esquerdo.

7. Clique em Save. Sua configuração agora está salva globalmente.

Etapa 4: crie e execute sua primeira implantação

Uma implantação é um conjunto controlado de ações que podem instalar, excluir ou configurar um agente na entidade gerenciada em sua frota. Agora você criará um para implantar o agente New Relic Infrastructure.

1. Volte para a aba Fleets e selecione a frota que você criou anteriormente.
2. Na página de resumo da frota, clique em Create a deployment. (Caso a frota possua implantação existente, acesse a aba Deployments e clique em Create deployment).
3. Dê à sua implantação um Name obrigatório. Um nome significativo fornece contexto histórico e ajuda na resolução de problemas. Considere um padrão que inclui a alteração, uma versão ou um ID ticket. Por exemplo: v1.0-initial-infra-deploy ou add-logging-JIRA-123.
4. Clique em Add an agent.
5. Selecione o tipo de agente para o qual você criou a configuração: New Relic Infrastructure.
6. Na lista de configurações disponíveis, selecione o New Relic default infra config que você acabou de criar. A versão padrão será v1.
7. Clique em Add to deployment. O agente e sua configuração associada agora aparecerão em uma tabela chamada Agents.
8. Clique em Save draft.
9. Quando estiver pronto, clique em Start deployment. Um modal de confirmação aparecerá.
10. No modal, clique em Start deployment para lançamento.

Uma tela "EM ANDAMENTO" mostrará o status, o número de entidades gerenciadas e agentes afetados, além de um ID de implantação. Quando concluída, a página será atualizada com o status "Concluído" e tabelas de resumo detalhando a implantação, o agente e a entidade gerenciada específica que foram instrumentados.

Próximos passos

Parabéns por implantar sua primeira frota! Você aprendeu o fluxo de trabalho principal para gerenciar sua instrumentação em escala.

Para desenvolver o que você aprendeu, explore nossa página sobre Gerenciamento de frotas. Ele fornece detalhes adicionais sobre o recurso mais detalhado e cotidiano do Controle de Agentes, incluindo como:

• Crie e versione seu agente de configuração.
• Gerencie os detalhes e configurações da sua frota.
• Use a guia Managed Entities de nível superior para ver toda a sua infraestrutura com o Agente Control instalado, incluindo entidades atribuídas e não atribuídas.
• Mergulhe em uma frota específica para visualizar a configuração efetiva em sua aba de Agents e entender os diferentes status de implantação e instrumentação.