Überwachung von Rekognition mit Amazon CloudWatch

Mit CloudWatch, Sie können Metriken für einzelne Rekognition-Operationen oder globale Rekognition-Metriken für Ihr Konto abrufen. Sie können Metriken verwenden, um den Zustand Ihrer auf Rekognition basierenden Lösung zu verfolgen und Alarme einzurichten, die Sie benachrichtigen, wenn eine oder mehrere Metriken einen definierten Schwellenwert überschreiten. Beispielsweise können Sie Metriken für die Anzahl aufgetretener Serverfehler oder Metriken für die Anzahl erkannter Gesichter anzeigen. Sie können auch Messwerte dafür sehen, wie oft ein bestimmter Rekognition-Vorgang erfolgreich war. Um Metriken zu sehen, können Sie Folgendes verwendenAmazon CloudWatch,AmazonasAWS Command Line Interface, oder derCloudWatch API.

Mithilfe der Rekognition-Konsole können Sie sich auch aggregierte Messwerte für einen ausgewählten Zeitraum ansehen. Weitere Informationen finden Sie unter Übung 4: Anzeigen von Gesamtmetriken (Konsole).

Verwenden CloudWatch Metriken für Rekognition

Um Metriken zu verwenden, müssen Sie die folgenden Informationen angeben:

• Die Metrikdimension oder keine Dimension. Eine Dimension ist ein Name-Wert-Paar, mit dem Sie eine Metrik eindeutig identifizieren. Rekognition hat eine Dimension, benanntBetrieb. Es stellt Metriken für eine bestimmte Operation zur Verfügung. Wenn Sie keine Dimension angeben, bezieht sich die Metrik auf alle Rekognition-Operationen in Ihrem Konto.

• Der Metrikname, beispielsweise UserErrorCount.

Sie können Überwachungsdaten für Rekognition abrufen, indem SieAWS Management Console, derAWS CLI, oder der CloudWatch API. Sie können auch die CloudWatch API über eines der Amazon AWS Software Development Kits (SDKs) oder CloudWatch API-Tools. Die Konsole zeigt eine Reihe von Diagrammen, die auf den Rohdaten von CloudWatch API. Je nach Anforderungen können Sie entweder die in der Konsole angezeigten oder die mit der API aufgerufenen Graphen verwenden.

In der folgenden Liste finden Sie einige häufige Verwendungszwecke für die Metriken. Es handelt sich dabei um Vorschläge für den Einstieg und nicht um eine umfassende Liste.

Wie gehe ich vor?	Relevante Metriken
Wie kann ich ermitteln, wie viele Gesichter erkannt wurden?	Überwachen Sie die Sum-Statistik der DetectedFaceCount-Metrik.
Wie kann ich erkennen, ob meine Anwendung die maximale Anzahl an Anfragen pro Sekunde erreicht hat?	Überwachen Sie die Sum-Statistik der ThrottledCount-Metrik.
Wie überwache ich die Anforderungsfehler?	Verwenden Sie die Sum-Statistik der UserErrorCount-Metrik.
Wie finde ich die Gesamtanzahl der Anforderungen?	Verwenden Sie die ResponseTime- und Data Samples-Statistik der ResponseTime-Metrik. Dies umfasst jegliche Anfrage, die zu einem Fehler geführt hat. Um nur erfolgreiche Operationsaufrufe anzuzeigen, verwenden Sie dieSuccessfulRequestCount-Metrik.
Wie überwache ich die Latenz der Rekognition-Operationsaufrufe?	Verwenden Sie die ResponseTime-Metrik.
Wie kann ich überwachen, wie oftIndexFacesDu hast erfolgreich Gesichter zu Rekognition-Sammlungen hinzugefügt?	Überwachen Sie die Sum-Statistik der SuccessfulRequestCount-Metrik und die IndexFaces-Operation. Verwenden Sie die Operation-Dimension, um die Operation und die Metrik auszuwählen.

Sie müssen die entsprechenden CloudWatch Berechtigungen zur Überwachung von Rekognition mit CloudWatch. Weitere Informationen finden Sie unter Identity and Access Management for Amazon CloudWatch.

Greifen Sie auf die Rekognito

Die folgenden Beispiele zeigen, Rekognition mit der CloudWatch Konsole,AWS CLI, und die CloudWatchAPI.

So zeigen Sie Metriken an (Konsole)

1. Öffne die CloudWatch Konsole beihttps://console.aws.amazon.com/cloudwatch/.

2. Wählen Sie Metrics, dann die Registerkarte All Metrics und dann Recognition.

3. Wählen Sie Metrics with no dimensions, und dann eine Metrik.

   Wählen Sie beispielsweise die DetectedFace-Metrik aus, um zu prüfen, wie viele Gesichter erkannt wurden.

4. Wählen Sie einen Wert für den Datumsbereich aus. Die Metrikanzahl, die im Graph angezeigt wird.

Um Metriken anzuzeigen, müssen über einen bestimmten Zeitraum regelmäßig erfolgreiche Aufrufe an die DetectFaces-Operation gemacht worden sein (CLI).

• Öffnen Sie die AWS CLI und geben Sie den folgenden Befehl ein:

  aws cloudwatch get-metric-statistics --metric-name SuccessfulRequestCount --start-time 2017-1-1T19:46:20 --end-time 2017-1-6T19:46:57 --period 3600 --namespace AWS/Rekognition --statistics Sum --dimensions Name=Operation,Value=DetectFaces --region us-west-2

  Dieses Beispiel zeigt die erfolgreichen Aufrufe der DetectFaces-Operation für einen bestimmten Zeitraum an. Weitere Informationen finden Sie unterget-metric-statistics.

Um auf Metriken zuzugreifen (CloudWatch API)

• Rufen Sie die folgende Seite auf GetMetricStatistics. Weitere Informationen finden Sie hier:Amazon CloudWatch API-Referenz.

Erstellen eines Alarms

Sie können ein CloudWatch Alarm, der eine Amazon Simple Notification Service (Amazon SNS) -Nachricht sendet, wenn sich der Status des Alarms ändert. Ein Alarm überwacht eine Metrik über einen bestimmten, von Ihnen definierten Zeitraum und führt eine oder mehrere Aktionen durch, die vom Wert der Metrik im Vergleich zu einem festgelegten Schwellenwert in einer Reihe von Zeiträumen abhängt. Die Aktion ist eine Benachrichtigung, die an ein Amazon-SNS-Thema oder eine Auto-Scaling-Richtlinie gesendet wird.

Alarme rufen nur Aktionen für nachhaltige Statusänderungen auf. CloudWatch Alarme rufen keine Aktionen auf, nur weil sie sich in einem bestimmten Zustand befinden. Der Status muss sich geändert haben und für eine festgelegte Anzahl an Zeiträumen aufrechterhalten worden sein.

So richten Sie einen Alarm ein (Konsole)

1. Loggen Sie sich einAWS Management Consoleund öffne CloudWatch Konsole beihttps://console.aws.amazon.com/cloudwatch/.

2. Wählen Sie Create Alarm (Alarm erstellen) aus. Dadurch wird der Create Alarm Wizard (Assistent zum Erstellen von Alarmen) gestartet.

3. Wählen Sie aus der Liste der Metriken Metrics with no dimensions den Eintrag Rekognition Metrics aus, und wählen Sie dann eine Metrik.

   Wählen Sie beispielsweise DetectedFaceCount aus, um einen Alarm für eine maximale Anzahl an erkannten Gesichtern einzurichten.

4. Wählen Sie im Bereich Time Range einen Datumsbereich-Wert aus, der die Operationen zur Gesichtserkennung beinhaltet, die Sie aufgerufen haben. Wählen Sie Next (Weiter)

5. Geben Sie Name und Description an. Für Whenever wählen Sie >= aus und geben einen maximalen Wert Ihrer Wahl an.

6. Wenn du willst CloudWatch um Ihnen eine E-Mail zu senden, wenn der Alarmstatus erreicht ist,Immer wenn dieser Alarm:, wählenStatus ist ALARM. Um Alarme an ein vorhandenes Amazon SNS SNS-Thema zu senden, fürDie Benachrichtigung ist ein wichtiger Teil der, wählen Sie ein vorhandenes SNS-Design. Um den Namen und die E-Mail-Adressen für eine neue E-Mail-Abonnementliste festzulegen,Thema erstellen CloudWatch speichert die Liste und zeigt sie im Feld an, sodass Sie sie verwenden können, um future Alarme einzustellen.

   Anmerkung

   Wenn duThema erstellenUm ein neues Amazon SNS zu erstellen, müssen die E-Mail-Adressen verifiziert werden, um die gewünschten Empfänger von Benachrichtigungen zu erhalten. Amazon SNS sendet nur dann eine E-Mail, wenn der Alarm in einen Alarmzustand. Wenn es zu dieser Änderung des Alarmzustands kommt, bevor die E-Mail-Adressen überprüft wurden, erhalten die vorgesehenen Empfänger keine Benachrichtigung.

7. Nutzen Sie die Alarmvorschau im Bereich Alarm Preview. Wählen Sie Create Alarm (Alarm erstellen) aus.

So richten Sie einen Alarm ein (AWS CLI)

• Öffnen Sie die AWS CLI und geben Sie den folgenden Befehl ein. Ändern Sie den Wert vonalarm-actionsParameter, um auf ein Amazon SNS SNS-Thema zu verweisen, das Sie zuvor erstellt haben.

  aws cloudwatch put-metric-alarm --alarm-name UserErrors --alarm-description "Alarm when more than 10 user errors occur" --metric-name UserErrorCount --namespace AWS/Rekognition --statistic Average --period 300 --threshold 10 --comparison-operator GreaterThanThreshold --evaluation-periods 2 --alarm-actions arn:aws:sns:us-west-2:111111111111:UserError --unit Count

  Dieses Beispiel zeigt, wie Sie einen Alarm für den Fall erstellen, dass innerhalb von 5 Minuten mehr als 10 Benutzerfehler auftreten. Weitere Informationen finden Sie unterput-metric-alarm.

Um einen Alarm einzustellen (CloudWatch API)

• Rufen Sie die folgende Seite auf PutMetricAlarm. Weitere Informationen finden Sie unterAmazon CloudWatch API-Referenz.

CloudWatchMetriken für Rekognition

Dieser Abschnitt enthält Informationen über Amazon CloudWatch Metriken und dieBetriebDie Größe ist für Amazon Rekognition verfügbar.

In der Rekognition-Konsole können Sie sich auch eine Gesamtansicht der Rekognition-Metriken anzeigen lassen. Weitere Informationen finden Sie unter Übung 4: Anzeigen von Gesamtmetriken (Konsole).

CloudWatch Metriken für Rekognition

In der folgenden Tabelle sind die Rekognition -Lösungen.

Metrik	Beschreibung
SuccessfulRequestCount	die Anzahl erfolgreicher Anforderungen. Der Antwortcode-Bereich für eine erfolgreiche Anfrage ist 200 bis 299. Einheit: Anzahl Gültige Statistiken: Sum,Average
ThrottledCount	Die Anzahl der gedrosselten Anforderungen. Rekognition drosselt eine Anfrage, wenn mehr Anfragen eingehen als das für Ihr Konto festgelegte Limit an Transaktionen pro Sekunde. Wenn der Grenzwert für Ihr Konto häufig überschritten wird, können Sie eine Erweiterung des Limits beantragen. Informationen zum Anfordern einer Erweiterung finden Sie unter AWS Service Limits. Einheit: Anzahl Gültige Statistiken: Sum,Average
ResponseTime	Die Zeit in Millisekunden, die Rekognition benötigt, um die Antwort zu berechnen. Einheiten: Anzahl für Data Samples-Statistiken Millisekunden für die Average Statistik Gültige Statistiken: Data Samples,Average Anmerkung DieResponseTimeDie Metrik ist nicht im Metrikbereich von Rekognition enthalten.
DetectedFaceCount	Die Anzahl von Gesichtern, die mithilfe der IndexFaces- oder der DetectFaces-Operation erkannt wurden. Einheit: Anzahl Gültige Statistiken: Sum,Average
DetectedLabelCount	Die Anzahl von Bezeichnungen, die mithilfe der DetectLabels-Operation erkannt wurden. Einheit: Anzahl Gültige Statistiken: Sum,Average
ServerErrorCount	Die Anzahl von Server-Fehlern. Der Antwortcode-Bereich für eine erfolgreiche Anfrage ist 500 bis 599. Einheit: Anzahl Gültige Statistiken: Sum, Average
UserErrorCount	Die Anzahl der Benutzerfehler (ungültige Parameter, ungültiges Bild, keine Berechtigung, usw.). Der Antwortcode-Bereich für einen Benutzerfehler ist 400 bis 499. Einheit: Anzahl Gültige Statistiken: Sum,Average
MinInferenceUnits	Die Mindestanzahl von Inferenz-Einheiten, die während derStartProjectVersionAnfrage. Einheit: Anzahl Gültige Statistiken: Average
MaxInferenceUnits	Die maximale Anzahl von Inferenz-Einheiten, die während derStartProjectVersion Anfrage. Einheit: Anzahl Gültige Statistiken: Average
DesiredInferenceUnits	Die Anzahl der Inferenzeinheiten, auf die Rekognition nach oben oder unten skaliert. Einheit: Anzahl Gültige Statistiken: Average
InServiceInferenceUnits	Die Anzahl der Inferenzeinheiten, die das Modell verwendet. Einheit: Anzahl Gültige Statistiken: Average Es wird empfohlen, die Durchschnittsstatistik zu verwenden, um den 1-Minuten-Durchschnitt der verwendeten Instanzen zu ermitteln.

CloudWatch Metriken für Rekognition Streaming

Rekognition hat auch einen zweiten Namespace, der für Streaming-Operationen verwendet wird, „Rekognition Streaming“. In der folgenden Tabelle sind die Rekognito Streaming-Metriken.

Metrik	Beschreibung
SuccessfulRequestCount	die Anzahl erfolgreicher Anforderungen. Der Antwortcode-Bereich für eine erfolgreiche Anfrage ist 200 bis 299. Einheit: Anzahl Gültige Statistiken: Sum,Average
CallCount	Die Anzahl der angegebenen Operationen, die in Ihrem Konto ausgeführt werden. Gültige Statistiken: Sum,Average
ThrottledCount	Die Anzahl der gedrosselten Anforderungen. Rekognition drosselt eine Anfrage, wenn mehr Anfragen eingehen als das für Ihr Konto festgelegte Limit an Transaktionen pro Sekunde. Wenn der Grenzwert für Ihr Konto häufig überschritten wird, können Sie eine Erweiterung des Limits beantragen. Informationen zum Anfordern einer Erweiterung finden Sie unter AWS Service Limits. Einheit: Anzahl Gültige Statistiken: Sum,Average
ServerErrorCount	Die Anzahl von Server-Fehlern. Der Antwortcode-Bereich für eine erfolgreiche Anfrage ist 500 bis 599. Einheit: Anzahl Gültige Statistiken: Sum, Average
UserErrorCount	Die Anzahl der Benutzerfehler (ungültige Parameter, ungültiges Bild, keine Berechtigung, usw.). Der Antwortcode-Bereich für einen Benutzerfehler ist 400 bis 499. Einheit: Anzahl Gültige Statistiken: Sum,Average

CloudWatch Dimension für Rekognition

Um operationsspezifische Metriken aufzurufen, verwenden Sie den Rekognition-Namespace und geben Sie eine Operationsdimension an.

Weitere Informationen zu den Dimensionen finden Sie unterAbmessungenin derAmazon CloudWatch Benutzerleitfaden.

CloudWatch Dimension von Rekognition Custom Labels

Die folgende Tabelle zeigt CloudWatch Verfügbare Abmessungen für die Verwendung mit Rekognition Custom Labels:

Dimension	Beschreibung
ProjectName	Der Name des Rekognition Custom Labels-Projekts, mit dem Sie es erstellt habenCreateProject.
VersionName	Der Name der Rekognition Custom Labels-Projektversion, mit der Sie erstellt habenCreateProjectVersion.

Weitere Informationen zu den Dimensionen finden Sie unterAbmessungenin derAmazon CloudWatch Benutzerleitfaden.