Benutzerpool-Metriken in CloudWatch

Benutzerpools melden Statistiken zur Benutzeraktivität CloudWatch als Metriken. Von CloudWatch dort aus können Sie das Volumen der Authentifizierungsaktivitäten und die Kontingentnutzung in Ihren Benutzerpools analysieren. Anhand der Informationen in diesen Kennzahlen können Sie Alarme für wichtige Ereignisse einrichten und die Konfiguration Ihres Benutzerpools nach Bedarf anpassen. Während die Protokollierung der Benutzeraktivitäten detaillierte Aufzeichnungen der Benutzeraktivitäten in Ihren Benutzerpools enthält, enthalten CloudWatch Metriken aggregierte Statistiken und Leistungsindikatoren.

In der folgenden Tabelle sind die Metriken aufgeführt, die für Amazon-Cognito-Benutzerpools verfügbar sind. Der Amazon CloudWatch -Metrik-Namespace für Amazon Cognito lautet AWS/Cognito. Weitere Informationen finden Sie unter Namespaces im CloudWatch Amazon-Benutzerhandbuch.

Anmerkung

Metriken, für die in den letzten zwei Wochen keine neuen Datenpunkte vorlagen, werden nicht in der Konsole angezeigt. Sie werden auch nicht angezeigt, wenn Sie den Metriknamen oder die Dimensionsnamen in der Konsole in das Suchfeld auf der Registerkarte Alle Metriken eingeben. Darüber hinaus werden sie nicht in den Ergebnissen eines Listenmetriks-Befehls zurückgegeben. Diese Metriken lassen sich am besten mit den get-metric-statistics Befehlen get-metric-data oder im abrufen. AWS CLI

Metrik	Beschreibung
SignUpSuccesses	Gibt die Gesamtzahl der an den Amazon-Cognito-Benutzerpool gerichteten erfolgreichen Benutzerregistrierungsanforderungen an. Eine erfolgreiche Benutzerregistrierungsanforderung liefert den Wert 1, eine fehlgeschlagene Anforderung den Wert 0. Eine gedrosselte Anforderung wird als fehlgeschlagene Anforderung gezählt, liefert also auch den Wert 0. Verwenden Sie den statistischen Wert Average für diese Metrik, um den Prozentsatz erfolgreicher Benutzerregistrierungsanforderungen zu ermitteln. Verwenden Sie den statistischen Wert Sample Count für diese Metrik, um die Gesamtzahl der Benutzerregistrierungsanforderungen zu ermitteln. Verwenden Sie den statistischen Wert Sum für diese Metrik, um die Gesamtzahl erfolgreicher Benutzerregistrierungsanforderungen zu ermitteln. Um die Gesamtzahl der fehlgeschlagenen Benutzerregistrierungsanfragen zu zählen, verwenden Sie den CloudWatch Math Ausdruck und subtrahieren Sie die Sum Statistik von der Sample Count Statistik. Diese Metrik wird pro Benutzerpool pro Benutzerpool-Client veröffentlicht. Wenn die Benutzerregistrierung durch einen Administrator erfolgt, wird die Metrik mit dem Benutzerpool-Client als veröffentlicht Admin. Beachten Sie, dass diese Metrik für die Anwendungsfälle User import (Benutzerimport) und User migration (Benutzermigration) nicht ausgegeben wird. Metrikdimension: UserPool, UserPoolClient Einheiten: Anzahl
SignUpThrottles	Gibt die Gesamtzahl der an den Amazon-Cognito-Benutzerpool gerichteten gedrosselten Benutzerregistrierungsanforderungen an. Sobald eine Benutzerregistrierungsanforderung gedrosselt wird, wird der Wert 1 veröffentlicht. Verwenden Sie den statistischen Wert Sum für diese Metrik, um die Gesamtzahl der gedrosselten Benutzerregistrierungsanforderungen zu ermitteln. Diese Metrik wird für jeden Benutzerpool für jeden Client veröffentlicht. Falls die Anforderung, die gedrosselt wurde, von einem Administrator stammt, wird die Metrik mit dem Benutzerpool-Client als veröffentlicht Admin. Metrikdimension: UserPool, UserPoolClient Einheiten: Anzahl
SignInSuccesses	Gibt die Gesamtzahl der an den Amazon-Cognito-Benutzerpool gerichteten erfolgreichen Benutzerauthentifizierungsanforderungen an. Eine Benutzerauthentifizierung gilt als erfolgreich, wenn ein Authentifizierungs-Token an den Benutzer ausgegeben wird. Eine erfolgreiche Authentifizierung liefert den Wert 1, eine fehlgeschlagene Anforderung den Wert 0. Eine gedrosselte Anforderung wird als fehlgeschlagene Anforderung gezählt, liefert also auch den Wert 0. Verwenden Sie den statistischen Wert Average für diese Metrik, um den Prozentsatz erfolgreicher Benutzerauthentifizierungsanforderungen zu ermitteln. Verwenden Sie den statistischen Wert Sample Count für diese Metrik, um die Gesamtzahl der Benutzerauthentifizierungsanforderungen zu ermitteln. Verwenden Sie den statistischen Wert Sum für diese Metrik, um die Gesamtzahl erfolgreicher Benutzerauthentifizierungsanforderungen zu ermitteln. Um die Gesamtzahl der fehlgeschlagenen Benutzerauthentifizierungsanfragen zu zählen, verwenden Sie den CloudWatch Math Ausdruck und subtrahieren Sie die Statistik von der Sum Statistik. Sample Count Diese Metrik wird für jeden Benutzerpool für jeden Client veröffentlicht. Falls ein ungültiger Benutzerpool-Client mit einer Anfrage versorgt wird, enthält der entsprechende Benutzerpool-Client-Wert in der Metrik einen festen Wert Invalid anstelle des tatsächlich in der Anfrage gesendeten ungültigen Werts. Beachten Sie, dass Anforderungen zur Aktualisierung des Amazon-Cognito-Tokens in dieser Metrik nicht enthalten sind. Es gibt eine separate Metrik mit dem statistischen Wert für die Token-Refresh. Metrikdimension: UserPool, UserPoolClient Einheiten: Anzahl
SignInThrottles	Gibt die Gesamtzahl der an den Amazon-Cognito-Benutzerpool gerichteten gedrosselten Benutzerauthentifizierungsanforderungen an. Der Wert 1 wird veröffentlicht, wann immer eine Authentifizierungsanforderung gedrosselt wird. Verwenden Sie den statistischen Wert Sum für diese Metrik, um die Gesamtzahl der gedrosselten Benutzerauthentifizierungsanforderungen zu ermitteln. Diese Metrik wird für jeden Benutzerpool für jeden Client veröffentlicht. Falls ein ungültiger Benutzerpool-Client mit einer Anfrage versorgt wird, enthält der entsprechende Benutzerpool-Client-Wert in der Metrik einen festen Wert Invalid anstelle des tatsächlich in der Anfrage gesendeten ungültigen Werts. Anforderungen zum Aktualisieren des Amazon-Cognito-Tokens sind in dieser Metrik nicht enthalten. Es gibt eine separate Metrik mit dem statistischen Wert für die Token-Refresh. Metrikdimension: UserPool, UserPoolClient Einheiten: Anzahl
TokenRefreshSuccesses	Stellt die Gesamtzahl an den Amazon-Cognito-Benutzerpool gerichteter erfolgreicher Anforderungen zum Aktualisieren eines Amazon-Cognito-Tokens bereit. Eine erfolgreiche Anforderung zum Aktualisieren eines Amazon-Cognito-Tokens liefert den Wert 1, eine fehlgeschlagene Anforderung dagegen den Wert 0. Eine gedrosselte Anforderung wird als fehlgeschlagene Anforderung gezählt, liefert also auch den Wert 0. Verwenden Sie den statistischen Wert Average für diese Metrik, um den Prozentsatz erfolgreicher Anforderungen zum Aktualisieren eines Amazon-Cognito-Tokens zu ermitteln. Verwenden Sie den statistischen Wert Sample Count für diese Metrik, um die Gesamtzahl der Anforderungen zum Aktualisieren eines Amazon-Cognito-Tokens zu ermitteln. Verwenden Sie den statistischen Wert Sum für diese Metrik, um die Gesamtzahl der erfolgreichen Anforderungen zum Aktualisieren eines Amazon-Cognito-Tokens zu ermitteln. Um die Gesamtzahl der fehlgeschlagenen Anfragen zur Aktualisierung eines Amazon Cognito Cognito-Tokens zu zählen, verwenden Sie den CloudWatch Math Ausdruck und subtrahieren Sie die Sum Statistik von der Statistik. Sample Count Diese Metrik wird pro Benutzerpool-Client veröffentlicht. Wenn ein ungültiger Benutzerpool-Client in einer Anforderung enthalten ist, enthält der Benutzerpool-Client-Wert einen festen Wert von Invalid. Metrikdimension: UserPool, UserPoolClient Einheiten: Anzahl
TokenRefreshThrottles	Stellt die Gesamtzahl der gedrosselten Anforderungen zum Aktualisieren eines Amazon-Cognito-Tokens bereit, die an den Amazon-Cognito-Benutzerpool gestellt wurden. Der Wert 1 wird veröffentlicht, wann immer eine Anforderung zur Aktualisierung eines Amazon-Cognito-Tokens gedrosselt wird. Verwenden Sie den statistischen Wert Sum für diese Metrik, um die Gesamtzahl der gedrosselten Anforderungen zum Aktualisieren eines Amazon-Cognito-Tokens zu ermitteln. Diese Metrik wird für jeden Benutzerpool für jeden Client veröffentlicht. Falls ein ungültiger Benutzerpool-Client mit einer Anfrage versorgt wird, enthält der entsprechende Benutzerpool-Client-Wert in der Metrik einen festen Wert Invalid anstelle des tatsächlich in der Anfrage gesendeten ungültigen Werts. Metrikdimension: UserPool, UserPoolClient Einheiten: Anzahl
FederationSuccesses	Gibt die Gesamtzahl der an den Amazon-Cognito-Benutzerpool gerichteten erfolgreichen Identitätsverbundanforderungen an. Ein Identitätsverbund gilt als erfolgreich, wenn Amazon Cognito Authentifizierungs-Token an den Benutzer ausgibt. Eine erfolgreiche Identitätsverbundanforderung liefert den Wert 1, eine fehlgeschlagene Anforderung den Wert 0. Gedrosselte Anfragen und Anfragen, die einen Autorisierungscode, aber keine Token generieren, ergeben den Wert 0. Verwenden Sie den statistischen Wert Average für diese Metrik, um den Prozentsatz erfolgreicher Identitätsverbundanforderungen zu ermitteln. Verwenden Sie den statistischen Wert Sample Count für diese Metrik, um die Gesamtzahl der Identitätsverbundanforderungen zu ermitteln. Verwenden Sie den statistischen Wert Sum für diese Metrik, um die Gesamtzahl erfolgreicher Identitätsverbundanforderungen zu ermitteln. Um die Gesamtzahl der fehlgeschlagenen Identity Federation-Anfragen zu zählen, verwenden Sie den CloudWatch Math Ausdruck und subtrahieren Sie die Statistik von der Sum Statistik. Sample Count Metrikdimension: UserPool, UserPoolClient, IdentityProvider Einheiten: Anzahl
FederationThrottles	Gibt die Gesamtzahl der an den Amazon-Cognito-Benutzerpool gerichteten gedrosselten Identitätsverbundanforderungen an. Sobald eine Identitätsverbundanforderung gedrosselt wird, wird der Wert 1 veröffentlicht. Verwenden Sie den statistischen Wert Sum für diese Metrik, um die Gesamtzahl der gedrosselten Identitätsverbündungsanforderungen zu ermitteln. Metrikdimension: UserPool, UserPoolClient, IdentityProvider Einheiten: Anzahl
CallCount	Gibt die Gesamtzahl der Anrufe an, die Kunden in Bezug auf eine Kategorie getätigt haben. Diese Metrik umfasst alle Anrufe, wie gedrosselte Anrufe, fehlgeschlagene Anrufe und erfolgreiche Anrufe. Diese Metrik ist unter Verwendung nameSpace verfügbar. Das Kategorienkontingent wird für jedes AWS Konto in allen Benutzerpools eines Kontos und einer Region durchgesetzt. Mithilfe der Sum-Statistik für diese Metrik können Sie die Gesamtzahl der Anrufe in einer Kategorie zählen. Metrik-Dimension: Service, Typ, Ressource, Klasse Einheiten: Anzahl
ThrottleCount	Gibt die Gesamtzahl der gedrosselten Anrufe in Bezug auf eine Kategorie an. Diese Metrik ist unter Verwendung nameSpace verfügbar. Diese Metrik wird auf Kontoebene veröffentlicht. Mithilfe der Sum-Statistik für diese Metrik können Sie die Gesamtzahl der Anrufe in einer Kategorie zählen. Metrik-Dimension: Service, Typ, Ressource, Klasse Einheiten: Anzahl

Dimensionen für Amazon-Cognito-Benutzerpools

Die folgenden Dimensionen werden verwendet, um die Nutzungsmetriken zu verfeinern, die von Amazon Cognito veröffentlicht werden. Die Dimensionen gelten nur für CallCount- und ThrottleCount -Metriken.

Dimension	Beschreibung
Service	Der Name des AWS Dienstes, der die Ressource enthält. Für Amazon-Cognito-Nutzungsmetriken lautet der Wert für diese Dimension Cognito user pool.
Typ	Der Typ von Entität, die gemeldet wird. Der einzig gültige Wert für Amazon Cognito Cognito-Nutzungsmetriken istAPI.
Ressource	Der Typ der Ressource, die ausgeführt wird. Der einzige gültige Wert ist Kategoriename.
Klasse	Die Klasse der nachverfolgten Ressource. Amazon Cognito verwendet nicht die Klassendimension.

Verwenden Sie die CloudWatch Konsole, um Metriken zu verfolgen

Sie können mithilfe CloudWatch von Amazon Cognito-Benutzerpool-Metriken verfolgen und sammeln. Das CloudWatch Dashboard zeigt Kennzahlen zu jedem AWS Service an, den Sie verwenden. Sie können es verwenden CloudWatch , um metrische Alarme zu erstellen. Die Alarme können so eingerichtet werden, dass sie Ihnen Benachrichtigungen senden oder eine Änderung an einer bestimmten Ressource vornehmen, die Sie überwachen. Gehen Sie wie folgt vor CloudWatch, um die Kennzahlen zu Servicekontingenten in anzuzeigen.

1. Öffnen Sie die CloudWatchKonsole.

2. Wählen Sie im Navigationsbereich Metriken aus.

3. Wählen Sie unter Alle Metriken eine Metrik und eine Dimension aus.

4. Aktivieren Sie das Kontrollkästchen neben der Metrik. Die Metriken werden im Diagramm angezeigt.

Anmerkung

Metriken, für die in den letzten zwei Wochen keine neuen Datenpunkte vorlagen, werden nicht in der Konsole angezeigt. Sie werden auch nicht angezeigt, wenn Sie den Metriknamen oder die Dimensionsnamen in der Konsole in das Suchfeld auf der Registerkarte Alle Metriken eingeben, und sie werden nicht in den Ergebnissen eines Befehls vom Typ list-metrics zurückgegeben. Diese Metriken lassen sich am besten mit den get-metric-statistics Befehlen get-metric-data oder in der abrufen AWS CLI.

Erstellen Sie einen CloudWatch Alarm für ein Kontingent

Amazon Cognito stellt CloudWatch Nutzungsmetriken bereit, die den AWS Servicekontingenten für CallCount und ThrottleCount APIs entsprechen. Weitere Informationen zur Nachverfolgung der Nutzung finden Sie CloudWatch unterVerfolgen der Kontingentnutzung.

In der Service-Quotas-Konsole können Sie Alarme erstellen, die Sie benachrichtigen, wenn sich Ihre Nutzung einem Servicekontingent nähert. Informationen zum Einrichten eines CloudWatch Alarms mithilfe der Service Quotas Console finden Sie unter Servicequotas und CloudWatch Alarme.