中的使用者集區指標 CloudWatch - Amazon Cognito

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

中的使用者集區指標 CloudWatch

使用者集區會將使用者活動統計資料報告為 CloudWatch 作為指標。從 CloudWatch,您可以分析使用者集區中的身分驗證活動和配額用量。透過這些指標中的資訊,您可以為值得注意的事件設定警示,並視需要調整使用者集區組態。如果使用者活動記錄具有使用者集區中使用者活動的詳細記錄,則 CloudWatch 指標具有彙總統計資料和效能指標。

下表列出 Amazon Cognito 使用者集區可用的指標。Amazon Cognito 的 Amazon CloudWatch 指標命名空間是 AWS/Cognito。如需詳細資訊,請參閱 Amazon CloudWatch 使用者指南 中的命名空間

注意

過去兩週內沒有任何新資料點的指標不會顯示在主控台中。也不會在您於主控台 All metrics (所有指標) 標籤的搜尋方塊中輸入指標名稱或維度名稱時顯示。此外,它們不會在 list-metrics 命令的結果中傳回。擷取這些指標的最佳方法是使用 中的 get-metric-dataget-metric-statistics命令 AWS CLI。

指標 描述
SignUpSuccesses

提供對 Amazon Cognito 使用者集區提出的成功使用者註冊請求總數。成功的使用者註冊請求會產生值 1,而不成功的請求會產生值 0。調節的請求也遭認為是不成功的請求,因此調節的請求也將產生計數 0。

若要尋找成功的使用者註冊請求百分比,請使用此指標的 Average 統計數字。若要計算使用者註冊請求的總數,請使用此指標的 Sample Count 統計數字。若要計算成功的使用者註冊請求總數,請使用此指標的 Sum 統計數字。若要計算失敗的使用者註冊請求總數,請使用 CloudWatch Math運算式,然後從Sum統計數字中減去Sample Count統計數字。

此指標會針對每個使用者集區用戶端的每個使用者集區發佈。如果是由管理員執行使用者註冊,則指標會與使用者集區用戶端一起發佈為 Admin

請注意,不會針對使用者匯入使用者遷移案例發出此指標。

指標維度:UserPoolUserPoolClient

單位:計數

SignUpThrottles

提供對 Amazon Cognito 使用者集區提出的調節使用者註冊請求總數。每當調節使用者註冊請求時,就會發佈計數 1。

若要計算調節的使用者註冊請求總數,請使用此指標的 Sum 統計數字。

此指標針對每個用戶端的每個使用者集區發佈。如果是由管理員調節請求,則指標會與使用者集區用戶端一起發佈為 Admin

指標維度:UserPoolUserPoolClient

單位:計數

SignInSuccesses

提供對 Amazon Cognito 使用者集區提出的成功使用者身分驗證請求總數。當身分驗證權杖發行給使用者時,使用者身分驗證會視為成功。成功的身分驗證請求會產生值 1,而不成功的請求會產生值 0。調節的請求也遭認為是不成功的請求,因此調節的請求也將產生計數 0。

若要尋找成功的使用者身分驗證請求百分比,請使用此指標的 Average 統計數字。若要計算使用者身分驗證請求的總數,請使用此指標的 Sample Count 統計數字。若要計算成功的使用者身分驗證請求總數,請使用此指標的 Sum 統計數字。若要計算失敗的使用者身分驗證請求總數,請使用 CloudWatch Math Sum 運算式,並從統計資料中減去 Sample Count統計資料。

此指標針對每個用戶端的每個使用者集區發佈。如果請求中提供了無效的使用者集區用戶端,則指標中對應的使用者集區用戶端值會包含固定值 Invalid,而非請求中傳送的實際無效值。

請注意,此指標中不包含重新整理 Amazon Cognito 權杖的請求。有個別指標可以提供 Refresh 權杖統計資料。

指標維度:UserPoolUserPoolClient

單位:計數

SignInThrottles

提供對 Amazon Cognito 使用者集區提出的調節使用者身分驗證請求總數。每當調節使用者身分驗證請求時,就會發佈計數 1。

若要計算調節的使用者身分驗證請求總數,請使用此指標的 Sum 統計數字。

此指標針對每個用戶端的每個使用者集區發佈。如果請求中提供了無效的使用者集區用戶端,則指標中對應的使用者集區用戶端值會包含固定值 Invalid,而非請求中傳送的實際無效值。

此指標中不包含重新整理 Amazon Cognito 權杖的請求。有個別指標可以提供 Refresh 權杖統計資料。

指標維度:UserPoolUserPoolClient

單位:計數

TokenRefreshSuccesses

提供對 Amazon Cognito 使用者集區提出重新整理 Amazon Cognito 權杖的成功請求總數。成功的重新整理 Amazon Cognito 權杖請求會產生值 1,而不成功的請求會產生值 0。調節的請求也遭認為是不成功的請求,因此調節的請求也將產生計數 0。

若要尋找成功的重新整理 Amazon Cognito 權杖請求百分比,請使用此指標的 Average 統計數字。若要計算重新整理 Amazon Cognito 權杖請求的總數,請使用此指標的 Sample Count 統計數字。若要計算成功的重新整理 Amazon Cognito 權杖請求總數,請使用此指標的 Sum 統計數字。若要計算重新整理 Amazon Cognito 權杖的失敗請求總數,請使用 CloudWatchMath運算式並從Sum統計資料中減去 Sample Count統計資料。

此指標會根據每個使用者集區用戶端發佈。如果請求中有無效的使用者集區用戶端,使用者集區用戶端值會包含固定值 Invalid

指標維度:UserPoolUserPoolClient

單位:計數

TokenRefreshThrottles

提供對 Amazon Cognito 使用者集區提出重新整理 Amazon Cognito 權杖的調節請求總數。每當調節重新整理 Amazon Cognito 權杖請求時,就會發佈計數 1。

若要計算調節的重新整理 Amazon Cognito 權杖請求總數,請使用此指標的 Sum 統計數字。

此指標針對每個用戶端的每個使用者集區發佈。如果請求中提供了無效的使用者集區用戶端,則指標中對應的使用者集區用戶端值會包含固定值 Invalid,而非請求中傳送的實際無效值。

指標維度:UserPoolUserPoolClient

單位:計數

FederationSuccesses

提供對 Amazon Cognito 使用者集區提出的成功聯合身分請求總數。Amazon Cognito 向使用者發出身分驗證權杖時,則聯合身分視為成功。成功的聯合身分請求會產生值 1,而不成功的請求會產生值 0。限流請求和產生身分代碼但是沒有產生權杖的請求會產生值 0。

若要尋找成功的聯合身分請求百分比,請使用此指標的 Average 統計數字。若要計算聯合身分請求的總數,請使用此指標的 Sample Count 統計數字。若要計算成功的聯合身分請求總數,請使用此指標的 Sum 統計數字。若要計算失敗的身分聯合請求總數,請使用 Sum 表達式 CloudWatch Math,並從統計數字中減去Sample Count統計數字。

指標維度:UserPoolUserPoolClientIdentityProvider

單位:計數

FederationThrottles

提供對 Amazon Cognito 使用者集區提出的調節聯合身分請求總數。每當調節聯合身分請求時,就會發佈計數 1。

若要計算調節的聯合身分請求總數,請使用此指標的 Sum 統計數字。

指標維度:UserPoolUserPoolClientIdentityProvider

單位:計數

CallCount

提供與類別相關的客戶呼叫總數。此指標包含所有呼叫,例如調節呼叫、失敗呼叫和成功呼叫。

此指標可在 Usage (用量) nameSpace 取得。

帳戶和區域中 AWS 所有使用者集區的每個帳戶都會強制執行類別配額。

您可以使用此指標的 Sum 統計數字,計算類別中的呼叫總數。

指標維度:Service、Type、Resource、Class

單位:計數

ThrottleCount

提供與類別相關的調節呼叫總數。

此指標可在 Usage (用量) nameSpace 取得。

此指標在帳戶層級發佈。

您可以使用此指標的 Sum 統計數字,計算類別中的呼叫總數。

指標維度:Service、Type、Resource、Class

單位:計數

Amazon Cognito 使用者集區的維度

以下維度用於調整 Amazon Cognito 發佈的用量指標。維度僅適用於 CallCountThrottleCount 指標。

維度 描述

Service (服務)

包含 資源 AWS 的服務名稱。對於 Amazon Cognito 用量指標,此維度的值為 Cognito user pool

Type

正在報告的實體類型。Amazon Cognito 用量指標的唯一有效值為 API。

資源

正在執行的資源類型。唯一有效的值為類別名稱。

類別

正在追蹤的資源類別。Amazon Cognito 不會使用類別維度。

使用 CloudWatch 主控台追蹤指標

您可以使用 追蹤和收集 Amazon Cognito 使用者集區指標 CloudWatch。 CloudWatch 儀表板會顯示您使用的每個 AWS 服務的指標。您可以使用 CloudWatch 建立指標警示。警示可設為傳送通知或變更您正在監控的特定資源。若要在 中檢視服務配額指標 CloudWatch,請完成下列步驟。

  1. 開啟CloudWatch主控台

  2. 在導覽窗格中,選擇 Metrics (指標)

  3. All metrics (所有指標) 中,選取指標和維度。

  4. 選取指標旁的核取方塊。指標會顯示在圖表中。

注意

過去兩週內沒有任何新資料點的指標不會顯示在主控台中。當您在主控台的 All metrics (所有指標) 索引標籤的搜尋方塊中輸入指標名稱或維度名稱時,它們也不會顯示,而且在 list-metrics 命令的結果中不會傳回這些名稱。擷取這些指標的最佳方法是使用 AWS 中的 get-metric-dataget-metric-statistics命令CLI。

為配額建立 CloudWatch 警示

Amazon Cognito 提供與 CallCountThrottleCount AWS 的服務配額對應的 CloudWatch 用量指標APIs。如需在 中追蹤用量的詳細資訊 CloudWatch,請參閱 追蹤配額使用量

在 Service Quotas 主控台中,您可以建立警示,在您的用量接近服務配額時提醒您。若要了解如何使用 Service Quotas 主控台設定 CloudWatch 警示,請參閱 Service Quotas 和 CloudWatch 警示