Como soluciono e resolvo problemas no canário do Amazon CloudWatch Synthetics?

Resolução

Para solucionar problemas no canário do CloudWatch Synthetics, execute as seguintes ações:

Verifique perfis e permissões para canários e usuários do IAM que gerenciam canários

Verifique se os usuários e canários do AWS Identity and Access Management (AWS IAM) possuem os perfis e permissões necessárias. Para obter mais informações, consulte Funções e permissões necessárias para usuários que gerenciam canários do CloudWatch e Funções e permissões necessárias para canários.

Se quiser que seu usuário do IAM visualize somente canários específicos, anexe uma política para o perfil ou usuário do IAM.

Resolva problemas de bucket do Amazon S3

Resolva o erro "The specified bucket does not exist"

O bucket do Amazon Simple Storage Service (Amazon S3) deve existir para que o canário do CloudWatch Synthetics encontre o bucket do Amazon S3. Se o bucket do S3 não existir mais, um erro será exibido.

Para evitar que esse erro ocorra novamente, crie uma regra de ciclo de vida no bucket usado para armazenar os artefatos do canário do CloudWatch Synthetics. Para obter mais informações, consulte Gerenciando seu ciclo de vida de armazenamento.

Resolva o erro "Unable to upload artifacts to S3, Exception: Unable to fetch S3 bucket location: Access denied"

Esse erro ocorre quando o perfil do IAM do canário não tem as permissões necessárias para acessar o bucket. O erro também ocorre quando as configurações de criptografia estão incorretas ou quando as políticas organizacionais bloqueiam o acesso.

Confirme se o perfil do IAM do canário tem as permissões de bucket corretas. Verifique também se as políticas de controle de serviços da sua organização não bloqueiam o acesso do usuário ao bucket. Para obter instruções, consulte Obter informações sobre as políticas da sua organização.

Verifique se o canário usa uma chave gerenciada pela AWS padrão e não uma chave gerenciada pelo cliente do AWS Key Management Service (AWS KMS) para criptografia. Se o canário usar uma chave gerenciada pelo cliente do AWS KMS, o perfil do IAM do canário talvez não tenha permissão para criptografar ou descriptografar. Para obter mais informações, consulte Criptografia dos artefatos do canário.

Verifique se o canário realiza monitoramento visual. Para obter mais informações, consulte Atualização da localização e criptografia de artefatos ao usar o monitoramento visual.

Para que a política do bucket permita o mecanismo de criptografia utilizado pelo canário, verifique se o modo de criptografia do canário é o mesmo definido na política do bucket. Se não for, escolha uma opção de criptografia diferente:

1. Abra o console do Amazon CloudWatch.
2. No painel de navegação, escolha Canários do Synthetics e selecione seu canário.
3. Escolha Ações e, em seguida, selecione Editar.
4. Na seção Armazenamento de dados, escolha Configuração adicional.
5. Escolha o tipo de chave a ser usada para criptografia para selecionar uma opção de criptografia diferente.

Resolva o erro "1 validation error detected: Value 'XXXXX' at 'content.s3Bucket' failed to satisfy constraint: Member must satisfy regular expression pattern: ^[0-9A-Za-z\.\-_]*(?<!\.)$"

Para resolver esse erro, verifique seu bucket e confirme se ele contém o script do seu canário.

Se o script estiver localizado no bucket, especifique o nome do bucket no código do script. Não inclua s3:// no início do nome do bucket.

Resolver problemas do Lambda

Resolva o erro "The canary can't detect the latest Lambda layer"

O canário pode detectar a camada mais recente do AWS Lambda se você fizer alterações manuais ou excluir a função do Lambda. Para resolver esse problema, crie um novo canário.

Resolva o erro "The IAM role attached to the canary doesn't have a trust relationship for the Lambda service"

O perfil do IAM do seu canário deve ter uma relação de confiança com o serviço Lambda.

Confirme se o perfil do IAM contém a seguinte declaração:

{  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "lambda.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Resolva uma falha no canário do CloudWatch em sua VPC

Se seu canário do CloudWatch em uma nuvem privada virtual (VPC) receber um erro e falhar, siga as instruções em Como resolvo os erros do canário do CloudWatch que falhou na minha VPC?

Práticas recomendadas para problemas no canário do CloudWatch Synthetics

Realize as seguintes ações

• Verifique a guia Disponibilidade para identificar um problema em uma execução específica que falhou ou foi aprovada.
• Verifique a mensagem de erro na página Detalhes para ver por que um canário está falhando.
• Verifique as capturas de tela para verificar as últimas invocações do canário.
• Verifique o arquivo de log para identificar problemas de permissão ou exceções de controle de utilização.
• Verifique a guia Monitoramento para obter métricas do canário e do Lambda.
• Verifique os grupos de logs do CloudWatch Logs com o nome /aws/lambda/cwsyn-MyCanaryName-randomId para obter os registros recentes de operações do canário.
• Verifique o bucket do Amazon S3 com o nome cw-syn-results-accountID-region para ver se há uploads de artefatos, como capturas de tela ou arquivos HAR.
• Confira as métricas do CloudWatch publicadas pelos canários.

Informações relacionadas

Por que meu canário do Amazon CloudWatch parou de funcionar?

Como posso usar o CloudWatch Synthetics para monitorar o desempenho do meu site?