Konfigurieren der Erfassung von PostgreSQL-Serverprotokollen und Updateprotokollen der Hauptversion

GILT FÜR: Azure Database for PostgreSQL – Flexibler Server

Sie können PostgreSQL-Serverprotokolle verwenden, um bestimmte Probleme zu diagnostizieren, die in einer Azure-Datenbank für PostgreSQL – Flexibler Server aufgetreten sind, und um detaillierte Einblicke zu den Aktivitäten zu erhalten, die auf Ihren Servern ausgeführt werden. Sie können Upgradeprotokolle der Hauptversion verwenden, um Fehler zu beheben, die während eines Versuchs auftreten können, ein Upgrade für Ihren Server auf eine höhere Hauptversion von PostgreSQL durchzuführen.

Standardmäßig ist das Erfassen von Serverprotokollen für den Download in einer Azure-Datenbank für PostgreSQL – Flexibler Server deaktiviert. Nachdem Sie das Feature aktiviert haben, beginnt Ihre Instanz der Azure-Datenbank für PostgreSQL – Flexibler Server jedoch mit der Erfassung der Serverprotokolle in Dateien, die Sie zur detaillierten Überprüfung herunterladen können. Sie können Azure-Portal- oder Azure CLI-Befehle verwenden, um diese Dateien aufzulisten und herunterzuladen, die Sie bei jeder Problembehandlung unterstützen können.

In diesem Artikel wird erläutert, wie Sie das Feature aktivieren und deaktivieren. Außerdem wird beschrieben, wie Sie alle verfügbaren Serverprotokolle auflisten und wie Sie sie herunterladen können.

Aktivieren der Erfassung von PostgreSQL-Serverprotokollen und Updateprotokollen der Hauptversion zum Download

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

2. Wählen Sie im Ressourcenmenü im Abschnitt Überwachung die Option Serverprotokolle aus.

   

3. Aktivieren Sie unter Serverprotokolle herunterladen das Kontrollkästchen Aktivieren.

   

4. Protokolldateien werden standardmäßig drei Tage lang aufbewahrt, aber Sie können den Aufbewahrungszeitraum anpassen, sodass er zwischen einem Tag und sieben Tage liegt. Verwenden Sie den Slicer Aufbewahrungszeitraum (in Tagen), um die gewünschte Konfiguration anzupassen.

   

5. Wählen Sie die Schaltfläche Speichern aus.

   

6. Eine Benachrichtigung informiert Sie darüber, dass der Dienst die Erfassung von Protokollen für den Download konfiguriert.

   

7. Nach Abschluss des Vorgangs informiert Sie eine Benachrichtigung darüber, dass der Dienst die Konfiguration der Erfassung von Protokollen zum Download abgeschlossen hat.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können die Erfassung von PostgreSQL-Serverprotokollen und Upgradeprotokollen der Hauptversion über den Befehl az postgres flexible-server parameter set aktivieren.

Verwenden Sie den folgenden Befehl, um die Erfassung der Protokolle zum Download zu aktivieren:

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.download_enable --value on

Verwenden Sie den folgenden Befehl, um den Aufbewahrungszeitraum für die Protokolle anzupassen, die für den Download erfasst werden:

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.retention_days --value <retention_period_in_days>

Zulässige Werte für den Serverparameter logfiles.retention_days können zwischen einem Tag und sieben Tagen liegen. Wenn Sie versuchen, ihn auf einen anderen Wert festzulegen, wird folgende Fehlermeldung angezeigt:

Code: ServerParameterToCMSUnAllowedParameterValue
Message: The value: [<value>] of Server Parameter: [logfiles.retention_days] is invalid, the allowed values are: [1-7]

Hinweis

• Ein paar Minuten nach dem Aktivieren der Erfassung von Serverprotokollen zum Download steht das erste Protokoll zum Download zur Verfügung.

• Anfangs belegen Serverprotokolle ungefähr für eine Stunde Speicherplatz auf dem Datenträger. Anschließend werden sie in den Sicherungsspeicher verschoben und dort für den konfigurierten Aufbewahrungszeitraum aufbewahrt.

Deaktivieren der Erfassung von PostgreSQL-Serverprotokollen und Updateprotokollen der Hauptversion zum Download

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

2. Wählen Sie im Ressourcenmenü im Abschnitt Überwachung die Option Serverprotokolle aus.

   

3. Deaktivieren Sie unter Serverprotokolle herunterladen das Kontrollkästchen Aktivieren.

   

4. Wählen Sie die Schaltfläche Speichern aus.

   

5. Eine Benachrichtigung informiert Sie darüber, dass der Dienst die Erfassung von Protokollen für den Download konfiguriert.

   

6. Nach Abschluss des Vorgangs informiert Sie eine Benachrichtigung darüber, dass der Dienst die Konfiguration der Erfassung von Protokollen zum Download abgeschlossen hat.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können die Erfassung von PostgreSQL-Serverprotokollen und Upgradeprotokollen der Hauptversion über den Befehl az postgres flexible-server parameter set deaktivieren.

Verwenden Sie den folgenden Befehl, um die Erfassung der Protokolle zum Download zu deaktivieren:

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.download_enable --value off

Auflisten erfasster Protokolle, die zum Download verfügbar sind

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

2. Wählen Sie im Ressourcenmenü im Abschnitt Überwachung die Option Serverprotokolle aus.

   

3. Eine Tabelle zeigt alle erfassten Protokolldateien an, die noch nicht gelöscht wurden. Dateien, die irgendwann erfasst wurden, aber gelöscht wurden, weil sie den konfigurierten Aufbewahrungszeitraum überschritten haben, sind nicht mehr sichtbar oder zugänglich. Mithilfe der Felder Suche nach einer Protokolldatei, Protokollzeitbereich und Protokolltyp können Sie Filterbedingungen definieren, um die angezeigten Protokolle zu reduzieren. Durch Auswählen einer Spaltenüberschrift können Sie die Liste der sichtbaren Protokolldateien in aufsteigender oder absteigender Reihenfolge nach dem Wert des Attributs sortieren, das durch die ausgewählte Kopfzeile dargestellt wird. Unter jeder verfügbaren Spalte können Sie die verschiedenen Attribute jeder Datei sehen:

   • Name: Name der Protokolldatei. Der Dienst weist jeder Protokolldatei einen Namen mit dem Muster postgresql_yyyy_mm_dd_hh_00_00.log zu.
   • Zeitpunkt der letzten Aktualisierung: Zeitstempel des letzten Uploads jeder Protokolldatei. Protokolldateien werden ungefähr alle zehn Minuten hochgeladen.
   • Größe: Größe in Byte, die von der Protokolldatei belegt sind.
   • Protokolltyp: Serverprotokoll gibt an, dass die Datei einem PostgreSQL-Serverprotokoll entspricht. Upgradeprotokoll gibt an, dass die Datei einem Upgradeprotokoll der Hauptversion entspricht.

   

4. Der Inhalt der Tabelle wird nicht automatisch aktualisiert. Um die neuesten Informationen anzuzeigen, können Sie Aktualisieren auswählen.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können die erfassten PostgreSQL-Serverprotokolle und Upgradeprotokolle der Hauptversion über den Befehl az postgres flexible-server server-logs list auflisten.

Um alle erfassten Protokolle aufzulisten, die zum Download verfügbar sind, die in den letzten 72 Stunden aktualisiert wurden (Standardwert), verwenden Sie diesen Befehl:

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server>

Um alle erfassten Protokolle aufzulisten, die zum Download verfügbar sind, die in den letzten zehn Stunden aktualisiert wurden, verwenden Sie diesen Befehl:

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --file-last-written 10

Um alle erfassten Protokolle aufzulisten, die zum Download verfügbar sind, deren Größe unter 30 KiB liegt, verwenden Sie diesen Befehl:

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --max-file-size 30

Um alle erfassten Protokolle aufzulisten, die zum Download verfügbar sind und deren Name 01_07 enthält, verwenden Sie diesen Befehl:

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --filename-contains 01_07

Herunterladen erfasster Protokolle, die zum Download verfügbar sind

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre Instanz von Azure Database for PostgreSQL – Flexible Server aus.

2. Wählen Sie im Ressourcenmenü im Abschnitt Überwachung die Option Serverprotokolle aus.

   

3. Eine Tabelle zeigt alle erfassten Protokolldateien an, die noch nicht gelöscht wurden. Dateien, die irgendwann erfasst wurden, aber gelöscht wurden, weil sie den konfigurierten Aufbewahrungszeitraum überschritten haben, sind nicht mehr sichtbar oder zugänglich. Mithilfe der Felder Suche nach einer Protokolldatei, Protokollzeitbereich und Protokolltyp können Sie Filterbedingungen definieren, um die angezeigten Protokolle zu reduzieren. Durch Auswählen einer Spaltenüberschrift können Sie die Liste der sichtbaren Protokolldateien in aufsteigender oder absteigender Reihenfolge nach dem Wert des Attributs sortieren, das durch die ausgewählte Kopfzeile dargestellt wird. Identifizieren Sie das Protokoll, das Sie herunterladen möchten, und wählen Sie unter der Spalte Aktionen Herunterladen aus.

   

4. Wenn Sie mehrere Protokolldateien gleichzeitig herunterladen möchten, wählen Sie alle Dateien aus, die Sie herunterladen möchten, und wählen Sie Herunterladen auf der Symbolleiste aus.

   

5. Der Inhalt der Tabelle wird nicht automatisch aktualisiert. Um die neuesten Informationen anzuzeigen, können Sie Aktualisieren auswählen.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können die erfassten PostgreSQL-Serverprotokolle und Upgradeprotokolle der Hauptversion über den Befehl az postgres flexible-server server-logs download herunterladen.

Verwenden Sie den folgenden Befehl, um ein bestimmtes Protokoll herunterzuladen:

az postgres flexible-server server-logs download --resource-group <resource_group> --server-name <server> --name <log_name>

Verwenden Sie den folgenden Befehl, um ein bestimmtes Protokoll herunterzuladen:

az postgres flexible-server server-logs download --resource-group <resource_group> --server-name <server> --name <log1_name log2_name ...logn_name>

Hinweis

• Für die Dateinamen, für die Protokolldateien mit übereinstimmenden Namen zum Download vorhanden sind, wird eine lokale Datei mit demselben Namen und denselben Inhalt erstellt.

• Wenn einer der bereitgestellten Dateinamen nicht heruntergeladen werden kann, meldet der Befehl keinen Fehler. Diese Datei wird dann einfach nicht heruntergeladen.

Zugehöriger Inhalt

• Neustarten einer Instanz von Azure Database for PostgreSQL – Flexible Server.
• Starten einer Instanz von Azure Database for PostgreSQL – Flexibler Server
• Beenden einer Instanz von Azure Database for PostgreSQL – Flexibler Server
• Neustarten einer Instanz von Azure Database for PostgreSQL – Flexible Server.
• Computeoptionen in Azure Database for PostgreSQL – Flexible Server.
• Speicheroptionen in Azure Database for PostgreSQL – Flexible Server.
• Beschränkungen in Azure Database for PostgreSQL – Flexible Server.