CSV ファイルからユーザープールにユーザーをインポートする際に、CloudWatch ログのエラーを確認するにはどうすればよいですか?

簡単な説明

Amazon Cognito では、特別にフォーマットされた CSV ファイルから Amazon Cognito ユーザープールにユーザーをインポートできます。このインポートプロセスでは、パスワードを除くすべてのユーザー属性の値を設定します。詳細については、「CSV ファイルからユーザープールへのユーザーのインポート」を参照してください。

インポートプロセス中によく発生するエラーについては、「How do I troubleshoot common errors with the importing process in Amazon Cognito?」(Amazon Cognito のインポートプロセスでよく発生するエラーをトラブルシューティングするにはどうすればよいですか?) を参照してください。

これらのエラーを検索するには、次を実行します。

1. ユーザープール ID と名前を検索する。
2. ジョブ名をインポートする。
3. CloudWatch ロググループを検索する。
4. CloudWatch のログストリームを使用する。

解決方法

ユーザープール ID と名前を検索する

1. Amazon Cognito コンソールを開きます。
   注: 古いインターフェイスを使用している場合は、[Manage User Pools] (ユーザープールを管理) を選択します。
2. インポートジョブを実行したユーザープールを検索して、ユーザープールの名前と ID を検索します。
3. ユーザープールの名前と ID を書き留めておきます。

ユーザープールの ID と名前の例:

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

インポートジョブ名を検索する

古いインターフェイス

1. Amazon Cognito コンソールを開きます。
2. [Manager User Pools] (マネージャーユーザープール) を選択します。
3. ユーザープールを選択します。
4. ナビゲーションペインで、[General settings] (一般設定) の [Users and groups] (ユーザーとグループ) を選択します。
5. [Import Users] (ユーザーをインポート) を選択します。
6. 失敗したジョブ名を書き留めておきます。

新しいインターフェイス

1. Amazon Cognito コンソールを開きます。
2. ユーザープールを選択します。
3. [Users] (ユーザー) タブで、[Import users] (ユーザーをインポート) の情報を探します。
4. 失敗したジョブ名を書き留めておきます。
   注: 失敗したインポートジョブについて [View logs] (ログを表示) をクリックすると、ここから CloudWatch ログを表示できます。これにより、ロググループストリームにリダイレクトされます。

インポートジョブ名の例:

import-Test1

CloudWatch ロググループを検索する

1. Amazon CloudWatch コンソールを開きます。
2. ナビゲーションペインの [Logs] (ログ) を展開し、[Log Groups] (ロググループ) を選択します。
3. [Log Groups] (ロググループ) の検索バー機能を使用して、ユーザープールの ID または名前を検索できます。これを実行すると、そのユーザープールの特定のロググループがフィルタリングされます。

CloudWatch ロググループの例:

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

CloudWatch ログストリームを検索する

1. CloudWatch を開いたまま、前のステップで見つけたユーザープールのロググループを選択します。
2. [Log Streams] (ログストリーム) タブを選択し、検索フィルター機能を使用して、インポートジョブ名を使用してログストリームを検索します。
3. ログストリームを選択して、インポートジョブエラーのログイベントを確認します。

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.

注: この例に基づくと、[CloudWatch Log Streams] (CloudWatch ログストリーム) で報告されるエラーは、[phone_number_verified] フィールドの値が誤って設定されていることを示しています。

---

関連情報

ロググループとログストリームの操作