當我從 CSV 檔案將使用者匯入使用者集區時，如何檢查 CloudWatch 日誌是否有錯誤？

簡短描述

Amazon Cognito 可讓您從特殊格式的 CSV 檔案將使用者匯入 Amazon Cognito 使用者集區。此匯入程序會設定除密碼以外的所有使用者屬性的值。如需詳細資訊，請參閱從 CSV 檔案將使用者匯入使用者集區。

如需匯入程序期間常見錯誤的詳細資訊，請參閱如何針對 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 日誌串流中報告的錯誤會顯示 phone_number_verified 欄位的值未正確設定。

---

相關資訊

使用日誌群組和日誌串流