本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
中的用户池指标 CloudWatch
用户池将用户活动统计数据报告 CloudWatch 为指标。您可以从中 CloudWatch分析用户池中的身份验证活动量和配额使用情况。利用这些指标中的信息，您可为值得注意的事件设置警报，并根据需要调整用户池配置。用户活动日志记录包含用户池中用户活动的详细记录，而 CloudWatch 指标则包含汇总的统计数据和绩效指标。
下表列出了对 Amazon Cognito 用户池可用的指标。Amazon Cognito 将指标发布到命名空间 AWS/Cognito 和 AWS/Usage。有关更多信息，请参阅 A mazon CloudWatch 用户指南中的命名空间。
有关跟踪配额和使用情况的更多信息，请参阅跟踪配额使用量和跟踪每月活跃用户（MAU）。
注意
控制台中不会显示在过去两周内没有任何新数据点的指标。当您在控制台中所有指标选项卡的搜索框中输入其指标名称或维度名称时，它们也不会显示。此外，它们不会在 list-metrics 命令的结果中返回。检索这些指标的最佳方法是在 Amazon CLI 中使用get-metric-data或get-metric-statistics命令。
| 指标 | 说明 | 命名空间 |
|---|---|---|
SignUpSuccesses |
提供向 Amazon Cognito 用户池发出的成功用户注册请求的总数。一个成功的用户注册请求会产生值 1，而一个不成功的请求会产生值 0。受限制的请求也被视为失败的请求，因此受限制的请求也会生成 0 的计数。 要查找成功的用户注册请求的百分比，请对此指标使用 为每个用户池客户端的用户池发布此指标。如果用户注册由管理员执行，则以 指标维度： 单位：计数 |
AWS/Cognito |
SignUpThrottles |
提供向 Amazon Cognito 用户池发出的受限的用户注册请求的总数。当用户注册请求受到限制时，将发布计数 1。 要计算受限制的用户注册请求的总数，请对此指标使用 为每个客户端的每个用户池发布此指标。如果受限制的请求由管理员发出，则以 指标维度： 单位：计数 |
AWS/Cognito |
SignInSuccesses |
提供向 Amazon Cognito 用户池发出的成功的用户身份验证请求的总数。在向用户颁发身份验证令牌时，用户身份验证将被视为成功。一个成功的身份验证会产生值 1，而一个不成功的请求会产生值 0。受限制的请求也被视为失败的请求，因此受限制的请求也会生成 0 的计数。 要查找成功的用户身份验证请求的百分比，请对此指标使用 为每个客户端的每个用户池发布此指标。如果请求中提供了无效的用户池客户端，则指标中的相应用户池客户端值将包含固定值 请注意，Amazon Cognito 令牌刷新请求并未包含在此指标中。有一个用于提供 指标维度： 单位：计数 |
AWS/Cognito |
SignInThrottles |
提供向 Amazon Cognito 用户池发出的受限制的用户身份验证请求的总数。当身份验证请求受到限制时，将发布计数 1。 要计算受限制的用户身份验证请求的总数，请对此指标使用 为每个客户端的每个用户池发布此指标。如果请求中提供了无效的用户池客户端，则指标中的相应用户池客户端值将包含固定值 Amazon Cognito 令牌刷新请求并未包含在此指标中。有一个用于提供 指标维度： 单位：计数 |
AWS/Cognito |
TokenRefreshSuccesses |
提供向 Amazon Cognito 用户池发出的成功的 Amazon Cognito 令牌刷新请求的总数。一个成功的 Amazon Cognito 令牌刷新请求会产生值 1，而一个不成功的请求会产生值 0。受限制的请求也被视为失败的请求，因此受限制的请求也会生成 0 的计数。 要查找成功的 Amazon Cognito令牌刷新请求的百分比，请对此指标使用 按每个用户池客户端发布此指标。如果请求中有无效的用户池客户端，则用户池客户端值包含固定值 指标维度： 单位：计数 |
AWS/Cognito |
TokenRefreshThrottles |
提供向 Amazon Cognito 用户池发出的受限制 Amazon Cognito 令牌刷新请求的总数。当 Amazon Cognito 令牌刷新请求受到限制时，将发布计数 1。 要计算受限制的 Amazon Cognito 令牌刷新请求的总数，请对此指标使用 为每个客户端的每个用户池发布此指标。如果请求中提供了无效的用户池客户端，则指标中的相应用户池客户端值将包含固定值 指标维度： 单位：计数 |
AWS/Cognito |
FederationSuccesses |
提供向 Amazon Cognito 用户池发出的成功的联合身份验证请求的总数。当 Amazon Cognito 向用户颁发身份验证令牌时，身份联合验证被视为成功。一个成功的联合身份验证请求会产生值 1，而一个不成功的请求会产生值 0。节流的请求以及生成授权码但没有令牌的请求所生成的值为 0。 要查找成功的联合身份验证请求的百分比，请对此指标使用 指标维度： 单位：计数 |
AWS/Cognito |
FederationThrottles |
提供向 Amazon Cognito 用户池发出的受限制的联合身份验证请求的总数。当联合身份验证请求受到限制时，将发布计数 1。 要计算受限制的联合身份验证请求的总数，请对此指标使用 指标维度： 单位：计数 |
AWS/Cognito |
CallCount |
提供客户发出的与类别相关的调用总数。此指标包括所有调用，如受限制的调用、失败的调用和成功的调用。 在账户和地区的所有用户池中，每个 Amazon 账户都必须使用类别配额。 您可以使用此指标的 指标维度：服务、类型、资源、类 单位：计数 |
AWS/Usage |
ThrottleCount |
提供与类别相关的受限调用总数。 此指标已在账户级别发布。 您可以使用此指标的 指标维度：服务、类型、资源、类 单位：计数 |
AWS/Usage |
查看威胁防护指标
您的用户池发布的指标包含有关以下方面的统计信息：您的威胁防护设置对用户身份验证活动的影响。您可能想知道有多少用户尝试使用已泄露的凭证登录。您还可以了解有多少百分比的登录活动被评估为存在一定风险。Amazon Cognito 将威胁防护功能的指标发布到您在亚马逊上的账户。 CloudWatchAmazon Cognito 同时按风险级别和请求级别对威胁防护指标进行分组。
要为风险分析添加背景信息，您可以在用户池或导出的数据来源中查看有关单个用户登录尝试的信息。
在 CloudWatch 控制台中查看指标
-
打开 CloudWatch 控制台，网址为https://console.aws.amazon.com/cloudwatch/
。 -
在导航窗格中，选择指标。
-
选择 Amazon Cognito。
-
选择一组聚合指标，如按风险分类。
-
所有指标选项卡显示该选择的所有指标。您可执行以下操作：
-
要对表进行排序，请使用列标题。
-
要为指标绘制图表，请选中该指标旁边的复选框。要选择所有指标，请选中表格标题行中的复选框。
-
要按资源进行筛选，请选择资源 ID，然后选择添加到搜索。
-
要按指标进行筛选，请选择指标名称，然后选择添加到搜索。
-
|
指标 |
说明 |
指标维度 |
命名空间 |
|---|---|---|---|
|
CompromisedCredentialRisk |
Amazon Cognito 在其中检测到泄露凭证的请求。 |
Operation：操作类型。仅有的维度是 UserPoolId：用户池的标识符。 RiskLevel：高（默认）、中或低。 |
AWS/Cognito |
|
AccountTakeoverRisk |
Amazon Cognito 在其中检测到账户接管风险的请求。 |
Operation：操作类型。仅有的维度是 UserPoolId：用户池的标识符。 RiskLevel: 高、中或低。 |
AWS/Cognito |
|
OverrideBlock |
因开发人员提供的配置而被 Amazon Cognito 阻止的请求。 |
Operation：操作类型。仅有的维度是 UserPoolId：用户池的标识符。 RiskLevel: 高、中或低。 |
AWS/Cognito |
|
Risk |
Amazon Cognito 标记为有风险的请求。 |
Operation：操作类型，例如 UserPoolId：用户池的标识符。 |
AWS/Cognito |
|
NoRisk |
Amazon Cognito 在其中没有识别出任何风险的请求。 |
Operation：操作类型，例如 UserPoolId：用户池的标识符。 |
AWS/Cognito |
Amazon Cognito 为您提供了两组预定义的指标，供您随时进行分析。 CloudWatch按风险分类标识 Amazon Cognito 认定为有风险的请求的风险级别。按请求分类体现了按请求级别聚合的指标。
|
汇总指标组 |
说明 |
|---|---|
|
按风险分类 |
被 Amazon Cognito 标识为有风险的请求。 |
|
按请求分类 |
按请求汇总的指标。 |
Amazon Cognito 用户池的维度
以下维度用于优化由 Amazon Cognito 发布的用量指标。维度仅适用于 CallCount 和 ThrottleCount 指标。
| 维度 | 描述 |
|---|---|
|
服务 |
包含资源的 Amazon 服务的名称。对于 Amazon Cognito 用量指标，此维度的值为 |
|
类型 |
正在报告的实体的类型。Amazon Cognito 用量指标的唯一有效值为 API。 |
|
资源 |
正在运行的资源的类型。唯一的有效值是类别名。 |
|
类 |
所跟踪的资源的类。Amazon Cognito 不使用类维度。 |
使用 CloudWatch 控制台跟踪指标
您可以使用跟踪和收集 Amazon Cognito 用户池指标。 CloudWatch CloudWatch 控制面板显示有关您使用的每项 Amazon 服务的指标。您可以使用 CloudWatch 创建指标警报。可以将警报设置为向您发送通知或更改您正在监控的特定资源。要在中查看服务配额指标 CloudWatch，请完成以下步骤。
-
打开 CloudWatch 控制台
。 -
在导航窗格中，选择指标。
-
在所有指标中，选择一个指标和维度。
-
选中指标旁边的复选框。指标显示在图表中。
注意
控制台中不会显示在过去两周内没有任何新数据点的指标。当您在控制台的“全部指标”选项卡的搜索框中输入指标名称或维度名称时，它们也不会显示，并且 list-metrics 命令的结果中不会返回它们。检索这些指标的最佳方法是在 Amazon
CLI 中使用 get-metric-data 或者 get-metric-statistics 命令。
为配额创建 CloudWatch 警报
Amazon Cognito 提供的 CloudWatch 使用量指标与CallCount和 ThrottleCount API 的 Amazon 服务配额相对应。有关在中跟踪使用情况的更多信息 CloudWatch，请参阅跟踪配额使用量。
在 Service Quotas 控制台中，您可以创建告警，以便在您的使用量接近服务配额时提示您。要了解如何使用服务配额控制台设置 CloudWatch 警报，请参阅服务配额和 CloudWatch 警报。