Como faço para verificar se há erros nos logs do CloudWatch ao importar usuários de um arquivo CSV para um grupo de usuários?

Breve descrição

O Amazon Cognito permite que você importe usuários de um arquivo CSV especialmente formatado para um grupo de usuários do Amazon Cognito. Esse processo de importação define valores para todos os atributos do usuário, exceto a senha. Para obter mais informações, consulte Importing users into user pools from a CSV file (Importação de usuários de um arquivo CSV para grupos de usuários).

Para obter informações sobre erros comuns durante o processo de importação, consulte How do I troubleshoot common errors with the importing process in Amazon Cognito? (Como faço para solucionar erros comuns com o processo de importação no Amazon Cognito?)

Para encontrar esses erros, faça o seguinte:

1. Encontre o ID e o nome do grupo de usuários.
2. Importe o nome da tarefa.
3. Encontre o grupo de logs do Cloudwatch.
4. Use o fluxo de logs do Cloudwatch.

Resolução

Encontre o ID e o nome do grupo de usuários

1. Abra o Amazon Cognito console (Console do Amazon Cognito).
   Observação: se estiver usando a interface antiga, selecione Manage User Pools (Gerenciar grupos de usuários).
2. Pesquise o grupo de usuários em que você executou a tarefa de importação para encontrar o nome e o ID do grupo de usuários.
3. Anote o nome e o ID do grupo de usuários.

Exemplo de nome e ID do grupo de usuários:

- Pool Id - us-east-1_XXXXXXXXX
- Pool Name - testuserimport

Encontre o nome da tarefa de importação

Interface antiga

1. Abra o Amazon Cognito console (Console do Amazon Cognito).
2. Selecione Manager User Pools (Gerenciar grupos de usuários).
3. Escolha seu grupo de usuários.
4. No painel de navegação, escolha Users and groups (Usuários e grupos) em General settings (Configurações gerais).
5. Selecione Import Users (Importar usuários).
6. Observe o nome da tarefa com falha.

Nova interface

1. Abra o Amazon Cognito console (Console do Amazon Cognito).
2. Escolha seu grupo de usuários.
3. Na guia Users (Usuários), encontre as informações sobre Import users (Importar usuários).
4. Observe o nome da tarefa com falha.
   Observação: você pode ver os logs do CloudWatch aqui, clicando em View logs (Visualizar logs) na tarefa de importação com falha. Isso o redirecionará para o fluxo do grupo de logs.

Exemplo de nome de tarefa de importação:

import-Test1

Encontre o grupo de logs do Cloudwatch

1. Abra o Amazon CloudWatch console (Console do Amazon CloudWatch).
2. Expanda Logs no painel de navegação e selecione Log Groups (Grupos de logs).
3. Usando a funcionalidade da barra de pesquisa Log Groups (Grupos de logs), você pode procurar o ID ou o nome do grupo de usuários. Essa ação filtrará o grupo de logs específico desse grupo de usuários.

Exemplo de grupo de logs do CloudWatch:

/aws/cognito/userpools/{user_pool_id}/{user_pool_name}

Encontre o fluxo de logs do CloudWatch

1. Enquanto ainda estiver no CloudWatch, selecione o grupo de logs que você encontrou para o seu grupo de usuários durante as etapas anteriores.
2. Selecione a guia Log Streams (Fluxos de log) e use a funcionalidade do filtro de pesquisa para encontrar o fluxo de logs usando o nome da tarefa de importação.
3. Selecione o fluxo de logs para verificar se há erros na tarefa de importação nos eventos de log.

Exemplo de fluxo de logs do CloudWatch:

[Timestamp]    Cognito User Pools Import - Test Log 
[Timestamp]    Cognito User Pools Import - Test Log 
[Timestamp]    [FAILED] Line Number 2 - The User Record contains an invalid value for phone_number_verified. It must be true or false.

Observação: com base nesse exemplo, o erro relatado no fluxo de logs do CloudWatch mostra que o valor do campo phone_number_verified está definido incorretamente.

---

Informações relacionadas

Working with log groups and log streams (Trabalho com grupos de logs e fluxos de logs)