Como soluciono erros de permissão e falhas de integração entre os logs do Session Manager e do CloudWatch?
Quero solucionar falhas de integração do Amazon CloudWatch Logs ou erros de permissão que aparecem quando eu uso o Session Manager, um recurso do AWS Systems Manager.
Breve descrição
Os problemas a seguir causam falhas de integração entre o Session Manager e o CloudWatch Logs:
- Você não definiu suas configurações de criptografia.
- O AWS Systems Manager Agent (SSM Agent) ou seu perfil de instância do Amazon Elastic Compute Cloud (Amazon EC2) não têm as permissões necessárias do AWS Identity and Access Management (IAM).
Observação: Se sua instância não tiver as permissões de IAM necessárias, o Gerenciador de Sessões criará um novo fluxo de logs para cada sessão. - Suas instâncias em uma sub-rede privada não podem acessar o endpoint de nuvem privada virtual (VPC).
- Sua instância não pode se conectar ao CloudWatch Logs.
Resolução
Identifique o problema
**Visualize seus logs do SSM Agent **
Para identificar problemas que causam falhas de integração, use o Gerenciador de Sessões para se conectar à sua instância e, em seguida, visualizar seus logs do SSM Agent.
Em seus logs, procure os seguintes erros do CloudWatch Logs:
- "An error occurred (AccessDeniedException) when calling the DescribeLogGroups operation." permissions errors show that your IAM doesn't have the necessary permissions.
- Sua instância não pode se conectar aos endpoints do CloudWatch Logs.
Solucione seu problema com base no erro que você identifica nos logs do SSM Agent.
Observação: Se o CloudWatch Logs interromper o acesso aos seus logs do SSM Agent, desative temporariamente o CloudWatch Logs. Depois de solucionar o problema, reative o CloudWatch Logs.
Ativar o log de depuração
Para ver informações mais detalhadas em seus logs do SSM Agent, conclua as seguintes etapas
-
Para abrir o arquivo de configuração do SSM Agent, execute o seguinte comando:
sudo vi /etc/amazon/ssm/amazon-ssm-agent.json -
No arquivo de configuração, defina o valor LogLevel para debug:
"LogLevel": "debug" -
Salve seu arquivo de configuração do SSM Agent.
-
Execute um dos comandos a seguir para reiniciar o SSM Agent.
Para Linux:sudo systemctl restart amazon-ssm-agentPara Windows:
Restart-Service AmazonSSMAgent
Verifique se você criptografou seu grupo de logs do CloudWatch
Observação: se você receber mensagens de erro ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.
Se você receber a seguinte mensagem de erro depois de tentar iniciar uma sessão, você não criptografou seu grupo de logs do CloudWatch:
"We couldn't start the session because encryption is not set up on the selected CloudWatch log group"
Se você ativar Permitir somente grupos de logs criptografados do CloudWatch em suas preferências do Systems Manager, deverá criptografar o grupo de logs com uma chave do AWS Key Management Service (AWS KMS). Ou desative o requisito de criptografia.
Para desativar o requisito de criptografia nas preferências do Session Manager, consulte Registro em log de dados de sessão usando Amazon CloudWatch Logs (console). Nas preferências, desmarque Permitir somente grupos de logs criptografados do CloudWatch e salve suas alterações.
Resolver problemas de permissões do IAM
Seu perfil do IAM da instância deve ter permissões para interagir com o CloudWatch Logs. Se você receber um erro de "log stream does not exist" ao iniciar uma sessão do Gerenciador de Sessões, a função não tem as permissões necessárias.
Se você configurar o Session Manager para enviar logs tanto para o CloudWatch Logs quanto para o Amazon Simple Storage Service (Amazon S3) com a criptografia ativada, sua função exigirá permissões adicionais.
Se você usa um nó gerenciado em um ambiente híbrido e multicloud, deve usar o perfil de serviço do IAM usado para a ativação híbrida.
Resolver as permissões do IAM ausentes para o perfil de instância
Para resolver a falta de permissões do IAM para o perfil de instância, adicione as seguintes permissões à política anexada ao perfil do IAM:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams", "logs:DescribeLogGroups" ], "Resource": "*" } ] }
Ou anexe a política gerenciada pela AWS do CloudWatchAgentServerPolicy à função de perfil de instância. A política inclui as permissões necessárias do CloudWatch Logs. Para obter mais informações, consulte a Política: Seção CloudWatchAgentServerPolicy de Considerações adicionais sobre políticas para instâncias gerenciadas.
Se o perfil do IAM não existir, crie uma função com permissões para o CloudWatch Logs.
Depois de adicionar as permissões necessárias, reinicie o SSM Agent.
Resolver as permissões de configuração de criptografia do Amazon S3 para o perfil de instância
Se você definiu as configurações a seguir, o perfil de instância deverá ter permissão para executar GetEncryptionConfiguration em seu bucket do S3:
- Você ativou a criptografia para o Gerenciador de Sessões.
- O gerenciador de sessões envia logs para o CloudWatch Logs.
- O Gerenciador de Sessões envia logs para um bucket do S3.
Adicione a seguinte permissão à política do perfil do IAM:
{ "Effect": "Allow", "Action": [ "s3:GetEncryptionConfiguration" ], "Resource": "*" }
Resolver permissões KMS para grupos de logs criptografados
Se você usa grupos de logs criptografados do CloudWatch ou buckets do S3 com chaves KMS gerenciadas pelo cliente, sua função deve ter as permissões de chave KMS necessárias.
Observação: Se você usa somente chaves gerenciadas pela AWS, não adicione permissões do KMS à política do perfil do IAM.
Adicione as seguintes permissões KMS à política do perfil do IAM:
{ "Effect": "Allow", "Action": [ "kms:Decrypt", "kms:GenerateDataKey", "kms:DescribeKey" ], "Resource": "arn:aws:kms:example-region:example-account-id-ID:key/example-kms-key-id" }
Observação: substitua example-region pela sua região da AWS, example-account-id pelo ID da conta da AWS e example-kms-key-id pelo ID de sua chave KMS.
Atualize as permissões para nós gerenciados em um ambiente híbrido e multicloud
Para atualizar as permissões para nós gerenciados em um ambiente híbrido e multicloud, identifique o perfil de serviço do IAM que você usou para a ativação híbrida. Em seguida, adicione a política de permissões do CloudWatchAgentServerPolicy ao perfil de serviço do IAM.
Se você usou o SSMServiceRole padrão para ativação híbrida, conclua as seguintes etapas:
- Crie um perfil de serviço do IAM e, em seguida, anexe as políticas AmazonSSMManagedInstanceCore e CloudWatchAgentServerPolicy à função.
- Se você usa grupos de logs criptografados, adicione as permissões KMS Decrypt, GenerateDataKey e DescribeKey.
- Use o perfil de serviço para criar uma nova ativação híbrida.
- Cancele o registro do nó gerenciado existente no ambiente híbrido e multicloud.
Observação: Ao cancelar o registro do nó gerenciado, você o remove do Systems Manager. - Registre novamente o nó gerenciado com o novo código de ativação e ID.
Verifique sua conexão com o CloudWatch Logs
Verifique o acesso ao endpoint da VPC para o CloudWatch Logs
Se suas instâncias estiverem em sub-redes privadas sem acesso à Internet, o SSM Agent deverá ter acesso a um endpoint da VPC para o CloudWatch Logs. Se você não conseguir acessar o endpoint da VPC para o CloudWatch Logs, deverá criar um.
Para verificar se sua instância pode se conectar ao CloudWatch Logs, conclua as seguintes etapas:
-
Use o Session Manager para se conectar à sua instância e, em seguida, execute o seguinte comando:
nslookup logs.example-region.amazonaws.com -
Observação: substitua example-region pela sua região.
-
Se a saída mostrar um endereço IP privado e seus logs não aparecerem, verifique o grupo de segurança que está anexado ao endpoint da VPC. Confirme se o grupo de segurança permite tráfego HTTPS de entrada na porta 443 do grupo de segurança da sua instância ou do intervalo CIDR da VPC.
-ou-
Se o comando falhar ou for resolvido para um endereço IP público, crie um endpoint da VPC para o CloudWatch Logs. -
Verifique se o grupo de segurança associado ao endpoint da VPC permite tráfego de entrada na porta 443, no grupo de segurança de sua instância ou no intervalo CIDR da VPC.
Verifique se você configurou as preferências do Session Manager para enviar logs para o CloudWatch Logs
Analise suas preferências do Gerenciador de Sessões. Confirme se você selecionou Ativar no registro em log do CloudWatch. Certifique-se de especificar o nome correto do grupo de logs para o nome do grupo de logs do CloudWatch. Além disso, verifique o grupo de logs que você especificou para Grupo de logs. Em seguida, abra o console do CloudWatch e verifique se o grupo que você especificou aparece na página Grupos de logs.
Identifique problemas de permissões de instância
Se as etapas de solução de problemas anteriores não resolverem seu problema, conclua as seguintes etapas:
- Abra o console do AWS CloudTrail.
- Escolha Histórico de eventos.
- Filtre eventos pelas seguintes ações:
CreateLogStream
PutLogEvents
DescribeLogGroups
DescribeLogStreams
Se os eventos não aparecerem para essas ações, configure o SSM Agent para enviar logs para o CloudWatch e repita as etapas anteriores.
Se aparecerem eventos para as ações que contêm mensagens de erro, revise os detalhes para identificar e resolver problemas de configuração ou permissões ausentes.
- Tópicos
- Management & Governance
- Idioma
- Português
