Stáhněte si PostgreSQL a aktualizujte logy

Protokoly serveru PostgreSQL můžete použít k diagnostice konkrétních problémů, ke kterým došlo v instanci flexibilního serveru Azure Database for PostgreSQL, a získat podrobné přehledy o aktivitách, které běží na vašich serverech. Protokoly upgradu hlavní verze můžete použít k řešení chyb, ke kterým může dojít při pokusu o upgrade serveru na vyšší hlavní verzi PostgreSQL.

Ve výchozím nastavení je zakázané zachytávání protokolů serveru ke stažení v instanci flexibilního serveru Azure Database for PostgreSQL. Po povolení této funkce ale instance flexibilního serveru Azure Database for PostgreSQL začne zaznamenávat protokoly serveru do souborů, které si můžete stáhnout pro podrobnou kontrolu. Pomocí webu Azure Portal nebo příkazů Azure CLI můžete vypsat a stáhnout tyto soubory, které vám pomůžou při řešení potíží.

Tento článek vysvětluje, jak funkci povolit a zakázat. Popisuje také, jak můžete zobrazit seznam všech dostupných protokolů serveru a jak si můžete libovolnou z nich stáhnout.

Kroky pro povolení zachytávání protokolů PostgreSQL a protokolů aktualizace pro jejich stažení

Portal

Použití portálu Azure:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Monitorování vyberte Protokoly serveru.

   

3. Označte zaškrtávací políčko 'Zachytávání protokolů pro stažení'.

   

4. Soubory protokolu se ve výchozím nastavení uchovávají po dobu tří dnů, ale dobu uchovávání můžete upravit od 1 do 7 dnů. Pomocí průřezu uchovávání protokolů (ve dnech) můžete upravit požadovanou konfiguraci.

   

5. Vyberte tlačítko Uložit.

   

6. Oznámení vás informuje, že služba konfiguruje zachytávání protokolů ke stažení.

   

7. Jakmile operace skončí, oznámení vás informuje, že služba dokončila konfiguraci zachytávání protokolů ke stažení.

   

CLI

Zachycení protokolů serveru PostgreSQL a protokolů upgradu hlavní verze můžete povolit spuštěním příkazu az postgres flexible-server parameter set.

Pokud chcete povolit zachytávání protokolů ke stažení, použijte tento příkaz:

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

Pokud chcete upravit dobu uchovávání protokolů zachycených ke stažení, použijte tento příkaz:

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

Povolené hodnoty pro parametr logfiles.retention_days serveru můžou být mezi 1 a 7 dny. Pokud se pokusíte nastavit jinou hodnotu, zobrazí se tato chyba:

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

Poznámka:

• Několik minut po povolení zachytávání protokolů serveru ke stažení bude první protokol k dispozici ke stažení.

• Na začátku a přibližně hodinu zabírají protokoly serveru místo na datovém disku. Pak se přesunou do úložiště zálohování a uchovávají se tam po nakonfigurovanou dobu uchovávání.

Postup zakázání zachytávání protokolů PostgreSQL a upgradu ke stažení

Portal

Použití portálu Azure:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Monitorování vyberte Protokoly serveru.

   

3. Zrušte zaškrtnutí políčka Zachytávat protokoly pro stažení .

   

4. Vyberte tlačítko Uložit.

   

5. Oznámení vás informuje, že služba konfiguruje zachytávání protokolů ke stažení.

   

6. Jakmile operace skončí, oznámení vás informuje, že služba dokončila konfiguraci zachytávání protokolů ke stažení.

   

CLI

Můžete zakázat chytání protokolů serveru PostgreSQL a protokolů upgradeů hlavních verzí pomocí příkazu az postgres flexible-server parameter set.

Pokud chcete zakázat zachytávání protokolů ke stažení, použijte tento příkaz:

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

Postup zobrazení seznamu zachycených protokolů dostupných ke stažení

Portal

Použití portálu Azure:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Monitorování vyberte Protokoly serveru.

   

3. Tabulka zobrazuje všechny zachycené soubory protokolu, které se ještě neodstraní. Soubory, které byly zachyceny v určitém okamžiku, ale byly odstraněny, protože překročily nakonfigurovanou dobu uchovávání informací, už nejsou viditelné ani přístupné. Pomocí polí Hledat soubory obsahující názvy, Časový rozsah a Typ protokolu můžete definovat podmínky filtrování, které omezí zobrazené protokoly. Výběrem záhlaví sloupce můžete seřadit seznam viditelných souborů protokolu ve vzestupném nebo sestupném pořadí podle hodnoty atributu reprezentované vybranou hlavičkou. Pod každým dostupným sloupcem uvidíte různé atributy jednotlivých souborů:

   • Název: Název souboru protokolu. Služba přiřadí každému souboru protokolu název s tímto vzorem postgresql_yyyy_mm_dd_hh_00_00.log.
   • Čas poslední aktualizace: Časové razítko času, kdy byl každý soubor protokolu naposledy nahrán. Soubory protokolu se nahrají přibližně každých 10 minut.
   • Velikost: Velikost v bajtech obsazených souborem protokolu.
   • Typ protokolu: Protokol serveru indikuje, že soubor odpovídá protokolu serveru PostgreSQL. Protokol upgradu označuje, že soubor odpovídá protokolu upgradu hlavní verze.

   

4. Obsah tabulky se automaticky neaktualizuje. Pokud chcete zobrazit nejnovější informace, můžete vybrat Aktualizovat.

   

CLI

Zachycené protokoly serveru PostgreSQL a protokoly upgradu hlavní verze můžete zobrazit pomocí příkazu az postgres flexible-server-logs list .

Pokud chcete zobrazit seznam všech zachycených protokolů dostupných ke stažení, které byly aktualizovány za posledních 72 hodin (výchozí hodnota), použijte tento příkaz:

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

Pokud chcete zobrazit seznam všech zachycených protokolů dostupných ke stažení, které byly aktualizovány za posledních 10 hodin, použijte tento příkaz:

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

Pokud chcete zobrazit seznam všech zachycených protokolů dostupných ke stažení, jejichž velikost je pod 30 KiB, použijte tento příkaz:

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

Pokud chcete zobrazit seznam všech zachycených protokolů dostupných ke stažení, jejichž název obsahuje 01_07, použijte tento příkaz:

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

Jak postupovat při stahování zachycených protokolů

Portal

Použití portálu Azure:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Monitorování vyberte Protokoly serveru.

   

3. Tabulka zobrazuje všechny zachycené soubory protokolu, které se ještě neodstraní. Soubory, které byly zachyceny v určitém okamžiku, ale byly odstraněny, protože překročily nakonfigurovanou dobu uchovávání informací, už nejsou viditelné ani přístupné. Pomocí polí Hledat soubory obsahující názvy, Časový rozsah a Typ protokolu můžete definovat podmínky filtrování, které omezí zobrazené protokoly. Výběrem záhlaví sloupce můžete seřadit seznam viditelných souborů protokolu ve vzestupném nebo sestupném pořadí podle hodnoty atributu reprezentované vybranou hlavičkou. Určete protokol, který chcete stáhnout, a ve sloupci Akce vyberte Stáhnout.

   

4. Pokud chcete stáhnout více souborů protokolu najednou, vyberte všechny soubory, které chcete stáhnout, a na panelu nástrojů vyberte Stáhnout .

   

5. Obsah tabulky se automaticky neaktualizuje. Pokud chcete zobrazit nejnovější informace, můžete vybrat Aktualizovat.

   

CLI

Zachycené logy serveru PostgreSQL a logy upgradů hlavní verze si můžete stáhnout pomocí příkazu az postgres flexible-server server-logs download.

Pokud chcete stáhnout jeden konkrétní protokol, použijte tento příkaz:

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

Pokud chcete stáhnout jeden konkrétní protokol, použijte tento příkaz:

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

Poznámka:

• Pro názvy souborů, pro které jsou k dispozici soubory protokolu s odpovídajícími názvy ke stažení, se vytvoří místní soubor se stejným názvem a obsahem.

• Pokud některý z zadaných názvů souborů není k dispozici ke stažení, příkaz nehlásí žádnou chybu. Jednoduše tento soubor nestahuje.

Související obsah

• Konfigurace vysoké dostupnosti
• Nakonfigurujte plánovanou údržbu.
• Vytváření upozornění na metriky pomocí portálu