Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Mit CloudWatch können Sie Metriken für individuelle Amazon Textract Textract-Operationen oder globale Amazon Textract Textract-Metriken für das Konto abrufen. Sie können Metriken verwenden, um den Zustand der Amazon Texttract-basierten Lösung zu überwachen und Alarme einzurichten, damit Sie benachrichtigt werden, falls einzelne oder mehrere Metriken einen definierten Grenzwert überschreiten. Sie können beispielsweise Metriken für die Anzahl aufgetretener Serverfehler anzeigen. Außerdem können Sie Metriken für die Anzahl von erfolgreichen spezifischen Amazon Textract Textract-Operationen anzeigen. Verwenden Sie, um Metriken anzuzeigenAmazon CloudWatch
Verwenden von CloudWatch-Metriken für Amazon Textract
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. Amazon Textract verfügt über eine Dimension namensOperationaus. Es stellt Metriken für eine bestimmte Operation zur Verfügung. Wenn Sie keine Dimension angeben, gilt die Metrik für alle Amazon Textract Textract-Operationen innerhalb Ihres Kontos.
-
Der Metrikname, beispielsweise
UserErrorCount.
Sie können Überwachungsdaten für Amazon Textract mithilfe derAWS Management Console, derAWS CLIoder die CloudWatch API. Sie können die CloudWatch-API auch über eines der Amazon AWS Software Development Kits (SDKs) oder der CloudWatch-API-Tools verwenden. Die Konsole zeigt eine Reihe von Graphen an, die auf den unformatierten Daten aus der CloudWatch-API basieren. 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 erkennen, ob meine Anwendung die maximale Anzahl an Anfragen pro Sekunde erreicht hat? |
Überwachen Sie die |
|
Wie überwache ich die Anforderungsfehler? |
Verwenden Sie die |
|
Wie finde ich die Gesamtanzahl der Anforderungen? |
Verwenden Sie die |
|
Wie überwache ich die Latenz der Amazon Textract Textract-Operationsaufrufe? |
Verwenden Sie die |
Sie müssen zur Überwachung von Amazon Textract mit CloudWatch über die entsprechenden CloudWatch-Berechtigungen verfügen. Weitere Informationen finden Sie unter Authentifizierung und Zugriffssteuerung für Amazon CloudWatch.
Zugriff auf Amazon Textract -Metriken
Die folgenden Beispiele zeigen, wie Sie mithilfe der CloudWatch-Konsole, auf Amazon Textract Textract-Metriken zugreifen.AWS CLIund die CloudWatch API.
So zeigen Sie Metriken an (Konsole)
-
Öffnen Sie die CloudWatch-Konsole unter https://console.aws.amazon.com/cloudwatch/
. -
Klicken Sie aufMetriken, wähle dasAlle -Metrikenund wählen Sie dannAmazon Textractaus.
-
Klicken Sie aufNach dem Betriebund wählen Sie dann eine Metrik.
Wählen Sie z. B.StartDocumentAnalysisMetrik, um zu messen, wie oft die asynchrone Dokumentenanalyse gestartet wurde.
-
Wählen Sie einen Wert für den Datumsbereich aus. Die Metrikanzahl, die im Graph angezeigt wird.
So zeigen Sie Metriken an, um erfolgreichStartDocumentAnalysisOperationsaufrufe, die über einen bestimmten Zeitraum getätigt wurden (CLI)
-
Öffnen Sie die AWS CLI und geben Sie den folgenden Befehl ein:
aws cloudwatch get-metric-statistics \ --metric-name SuccessfulRequestCount \ --start-time 2019-02-01T00:00:00Z \ --period 3600 \ --end-time 2019-03-01T00:00:00Z \ --namespace AWS/Textract \ --dimensions Name=Operation,Value=StartDocumentAnalysis \ --statistics SumDieses Beispiel zeigt die erfolgreichen Aufrufe der
StartDocumentAnalysis-Operation für einen bestimmten Zeitraum an. Weitere Informationen finden Sie unter get-metric-statistics.
So greifen Sie auf Metriken zu (CloudWatch-API)
-
Rufen Sie die folgende Seite auf
GetMetricStatistics. Weitere Informationen finden Sie im .Amazon CloudWatch CloudWatch-API-Referenzaus.
Einrichten eines Alarms
Sie können einen CloudWatch-Alarm erstellen, der eine Amazon Simple Notification Service (Amazon SNS) sendet, sobald sich der Status des Alarms ändert. Ein Alarm überwacht eine Metrik über einen bestimmten, von Ihnen definierten Zeitraum. Der Alarm führt eine oder mehrere Aktionen durch, basierend auf dem Wert der Metrik im Vergleich zu einem bestimmten Schwellenwert in einer Reihe von Zeiträumen. 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 Status 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)
-
Melden Sie sich bei AWS Management Console an und öffnen Sie die CloudWatch-Konsole unter https://console.aws.amazon.com/cloudwatch/
. Wählen Sie im NavigationsbereichAlarme, und wählen SieAlarm erstellenaus. Dies öffnetCreate Alarm Wizardaus.
Wählen Sie Select metric (Metrik auswählen) aus.
In derAlle Metriken-Tab wählenTextractaus.
-
Klicken Sie aufNach Operationund wählen Sie dann eine Metrik.
Wählen Sie z. B.StartDocumentAnalysisum einen Alarm für eine maximale Anzahl an asynchronen Dokumentanalysevorgängen einzurichten.
Wählen Sie die Registerkarte Graphed metrics aus.
Wählen Sie für Statistic (Statistik) Sum (Summe) aus.
Wählen Sie Select metric (Metrik auswählen) aus.
-
Geben Sie Name und Description an. Für Whenever wählen Sie >= aus und geben einen maximalen Wert Ihrer Wahl an.
-
Wenn CloudWatch Ihnen eine E-Mail senden soll, sobald der Alarmstatus erreicht ist, fürWann immer dieser Alarm:, wählenStaat ist ALARMaus. So senden Sie Alarme für ein bestehendes Amazon SNS SNS-ThemaBenachrichtigung senden an:Wählen Sie ein vorhandenes SNS-Thema. Um den Namen und die E-Mail-Adressen für eine neue E-Mail-Abonnementliste einzurichten, wählen Sie ausNeue Listeaus. CloudWatch speichert die Liste und zeigt sie im Feld an, damit Sie sie für die Einrichtung zukünftiger Alarme nutzen können.
Anmerkung
Bei VerwendungNeue ListeUm ein neues Amazon SNS-Thema einzurichten, müssen die E-Mail-Adressen überprüft werden, bevor die gewünschten Empfänger Benachrichtigungen erhalten. Amazon SNS sendet nur dann eine E-Mail, wenn der Alarm einen Alarmzustand auslöst. Wenn es zu dieser Änderung des Alarmzustands kommt, bevor die E-Mail-Adressen überprüft wurden, erhalten die vorgesehenen Empfänger keine Benachrichtigung.
-
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
alarm-actions-Parameter, um auf ein zuvor erstelltes Amazon SNS SNS-Thema zu verweisen.aws cloudwatch put-metric-alarm \ --alarm-name StartDocumentAnalysisUserErrors \ --alarm-description "Alarm when more than 10 StartDocumentAnalysys user errors occur within 5 minutes" \ --metric-name UserErrorCount \ --namespace AWS/Textract \ --statistic Sum \ --period 300 \ --threshold 10 \ --comparison-operator GreaterThanThreshold \ --evaluation-periods 1 \ --unit Count \ --dimensions Name=Operation,Value=StartDocumentAnalysis \ --alarm-actions arn:aws:sns:us-east-1:111111111111:alarmtopicDieses Beispiel zeigt, wie Sie einen Alarm erstellen, wenn mehr als 10 Benutzerfehler innerhalb von 5 Minuten auftreten, damit Aufrufe von
StartDocumentAnalysisaus. Weitere Informationen finden Sie unter put-metric-alarm.
So richten Sie einen Alarm ein (CloudWatch-API)
-
Rufen Sie die folgende Seite auf
PutMetricAlarm. Weitere Informationen finden Sie unterAmazon CloudWatch CloudWatch-API-Referenzaus.
