View a markdown version of this page

Überwachung von Amazon Textract - Amazon Textract
Verwenden von CloudWatch Metriken für Amazon TextractGreifen Sie auf Amazon Textract Metrics zuEinrichten eines Alarms

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.

Überwachung von Amazon Textract

Mit CloudWatch können Sie Metriken für einzelne Amazon Textract-Operationen oder globale Amazon Textract-Metriken für Ihr Konto abrufen. Mithilfe von Metriken können Sie den Zustand Ihrer auf Amazon Textract basierenden Lösung verfolgen und Alarme einrichten, die Sie benachrichtigen, wenn eine oder mehrere Metriken einen definierten Schwellenwert überschreiten. So können Sie sich beispielsweise Messwerte für die Anzahl der aufgetretenen Serverfehler anzeigen lassen. Sie können sich auch Messwerte dafür anzeigen lassen, wie oft ein bestimmter Amazon Textract-Vorgang erfolgreich war. Um Metriken anzuzeigen, können Sie Amazon CloudWatch AWS CLI, die oder die CloudWatch API verwenden.

Verwenden von CloudWatch Metriken für Amazon Textract

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

  • Die metrische Dimension oder keine Dimension. Eine Dimension ist ein Name-Wert-Paar, mit dem Sie eine Metrik eindeutig identifizieren. Amazon Textract hat eine Dimension namens Operation. Es stellt Metriken für eine bestimmte Operation zur Verfügung. Wenn Sie keine Dimension angeben, bezieht sich die Metrik auf alle Amazon Textract-Vorgänge in Ihrem Konto.

  • Der Metrikname, beispielsweise UserErrorCount.

Sie können Überwachungsdaten für Amazon Textract abrufen, indem Sie die AWS-Managementkonsole, die oder die AWS CLI API verwenden. CloudWatch Sie können die CloudWatch API auch über eines der Amazon AWS Software Development Kits (SDKs) oder die CloudWatch API-Tools verwenden. Die Konsole zeigt eine Reihe von Diagrammen an, die auf den Rohdaten 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 Anforderungen 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 SampleCount-Statistik der ResponseTime-Metrik. Dies umfasst jegliche Anforderung, die zu einem Fehler geführt hat. Um nur erfolgreiche Operationsaufrufe anzuzeigen, verwenden Sie dieSuccessfulRequestCount-Metrik.

Wie kann ich die Latenz von Amazon Textract-Betriebsaufrufen überwachen?

Verwenden Sie die ResponseTime-Metrik.

Sie müssen über die entsprechenden CloudWatch Berechtigungen verfügen, um Amazon Textract überwachen zu können. CloudWatch Weitere Informationen finden Sie unter Identity and Access Management for Amazon CloudWatch.

Greifen Sie auf Amazon Textract Metrics zu

Die folgenden Beispiele zeigen, wie Sie mithilfe der CloudWatch Konsole, der und der API auf Amazon Textract-Metriken zugreifen. AWS CLI CloudWatch

So zeigen Sie Metriken an (Konsole)

  1. Öffnen Sie die CloudWatch Konsole unter. https://console.aws.amazon.com/cloudwatch/

  2. Wählen Sie Metrics, dann den Tab All Metrics und dann Amazon Textract.

  3. Wählen Sie Nach Vorgang und dann eine Metrik aus.

    Wählen Sie beispielsweise die StartDocumentAnalysis Metrik aus, um zu messen, wie oft die asynchrone Dokumentenanalyse gestartet wurde.

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

Um Kennzahlen für erfolgreiche StartDocumentAnalysis Betriebsaufrufe anzuzeigen, die über einen bestimmten Zeitraum getätigt wurden (CLI)

  • Öffnen Sie das 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 Sum

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

Um auf Metriken zuzugreifen (CloudWatch API)

Einrichten eines Alarms

Sie können einen CloudWatch Alarm erstellen, der eine Amazon Simple Notification Service (Amazon SNS) -Meldung sendet, wenn 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 Aktionen nur bei anhaltenden Zustandsänderungen auf. CloudWatch Alarme lösen keine Aktionen aus, 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. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Wählen Sie im Navigationsbereich Alarme und dann Alarm erstellen aus. Dadurch wird der Assistent zum Erstellen von Alarmen geöffnet.

  3. Wählen Sie Select metric (Metrik auswählen) aus.

  4. Wählen Sie auf der Registerkarte Alle Metriken die Option Textract aus.

  5. Wählen Sie „Nach Vorgang“ und dann eine Metrik aus.

    Wählen Sie beispielsweise aus, StartDocumentAnalysis dass ein Alarm für eine maximale Anzahl asynchroner Dokumentanalysevorgänge gesetzt werden soll.

  6. Wählen Sie die Registerkarte Graphed metrics (Grafisch dargestellte Metriken) aus.

  7. Wählen Sie für Statistic (Statistik) Sum (Summe) aus.

  8. Wählen Sie Select metric (Metrik auswählen) aus.

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

  10. Wenn Sie Ihnen eine E-Mail senden CloudWatch möchten, wenn der Alarmstatus erreicht ist, wählen Sie für Immer diesen Alarm: die Option Status ist ALARM. Um Alarme für ein bestehendes Amazon-SNS-Thema zu senden, wählen Sie für Benachrichtigung senden an: ein bestehendes SNS-Thema aus. Um den Namen und die E-Mail-Adressen für eine neue E-Mail-Abonnementliste festzulegen, wählen Sie Neue Liste. CloudWatch speichert die Liste und zeigt sie im Feld an, sodass Sie sie verwenden können, um zukünftige Alarme einzustellen.

    Anmerkung

    Wenn Sie Neue Liste verwenden, um ein neues Amazon SNS-Thema zu erstellen, müssen die E-Mail-Adressen verifiziert werden, bevor die vorgesehenen Empfänger Benachrichtigungen erhalten. Amazon SNS sendet nur dann eine E-Mail, wenn der Alarm einen Alarmzustand auslöst. Wenn sich dieser Alarmstatus ändert, bevor die E-Mail-Adressen verifiziert wurden, erhalten die beabsichtigten Empfänger keine Benachrichtigung.

  11. Wählen Sie Alarm erstellen aus.

Um einen Alarm einzustellen (AWS CLI)

  • Öffnen Sie das AWS CLI und geben Sie den folgenden Befehl ein. Ändern Sie den Wert des alarm-actions Parameters so, dass er auf ein Amazon SNS-Thema verweist, das Sie zuvor erstellt haben. 

    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:alarmtopic

    Dieses Beispiel zeigt, wie bei Anrufen von innerhalb von 5 Minuten ein Alarm ausgelöst wird, wenn innerhalb von 5 Minuten mehr als 10 Benutzerfehler auftreten. StartDocumentAnalysis Weitere Informationen finden Sie unter put-metric-alarm.

Um einen Alarm einzustellen (CloudWatch API)