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. # Veröffentlichen von Aurora-PostgreSQL-Protokollen in Amazon CloudWatch Logs Sie können Ihren Aurora-PostgreSQL-DB-Cluster so konfigurieren, dass Protokolldaten regelmäßig in Amazon CloudWatch Logs exportiert werden. Wenn Sie dies tun, werden Ereignisse aus dem PostgreSQL-Protokoll Ihres Aurora-PostgreSQL-DB-Clusters automatisch als Amazon CloudWatch Logs auf Amazon CloudWatch *veröffentlicht*. In CloudWatch finden Sie die exportierten Protokolldaten in einer *Protokollgruppe* für Ihren Aurora-PostgreSQL-DB-Cluster. Die Protokollgruppe enthält einen oder mehrere *Protokollstreams*, die die Ereignisse aus dem PostgreSQL-Protokoll von jeder Instance im Cluster enthalten. Durch die Veröffentlichung der Protokolle in CloudWatch Logs können Sie die PostgreSQL-Protokolldatensätze in einem Speicher mit hoher Beständigkeit aufbewahren. Mit den in CloudWatch Logs verfügbaren Protokolldaten können Sie den Betrieb Ihres Clusters auswerten und verbessern. Sie können CloudWatch also verwenden, um Alarme zu erstellen und Metriken anzuzeigen. Weitere Informationen hierzu finden Sie unter [Überwachen von Protokollereignissen in Amazon CloudWatch](AuroraPostgreSQL.CloudWatch.Monitor.md). **Anmerkung** Das Veröffentlichen Ihrer PostgreSQL-Protokolle in CloudWatch Logs verbraucht Speicherplatz, und für diesen Speicher fallen Gebühren an. Löschen Sie CloudWatch Logs, die nicht mehr benötigt werden. Das Deaktivieren der Option zum Exportieren von Protokollen für einen vorhandenen Aurora PostgreSQL DB-Cluster wirkt sich nicht auf Daten aus, die bereits in CloudWatch Logs gespeichert sind. Bestehende Protokolle bleiben in CloudWatch Logs verfügbar, basierend auf Ihren Protokollaufbewahrungseinstellungen. Weitere Informationen zu CloudWatch Logs finden Sie unter [Was ist CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) Aurora PostgreSQL unterstützt die Veröffentlichung von Protokollen in CloudWatch Logs für die folgenden Versionen. + 16.1 und alle höheren Versionen + 15.2 und höhere 15-Versionen + 14.3 und höhere 14-Versionen + 13.3 und höhere 13 Versionen + 12.8 und höhere 12 Versionen + 11.9 und höher 11 Versionen Informationen zum Aktivieren der Option zum Veröffentlichen von Protokollen in CloudWatch Logs, zum Überwachen von Protokollereignissen in CloudWatch Logs und zum Analysieren von Protokollen mit CloudWatch Logs Insights finden Sie in den folgenden Themen. **Topics** + [Aktivieren der Option zum Veröffentlichen von Protokollen in Amazon CloudWatch](AuroraPostgreSQL.CloudWatch.Publishing.md) + [Überwachen von Protokollereignissen in Amazon CloudWatch](AuroraPostgreSQL.CloudWatch.Monitor.md) + [Analysieren von Aurora-PostgreSQL-Protokollen mit CloudWatch Logs Insights](AuroraPostgreSQL.CloudWatch.Analyzing.md) # Aktivieren der Option zum Veröffentlichen von Protokollen in Amazon CloudWatch Um das PostgreSQL-DB-Cluster in CloudWatch Logs zu veröffentlichen, wählen Sie die Option **Log export** (Protokollexport) für den Cluster. Sie können die Log-Export-Einstellung beim Erstellen Ihres Aurora-PostgreSQL-DB-Clusters auswählen. Sie können den Cluster auch später ändern. Wenn Sie einen vorhandenen Cluster ändern, werden seine PostgreSQL-Protokolle von jeder Instance ab diesem Zeitpunkt im CloudWatch-Cluster veröffentlicht. Für Aurora PostgreSQL ist das PostgreSQL-Protokoll (`postgresql.log`) das einzige Protokoll, das auf Amazon CloudWatch veröffentlicht wird. Sie können das AWS-Managementkonsole, das AWS CLI oder die RDS-API verwenden, um die Protokollexportfunktion für Ihren Aurora PostgreSQL DB-Cluster zu aktivieren. ## Konsole Wählen Sie die Option Protokollexporte, um mit der Veröffentlichung der PostgreSQL-Protokolle aus Ihrem Aurora PostgreSQL DB-Cluster in CloudWatch Logs zu beginnen. **So aktivieren Sie die Funktion zum Exportieren von Protokollen über die Konsole** 1. Öffnen Sie die Amazon-RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Wählen Sie im Navigationsbereich **Databases (Datenbanken)** aus. 1. Wählen Sie den Aurora-PostgreSQL-DB-Cluster, für den die Protokolldaten in CloudWatch Logs veröffentlicht werden sollen. 1. Wählen Sie **Ändern** aus. 1. Wählen Sie im Abschnitt **Log exports (Protokollexporte)** die Option **PostgreSQL log** aus. 1. Wählen Sie **Continue (Weiter)** und dann auf der Übersichtsseite **Modify cluster (Cluster ändern)**. ## AWS CLI Sie können die Option zum Exportieren von Protokollen aktivieren, um die Veröffentlichung von Aurora-PostgreSQL-Protokollen in Amazon CloudWatch Logs mit AWS CLI zu starten. Hierzu führen Sie den Befehl [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) AWS CLI mit den folgenden Optionen aus: + `--db-cluster-identifier` – Die DB-Cluster-Kennung. + `--cloudwatch-logs-export-configuration` – Die Konfigurationseinstellung für die Protokolltypen, die für den Export in CloudWatch Logs für den DB-Cluster eingestellt werden sollen. Sie können Aurora-PostgreSQL-Protokolle auch veröffentlichen, indem Sie einen der folgenden AWS CLI-Befehle ausführen: + [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) + [restore-db-cluster-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-from-s3.html) + [restore-db-cluster-from-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-from-snapshot.html) + [restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) Führen Sie einen dieser AWS CLI-Befehle mit den folgenden Optionen aus: + `--db-cluster-identifier` – Die DB-Cluster-Kennung. + `--engine`— Die Datenbank-Engine. + `--enable-cloudwatch-logs-exports`— Konfigurationseinstellung für die Protokolltypen, die für den Export in CloudWatch Logs für den DB-Cluster aktiviert werden sollen. Je nach ausgeführtem AWS CLI-Befehl müssen möglicherweise noch weitere Optionen angegeben werden. **Example** Der folgende Befehl erstellt einen Aurora-PostgreSQL-DB-Cluster zum Veröffentlichen von Protokolldateien in CloudWatch Logs. Für Linux, macOS oder Unix: ``` 1. aws rds create-db-cluster \ 2. --db-cluster-identifier my-db-cluster \ 3. --engine aurora-postgresql \ 4. --enable-cloudwatch-logs-exports postgresql ``` Für Windows: ``` 1. aws rds create-db-cluster ^ 2. --db-cluster-identifier my-db-cluster ^ 3. --engine aurora-postgresql ^ 4. --enable-cloudwatch-logs-exports postgresql ``` **Example** Der folgende Befehl modifiziert einen vorhandenen Aurora-PostgreSQL-DB-Cluster zum Veröffentlichen von Protokolldateien in CloudWatch Logs. Der `--cloudwatch-logs-export-configuration`-Wert ist ein JSON-Objekt. Der Schlüssel für dieses Objekt ist `EnableLogTypes` und sein Wert lautet `postgresql` und `instance`. Für Linux, macOS oder Unix: ``` 1. aws rds modify-db-cluster \ 2. --db-cluster-identifier my-db-cluster \ 3. --cloudwatch-logs-export-configuration '{"EnableLogTypes":["postgresql","instance"]}' ``` Für Windows: ``` 1. aws rds modify-db-cluster ^ 2. --db-cluster-identifier my-db-cluster ^ 3. --cloudwatch-logs-export-configuration '{\"EnableLogTypes\":[\"postgresql\",\"instance\"]}' ``` Wenn Sie die Windows-Befehlszeile verwenden, stellen Sie sicher, dass Sie doppelte Anführungszeichen (") im JSON-Code maskieren, indem Sie ihnen einen umgekehrten Schrägstrich (\$1) voranstellen. **Example** Das folgende Beispiel modifiziert einen vorhandenen Aurora-PostgreSQL-DB-Cluster zum Deaktivieren der Veröffentlichung von Protokolldateien in CloudWatch Logs. Der `--cloudwatch-logs-export-configuration`-Wert ist ein JSON-Objekt. Der Schlüssel für dieses Objekt ist `DisableLogTypes` und sein Wert lautet `postgresql` und `instance`. Für Linux, macOS oder Unix: ``` aws rds modify-db-cluster \ --db-cluster-identifier mydbinstance \ --cloudwatch-logs-export-configuration '{"DisableLogTypes":["postgresql","instance"]}' ``` Für Windows: ``` aws rds modify-db-cluster ^ --db-cluster-identifier mydbinstance ^ --cloudwatch-logs-export-configuration "{\"DisableLogTypes\":[\"postgresql\",\"instance\"]}" ``` Bei Verwendung der Windows-Befehlszeile müssen doppelte Anführungszeichen (") im JSON-Code mit einem umgekehrten Schrägstrich (\$1) als Escape-Zeichen versehen werden. ## RDS-API Sie können die Log-Export-Option aktivieren, um die Veröffentlichung von Aurora-PostgreSQL-Protokollen mit der RDS-API zu starten. Hierzu führen Sie den Vorgang [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) mit den folgenden Optionen aus: + `DBClusterIdentifier` – Die DB-Cluster-ID. + `CloudwatchLogsExportConfiguration` – Konfigurationseinstellung für die Protokolltypen, die für den Export in CloudWatch Logs für den DB-Cluster aktiviert werden sollen. Sie können Aurora PostgreSQL-Protokolle auch mit der RDS-API veröffentlichen, indem Sie eine der folgenden RDS-API-Operationen ausführen: + [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) + [RestoreDBClusterFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromS3.html) + [RestoreDBClusterFromSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromSnapshot.html) + [RestoreDBClusterToPointInTime](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterToPointInTime.html) Führen Sie die RDS-API-Operation mit den folgenden Parametern aus: + `DBClusterIdentifier` – Die DB-Cluster-Kennung. + `Engine`— Die Datenbank-Engine. + `EnableCloudwatchLogsExports`— Konfigurationseinstellung für die Protokolltypen, die für den Export in CloudWatch Logs für den DB-Cluster aktiviert werden sollen. Je nach ausgeführtem AWS CLI-Befehl müssen möglicherweise noch weitere Parameter angegeben werden. # Überwachen von Protokollereignissen in Amazon CloudWatch Da Aurora PostgreSQL-Protokollereignisse veröffentlicht und als Amazon CloudWatch Logs verfügbar sind, können Sie Ereignisse mit Amazon anzeigen und überwachen. CloudWatch Weitere Informationen zur Überwachung finden Sie unter An Logs [gesendete Protokolldaten anzeigen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#ViewingLogData). CloudWatch Wenn Sie Log exports (Protokollexporte) aktivieren, wird mit dem Präfix `/aws/rds/cluster/` automatisch eine neue Protokollgruppe mit dem Namen Ihrer Aurora PostgreSQL und dem Protokolltyp, wie im folgenden Muster erstellt. ``` /aws/rds/cluster/your-cluster-name/postgresql ``` Nehmen wir als Beispiel an, dass ein Aurora PostgreSQL-DB-Cluster mit dem Namen sein Protokoll nach Amazon CloudWatch Logs `docs-lab-apg-small` exportiert. Der Name der Protokollgruppe in Amazon CloudWatch wird im Folgenden angezeigt. ``` /aws/rds/cluster/docs-lab-apg-small/postgresql ``` Wenn bereits eine Protokollgruppe mit dem angegebenen Namen existiert, verwendet Aurora diese Protokollgruppe, um Protokolldaten für den Aurora-DB-Cluster zu exportieren. Jede DB-Instance im Aurora PostgreSQL DB-Cluster lädt ihr PostgreSQL-Protokoll als eigenständigen Protokollstream in die Protokollgruppe hoch. Sie können die Protokollgruppe und ihre Protokollstreams mithilfe der verschiedenen grafischen und analytischen Tools von Amazon untersuchen CloudWatch. Sie können beispielsweise in den Protokollereignissen Ihres Aurora PostgreSQL-DB-Clusters nach Informationen suchen und Ereignisse mithilfe der CloudWatch Logs-Konsole, der oder der AWS CLI CloudWatch Logs-API filtern. Weitere Informationen finden Sie unter [Suchen und Filtern von Protokolldaten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/MonitoringLogData.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*. Standardmäßig werden neue Protokollgruppen mit **Läuft niemals ab** für ihre Aufbewahrungszeit erstellt. Sie können die CloudWatch Logs-Konsole AWS CLI, die oder die CloudWatch Logs-API verwenden, um den Aufbewahrungszeitraum für Protokolle zu ändern. Weitere Informationen finden Sie unter [Ändern der Aufbewahrung von Protokolldaten in CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*. **Tipp** Sie können die automatische Konfiguration verwenden AWS CloudFormation, um beispielsweise Protokollgruppen mit vordefinierten Aufbewahrungsfristen für Protokolle, Metrikfiltern und Zugriffsberechtigungen zu erstellen. # Analysieren von Aurora-PostgreSQL-Protokollen mit CloudWatch Logs Insights Wenn die PostgreSQL-Protokolle aus Ihrem Aurora-PostgreSQL-DB-Cluster als CloudWatch Logs veröffentlicht wurden, können Sie CloudWatch Logs Insights verwenden, um interaktiv Ihre Protokolldaten in Amazon CloudWatch Logs zu suchen und zu analysieren. CloudWatch Logs Insights umfasst eine Abfragesprache, Beispielabfragen und andere Tools zur Analyse Ihrer Protokolldaten, damit Sie potenzielle Probleme identifizieren und Korrekturen überprüfen können. Weitere Informationen finden Sie unter [Analyse von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*. **So analysieren Sie PostgreSQL-Protokolle mit CloudWatch Logs Insights** 1. Öffnen Sie die CloudWatch-Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Öffnen Sie im Navigationsbereich **Logs** (Protokolle) und wählen Sie **Log insights** (Protokoll-Erkenntnisse) aus. 1. Wählen Sie unter **Select log group(s)** (Protokollgruppe(n) auswählen) die Protokollgruppe für Ihren Aurora-PostgreSQL-DB-Cluster aus. ![\[\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-select-log-group.png) 1. Löschen Sie im Abfrage-Editor die aktuell angezeigte Abfrage und geben Sie Folgendes ein. Wählen Sie anschließend **Run query** (Abfrage ausführen) aus. ``` ##Autovacuum execution time in seconds per 5 minute fields @message | parse @message "elapsed: * s" as @duration_sec | filter @message like / automatic vacuum / | display @duration_sec | sort @timestamp | stats avg(@duration_sec) as avg_duration_sec, max(@duration_sec) as max_duration_sec by bin(5 min) ``` ![\[\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-query.png) 1. Wählen Sie die Registerkarte **Visualization (Visualisierung)** aus. ![\[\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-visualization.png) 1. Wählen Sie **Add to dashboard (Zu Dashboard hinzufügen)** aus. 1. Wählen Sie unter **Dashboard auswählen** entweder ein Dashboard aus oder geben Sie einen Namen ein, um ein neues Dashboard zu erstellen. 1. Wählen Sie unter **Widget-Typ** einen Widget-Typ für Ihre Visualisierung aus. ![\[\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-dashboard.png) 1. (Optional) Fügen Sie basierend auf Ihren Protokollabfrage-Ergebnissen weitere Widgets hinzu. 1. Wählen Sie **Add widget** aus. 1. Wählen Sie einen Widget-Typ aus, z. B. **Linie**. ![\[\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-widget.png) 1. Wählen Sie im Fenster **Zu diesem Dashboard hinzufügen** die Option **Protokolle** aus. ![\[\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-add-logs-to-dashboard.png) 1. Wählen Sie unter **Select log group(s)** die Protokollgruppe für Ihren DB-Cluster aus. 1. Löschen Sie im Abfrage-Editor die aktuell angezeigte Abfrage und geben Sie Folgendes ein. Wählen Sie anschließend **Run query** aus. ``` ##Autovacuum tuples statistics per 5 min fields @timestamp, @message | parse @message "tuples: " as @tuples_temp | parse @tuples_temp "* removed," as @tuples_removed | parse @tuples_temp "remain, * are dead but not yet removable, " as @tuples_not_removable | filter @message like / automatic vacuum / | sort @timestamp | stats avg(@tuples_removed) as avg_tuples_removed, avg(@tuples_not_removable) as avg_tuples_not_removable by bin(5 min) ``` ![\[\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-query2.png) 1. Wählen Sie **Create widget** aus. Ihr Dashboard sollte folgender Abbildung ähnlich sein. ![\[\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/apg-cwl-insights-dashboard-two-graphs.png)