Statistiques du pool d'utilisateurs dans CloudWatch

Les groupes d'utilisateurs transmettent les statistiques d'activité des utilisateurs CloudWatch sous forme de mesures. À partir de là CloudWatch, vous pouvez analyser le volume d'activité d'authentification et l'utilisation des quotas dans vos groupes d'utilisateurs. Grâce aux informations contenues dans ces indicateurs, vous pouvez définir des alarmes pour des événements importants et ajuster la configuration de votre groupe d'utilisateurs selon vos besoins. Lorsque la journalisation de l'activité des utilisateurs contient des enregistrements détaillés de l'activité des utilisateurs dans vos groupes d'utilisateurs, CloudWatch les métriques contiennent des statistiques agrégées et des indicateurs de performance.

Le tableau suivant répertorie les métriques disponibles pour les groupes d’utilisateurs Amazon Cognito. L’espace de noms des métriques Amazon CloudWatch pour Amazon Cognito est AWS/Cognito. Pour plus d'informations, consultez Namespaces dans le guide de CloudWatch l'utilisateur Amazon.

Note

Les métriques qui n'ont pas eu de nouveaux points de données au cours des deux dernières semaines ne s'affichent pas dans la console. Elles ne s’affichent pas non plus lorsque vous saisissez leur nom de métrique ou de dimension dans la zone de recherche sous l’onglet Toutes les métriques dans la console. En outre, elles ne sont pas renvoyées dans les résultats d’une commande list-metrics. La meilleure façon de récupérer ces métriques est d'utiliser les get-metric-statistics commandes get-metric-data or du AWS CLI.

Métrique	Description
SignUpSuccesses	Indique le nombre total de demandes d’enregistrement utilisateur adressées au groupe d’utilisateurs Amazon Cognito qui ont abouti. Une demande d’enregistrement d’utilisateur réussie génère la valeur 1, tandis qu’une demande infructueuse indique la valeur 0. Une demande limitée étant également considérée comme inaboutie, elle produit le résultat 0. Pour obtenir le pourcentage de demandes d’enregistrement d’utilisateurs ayant abouti, utilisez la statistique Average pour cette métrique. Pour compter le nombre total de demandes d’enregistrement d’utilisateurs, utilisez la statistique Sample Count pour cette métrique. Pour compter le nombre total de demandes d’enregistrement d’utilisateurs ayant abouti, utilisez la statistique Sum pour cette métrique. Pour compter le nombre total de demandes d'enregistrement d'utilisateurs ayant échoué, utilisez l' CloudWatch Mathexpression et soustrayez la Sum statistique de la Sample Count statistique. Cette métrique est publiée pour chaque groupe d’utilisateurs pour chaque client de groupe d’utilisateurs. Si l’enregistrement utilisateur est effectué par un administrateur, la métrique est publiée avec le client de groupe d’utilisateurs en tant que Admin. Notez que cette métrique n’est pas émise pour les cas d’importation d’utilisateurs et de migration d’utilisateurs. Dimension de métrique : UserPool, UserPoolClient Unités : nombre
SignUpThrottles	Indique le nombre total de demandes d’enregistrement utilisateur envoyées au groupe d’utilisateurs Amazon Cognito qui ont été limitées. La valeur 1 est générée chaque fois qu’une demande d’enregistrement d’utilisateur est restreinte. Pour compter le nombre total de demandes d’enregistrement d’utilisateurs restreintes, utilisez la statistique Sum pour cette métrique. Cette métrique est publiée pour chaque groupe d’utilisateurs pour chaque client. Si la demande limitée a été effectuée par un administrateur, la métrique est publiée avec le client de groupe d’utilisateurs en tant que Admin. Dimension de métrique : UserPool, UserPoolClient Unités : nombre
SignInSuccesses	Indique le nombre total de demandes d’authentification d’utilisateur envoyées au groupe d’utilisateurs Amazon Cognito qui ont abouti. Une authentification utilisateur est considérée comme réussie lorsque le jeton d’authentification est transmis à l’utilisateur. Une authentification réussie génère la valeur 1, tandis qu’une demande infructueuse indique la valeur 0. Une demande limitée étant également considérée comme inaboutie, elle produit le résultat 0. Pour obtenir le pourcentage de demandes d’authentification ayant abouti, utilisez la statistique Average pour cette métrique. Pour compter le nombre total de demandes d’authentification d’utilisateurs, utilisez la statistique Sample Count pour cette métrique. Pour compter le nombre total de demandes d’authentification d’utilisateurs ayant abouti, utilisez la statistique Sum pour cette métrique. Pour compter le nombre total de demandes d'authentification utilisateur ayant échoué, utilisez l' CloudWatch Mathexpression et soustrayez la Sum statistique de la Sample Count statistique. Cette métrique est publiée pour chaque groupe d’utilisateurs pour chaque client. Si un client de groupe d’utilisateurs non valide est fourni avec une demande, la valeur du client de groupe d’utilisateurs correspondante dans la métrique contient la valeur fixe Invalid au lieu de la valeur non valide réelle envoyée dans cette demande. Notez que les demandes d’actualisation du jeton Amazon Cognito ne sont pas incluses dans cette métrique. Une métrique distincte permet de fournir les statistiques du jeton Refresh. Dimension de métrique : UserPool, UserPoolClient Unités : nombre
SignInThrottles	Indique le nombre total de demandes d’authentification d’utilisateurs envoyées au groupe d’utilisateurs Amazon Cognito qui ont été limitées. La valeur 1 est générée chaque fois qu’une demande d’authentification est restreinte. Pour compter le nombre total de demandes d’authentification d’utilisateurs restreintes, utilisez la statistique Sum pour cette métrique. Cette métrique est publiée pour chaque groupe d’utilisateurs pour chaque client. Si un client de groupe d’utilisateurs non valide est fourni avec une demande, la valeur du client de groupe d’utilisateurs correspondante dans la métrique contient la valeur fixe Invalid au lieu de la valeur non valide réelle envoyée dans cette demande. Les demandes d’actualisation de jeton Amazon Cognito ne sont pas incluses dans cette métrique. Une métrique distincte permet de fournir les statistiques du jeton Refresh. Dimension de métrique : UserPool, UserPoolClient Unités : nombre
TokenRefreshSuccesses	Indique le nombre total de demandes d’actualisation de jeton Amazon Cognito envoyées au groupe d’utilisateurs Amazon Cognito qui ont abouti. Une demande d’actualisation de jeton Amazon Cognito aboutie génère la valeur 1, tandis qu’une demande non aboutie génère la valeur 0. Une demande limitée étant également considérée comme inaboutie, elle produit le résultat 0. Pour obtenir le pourcentage de demandes d’actualisation de jeton Amazon Cognito ayant abouti, utilisez la statistique Average sur cette métrique. Pour compter le nombre total de demandes d’actualisation de jeton Amazon Cognito, utilisez la statistique Sample Count sur cette métrique. Pour compter le nombre total de demandes d’actualisation de jeton Amazon Cognito ayant abouti, utilisez la statistique Sum sur cette métrique. Pour compter le nombre total de demandes d'actualisation d'un jeton Amazon Cognito ayant échoué, utilisez l' CloudWatchMathexpression et soustrayez la Sum statistique de la statistique. Sample Count Cette métrique est publiée par client de groupe d’utilisateurs. Si un client de groupe d’utilisateurs non valide figure dans une demande, la valeur de ce client contient une valeur fixe Invalid. Dimension de métrique : UserPool, UserPoolClient Unités : nombre
TokenRefreshThrottles	Indique le nombre total de demandes d’actualisation de jeton Amazon Cognito envoyées au groupe d’utilisateurs Amazon Cognito qui ont échoué. La valeur 1 est publiée chaque fois qu’une demande d’actualisation de jeton Amazon Cognito est limitée. Pour compter le nombre total de demandes d’actualisation de jeton Amazon Cognito limitées, utilisez la statistique Sum pour cette métrique. Cette métrique est publiée pour chaque groupe d’utilisateurs pour chaque client. Si un client de groupe d’utilisateurs non valide est fourni avec une demande, la valeur du client de groupe d’utilisateurs correspondante dans la métrique contient la valeur fixe Invalid au lieu de la valeur non valide réelle envoyée dans cette demande. Dimension de métrique : UserPool, UserPoolClient Unités : nombre
FederationSuccesses	Indique le nombre total de demandes de fédération d’identité envoyées au groupe d’utilisateurs Amazon Cognito qui ont abouti. Une fédération d’identité est considérée comme réussie quand Amazon Cognito émet des jetons d’authentification pour l’utilisateur. Une demande de fédération d’identité réussie génère la valeur 1, tandis qu’une demande infructueuse indique la valeur 0. Les demandes limitées et les demandes qui génèrent un code d’autorisation mais aucun jeton produisent une valeur de 0. Pour obtenir le pourcentage de demandes de fédération d’identité ayant abouti, utilisez la statistique Average pour cette métrique. Pour compter le nombre total de demandes de fédération d’identité, utilisez la statistique Sample Count pour cette métrique. Pour compter le nombre total de demandes de fédération d’identité ayant abouti, utilisez la statistique Sum pour cette métrique. Pour compter le nombre total de demandes de fédération d'identité ayant échoué, utilisez l' CloudWatch Mathexpression et soustrayez la Sum statistique de la Sample Count statistique. Dimension de métrique : UserPool, UserPoolClient, IdentityProvider Unités : nombre
FederationThrottles	Indique le nombre total de demandes de fédération d’identité envoyées au groupe d’utilisateurs Amazon Cognito qui ont été limitées. La valeur 1 est publiée chaque fois qu’une demande de fédération d’identité est limitée. Pour compter le nombre total de demandes de fédération d’identité restreintes, utilisez la statistique Sum pour cette métrique. Dimension de métrique : UserPool, UserPoolClient, IdentityProvider Unités : nombre
CallCount	Indique le nombre total d’appels effectués par des clients en rapport avec une catégorie. Cette métrique inclut tous les appels, tels que les appels limités, les appels échoués et les appels réussis. Cette métrique est disponible dans le nameSpace Utilisation. Le quota de catégorie est appliqué pour chaque AWS compte dans tous les groupes d'utilisateurs d'un compte et d'une région. Vous pouvez compter le nombre total d’appels dans une catégorie à l’aide de la statistique Sum pour cette métrique. Dimension de métrique : Service, Type, Ressource, Classe Unités : nombre
ThrottleCount	Indique le nombre total d’appels limités en rapport avec une catégorie. Cette métrique est disponible dans le nameSpace Utilisation. Cette métrique est publiée au niveau du compte. Vous pouvez compter le nombre total d’appels dans une catégorie à l’aide de la statistique Sum pour cette métrique. Dimension de métrique : Service, Type, Ressource, Classe Unités : nombre

Dimensions pour les groupes d’utilisateurs Amazon Cognito

Les dimensions suivantes permettent d’affiner les métriques d’utilisation publiées par Amazon Cognito. Les dimensions s’appliquent uniquement aux métriques CallCount et ThrottleCount .

Dimension	Description
Service	Nom du AWS service contenant la ressource. Pour les métriques d’utilisation d’Amazon Cognito, la valeur de cette dimension est Cognito user pool.
Type	Type d’entité faisant l’objet d’un rapport. La seule valeur valide pour les statistiques d'utilisation d'Amazon Cognito est. API
Ressource	Type de ressource en cours d’exécution. La seule valeur valide est un nom de catégorie.
Classe	Classe de ressource suivie. Amazon Cognito n’utilise pas la dimension Classe.

Utiliser la CloudWatch console pour suivre les métriques

Vous pouvez suivre et collecter les statistiques des groupes d'utilisateurs Amazon Cognito à l'aide de. CloudWatch Le CloudWatch tableau de bord affichera des statistiques sur chaque AWS service que vous utilisez. Vous pouvez l'utiliser CloudWatch pour créer des alarmes métriques. Vous pouvez configurer les alarmes pour vous envoyer des notifications ou apporter une modification à une ressource spécifique que vous surveillez. Pour consulter les métriques de quota de service dans CloudWatch, procédez comme suit.

1. Ouvrez la CloudWatchconsole.

2. Dans le panneau de navigation, sélectionnez ‎Métriques.

3. Dans Toutes les métriques, sélectionnez une métrique et une dimension.

4. Sélectionnez la case à cocher en regard d’une métrique. Les métriques apparaissent dans le graphique.

Note

Les métriques qui n’ont pas eu de nouveaux points de données au cours des deux dernières semaines ne s’affichent pas dans la console. Elles ne s’affichent pas non plus lorsque vous saisissez leur nom de métrique ou de dimension dans la zone de recherche sous l’onglet Toutes les métriques dans la console, et ne sont pas renvoyées dans les résultats d’une commande list-metrics . La meilleure façon de récupérer ces métriques est d'utiliser les get-metric-statistics commandes get-metric-data or du AWS CLI.

Création d'une CloudWatch alarme pour un quota

Amazon Cognito fournit des statistiques CloudWatch d'utilisation qui correspondent aux quotas de AWS service pour CallCount et. ThrottleCount APIs Pour plus d'informations sur le suivi de l'utilisation dans CloudWatch, consultezSuivre l’usage des quotas.

Dans la console Service Quotas, vous pouvez créer des alarmes qui vous alertent quand votre utilisation d’un service approche du quota défini pour celui-ci. Pour savoir comment configurer une CloudWatch alarme à l'aide de la console Service Quotas, voir Quotas de service et CloudWatch alarmes.