Por que recebo o erro "Plugin with name Standard_Stream not found" quando uso o Gerenciador de Sessões para me conectar à minha instância do Amazon EC2?

Breve descrição

Se o AWS Systems Manager Agent (SSM Agent) não conseguir criar os arquivos necessários para estabelecer uma sessão, você receberá a seguinte mensagem de erro:

"Your session has been terminated for the following reasons: Plugin with name Standard_Stream not found. Step name: Standard_Stream"

Esse problema normalmente ocorre se não houver espaço de armazenamento suficiente em sua instância ou se você tiver muitos arquivos abertos simultaneamente.

Para identificar a causa do problema, verifique os logs do seu sistema em busca de mensagens de erro específicas. Com base no erro recebido, realize as seguintes ações de solução de problemas.

Resolução

Solucione erros "No space left on device"

Você deve ter espaço suficiente na partição raiz para que o SSM Agent crie os dados temporários necessários para iniciar uma sessão. Se você receber a mensagem de erro "No space left on device", deve aumentar o espaço disponível no sistema de arquivos raiz. Primeiro, remova os arquivos não utilizados da partição raiz. Se ainda não houver espaço suficiente, use volumes elásticos para aumentar seu volume do Amazon Elastic Block Store (Amazon EBS). Ou use um dos métodos a seguir para estender o sistema de arquivos raiz no nível do sistema operacional (SO).

Use o SSH ou o Console de série do EC2 para estender o sistema de arquivos raiz

Conclua as etapas a seguir:

1. Use o SSH ou o Console de série do EC2 para se conectar à sua instância.
   Observação: para usar o Console de série do EC2, você deve configurar o acesso ao Console de série do EC2. Para obter mais informações sobre os requisitos, consulte Pré-requisitos do Console de série do EC2.

2. Para verificar o espaço disponível na partição raiz, execute o seguinte comando:

   df -Th

   Exemplo de saída:

   $ df -Th
   
   Filesystem Type Size Used Avail Use% Mounted on
   
   devtmpfs devtmpfs 4.0M 0 4.0M 0% /dev
   
   tmpfs tmpfs 3.9G 0 3.9G 0% /dev/shm
   
   tmpfs tmpfs 1.6G 440K 1.6G 1% /run
   
   /dev/nvme0n1p1 xfs 8.0G 2.0G 6.0G 25% /
   
   tmpfs tmpfs 3.9G 0 3.9G 0% /tmp
   
   /dev/nvme0n1p128 vfat 10M 1.3M 8.7M 13% /boot/efi
   
   tmpfs tmpfs 782M 0 782M 0% /run/user/1000

3. Para visualizar detalhes como o nome e os tipos de sistema de arquivos dos dispositivos de blocos e da partição raiz, execute o seguinte comando lsblk:

   lsblk -f

   Exemplo de saída:

   $ lsblk -f
   NAME          FSTYPE LABEL           UUID                                 MOUNTPOINT
   nvme0n1
   ├─nvme0n1p1   xfs    /               abcd123-abcd-1234-abcd-abcdef1234 /
   └─nvme0n1p128

4. Para estender uma partição, execute o seguinte comando:

   sudo growpart /dev/nvme0n1 1

   Observação: substitua nvme0n1 pelo nome da partição.

5. Para verificar se você estendeu a partição, execute novamente o comando lsblk. Na saída, verifique se o tamanho da partição é igual ao tamanho do volume.

6. Para expandir o sistema de arquivos, execute um dos seguintes comandos com base no seu tipo de sistema de arquivos.
   Volumes ext4:

   sudo resize2fs /dev/nvme0n1p1

   Observação: substitua nvme0n1p1 pelo nome da partição.
   Volumes XFS:

   sudo xfs_growfs -d /

Use uma instância de resgate para estender o sistema de arquivos raiz

Se não for possível usar o SSH para se conectar a uma instância inacessível, crie uma instância de resgate na mesma Zona de disponibilidade da instância inacessível. Para obter instruções, consulte Solucionar o erro "No space left on device" em Como soluciono problemas de uma instância do Linux do EC2 que apresenta falha na verificação de status devido ao uso excessivo de recursos? Depois de montar o volume raiz na instância de resgate, estenda o sistema de arquivos.

Solucione erros "Too many open files"

Se você exceder o máximo de recursos do inotify, o SSM Agent não poderá criar os novos descritores de arquivo necessários para estabelecer uma sessão. Esse problema ocorre se você tiver muitos arquivos ou descritores de arquivo abertos simultaneamente ou se o subsistema inotify do kernel exceder sua instância máxima ou cota de observação. Para obter mais informações, consulte inotify no site do man7.

Para solucionar esse problema, realize as seguintes ações:

Reinicialize ou reinicie sua instância

Para reiniciar todos os processos e liberar os recursos do inotify em uso, reinicialize ou interrompa e execute a instância.

Observação: quando você interrompe e executa uma instância, o endereço IP público dela muda. Ao rotear tráfego externo para sua instância, é uma prática recomendada usar um endereço IP elástico em vez de um endereço IP público. Se você usa o Amazon Route 53, talvez seja necessário atualizar os registros DNS do Route 53 quando o endereço IP público mudar.

Antes de interromper e iniciar sua instância, realize as seguintes ações:

• Se sua instância usa um armazenamento de instância, salve os dados do volume no armazenamento de instância em armazenamento persistente. Por exemplo, é possível salvar os dados em volumes do Amazon EBS ou em buckets do Amazon Simple Storage Service (Amazon S3).
  Importante: o Amazon EC2 exclui dados do armazenamento de instância quando você interrompe a instância.
• Crie um snapshot do seu volume do Amazon EBS. Se você tiver problemas, pode usar o snapshot para restaurar sua instância.
• Remova temporariamente a instância do grupo do Amazon EC2 Auto Scaling para que você não a encerre acidentalmente ao interrompê-la.
  Observação: o EC2 Auto Scaling pode encerrar instâncias interrompidas em um grupo do Auto Scaling com base em suas configurações de proteção na redução de escala. As instâncias executadas com o Amazon EMR, o AWS CloudFormation ou o AWS Elastic Beanstalk podem fazer parte de um grupo do Auto Scaling.
• Defina o comportamento de desligamento da instância como Interromper para garantir que as instâncias não sejam encerradas quando você as interrompe.

Aumente sua cota do inotify

Se você ainda encontrar problemas após uma reinicialização, conclua as etapas a seguir para aumentar a cota do inotify em sua instância:

1. Execute os seguintes comandos para verificar a cota do inotify:

   cat /proc/sys/fs/inotify/max_user_watches
   cat /proc/sys/fs/inotify/max_user_instances

   Observação: por padrão, max_user_watches é 8192 e max_user_instances é 128.
2. Para aumentar temporariamente os valores máximos da cota, execute o seguinte comando:

   sudo sysctl fs.inotify.max_user_watches=newwatchesquota
   sudo sysctl fs.inotify.max_user_instances=newinstancesquota

   Observação: substitua newwatchesquota pela nova cota de max_user_watches e newinstancesquota pela nova cota de max_user_instances. O comando anterior atualiza as cotas até a próxima reinicialização da instância. É uma prática recomendada testar primeiro os valores atualizados por meio de alterações temporárias.
3. Para tornar as atualizações de cota permanentes, adicione os seguintes parâmetros ao arquivo /etc/sysctl.conf:

   echo "fs.inotify.max_user_watches = newwatchesquota" >> /etc/sysctl.d/20-fs-inotify.conf
   echo "fs.inotify.max_user_instances = newinstancesquota" >> /etc/sysctl.d/20-fs-inotify.conf

   Observação: substitua newwatchesquota pela nova cota de max_user_watches e newinstancesquota pela nova cota de max_user_instances.
4. Reinicialize a instância para aplicar as alterações.

Observação: é uma prática recomendada monitorar o desempenho do seu sistema depois de modificar sua instância para validar se as cotas atualizadas estão alinhadas aos requisitos do seu sistema.

Informações relacionadas

Por que não consigo usar o Gerenciador de Sessões para me conectar à minha instância do Amazon EC2?

Como faço para estender meu sistema de arquivos Linux depois de aumentar meu volume do EBS na minha instância do EC2?