• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
# Automatizar atualizações do SSM Agent
A AWS lança uma nova versão do AWS Systems Manager Agent (SSM Agent) quando adicionamos ou atualizamos ferramentas do Systems Manager. Se os nós gerenciados usarem uma versão mais antiga do agente, você não poderá usar as novas ferramentas nem se beneficiar das ferramentas atualizadas. Por esses motivos, recomendamos que você automatize o processo de atualização do SSM Agent em seus nós gerenciados, usando qualquer um dos seguintes métodos.
**Atualizações do agente no sistema operacional Bottlerocket**
Não é possível atualizar o SSM Agent no sistema operacional Bottlerocket usando o documento Systems Manager Command `AWS-UpdateSSMAgent`. As atualizações são gerenciadas dentro do contêiner de controle do Bottlerocket. Para obter mais informações, consulte [Contêiner de controle do Bottlerocket](https://github.com/bottlerocket-os/bottlerocket-control-container/blob/develop/README.md) e [Operador de atualização do Bottlerocket](https://github.com/bottlerocket-os/bottlerocket-update-operator/blob/develop/README.md) no GitHub.
**Requisitos de versão do macOS**
Se uma instância estiver sendo executada no macOS versão 11.0 (Big Sur) ou posterior, a instância deverá ter o SSM Agent versão 3.1.941.0 ou posterior para executar o documento AWS-UpdateSSMAgent. Se a instância estiver executando uma versão do SSM Agent lançada antes da 3.1.941.0, atualize o SSM Agent para executar o documento AWS-UpdateSSMAgent executando os comandos `brew upgrade amazon-ssm-agent` e `brew update`.
****
| Método | Detalhes |
| --- | --- |
| Atualização automatizada com um clique em todas os nós gerenciados (recomendado) | Você pode configurar todos os nós gerenciados em sua Conta da AWS para verificar e baixar automaticamente novas versões do SSM Agent. Para isso, escolha **Atualização automática do SSM Agent** na guia **Configurações** no Fleet Manager, conforme descrito posteriormente neste tópico. |
| Atualização global ou seletiva | Você pode usar o State Manager, uma ferramenta do AWS Systems Manager, para criar uma associação que baixe e instale automaticamente o SSM Agent em seus nós gerenciados. Se quiser limitar a interrupção às cargas de trabalho, crie uma janela de manutenção do Systems Manager para executar a instalação durante períodos designados. Ambos os métodos permitem que você crie uma configuração de atualização global para todos os nós gerenciados ou escolha seletivamente quais instâncias serão atualizadas. Para obter informações sobre como criar uma associação do State Manager, consulte [Walkthrough: Automatically update SSM Agent with the AWS CLI](state-manager-update-ssm-agent-cli.md). Para obter informações sobre como criar uma janela de manutenção, consulte [Tutorial: Create a maintenance window for patching using the console](maintenance-window-tutorial-patching.md). |
| Atualização global ou seletiva para novos ambientes | Se você estiver começando a usar o Systems Manager, recomendamos usar a opção **Atualizar o Systems Manager (SSM) Agent a cada duas semanas** no Quick Setup, uma ferramenta do AWS Systems Manager. O Quick Setup permite que você crie uma configuração de atualização global para todas os nós gerenciados ou escolha seletivamente quais nós gerenciados serão atualizados. Para obter mais informações, consulte [Configurar o gerenciamento de host do Amazon EC2 usando a Quick Setup](quick-setup-host-management.md). |
Se você preferir atualizar o SSM Agent em seus nós gerenciados manualmente, poderá assinar as notificações que a AWS publica quando uma nova versão do agente é lançada. Para mais informações, consulte [Assinar as notificações do SSM Agent](ssm-agent-subscribe-notifications.md). Depois de assinar notificações, você pode usar o Run Command para atualizar manualmente uma ou mais nós gerenciados com a versão mais recente. Para obter mais informações, consulte [Atualização do SSM Agent por meio de Run Command](run-command-tutorial-update-software.md#rc-console-agentexample).
## Atualizar automaticamente o SSM Agent
Você pode configurar o Systems Manager para atualizar automaticamente o SSM Agent em todos os nós gerenciados com base em Linux e Windows em sua Conta da AWS. Se você ativar essa opção, o Systems Manager verificará automaticamente a cada duas semanas se há uma nova versão do agente. Se houver uma nova versão, o Systems Manager atualizará automaticamente o agente para a última versão lançada usando o documento SSM `AWS-UpdateSSMAgent`. Recomendamos escolher essa opção para garantir que os nós gerenciados estejam sempre executando a versão mais atualizada do SSM Agent.
**nota**
Se você usar um comando `yum` para atualizar o SSM Agent em um nó gerenciado após o agente ter sido instalado ou atualizado usando o documento `AWS-UpdateSSMAgent` do SSM, você poderá ver a seguinte mensagem: `"Warning: RPMDB altered outside of yum."` Esta mensagem é esperada e pode ser ignorada com segurança.
**Como atualizar automaticamente o SSM Agent**
1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. No painel de navegação, escolha **Fleet Manager**.
1. Escolha a guia **Configurações**.
1. Na área **Atualização automática do agente**, escolha **Atualização automática do SSM Agent**.
Para alterar a versão do SSM Agent para a qual a frota é atualizada, escolha **Editar** em **Atualização automática do agente** na guia **Configurações**. Em seguida, insira o número da versão do SSM Agent para a qual você deseja atualizar na opção **Version** (Versão) em **Parameters** (Parâmetros). Se não for especificado, o agente será atualizado para a versão mais recente.
Para interromper a implantação automática de versões atualizadas do SSM Agent em todos os nós gerenciados da conta, escolha **Excluir** em **Atualização automática do agente** na guia **Configurações**. Essa ação exclui a associação do State Manager que atualiza automaticamente o SSM Agent em seus nós gerenciados.