Vastleggen van PostgreSQL-serverlogboeken en upgradelogboeken van de primaire versie configureren

VAN TOEPASSING OP: Azure Database for PostgreSQL - Flexibele server

U kunt PostgreSQL-serverlogboeken gebruiken om specifieke problemen vast te stellen die zijn opgetreden in een flexibele Azure Database for PostgreSQL-server en om gedetailleerde inzichten te krijgen over de activiteiten die op uw servers worden uitgevoerd. U kunt logboeken voor de primaire versie-upgrade gebruiken om fouten op te lossen die kunnen optreden tijdens een poging om uw server bij te werken naar een hogere primaire versie van PostgreSQL.

Het vastleggen van serverlogboeken voor downloaden in een flexibele Azure Database for PostgreSQL-server is standaard uitgeschakeld. Nadat u de functie hebt ingeschakeld, begint uw flexibele Azure Database for PostgreSQL-server echter met het vastleggen van de serverlogboeken naar bestanden, die u kunt downloaden voor gedetailleerde inspectie. U kunt Azure Portal- of Azure CLI-opdrachten gebruiken om deze bestanden weer te geven en te downloaden die u kunnen helpen bij het oplossen van problemen.

In dit artikel wordt uitgelegd hoe u de functie inschakelt en uitschakelt. Ook wordt beschreven hoe u alle beschikbare serverlogboeken kunt weergeven en hoe u deze kunt downloaden.

Het vastleggen van PostgreSQL-serverlogboeken en de upgradelogboeken van de primaire versie inschakelen voor downloaden

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-server.

2. Selecteer serverlogboeken in het resourcemenu onder de sectie Bewaking.

   

3. Schakel onder Serverlogboeken downloaden het selectievakje Inschakelen in .

   

4. Standaard worden logboekbestanden drie dagen bewaard, maar u kunt de bewaarperiode van 1 tot 7 dagen aanpassen. Gebruik de slicer Bewaarperiode (in dagen) om de gewenste configuratie aan te passen.

   

5. Selecteer de knop Opslaan.

   

6. Een melding informeert u dat de service de registratie van logboeken configureert voor downloaden.

   

7. Zodra de bewerking is beëindigd, wordt u in een melding geïnformeerd dat de service de configuratie van het vastleggen van logboeken voor downloaden heeft voltooid.

   

CLI

U kunt het vastleggen van PostgreSQL-serverlogboeken en upgradelogboeken van de primaire versie inschakelen via de opdracht az postgres flexible-server parameter set .

Als u het vastleggen van de logboeken voor downloaden wilt inschakelen, gebruikt u deze opdracht:

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

Als u de bewaarperiode wilt aanpassen voor de logboeken die zijn vastgelegd voor downloaden, gebruikt u deze opdracht:

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

Toegestane waarden voor de serverparameter logfiles.retention_days kunnen tussen 1 en 7 dagen duren. Als u deze probeert in te stellen op een andere waarde, krijgt u deze fout:

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

Notitie

• Na het inschakelen van de opname van serverlogboeken voor downloaden, is het eerste logboek beschikbaar voor downloaden.

• In eerste instantie, en gedurende ongeveer één uur, bezetten serverlogboeken gegevensschijfruimte. Vervolgens worden ze verplaatst naar back-upopslag en daar bewaard voor de geconfigureerde bewaarperiode.

Het vastleggen van PostgreSQL-serverlogboeken en de upgradelogboeken van de primaire versie uitschakelen voor downloaden

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-server.

2. Selecteer serverlogboeken in het resourcemenu onder de sectie Bewaking.

   

3. Schakel onder Serverlogboeken downloaden het selectievakje Inschakelen uit.

   

4. Selecteer de knop Opslaan.

   

5. Een melding informeert u dat de service de registratie van logboeken configureert voor downloaden.

   

6. Zodra de bewerking is beëindigd, wordt u in een melding geïnformeerd dat de service de configuratie van het vastleggen van logboeken voor downloaden heeft voltooid.

   

CLI

U kunt het vastleggen van PostgreSQL-serverlogboeken en upgradelogboeken van de primaire versie uitschakelen via de opdracht az postgres flexible-server parameter set .

Als u het vastleggen van de logboeken voor downloaden wilt uitschakelen, gebruikt u deze opdracht:

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

Vastgelegde logboeken weergeven die beschikbaar zijn voor downloaden

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-server.

2. Selecteer serverlogboeken in het resourcemenu onder de sectie Bewaking.

   

3. Een tabel bevat alle vastgelegde logboekbestanden die nog niet zijn verwijderd. Bestanden die op een bepaald moment zijn vastgelegd, maar zijn verwijderd omdat ze de geconfigureerde bewaarperiode hebben overschreden, zijn niet meer zichtbaar of toegankelijk. Met behulp van de vakken Zoeken naar een logboekbestand, tijdsbereik en Logboektype kunt u filtervoorwaarden definiëren om de weergegeven logboeken te verminderen. Door een kolomkop te selecteren, kunt u de lijst met zichtbare logboekbestanden sorteren, in oplopende of aflopende volgorde, op basis van de waarde van het kenmerk dat wordt vertegenwoordigd door de geselecteerde koptekst. Onder elke beschikbare kolom ziet u de verschillende kenmerken van elk bestand:

   • Naam: naam van het logboekbestand. De service wijst elk logboekbestand een naam toe met dit patroon postgresql_yyyy_mm_dd_hh_00_00.log.
   • Tijd van laatste update: Tijdstempel van de laatste keer dat elk logboekbestand is geüpload. Logboekbestanden worden ongeveer elke 10 minuten geüpload.
   • Grootte: Grootte in bytes die worden bezet door het logboekbestand.
   • Logboektype: Serverlogboek geeft aan dat het bestand overeenkomt met een PostgreSQL-serverlogboek. Upgradelogboek geeft aan dat het bestand overeenkomt met een upgradelogboek van een primaire versie.

   

4. Inhoud van de tabel wordt niet automatisch bijgewerkt. Als u de meest recente informatie wilt zien, kunt u Vernieuwen selecteren.

   

CLI

U kunt de vastgelegde PostgreSQL-serverlogboeken en de upgradelogboeken van de primaire versie weergeven via de opdracht az postgres flexible-server-logs list .

Gebruik deze opdracht om alle vastgelegde logboeken weer te geven die beschikbaar zijn voor downloaden. Deze zijn bijgewerkt in de afgelopen 72 uur (standaardwaarde):

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

Gebruik deze opdracht om alle vastgelegde logboeken weer te geven die beschikbaar zijn voor downloaden, die in de afgelopen 10 uur zijn bijgewerkt:

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

Gebruik deze opdracht om alle vastgelegde logboeken weer te geven die beschikbaar zijn voor downloaden, waarvan de grootte kleiner is dan 30 KiB:

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

Als u alle vastgelegde logboeken wilt weergeven die beschikbaar zijn voor downloaden, waarvan de naam de naam bevat 01_07, gebruikt u deze opdracht:

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

Vastgelegde logboeken downloaden die beschikbaar zijn voor downloaden

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-server.

2. Selecteer serverlogboeken in het resourcemenu onder de sectie Bewaking.

   

3. Een tabel bevat alle vastgelegde logboekbestanden die nog niet zijn verwijderd. Bestanden die op een bepaald moment zijn vastgelegd, maar zijn verwijderd omdat ze de geconfigureerde bewaarperiode hebben overschreden, zijn niet meer zichtbaar of toegankelijk. Met behulp van de vakken Zoeken naar een logboekbestand, tijdsbereik en Logboektype kunt u filtervoorwaarden definiëren om de weergegeven logboeken te verminderen. Door een kolomkop te selecteren, kunt u de lijst met zichtbare logboekbestanden sorteren, in oplopende of aflopende volgorde, op basis van de waarde van het kenmerk dat wordt vertegenwoordigd door de geselecteerde koptekst. Identificeer het logboek dat u wilt downloaden en selecteer onder de kolom Acties downloaden.

   

4. Als u meerdere logboekbestanden tegelijk wilt downloaden, selecteert u alle bestanden die u wilt downloaden en selecteert u Downloaden op de werkbalk.

   

5. Inhoud van de tabel wordt niet automatisch bijgewerkt. Als u de meest recente informatie wilt zien, kunt u Vernieuwen selecteren.

   

CLI

U kunt de vastgelegde PostgreSQL-serverlogboeken en de upgradelogboeken van de primaire versie downloaden via de downloadopdracht az postgres flexible-server-logs.

Als u één specifiek logboek wilt downloaden, gebruikt u deze opdracht:

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

Als u één specifiek logboek wilt downloaden, gebruikt u deze opdracht:

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

Notitie

• Voor de bestandsnamen waarvoor logboekbestanden met overeenkomende namen beschikbaar zijn om te downloaden, wordt een lokaal bestand met dezelfde naam en inhoud gemaakt.

• Als een van de opgegeven bestandsnamen niet beschikbaar is om te downloaden, meldt de opdracht geen fout. Het downloadt dat bestand gewoon niet.

Gerelateerde inhoud

• Start een exemplaar van een flexibele Azure Database for PostgreSQL-server opnieuw op.
• Start een exemplaar van een flexibele Azure Database for PostgreSQL-server.
• Stop een exemplaar van een flexibele Azure Database for PostgreSQL-server.
• Start een exemplaar van een flexibele Azure Database for PostgreSQL-server opnieuw op.
• Rekenopties in Azure Database for PostgreSQL - Flexible Server.
• Opslagopties in Azure Database for PostgreSQL - Flexible Server.
• Limieten in Azure Database for PostgreSQL - Flexible Server.