中的用户池指标 CloudWatch - Amazon Cognito
Amazon Cognito 用户池的维度使用 CloudWatch 控制台跟踪指标为配额创建 CloudWatch 警报

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

中的用户池指标 CloudWatch

用户池将用户活动统计数据报告 CloudWatch 为指标。您可以从中 CloudWatch分析用户池中的身份验证活动量和配额使用情况。利用这些指标中的信息，您可以为值得注意的事件设置警报，并根据需要调整用户池配置。用户活动日志记录包含用户池中用户活动的详细记录，而 CloudWatch 指标则包含汇总的统计数据和绩效指标。

下表列出了对 Amazon Cognito 用户池可用的指标。Amazon Cognito 的 Amazon CloudWatch 指标命名空间是 AWS/Cognito。有关更多信息，请参阅 A mazon CloudWatch 用户指南中的命名空间。

注意

控制台中不会显示在过去两周内没有任何新数据点的指标。当您在控制台中所有指标选项卡的搜索框中输入其指标名称或维度名称时，它们也不会显示。此外，它们不会在 list-metrics 命令的结果中返回。检索这些指标的最佳方法是使用中的get-metric-data或get-metric-statistics命令 AWS CLI。

指标 描述
SignUpSuccesses

提供向 Amazon Cognito 用户池发出的成功用户注册请求的总数。一个成功的用户注册请求会产生值 1，而一个不成功的请求会产生值 0。受限制的请求也会被视为不成功的请求，因此，一个受限制的请求也将产生计数 0。

要查找成功的用户注册请求的百分比，请对此指标使用 Average 统计数据。要计算用户注册请求的总数，请对此指标使用 Sample Count 统计数据。要计算成功的用户注册请求的总数，请对此指标使用 Sum 统计数据。要计算失败的用户注册请求总数，请使用 CloudWatch Math表达式并从Sum统计数据中减去统计Sample Count数据。

为每个用户池客户端的用户池发布此指标。如果用户注册由管理员执行，则以 Admin 身份将指标与用户池客户端一起发布。

请注意，不会针对用户导入和用户迁移案例发出此指标。

指标维度：UserPool、UserPoolClient

单位：计数
SignUpThrottles

提供向 Amazon Cognito 用户池发出的受限的用户注册请求的总数。当用户注册请求受到限制时，将发布计数 1。

要计算受限制的用户注册请求的总数，请对此指标使用 Sum 统计数据。

为每个客户端的每个用户池发布此指标。如果受限制的请求由管理员发出，则以 Admin 身份将指标与用户池客户端一起发布。

指标维度：UserPool、UserPoolClient

单位：计数
SignInSuccesses

提供向 Amazon Cognito 用户池发出的成功的用户身份验证请求的总数。在向用户颁发身份验证令牌时，用户身份验证将被视为成功。一个成功的身份验证会产生值 1，而一个不成功的请求会产生值 0。受限制的请求也会被视为不成功的请求，因此，一个受限制的请求也将产生计数 0。

要查找成功的用户身份验证请求的百分比，请对此指标使用 Average 统计数据。要计算用户身份验证请求的总数，请对此指标使用 Sample Count 统计数据。要计算成功的用户身份验证请求的总数，请对此指标使用 Sum 统计数据。要计算失败的用户身份验证请求总数，请使用 CloudWatch Math表达式并从Sum统计数据中减去统计Sample Count数据。

为每个客户端的每个用户池发布此指标。如果请求中提供了无效的用户池客户端，则指标中的相应用户池客户端值将包含固定值 Invalid，而不是请求中发送的实际无效值。

请注意，Amazon Cognito 令牌刷新请求并未包含在此指标中。有一个用于提供 Refresh 令牌统计数据的单独指标。

指标维度：UserPool、UserPoolClient

单位：计数
SignInThrottles

提供向 Amazon Cognito 用户池发出的受限制的用户身份验证请求的总数。当身份验证请求受到限制时，将发布计数 1。

要计算受限制的用户身份验证请求的总数，请对此指标使用 Sum 统计数据。

为每个客户端的每个用户池发布此指标。如果请求中提供了无效的用户池客户端，则指标中的相应用户池客户端值将包含固定值 Invalid，而不是请求中发送的实际无效值。

Amazon Cognito 令牌刷新请求并未包含在此指标中。有一个用于提供 Refresh 令牌统计数据的单独指标。

指标维度：UserPool、UserPoolClient

单位：计数
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。

指标维度：UserPool、UserPoolClient

单位：计数
TokenRefreshThrottles

提供向 Amazon Cognito 用户池发出的受限制 Amazon Cognito 令牌刷新请求的总数。当 Amazon Cognito 令牌刷新请求受到限制时，将发布计数 1。

要计算受限制的 Amazon Cognito 令牌刷新请求的总数，请对此指标使用 Sum 统计数据。

为每个客户端的每个用户池发布此指标。如果请求中提供了无效的用户池客户端，则指标中的相应用户池客户端值将包含固定值 Invalid，而不是请求中发送的实际无效值。

指标维度：UserPool、UserPoolClient

单位：计数
FederationSuccesses

提供向 Amazon Cognito 用户池发出的成功的联合身份验证请求的总数。当 Amazon Cognito 向用户颁发身份验证令牌时，身份联合验证被视为成功。一个成功的联合身份验证请求会产生值 1，而一个不成功的请求会产生值 0。节流的请求以及生成授权码但没有令牌的请求所生成的值为 0。

要查找成功的联合身份验证请求的百分比，请对此指标使用 Average 统计数据。要计算联合身份验证请求的总数，请对此指标使用 Sample Count 统计数据。要计算成功的联合身份验证请求的总数，请对此指标使用 Sum 统计数据。要计算失败的身份联合请求总数，请使用 CloudWatch Math表达式并从Sum统计数据中减去统计Sample Count数据。

指标维度：UserPool、UserPoolClient、IdentityProvider

单位：计数
FederationThrottles

提供向 Amazon Cognito 用户池发出的受限制的联合身份验证请求的总数。当联合身份验证请求受到限制时，将发布计数 1。

要计算受限制的联合身份验证请求的总数，请对此指标使用 Sum 统计数据。

指标维度：UserPool、UserPoolClient、IdentityProvider

单位：计数
CallCount

提供客户发出的与类别相关的调用总数。此指标包括所有调用，如受限制的调用、失败的调用和成功的调用。

此指标在用量 nameSpace 中提供。

在账户和地区的所有用户池中，每个 AWS 账户都必须使用类别配额。

您可以使用此指标的 Sum 统计数据计算调用总数。

指标维度：服务、类型、资源、类

单位：计数
ThrottleCount

提供与类别相关的受限调用总数。

此指标在用量 nameSpace 中提供。

此指标已在账户级别发布。

您可以使用此指标的 Sum 统计数据计算某个类别中的调用总数。

指标维度：服务、类型、资源、类

单位：计数

Amazon Cognito 用户池的维度

以下维度用于优化由 Amazon Cognito 发布的用量指标。维度仅适用于 CallCount 和 ThrottleCount 指标。

维度 描述

服务

包含资源的 AWS 服务的名称。对于 Amazon Cognito 用量指标，此维度的值为 Cognito user pool。

类型

正在报告的实体的类型。Amazon Cognito 使用量指标的唯一有效值是。API

资源

正在运行的资源的类型。唯一的有效值是类别名。

类

所跟踪的资源的类。Amazon Cognito 不使用类维度。

使用 CloudWatch 控制台跟踪指标

您可以使用跟踪和收集 Amazon Cognito 用户池指标。 CloudWatch CloudWatch 控制面板将显示有关您使用的每项 AWS 服务的指标。您可以使用 CloudWatch 创建指标警报。可以将警报设置为向您发送通知或更改您正在监控的特定资源。要在中查看服务配额指标 CloudWatch，请完成以下步骤。

  1. 打开控制CloudWatch台。

  2. 在导航窗格中，选择指标。

  3. 在所有指标中，选择一个指标和维度。

  4. 选中指标旁边的复选框。指标将出现在图表中。

注意

控制台中不会显示在过去两周内没有任何新数据点的指标。当您在控制台的“全部指标”选项卡的搜索框中输入指标名称或维度名称时，它们也不会显示，并且 list-metrics 命令的结果中不会返回它们。检索这些指标的最佳方法是使用中的get-metric-data或get-metric-statistics命令 AWS CLI。

为配额创建 CloudWatch 警报

Amazon Cognito 提供的 CloudWatch 使用量指标与和的 AWS 服务配额CallCount相对应。ThrottleCount APIs有关在中跟踪使用情况的更多信息 CloudWatch，请参阅跟踪配额使用量。

在 Service Quotas 控制台中，您可以创建告警，以便在您的使用量接近服务配额时提示您。要了解如何使用 Service Quotas 控制台设置 CloudWatch 警报，请参阅服务配额和 CloudWatch 警报。