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 Translate Die Überwachung ist ein wichtiger Bestandteil der Aufrechterhaltung der Zuverlässigkeit, Verfügbarkeit und Leistung von Amazon Translate und Ihren Lösungen. AWS bietet verschiedene Tools, mit denen Sie Amazon Translate überwachen können. Sie können einige dieser Tools so konfigurieren, dass sie Ihre Lösungen für Sie überwachen. Wir empfehlen, dass Sie die Überwachungsaufgaben möglichst automatisieren. Amazon Translate bietet vorkonfigurierte Grafiken, die Ihnen die wichtigsten Kennzahlen für Ihre Lösung zeigen. Jedes Diagramm stellt einen Einblick in die Leistung Ihrer Lösung zur Verfügung. Um die Leistung Ihrer Lösung im Zeitverlauf zu vergleichen, können Sie den in Diagrammen dargestellten Zeitbereich ändern. Sie können Amazon Translate auch CloudWatch zur Überwachung von Amazon Translate verwenden. Mit CloudWatch können Sie die Überwachung bestimmter Metriken für Ihre Lösungen automatisieren. Sie erhalten eine Benachrichtigung, wenn eine Metrik die von Ihnen definierten Grenzwerte überschreitet. Sie können die CloudWatch API auch verwenden, um eine benutzerdefinierte Überwachungsanwendung zu erstellen, die für Ihre Bedürfnisse geeignet ist. Weitere Informationen finden Sie unter [Was ist Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) im * CloudWatch Amazon-Benutzerhandbuch*. In der folgenden Tabelle werden alle von Amazon Translate bereitgestellten vorkonfigurierten Grafiken beschrieben. | Diagramm | Description | | --- | --- | | ![\[Grafik, die die Anzahl erfolgreicher Anfragen zeigt.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/metric-successful-request-count.png) | Anzahl erfolgreicher Anforderungen Die Anzahl der erfolgreichen Anfragen an Amazon Translate während des angegebenen Zeitraums. | | ![\[Diagramm, das die Anzahl der gedrosselten Anfragen zeigt.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/metric-throttled-request-count.png) | Anzahl gedrosselter AnforderungenDie Anzahl der Anfragen an Amazon Translate, die während des angegebenen Zeitraums gedrosselt wurden. Verwenden Sie diese Informationen, um festzustellen, ob Ihre Anwendung Anfragen zu schnell an Amazon Translate sendet. | | ![\[Grafik mit durchschnittlicher Antwortzeit.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/metric-average-response-time.png) | Durchschnittliche Reaktionszeit Die durchschnittliche Zeit, die Amazon Translate für die Bearbeitung Ihrer Anfrage innerhalb des angegebenen Zeitraums benötigt hat. | | ![\[Grafik mit der Anzahl der Zeichen.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/metric-character-count.png) | ZeichenanzahlDie Gesamtzahl der Zeichen, die Sie im angegebenen Zeitraum an Amazon Translate gesendet haben. Dies ist die Anzahl der Zeichen, die Ihnen berechnet wird. | | ![\[Grafik mit der Anzahl der Benutzerfehler.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/metric-user-error-count.png) | Anzahl BenutzerfehlerDie Anzahl der Benutzerfehler, die im angegebenen Zeitraum aufgetreten sind. Benutzerfehler fallen in den HTTP-Fehlercodebereich 400 – 499. | | ![\[Grafik mit der Anzahl der Systemfehler.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/metric-system-error-count.png) | Anzahl SystemfehlerDie Anzahl der Systemfehler, die im angegebenen Zeitraum aufgetreten sind. Systemfehler fallen in den HTTP-Fehlercodebereich 500 – 599. | ## Überwachung von Amazon Translate Mit Amazon CloudWatch können Sie Metriken für einzelne Amazon Translate Translate-Operationen oder globale Amazon Translate Translate-Kennzahlen für Ihr Konto abrufen. Verwenden Sie Metriken, um den Zustand Ihrer Amazon Translate Translate-Lösungen zu verfolgen und Alarme einzurichten, die Sie benachrichtigen, wenn eine oder mehrere Metriken einen definierten Schwellenwert überschreiten. Sie können beispielsweise die Anzahl der Anfragen an Amazon Translate in einem bestimmten Zeitraum überwachen, die Latenz von Anfragen einsehen oder einen Alarm auslösen, wenn Fehler einen Schwellenwert überschreiten. ### CloudWatch Metriken für Amazon Translate verstehen Um Metriken für Ihre Amazon Translate Translate-Operationen zu erhalten, geben Sie die folgenden Informationen an: + Die Metrikdimension. Eine *Dimension* bezeichnet eine Reihe von Name-Wert-Paaren, mit denen eine Metrik eindeutig identifiziert wird. Amazon Translate hat zwei Dimensionen: + `Operation` + `Language pair` + Den Namen der Kennzahl wie `SuccessfulRequestCount` oder `RequestCharacters`. Eine vollständige Liste der Metriken finden Sie unter [CloudWatch Metriken für Amazon Translate](translate-cloudwatch.md#translate-cloudwatch-metrics). Sie können Metriken für Amazon Translate mit der AWS-Managementkonsole AWS CLI, der oder der CloudWatch API abrufen. Sie können die CloudWatch API über eines der Amazon AWS Software Development Kits (SDKs) oder die CloudWatch API-Tools verwenden. In der folgenden Tabelle sind einige gängige Verwendungszwecke für CloudWatch Metriken aufgeführt. Es handelt sich dabei um Vorschläge für den Einstieg und nicht um eine umfassende Liste. | Wie gehe ich vor? | Überwachen Sie diese Metrik | | --- | --- | | Anzahl erfolgreicher Anforderungen verfolgen | Die Statistik sum der Metrik SuccessfulRequestCount | | Erreichen des maximalen Durchsatzes der Anwendung ermitteln | Die Statistik sum der Metrik ThrottledCount | | Reaktionszeit der Anwendung ermitteln | Die Statistik average der Metrik ResponseTime | | Anzahl der Fehler für die Anwendung ermitteln | Die Statistik sum der Metriken ServerErrorCount und UserErrorCount | | Anzahl der kostenpflichtigen Zeichen ermitteln | Die Statistik sum der Metrik CharacterCount | Sie müssen über die entsprechenden CloudWatch Berechtigungen verfügen, um Amazon Translate überwachen zu können. CloudWatch Weitere Informationen finden Sie unter [Authentifizierung und Zugriffskontrolle für Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html) *im CloudWatch Amazon-Benutzerhandbuch*. ### Amazon Translate-Metriken anzeigen Sehen Sie sich Amazon Translate Translate-Metriken in der CloudWatch Konsole an. **Um Metriken anzuzeigen (CloudWatch Konsole)** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Wählen Sie **Metrics (Metriken)**, **All Metrics (Alle Metriken)** und dann **AWS/Translate (AWS/Übersetzen)**. 1. Wählen Sie die Dimension, den Namen einer Metrik und schließlich **Add to graph (Dem Diagramm hinzufügen)**. 1. Wählen Sie einen Wert für den Datumsbereich aus. Die Anzahl der Metriken für den angegebenen Datumsbereich wird im Diagramm angezeigt. # Protokollieren Amazon Translate Translate-API-Aufrufen mit AWS CloudTrail Amazon Translate ist in einen Service integriert AWS CloudTrail, der eine Aufzeichnung der von einer IAM-Entität oder einem AWS IAM-Dienst in Amazon Translate ausgeführten Aktionen bereitstellt. CloudTrail erfasst alle API-Aufrufe für Amazon Translate als Ereignisse. Dazu gehören Aufrufe von der Amazon Translate Translate-Konsole und Code-Aufrufe der Amazon Translate Translate-API-Operationen. Wenn Sie einen CloudTrail Trail erstellen, können Sie die kontinuierliche Übermittlung von CloudTrail Ereignissen, einschließlich Ereignissen für Amazon Translate, an einen Amazon Simple Storage Service (Amazon S3) -Bucket aktivieren. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im **Ereignisverlauf** anzeigen. Sie können die von gesammelten Informationen verwenden, CloudTrail um die Anfrage, die an Amazon Translate gestellt wurde, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details zu ermitteln. Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). **Topics** + [ ## Amazon Translate Informationen in CloudTrail ](#translate-info-in-cloudtrail) + [ ## Grundlegendes zu Amazon Translate Translate-Protokolldateieinträgen ](#understanding-translate-entries) ## Amazon Translate Informationen in CloudTrail CloudTrail ist für Ihr AWS Konto aktiviert, wenn Sie das Konto erstellen. Wenn eine Aktivität in Amazon Translate stattfindet, wird diese Aktivität zusammen mit anderen AWS Serviceereignissen in der CloudTrail **Ereignishistorie in einem Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem AWS Konto ansehen, suchen und herunterladen. Weitere Informationen finden Sie unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Für eine fortlaufende Aufzeichnung von Ereignissen in Ihrem AWS Konto, einschließlich Ereignissen für Amazon Translate, erstellen Sie einen Trail. Ein *Trail* ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail mit der Konsole erstellen, gilt dieser standardmäßig für alle AWS-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen in der AWS -Partition und stellt die Protokolldateien für den von Ihnen angegebenen S3 Bucket bereit. Sie können andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier: + [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [ CloudTrail Unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) von mehreren Konten Alle Amazon Translate Translate-Aktionen werden von der API-Referenz protokolliert CloudTrail und sind im [API-Referenzabschnitt](https://docs.aws.amazon.com/translate/latest/dg/API_Operations.html) dokumentiert. Beispielsweise generieren Aufrufe von `ImportTerminology` und `TranslateText` Aktionen Einträge in den CloudTrail Protokolldateien. `DeleteTerminology` Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Mit diesen Informationen können Sie Folgendes bestimmen: + Ob die Anfrage mit den Root-Benutzeranmeldedaten gestellt wurde + Ob die Anfrage mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen föderierten Benutzer ausgeführt wurde + Ob die Anfrage von einem anderen AWS Dienst gestellt wurde Weitere Informationen finden Sie unter [CloudTrail -Element userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## Grundlegendes zu Amazon Translate Translate-Protokolldateieinträgen Ein *Trail* ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden. Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die `TranslateText` Aktion demonstriert. ``` { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/Administrator", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "Administrator" }, "eventTime": "2019-09-03T20:32:50Z", "eventSource": "translate.amazonaws.com", "eventName": "TranslateText", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "aws-cli/1.16.207 Python/3.4.7 Linux/4.9.184-0.1.ac.235.83.329.metal1.x86_64 botocore/1.12.197", "requestParameters": { "text": "HIDDEN_DUE_TO_SECURITY_REASONS", "sourceLanguageCode": "en", "targetLanguageCode": "fr" }, "responseElements": { "translatedText": "HIDDEN_DUE_TO_SECURITY_REASONS", "sourceLanguageCode": "en", "targetLanguageCode": "fr" }, "requestID": "f56da956-284e-4983-b6fc-59befa20e2bf", "eventID": "1dc75278-84d7-4bb2-861a-493d08d67391", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ``` # CloudWatch Metriken und Dimensionen für Amazon Translate Verwenden Sie die CloudWatch Amazon-Metriken und -Dimensionen für Amazon Translate, um die Leistung Ihrer Lösung zu überwachen. ## CloudWatch Metriken für Amazon Translate | Metrik | Description | | --- | --- | | CharacterCount | Die Anzahl kostenpflichtiger Zeichen in Anforderungen. Gültige Dimensionen: Sprachpaar, Operation Gültige Statistiken: Durchschnitt, Maximum, Minimum, Summe Einheit: Anzahl | | ResponseTime | Die zur Beantwortung einer Anforderung erforderliche Zeit. Gültige Dimensionen: Sprachpaar, Operation Gültige Statistiken: Datenabtastungen, Durchschnitt Einheit: Zählen Sie für Datenproben. Millisekunden für Durchschnittsstatistiken. | | ServerErrorCount | Die Anzahl von Server-Fehlern. Der HTTP-Antwortcodebereich für einen Serverfehler lautet 500 bis 599. Gültige Dimension: Operation Gültige Statistiken: Durchschnitt, Summe Einheit: Anzahl | | SuccessfulRequestCount | Die Anzahl der erfolgreichen Übersetzungsanfragen. Der Antwortcodebereich für eine erfolgreiche Anforderung lautet 200 bis 299. Gültige Dimension: Operation Gültige Statistiken: Durchschnitt, Summe Einheit: Anzahl | | ThrottledCount | Die Anzahl der Anfragen, die einer Drosselung unterliegen. Verwenden Sie diese Option`ThrottledCount`, um festzustellen, ob Ihre Anwendung Anfragen schneller an Amazon Translate sendet, als Ihr Konto für deren Annahme konfiguriert ist. Weitere Informationen finden Sie unter [Amazon Translate Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate) in der *Allgemeine Amazon Web Services-Referenz*. Gültige Dimension: Operation Gültige Statistiken: Durchschnitt, Summe Einheit: Anzahl | | UserErrorCount | Die Anzahl der aufgetretenen Benutzerfehler. Der HTTP-Antwortcodebereich für einen Benutzerfehler reicht von 400 bis 499. Gültige Dimension: Operation Gültige Statistiken: Durchschnitt, Summe Einheit: Anzahl | ## CloudWatch Abmessungen für Amazon Translate Verwenden Sie die folgenden Dimensionen, um Amazon Translate Translate-Metriken zu filtern. Kennzahlen werden nach Ausgangs- und nach Zielsprache gruppiert. | Dimension | Description | | --- | --- | | LanguagePair | Beschränkt die Kennzahlen auf solche, die die angegebenen Sprachen enthalten. | | Operation | Beschränkt die Kennzahlen auf solche mit der angegebenen Operation. | # Überwachung von Amazon Translate Translate-Ereignissen mit Amazon EventBridge Amazon Translate ist in Amazon integriert EventBridge , um Sie über Änderungen zu informieren, die sich auf Ihre Übersetzungsaufträge und parallel Datenressourcen auswirken. Ereignisse aus AWS Diensten werden nahezu EventBridge in Echtzeit übermittelt. Sie können einfache Regeln schreiben, um anzugeben, welche Ereignisse für Sie interessant sind und welche automatisierten Aktionen durchgeführt werden sollen, wenn sich für ein Ereignis eine Übereinstimmung mit einer Regel ergibt. Zu den Aktionen, die automatisch gestartet werden können, gehören beispielsweise: + Eine AWS Lambda Funktion aufrufen + Aufrufen des AWS Systems Manager Manager-Ausführungsbefehls + Weiterleiten des Ereignisses an Amazon Kinesis Data Streams + Aktivierung einer AWS Step Functions Zustandsmaschine + Benachrichtigen eines Amazon SNS-Themas oder einer Amazon SQS-Warteschlange Weitere Informationen finden Sie im [* EventBridge Amazon-Benutzerhandbuch unter Erstellen von EventBridge Amazon-Regeln*, die auf Ereignisse reagieren](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html). ## Amazon Translate Translate-Ereignisse Im Folgenden finden Sie Beispielereignisse von Amazon Translate. ### Ereignisse für Batch-Übersetzungsaufträge Sie führen Batch-Übersetzungsaufträge mithilfe der Amazon Translate Translate-Konsole oder des [StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_StartTextTranslationJob.html)Vorgangs aus. Amazon Translate sendet Ereignisse, wenn diese Jobs erfolgreich oder erfolglos abgeschlossen wurden. Diese Ereignisse ähneln dem folgenden Beispiel. ``` { "version": "0", "id": "CWE-event-id", "detail-type": "Translate TextTranslationJob State Change", "source": "aws.translate", "account": "111122223333", "time": "2017-04-22T03:31:47Z", "region": "us-east-1", "resources": [], "detail": { "jobId": "01234567-0123-0123-0123-012345678901", "jobStatus": "STATUS" } } ``` Der Wert für das `jobStatus` Attribut hängt vom Auftragsstatus ab, für den Amazon Translate das Ereignis gesendet hat. Die Werte für `jobStatus` sind: + `COMPLETED`— Der Job wurde erfolgreich abgeschlossen und die Ausgabe ist verfügbar. + `COMPLETED_WITH_ERROR`— Der Job wurde mit Fehlern abgeschlossen. Die Fehler können in der Ausgabe des Jobs analysiert werden. + `STOPPED`— Der Job wurde gestoppt. + `FAILED`— Der Job wurde nicht abgeschlossen. Verwenden Sie die [DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_DescribeTextTranslationJob.html)Operation, um Details zu erhalten. ### Ereignisse für parallel Datenressourcen Wenn Sie Amazon Translate verwenden, um eine parallel Datenressource zu erstellen oder zu aktualisieren, sendet es ein Ereignis, das angibt, ob der Vorgang erfolgreich war oder nicht. Sie erstellen parallel Datenressourcen mithilfe der Amazon Translate Translate-Konsole oder des [CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html)Vorgangs. Wenn Sie dies tun, sendet Amazon Translate ein Ereignis wie das Folgende. ``` { "version": "0", "id": "CWE-event-id", "detail-type": "Translate Parallel Data State Change", "source": "aws.translate", "account": "111122223333", "time": "2017-04-22T03:31:47Z", "region": "us-east-1", "resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData], "detail": { "operation": "CreateParallelData", "name": "ExampleParallelData", "status": "STATUS" } } ``` Die Werte für das `status` Attribut sind: + `ACTIVE`— Der `CreateParallelData ` Vorgang war erfolgreich und die Ressource kann von Ihnen verwendet werden. + `FAILED`— Der `CreateParallelData` Vorgang ist fehlgeschlagen. Sie aktualisieren parallel Datenressourcen mithilfe der Amazon Translate Translate-Konsole oder des [UpdateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_UpdateParallelData.html)Vorgangs. Wenn Sie dies tun, sendet Amazon Translate ein Ereignis wie das Folgende. ``` { "version": "0", "id": "CWE-event-id", "detail-type": "Translate Parallel Data State Change", "source": "aws.translate", "account": "111122223333", "time": "2017-04-22T03:31:47Z", "region": "us-east-1", "resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData], "detail": { "operation": "UpdateParallelData", "name": "ExampleParallelData", "status": "STATUS", "latestUpdateAttemptStatus": "STATUS", "latestUpdateAttemptAt": "2017-04-22T03:31:47Z" } } ``` Das `status` Attribut gibt den Status der vorherigen Version der parallel Datenressource an, die durch das Update ersetzt wird. Die Werte sind: + `ACTIVE`— Die vorherige Version wurde erfolgreich erstellt oder aktualisiert. + `FAILED`— Die vorherige Version konnte nicht erstellt oder aktualisiert werden. Das `latestUpdateAttemptStatus` Attribut gibt den Status der neuen Version der parallel Datenressource an, die durch das Update erstellt wird. Die Werte sind: + `ACTIVE`— Der `UpdateParallelData` Vorgang war erfolgreich und die aktualisierte Ressource ist für Sie einsatzbereit. + `FAILED`— Der `UpdateParallelData` Vorgang ist fehlgeschlagen.