Download PostgreSQL en upgrade logs

APPLIES TO: Azure Database for PostgreSQL - Flexible Server

U kunt PostgreSQL-serverlogboeken gebruiken om specifieke problemen te diagnosticeren die optreden in een Azure Database voor PostgreSQL-flexibele server, en om gedetailleerd inzicht te krijgen in de activiteiten die op uw servers worden uitgevoerd. U kunt upgrade-logs van hoofdversies gebruiken om fouten op te lossen die kunnen optreden bij een poging om uw server te upgraden naar een hogere hoofdversie van PostgreSQL.

Standaard is het vastleggen van serverlogboeken voor download in een Azure Databaseserver voor PostgreSQL Flexibele server uitgeschakeld. Nadat u de functie hebt ingeschakeld, begint uw Azure Database voor PostgreSQL flexibele server de serverlogs vast te leggen in bestanden, die u kunt downloaden voor gedetailleerde inspectie. U kunt de Azure-portal of Azure CLI-opdrachten gebruiken om deze bestanden te vermelden en te downloaden, die u kunnen helpen bij alle probleemoplossingsactiviteiten.

Dit artikel legt uit hoe u de functie kunt inschakelen en uitschakelen. Het beschrijft ook hoe je alle beschikbare serverlogboeken kunt weergeven en hoe je er een kunt downloaden.

Stappen om het vastleggen van PostgreSQL- en upgrade-logs voor download in te schakelen

Portal

Gebruikmakend van de Azure portal:

1. Selecteer uw Azure Database voor PostgreSQL flexibele server.

2. In het bronnenmenu, onder het gedeelte Monitoring, selecteer Serverlogboeken.

   

3. Vink het selectievakje Capture logs for download aan.

   

4. Standaard worden logbestanden drie dagen bewaard, maar je kunt de bewaartermijn aanpassen van 1 tot 7 dagen. Gebruik de logretentieperiode (in dagen) om aan te passen aan je gewenste configuratie.

   

5. Selecteer de Save knop.

   

6. Een melding informeert u dat de dienst bezig is met het configureren van het vastleggen van logbestanden voor download.

   

7. Zodra de operatie is voltooid, ontvang je een melding dat de dienst de configuratie van de vastlegging van logs voor download heeft voltooid.

   

CLI

Je kunt het vastleggen van PostgreSQL-serverlogboeken en logboeken van belangrijke versie-upgrades inschakelen via het az postgres flexible-server parameter set commando.

Om het vastleggen van de logs voor download mogelijk te maken, gebruik deze opdracht:

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

Om de bewaartermijn voor de logbestanden die gereed zijn om te downloaden aan te passen, gebruik deze opdracht:

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

Allowed values for server parameter logfiles.retention_days can be between 1 and 7 days. If you try to set it to a different value, you get this error:

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

Opmerking

• Enkele minuten nadat het vastleggen van serverlogs voor download is ingeschakeld, zal het eerste logboek beschikbaar zijn voor download.

• Aanvankelijk, en gedurende ongeveer een uur, nemen serverlogs ruimte op de datadisk in beslag. Daarna worden ze verplaatst naar back-upopslag en daar bewaard gedurende de geconfigureerde retentieperiode.

Stappen om het vastleggen van PostgreSQL en upgrade logs voor download uit te schakelen

Portal

Gebruik het Azure-portaal:

1. Selecteer uw Azure Database for PostgreSQL flexibele server.

2. In het resourcemenu, onder het onderdeel Monitoring, selecteer Serverlogs.

   

3. Vink het selectievakje Capture logs for download uit.

   

4. Selecteer de Opslaan knop.

   

5. Een melding informeert u dat de dienst bezig is met het configureren van het vastleggen van logboeken voor download.

   

6. Zodra de operatie eindigt, krijg je een melding dat de service de configuratie van het vastleggen van logs voor download heeft voltooid.

   

CLI

Je kunt het vastleggen van PostgreSQL-serverlogboeken en logboeken van grote versie-upgrades uitschakelen via de opdracht az postgres flexible-server parameter set.

Om de vastlegging van de logs voor download uit te schakelen, gebruik deze opdracht:

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

Stappen om vastgelegde logbestanden beschikbaar voor download te maken

Portal

nl-NL: Gebruikmakend van de Azure portal:

1. Selecteer uw Azure Database voor PostgreSQL flexibele server.

2. In het resource-menu, onder de sectie Monitoring, selecteer Server logs.

   

3. Een tabel toont alle vastgelegde logbestanden die nog niet zijn verwijderd. Bestanden die op een gegeven moment zijn vastgelegd, maar werden verwijderd omdat ze de ingestelde retentieperiode overschreden, zijn niet meer zichtbaar of toegankelijk. Met de vakken Zoeken naar bestanden met namen die bevatten, Tijdsbereik, en Logtype kunt u filtercondities definiëren om het aantal weergegeven logs te verminderen. Door een kolomkop te selecteren, kunt u de lijst van zichtbare logbestanden sorteren in oplopende of aflopende volgorde, op basis van de waarde van het attribuut dat door de geselecteerde kop wordt weergegeven. Onder elke beschikbare kolom kunt u de verschillende attributen van elk bestand zien.

   • Name: Name of the log file. De service kent elk logbestand een naam toe met dit patroon postgresql_yyyy_mm_dd_hh_00_00.log.
   • Laatste update tijd: Tijdstempel van de laatste keer dat elk logbestand werd geüpload. Logbestanden worden ongeveer elke 10 minuten geüpload.
   • Grootte: Grootte in bytes ingenomen door het logbestand.
   • Logtype: Serverlog geeft aan dat het bestand overeenkomt met een PostgreSQL-serverlogboek. Upgrade log geeft aan dat het bestand hoort bij een upgrade-logboek van een hoofdversie.

   

4. De inhoud van de tabel wordt niet automatisch bijgewerkt. Om de meest recente informatie te zien, kunt u Vernieuwen selecteren.

   

CLI

U kunt de vastgelegde PostgreSQL-serverlogboeken en logs van belangrijke versie-upgrades opsommen via de opdracht az postgres flexible-server server-logs list.

Om alle vastgelegde logs die beschikbaar zijn voor download en die in de afgelopen 72 uur zijn bijgewerkt (standaardwaarde) op te sommen, gebruik deze opdracht:

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

Om alle vastgelegde logs op te sommen die beschikbaar zijn voor download en in de laatste 10 uur zijn bijgewerkt, gebruik deze opdracht:

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

Om alle vastgelegde logs beschikbaar voor download te vermelden, waarvan de grootte minder is dan 30 KiB, gebruik dit commando:

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

Om alle verzamelde logbestanden die beschikbaar zijn voor downloaden en waarvan de naam 01_07 bevat op te sommen, gebruikt u deze opdracht:

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

Stappen om vastgelegde logbestanden te downloaden

Portal

Met behulp van de Azure portal:

1. Select your Azure Database for PostgreSQL flexible server.

2. In het resourcemenu, onder de sectie Monitoring, selecteer Serverlogboeken.

   

3. Een tabel toont alle vastgelegde logbestanden die nog niet zijn verwijderd. Bestanden die op enig moment werden vastgelegd, maar werden verwijderd omdat ze de ingestelde bewaartermijn overschreden, zijn niet meer zichtbaar of toegankelijk. Met de vakken Zoeken naar bestanden met namen die bevatten, Tijdsbereik, en Logtype kunt u filtervoorwaarden definiëren om het aantal weergegeven logboeken te verminderen. Door een kolomkop te selecteren, kunt u de lijst van zichtbare logbestanden sorteren in oplopende of aflopende volgorde op basis van de waarde van het attribuut dat door de geselecteerde kop wordt weergegeven. Identificeer het logbestand dat u wilt downloaden en selecteer Downloaden onder de kolom Acties.

   

4. If you want to download multiple log files at one time, select all the files that you want to download, and select Download in the toolbar.

   

5. De inhoud van de tabel wordt niet automatisch bijgewerkt. Om de meest recente informatie te zien, kunt u Vernieuwen selecteren.

   

CLI

U kunt de vastgelegde PostgreSQL serverlogs en logs voor een upgrade naar een hogere versie downloaden via het az postgres flexible-server server-logs download commando.

Om één specifiek logbestand te downloaden, gebruik dit commando:

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

Om een specifiek logbestand te downloaden, gebruik deze opdracht:

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

Opmerking

• For the file names provided for which there're log files with matching names available to download, a local file is created with the same name and contents.

• 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

• Configureer hoge beschikbaarheid.
• Geplande onderhoud configureren.
• Meldingen maken op basis van metrics via het portaal.