Nach reiflicher Überlegung haben wir uns entschieden, Amazon Kinesis Data Analytics für SQL-Anwendungen einzustellen:
1. Ab dem **1. September 2025** werden wir keine Bugfixes für Amazon Kinesis Data Analytics for SQL-Anwendungen bereitstellen, da wir aufgrund der bevorstehenden Einstellung nur eingeschränkten Support dafür haben werden.
2. Ab dem **15. Oktober 2025** können Sie keine neuen Kinesis Data Analytics for SQL-Anwendungen mehr erstellen.
3. Wir werden Ihre Anwendungen ab dem **27. Januar 2026** löschen. Sie können Ihre Amazon Kinesis Data Analytics for SQL-Anwendungen nicht starten oder betreiben. Ab diesem Zeitpunkt ist kein Support mehr für Amazon Kinesis Data Analytics for SQL verfügbar. Weitere Informationen finden Sie unter [Einstellung von Amazon Kinesis Data Analytics für SQL-Anwendungen](discontinuation.md).
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 mit Amazon CloudWatch
Sie können Anwendungen mit Amazon überwachen CloudWatch. CloudWatch sammelt und verarbeitet Rohdaten in lesbare Messwerte, die nahezu in Echtzeit verfügbar sind. Diese Statistiken werden für einen Zeitraum von zwei Wochen gespeichert. Sie können auf die Verlaufsdaten zugreifen und sich einen besseren Eindruck von der Leistung Ihrer Webanwendung oder Ihres Service verschaffen. Standardmäßig werden Metrikdaten automatisch an gesendet CloudWatch. Weitere Informationen finden Sie unter [Was ist Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) im * CloudWatch Amazon-Benutzerhandbuch*.
**Topics**
+ [Metriken und Dimensionen](monitoring-metrics.md)
+ [Anzeigen von -Metriken und -Dimensionen](metrics-dimensions.md)
+ [CloudWatch Alarme zur Überwachung erstellen](creating-alarms.md)
+ [Mit Amazon CloudWatch Logs arbeiten](cloudwatch-logs.md)
# Metriken und Dimensionen
Der `AWS/KinesisAnalytics`-Namespace enthält die folgenden Metriken.
| Metrik | Description |
| --- | --- |
| `Bytes` | Anzahl der gelesenen (pro Eingabe-Stream) oder geschriebenen (pro Ausgabe-Stream) Byte. Ebenen: Pro Eingabe-Stream und pro Ausgabe-Stream |
| `KPUs` | Die Anzahl der Kinesis Processing Units, die zum Ausführen der Anwendung für die Stream-Verarbeitung verwendet werden. Die durchschnittliche Anzahl der KPUs Nutzer pro Stunde bestimmt die Abrechnung für Ihre Anwendung. Ebenen: Anwendungsebene |
| `MillisBehindLatest` | Gibt an, mit welcher zeitlichen Differenz zur aktuellen Zeit eine Anwendung von der Streaming-Quelle liest. Ebenen: Anwendungsebene |
| `Records` | Anzahl der gelesenen (pro Eingabe-Stream) oder geschriebenen (pro Ausgabe-Stream) Datensätze. Ebenen: Pro Eingabe-Stream und pro Ausgabe-Stream |
| `Success` | 1 für jeden erfolgreichen Zustellungsversuch an das für die Anwendung konfigurierte Ziel, 0 für jeden fehlgeschlagenen Zustellungsversuch. Der durchschnittliche Wert dieser Metrik zeigt an, wie viele erfolgreiche Zustellungen erfolgt sind. Ebenen: pro Ziel |
| `InputProcessing.Duration` | Die Zeit, die für jeden AWS Lambda Funktionsaufruf benötigt wurde, der von ausgeführt wurde. Ebenen: Pro Eingabe-Stream |
| `InputProcessing.OkRecords ` | Die Anzahl der von einer Lambda-Funktion zurückgegebenen Datensätze mit dem Status `Ok`. Ebenen: Pro Eingabe-Stream |
| `InputProcessing.OkBytes ` | Die Byte-Summe der mit dem Status `Ok` markierten Datensätze, die von einer Lambda-Funktion zurückgegeben wurden. Ebenen: Pro Eingabe-Stream |
| `InputProcessing.DroppedRecords ` | Die Anzahl der von einer Lambda-Funktion zurückgegebenen Datensätze mit dem Status `Dropped`. Ebenen: Pro Eingabe-Stream |
| `InputProcessing.ProcessingFailedRecords ` | Die Anzahl der von einer Lambda-Funktion zurückgegebenen Datensätze mit dem Status `ProcessingFailed`. Ebenen: Pro Eingabe-Stream |
| `InputProcessing.Success` | Die Anzahl der durch Lambda erfolgreich ausgeführten Aufrufe pro Ebenen: Pro Eingabe-Stream |
| `LambdaDelivery.OkRecords` | Die Anzahl der von einer Lambda-Funktion zurückgegebenen Datensätze mit dem Status `Ok`. Stufen: Pro Lambda-Ziel |
| `LambdaDelivery.DeliveryFailedRecords` | Die Anzahl der von einer Lambda-Funktion zurückgegebenen Datensätze mit dem Status `DeliveryFailed`. Stufen: Pro Lambda-Ziel |
| `LambdaDelivery.Duration` | Die Zeit, die für den Aufruf einer Lambda-Funktion benötigt wird pro Stufen: Pro Lambda-Ziel |
Stellt Metriken für die folgenden Dimensionen bereit.
| Dimension | Description |
| --- | --- |
| `Flow` | Pro Eingabe-Stream: Eingabe Pro Ausgabe-Stream: Ausgabe |
| `Id` | Pro Eingabe-Stream: Eingabe-ID Pro Ausgabe-Stream: Ausgabe-ID |
# Anzeigen von -Metriken und -Dimensionen
Wenn Ihre Anwendung Datenströme verarbeitet, sendet sie die folgenden Metriken und Dimensionen an CloudWatch. Sie können die folgenden Vorgehensweisen nutzen, um die Metriken für anzuzeigen.
Metriken sind in der Konsole zuerst nach dem Service-Namespace und dann nach verschiedenen Dimensionskombinationen innerhalb eines Namespace gruppiert.
**So zeigen Sie Metriken mit der CloudWatch Konsole an**
1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im Navigationsbereich **Metrics** (Metriken) aus.
1. Wählen Sie im Bereich **CloudWatch Metriken nach Kategorie** für eine Metrikkategorie aus.
1. Führen Sie im oberen Bereich einen Bildlauf durch, um die vollständige Liste der Metriken anzuzeigen.
**Um Metriken anzuzeigen, verwenden Sie AWS CLI**
+ Geben Sie als Eingabeaufforderung den folgenden Befehl ein.
```
1. aws cloudwatch list-metrics --namespace "AWS/KinesisAnalytics" --region region
```
Metriken werden auf den folgenden Ebenen gesammelt:
+ Anwendung
+ Eingabe-Stream
+ Ausgabe-Stream
# CloudWatch Alarme zur Überwachung erstellen
Sie können einen CloudWatch Amazon-Alarm erstellen, der eine Amazon SNS-Nachricht sendet, wenn sich der Status des Alarms ändert. Ein Alarm überwacht eine Metrik über einen bestimmten, von Ihnen festgelegten 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. Damit ein CloudWatch Alarm eine Aktion auslöst, muss sich der Status geändert haben und für einen bestimmten Zeitraum beibehalten worden sein.
Sie können Alarme mithilfe der CloudWatch API AWS-Managementkonsole CloudWatch AWS CLI, oder einrichten, wie im Folgenden beschrieben.
**Um mit der CloudWatch Konsole einen Alarm einzustellen**
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 **Alarm erstellen** aus. Der **Create Alarm Wizard (Assistent zur Alarmerstellung)** wird gestartet.
1. Wählen Sie **Kinesis Analytics Metrics (Amazon-Kinesis-Analytics-Metriken)** aus. Scrollen Sie dann durch die -Metriken, um die Metrik zu finden, für die Sie einen Alarm setzen möchten.
Um in diesem Dialogfeld nur die -Metriken anzuzeigen, suchen Sie nach der Dateisystem-ID Ihres Dateisystems. Wählen Sie die Metrik, für die ein Alarm erstellt werden soll, und dann **Weiter** aus.
1. Geben Sie unter **Name**, **Description (Beschreibung)** und **Whenever (Wenn)** die Werte für die Metrik ein.
1. Wenn Sie Ihnen eine E-Mail senden CloudWatch möchten, wenn der Alarmstatus erreicht ist, wählen Sie im Feld **Wann immer dieser Alarm:** die Option **Status ist ALARM**. Wählen Sie im Feld **Send notification to:** (Benachrichtigung senden an:) ein SNS-Thema aus. Wenn Sie **Create topic** auswählen, können Sie den Namen und die E-Mail Adressen für eine neue E-Mail-Abonnementliste einrichten. Diese Liste wird gespeichert und erscheint für künftige Alarme in der Liste.
**Anmerkung**
Wenn Sie **Create topic (Thema erstellen)** verwenden, um ein neues Amazon-SNS-Thema einzurichten, müssen die E-Mail Adressen überprüft werden, bevor die Empfänger Benachrichtigungen erhalten. E-Mail Nachrichten werden nur gesendet, wenn der Alarm in einen Alarmzustand wechselt. Wenn es zu dieser Änderung des Alarmzustands kommt, bevor die E-Mail Adressen überprüft wurden, erhalten die Empfänger keine Benachrichtigung.
1. Überprüfen Sie im **Alarm Preview** den Alarm, den Sie gerade erstellen.
1. Wählen Sie **Create Alarm**, um den Alarm zu erstellen.
**So richten Sie einen Alarm mit der CloudWatch CLI ein**
+ Rufen Sie die Seite `[mon-put-metric-alarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/cli-mon-put-metric-alarm.html)` auf. Weitere Informationen finden Sie in der [Amazon CloudWatch CLI Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/).
**So richten Sie mithilfe der CloudWatch API einen Alarm ein**
+ Rufen Sie die Seite `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)` auf. Weitere Informationen finden Sie in der [Amazon CloudWatch API-Referenz](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
# Mit Amazon CloudWatch Logs arbeiten
Wenn eine -Anwendung falsch konfiguriert ist, kann sie beim Start in den Status „Running“ (Wird ausgeführt) wechseln. Auch ist es möglich, dass die Anwendung Daten aus dem In-Application-Eingabe-Stream aktualisieren, jedoch nicht verarbeiten kann. Indem Sie der Anwendung eine CloudWatch Protokolloption hinzufügen, können Sie nach Problemen mit der Anwendungskonfiguration suchen.
Kann unter folgenden Bedingungen Konfigurationsfehler generieren:
+ Der Kinesis-Datenstrom, der für die Eingabe genutzt wird, ist nicht vorhanden.
+ Der Amazon Data Firehose-Lieferstream, der für die Eingabe verwendet wurde, ist nicht vorhanden.
+ Der als Referenzdatenquelle verwendete Amazon-S3-Bucket ist nicht vorhanden.
+ Die in der Referenzdatenquelle in dem S3-Bucket angegebene Datei ist nicht vorhanden.
+ Die richtige Ressource ist in der Rolle AWS Identity and Access Management (IAM), die die entsprechenden Berechtigungen verwaltet, nicht definiert.
+ Die richtige Berechtigung ist in der IAM-Rolle, die die damit verbundenen Berechtigungen verwaltet, nicht definiert.
+ ist nicht berechtigt, die IAM-Rolle anzunehmen, die die damit verbundenen Berechtigungen verwaltet.
Weitere Informationen zu Amazon CloudWatch finden Sie im [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
## Die PutLogEvents Richtlinienaktion wird hinzugefügt
benötigt Berechtigungen zum Schreiben von Fehlern bei Fehlkonfigurationen. CloudWatch Sie können diese Berechtigungen für die IAM-Rolle, die annehmen soll, wie folgt hinzufügen. Weitere Informationen zur Verwendung der IAM-Rolle finden Sie unter [Identitäts- und Zugriffsverwaltung in Kinesis Data Analytics](iam-role.md).
### Vertrauensrichtlinie
Zum Erteilen von -Berechtigungen, um eine IAM-Rolle anzunehmen, können Sie an die Rolle die folgenden Vertrauensrichtlinien anhängen.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "kinesisanalytics.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
### Berechtigungsrichtlinie
Um einer Anwendung Berechtigungen zum Schreiben von Protokollereignissen CloudWatch aus einer Ressource zu erteilen, können Sie die folgende IAM-Berechtigungsrichtlinie verwenden.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Stmt0123456789000",
"Effect": "Allow",
"Action": [
"logs:PutLogEvents"
],
"Resource": [
"arn:aws:logs:us-east-1:123456789012:log-group:my-log-group:log-stream:my-log-stream*"
]
}
]
}
```
------
## Hinzufügen einer Überwachung auf Konfigurationsfehler
Verwenden Sie die folgenden API-Aktionen, um einer neuen oder vorhandenen Anwendung eine CloudWatch Protokolloption hinzuzufügen oder eine Protokolloption für eine bestehende Anwendung zu ändern.
**Anmerkung**
Derzeit können Sie einer Anwendung nur mithilfe von API-Aktionen eine CloudWatch Protokolloption hinzufügen. Sie können CloudWatch Protokolloptionen nicht über die Konsole hinzufügen.
### Hinzufügen einer CloudWatch Protokolloption beim Erstellen einer Anwendung
Das folgende Codebeispiel zeigt, wie Sie die `CreateApplication` Aktion verwenden, um beim Erstellen einer Anwendung eine CloudWatch Protokolloption hinzuzufügen. Weitere Informationen zu `Create_Application` finden Sie unter [CreateApplication](API_CreateApplication.md).
```
{
"ApplicationCode": "",
"ApplicationDescription": "",
"ApplicationName": "",
"Inputs": [ ... ],
"Outputs": [ ... ],
"CloudWatchLoggingOptions": [{
"LogStreamARN": "",
"RoleARN": ""
}]
}
```
### Hinzufügen einer CloudWatch Protokolloption zu einer vorhandenen Anwendung
Das folgende Codebeispiel zeigt, wie Sie die `AddApplicationCloudWatchLoggingOption`-Aktion nutzen können, um einer bestehenden Anwendung eine CloudWatch-Protokollierungsoption hinzuzufügen. Mehr über `AddApplicationCloudWatchLoggingOption` erfahren Sie unter [AddApplicationCloudWatchLoggingOption](API_AddApplicationCloudWatchLoggingOption.md).
```
{
"ApplicationName": "",
"CloudWatchLoggingOption": {
"LogStreamARN": "",
"RoleARN": ""
},
"CurrentApplicationVersionId":
}
```
### Aktualisierung einer vorhandenen CloudWatch Protokolloption
Das folgende Codebeispiel zeigt, wie die `UpdateApplication` Aktion verwendet wird, um eine vorhandene CloudWatch Protokolloption zu ändern. Mehr über `UpdateApplication` erfahren Sie unter [UpdateApplication](API_UpdateApplication.md).
```
{
"ApplicationName": "",
"ApplicationUpdate": {
"CloudWatchLoggingOptionUpdates": [
{
"CloudWatchLoggingOptionId": "",
"LogStreamARNUpdate": "",
"RoleARNUpdate": ""
}
],
},
"CurrentApplicationVersionId":
}
```
### Löschen einer CloudWatch Protokolloption aus einer Anwendung
Das folgende Codebeispiel zeigt, wie die `DeleteApplicationCloudWatchLoggingOption` Aktion zum Löschen einer vorhandenen CloudWatch Protokolloption verwendet wird. Mehr über `DeleteApplicationCloudWatchLoggingOption` erfahren Sie unter [DeleteApplicationCloudWatchLoggingOption](API_DeleteApplicationCloudWatchLoggingOption.md).
```
{
"ApplicationName": "",
"CloudWatchLoggingOptionId": "",
"CurrentApplicationVersionId":
}
```
## Konfigurationsfehler
Die folgenden Abschnitte enthalten Informationen zu Fehlern, die in Amazon CloudWatch Logs aufgrund einer falsch konfigurierten Anwendung auftreten können.
### Format der Fehlermeldungen
Die Fehlermeldungen, die aufgrund von Fehlkonfigurationen von Anwendungen generiert werden, haben das folgende Format.
```
{
"applicationARN": "string",
"applicationVersionId": integer,
"messageType": "ERROR",
"message": "string",
"inputId": "string",
"referenceId": "string",
"errorCode": "string"
"messageSchemaVersion": "integer",
}
```
Die Felder in Fehlermeldungen können die folgenden Informationen enthalten:
+ `applicationARN`: der Amazon-Ressourcenname (ARN) der Anwendung, die den Fehler erzeugt hat. Beispiel: `arn:aws:kinesisanalytics:us-east-1:112233445566:application/sampleApp`
+ `applicationVersionId`: die Version der Anwendung zu dem Zeitpunkt, zu dem der Fehler aufgetreten ist. Weitere Informationen finden Sie unter [ApplicationDetail](API_ApplicationDetail.md).
+ `messageType`: der Typ der Mitteilung. Derzeit kann dieser Typ nur `ERROR` sein.
+ `message`: die Fehlerdetails. Beispiel:
```
There is a problem related to the configuration of your input. Please check that the resource exists, the role has the correct permissions to access the resource and that Kinesis Analytics can assume the role provided.
```
+ `inputId`: die der Anwendungseingabe zugeordnete ID. Dieser Wert ist nur vorhanden, wenn diese Eingabe die Ursache des Fehlers ist. Dieser Wert ist nicht vorhanden, wenn `referenceId` verfügbar ist. Weitere Informationen finden Sie unter [DescribeApplication](API_DescribeApplication.md).
+ `referenceId`: die der Referenzdatenquelle der Anwendung zugeordnete ID. Dieser Wert ist nur vorhanden, wenn diese Quelle die Ursache des Fehlers ist. Dieser Wert ist nicht vorhanden, wenn `inputId` verfügbar ist. Weitere Informationen finden Sie unter [DescribeApplication](API_DescribeApplication.md).
+ `errorCode`: die Kennung des Fehlers. Diese ID ist entweder `InputError` oder `ReferenceDataError`.
+ `messageSchemaVersion`: ein Wert, der die aktuelle Version des Meldungsschemas angibt, zurzeit `1`. Sie können diesen Wert überprüfen, um festzustellen, ob das Fehlermeldungsschema aktualisiert wurde.
### Fehler
Zu den Fehlern, die möglicherweise in CloudWatch Logs für angezeigt werden, gehören die folgenden.
#### Ressource ist nicht vorhanden
Wenn ein ARN für einen nicht vorhandenen Kinesis-Eingabe-Stream angegeben wird, der ARN aber syntaktisch korrekt ist, wird eine Fehlermeldung der folgenden Art angezeigt.
```
{
"applicationARN": "arn:aws:kinesisanalytics:us-east-1:112233445566:application/sampleApp",
"applicationVersionId": "5",
"messageType": "ERROR",
"message": "There is a problem related to the configuration of your input. Please check that the resource exists, the role has the correct permissions to access the resource and that Kinesis Analytics can assume the role provided.",
"inputId":"1.1",
"errorCode": "InputError",
"messageSchemaVersion": "1"
}
```
Wenn ein falscher Amazon-S3-Dateischlüssel für Referenzdaten verwendet wird, wird ein Fehler wie der folgende generiert:
```
{
"applicationARN": "arn:aws:kinesisanalytics:us-east-1:112233445566:application/sampleApp",
"applicationVersionId": "5",
"messageType": "ERROR",
"message": "There is a problem related to the configuration of your reference data. Please check that the bucket and the file exist, the role has the correct permissions to access these resources and that Kinesis Analytics can assume the role provided.",
"referenceId":"1.1",
"errorCode": "ReferenceDataError",
"messageSchemaVersion": "1"
}
```
#### Rolle ist nicht vorhanden
Wenn ein ARN wird für eine IAM-Eingaberolle angegeben wird, die nicht vorhanden ist, aber die ARN syntaktisch korrekt ist, wird ein Fehler wie folgt generiert.
```
{
"applicationARN": "arn:aws:kinesisanalytics:us-east-1:112233445566:application/sampleApp",
"applicationVersionId": "5",
"messageType": "ERROR",
"message": "There is a problem related to the configuration of your input. Please check that the resource exists, the role has the correct permissions to access the resource and that Kinesis Analytics can assume the role provided.",
"inputId":null,
"errorCode": "InputError",
"messageSchemaVersion": "1"
}
```
#### Rolle hat keine Berechtigung zum Zugriff auf die Ressource
Wenn eine Eingaberolle verwendet wird, die nicht über die erforderlichen Berechtigungen für den Zugriff auf Eingaberessourcen wie etwa einen Kinesis-Quell-Stream verfügt, wird eine Fehlermeldung der folgenden Art angezeigt.
```
{
"applicationARN": "arn:aws:kinesisanalytics:us-east-1:112233445566:application/sampleApp",
"applicationVersionId": "5",
"messageType": "ERROR",
"message": "There is a problem related to the configuration of your input. Please check that the resource exists, the role has the correct permissions to access the resource and that Kinesis Analytics can assume the role provided.",
"inputId":null,
"errorCode": "InputError",
"messageSchemaVersion": "1"
}
```