Atualizando o agente de controle e o agente gerenciado

Visão geral

O Agent Control oferece uma maneira centralizada e contínua de gerenciar todo o ciclo de vida dos seus agentes, incluindo atualizações. Em vez de atualizar manualmente os agentes em cada host ou cluster, você define o estado desejado no Fleet Control e o Agent Control cuida automaticamente do resto.

O Controle de agentes pode se atualizar como parte das suas implantações do Controle de Agentes, para que permaneça atualizado sem uma campanha de atualização separada. Você atualiza os agentes que ele gerencia alterando a versão deles na configuração da sua frota.

Principais benefícios do processo de atualização com o New Relic Control

• Controle centralizado: gerencie todas as versões de agentes de toda a sua frota a partir de um único local.
• Automatizado: assim que definir uma nova versão, o processo de implantação e reconciliação será tratado automaticamente.
• Instalações protegidas: nos hosts, o Controle de agentes verifica uma nova versão antes de substituir a que está em execução. No Kubernetes, uma atualização contínua mantém os pods antigos em execução até que os novos estejam íntegros. Consulte Se uma atualização do Controle de agentes falhar.

Atualizando seus Agentes gerenciados

Você pode atualizar qualquer agente gerenciado pelo Agent Control simplesmente alterando sua versão na configuração remota dentro do Fleet Control. Essa abordagem declarativa garante consistência e confiabilidade em toda a sua frota.

• Edite a configuração: Navegue até a configuração da sua frota no Fleet Control.
• Atualize a versão: Localize o agente que você deseja atualizar (por exemplo, infrastructure) e altere o valor de chart_version para o novo número da versão.
• Implantar as Alterações: Salve e implante a configuração atualizada.

O Agent Control detectará automaticamente a alteração e realizará uma atualização gradual sem interrupções, garantindo que seus novos agentes estejam em execução e íntegros antes de substituir os antigos.

Exemplo: Atualizando o agente de infraestrutura do New Relic

Este exemplo mostra como atualizar o agente de infraestrutura para uma nova versão.

# Remote configuration for a single agent
chart_version: "5.0.109"  # Change this value
chart_values:
  newrelic-infrastructure:
    enableProcessMetrics: true

Como o Controle de agentes é atualizado com o Controle de Frota

Ao enviar uma implantação no Controle de Agentes, o Controle de Agentes verifica se uma versão mais recente do Controle de agentes está disponível para as entidades gerenciadas nessa frota. Se houver, a atualização é incluída em sua implantação.

1. A equipe do Controle de agentes lança uma nova versão no canal de lançamento.
2. Você envia uma implantação no Controle de Agentes. A atualização do Controle de agentes é incluída nela.
3. O Controle de agentes atualiza a si mesmo, e seus agentes gerenciados recebem apenas as alterações de configuração solicitadas.

O Controle de agentes é atualizado como parte de uma implantação e não entre implantações. Para o lado da implantação desse processo, consulte Atualizações automáticas do Controle de agentes na documentação do Controle de Frota.

Em um host, uma atualização reinicia o Controle de agentes. Primeiro, ele para os agentes que gerencia e os inicia novamente depois que a nova versão estiver em execução, portanto, espere uma pequena lacuna nos dados desses agentes. No Kubernetes, o Flux substitui os pods do Controle de agentes por uma atualização contínua, e seus agentes gerenciados continuam em execução.

Canais de versão

Um canal de versão é uma trilha de versões do Controle de agentes que você assina. Cada canal tem sua própria política para quando uma nova versão chega, com base em fatores como há quanto tempo uma versão está disponível e quão comprovada ela é.

O Controle de Agentes oferece um canal, Rapid. Ele traz a versão mais recente do Controle de agentes pronta para produção. Uma nova versão chega com a sua próxima implantação no Controle de Agentes, que também é como as atualizações funcionam para o Controle de agentes no Kubernetes. Você não pode selecionar um canal diferente ou escolher a versão para a qual o Controle de Agentes atualiza.

Atualizando o Agent Control

Atualize o Controle de agentes por meio do Controle de Agentes em todas as plataformas. A atualização faz parte da sua implantação, conforme descrito em Como o Controle de agentes é atualizado com o Controle de Agentes.

Kubernetes

As instruções a seguir se aplicam ao Agent Control em execução em um cluster Kubernetes.

O Controle de Agentes inclui a atualização do Controle de agentes em sua implantação, conforme descrito em Como o Controle de agentes é atualizado com o Controle de Agentes. Quando uma versão mais recente está disponível, a página de implantação mostra um aviso de que o Controle de agentes será atualizado. Você não precisa alterar a versão do Controle de agentes em sua configuração. Isso mantém o Controle de agentes em execução no seu cluster atualizado com os recursos, correções e patches de segurança mais recentes.

A atualização aciona uma atualização gradual dos pods do Controle de agentes no seu cluster. As verificações de integridade integradas do Kubernetes garantem que a nova versão esteja saudável antes que a antiga seja encerrada para uma atualização sem interrupções.

Hosts Linux e Windows

Em hosts Linux e Windows, o Controle de Agentes também inclui a atualização do Controle de agentes na sua implantação. Você não precisa alterar a versão do Controle de agentes na configuração da sua frota.

Os agentes gerenciados (agente de infraestrutura, NRDOT) são atualizados da mesma forma que no Kubernetes. Atualize a versão desejada do agente na configuração da sua frota e implante as alterações.

Se uma atualização do Controle de agentes falhar

Como o Controle de agentes gerencia uma atualização com falha depende da plataforma:

• Hosts Linux e Windows: antes de o Controle de agentes substituir a si mesmo, ele executa a nova versão uma vez para confirmar que pode iniciar, carregar a sua configuração e se conectar ao Controle de Agentes. Se essa verificação falhar, ou se o download ou a verificação de assinatura falhar, a versão atual continuará em execução e a implantação será exibida como FAILED. Implantar uma versão desejada diferente inicia uma nova tentativa imediatamente. Se a causa for permanente, como um pacote que falha na verificação de assinatura, a atualização continuará falhando e a implantação permanecerá como FAILED até que você corrija a causa ou implante uma versão diferente. A verificação é executada antes da troca, portanto, não pode detectar uma versão que passa por ela e depois quebra.
• Kubernetes: a atualização gradual mantém os pods antigos do Controle de agentes em execução até que os novos pods estejam prontos.

Quando uma nova versão estiver em execução, o Controle de agentes não reverterá para a versão anterior por conta própria. Para se recuperar de uma versão ruim, avance para uma versão corrigida, que o Controle de Agentes inclui na sua próxima implantação. Para ver o que falhou, verifique os detalhes da implantação no Controle de Agentes. Consulte também Atualizações automáticas do Controle de agentes.

Iniciar, parar e reiniciar o Controle do Agente

O Agent Control inicia automaticamente após você executar o script de instalação.

Linux

Para Linux, certifique-se de usar o comando correto para o seu sistema de inicialização. Selecione start, stop, restart ou status conforme apropriado.

Aqui está um exemplo para systemd:

$
sudo systemctl <start|stop|restart|status> newrelic-agent-control

Windows

Execute estes comandos no PowerShell com privilégios de administrador:

Start-Service -Name newrelic-agent-control
Stop-Service -Name newrelic-agent-control
Restart-Service -Name newrelic-agent-control
Get-Service -Name newrelic-agent-control