Pobierz dzienniki PostgreSQL i aktualizacji

Dzienniki serwera PostgreSQL umożliwiają diagnozowanie konkretnych problemów napotykanych w wystąpieniu elastycznego serwera Azure Database for PostgreSQL oraz uzyskanie szczegółowego wglądu w działania uruchamiane na Twoich serwerach. Dzienniki uaktualniania wersji głównej umożliwiają rozwiązywanie problemów z błędami, które mogą wystąpić podczas próby uaktualnienia serwera do wyższej wersji głównej bazy danych PostgreSQL.

Domyślnie rejestrowanie dzienników serwera w celu ich pobrania w elastycznym wystąpieniu serwera Azure Database for PostgreSQL jest wyłączone. Jednak po włączeniu tej funkcji wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL rozpoczyna przechwytywanie dzienników serwera do plików, które można pobrać w celu przeprowadzenia szczegółowej inspekcji. Możesz użyć witryny Azure Portal lub poleceń interfejsu wiersza polecenia platformy Azure, aby wyświetlić listę i pobrać te pliki, które mogą pomóc w rozwiązywaniu problemów.

W tym artykule wyjaśniono, jak włączyć i wyłączyć funkcję. Opisano w nim również sposób wyświetlania listy wszystkich dostępnych dzienników serwera oraz sposobu ich pobierania.

Procedura włączania przechwytywania dzienników PostgreSQL oraz dzienników aktualizacji do pobrania

Portal

Korzystanie z portalu Azure:

1. Wybierz swoją instancję elastycznego serwera usługi Azure Database dla PostgreSQL.

2. W menu zasobów w sekcji Monitorowanie wybierz pozycję Dzienniki serwera.

   

3. Zaznacz pole zaznaczenia Zapisz dzienniki do pobrania.

   Zrzut ekranu przedstawiający sposób konfigurowania serwera do przechwytywania dzienników serwera PostgreSQL oraz dzienników uaktualnień głównych wersji. Przechwycone pliki dziennika można pobrać do inspekcji.

4. Domyślnie pliki dziennika są przechowywane przez trzy dni, ale można dostosować okres przechowywania z 1 do 7 dni. Użyj fragmentatora Okres przechowywania dziennika (w dniach), aby dostosować się do żądanej konfiguracji.

   

5. Wybierz przycisk Zapisz .

   

6. Powiadomienie informuje, że usługa przygotowuje logi do pobrania.

   

7. Po zakończeniu operacji zostanie wyświetlone powiadomienie informujące, że usługa zakończyła konfigurację zapisywania logów do pobrania.

   

CLI

Przechwytywanie dzienników serwera PostgreSQL i dzienników uaktualniania wersji głównej można włączyć za pomocą polecenia az postgres flexible-server parameter set .

Aby włączyć przechwytywanie dzienników do pobrania, użyj następującego polecenia:

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

Aby dostosować okres przechowywania dzienników przechwyconych do pobrania, użyj następującego polecenia:

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

Dozwolone wartości parametru logfiles.retention_days serwera mogą należeć do zakresu od 1 do 7 dni. Jeśli spróbujesz ustawić ją na inną wartość, zostanie wyświetlony następujący błąd:

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

Note

• Kilka minut po włączeniu przechwytywania dzienników serwera do pobrania pierwszy dziennik będzie dostępny do pobrania.

• Początkowo i przez około godzinę dzienniki serwera zajmują miejsce na dysku danych. Następnie są one przenoszone do magazynu kopii zapasowych i przechowywane tam przez skonfigurowany okres przechowywania.

Kroki wyłączania przechwytywania dzienników postgreSQL i uaktualniania do pobrania

Portal

Korzystanie z portalu Azure:

1. Wybierz swoją instancję elastycznego serwera usługi Azure Database dla PostgreSQL.

2. W menu zasobów w sekcji Monitorowanie wybierz pozycję Dzienniki serwera.

   

3. Wyczyść pole wyboru Przechwyć dzienniki pobierania .

   

4. Wybierz przycisk Zapisz .

   

5. Powiadomienie informuje, że usługa przygotowuje logi do pobrania.

   

6. Po zakończeniu operacji zostanie wyświetlone powiadomienie informujące, że usługa zakończyła konfigurację zapisywania logów do pobrania.

   

CLI

Przechwytywanie dzienników serwera PostgreSQL i dzienników uaktualniania wersji głównej można wyłączyć za pomocą polecenia az postgres flexible-server parameter set .

Aby wyłączyć przechwytywanie dzienników do pobrania, użyj następującego polecenia:

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

Procedura wyświetlania listy przechwyconych dzienników dostępnych do pobrania

Portal

Korzystanie z portalu Azure:

1. Wybierz swoją instancję elastycznego serwera usługi Azure Database dla PostgreSQL.

2. W menu zasobów w sekcji Monitorowanie wybierz pozycję Dzienniki serwera.

   

3. Tabela zawiera wszystkie przechwycone pliki dziennika, które nie zostały jeszcze usunięte. Pliki przechwycone w pewnym momencie, ale zostały usunięte, ponieważ przekroczyły skonfigurowany okres przechowywania, nie są już widoczne ani dostępne. Korzystając z pól Wyszukaj pliki zawierające nazwy, Zakres czasu i Typ dziennika , można zdefiniować warunki filtrowania, aby zmniejszyć wyświetlane dzienniki. Wybierając nagłówek kolumny, można sortować listę widocznych plików dziennika w kolejności rosnącej lub malejącej według wartości atrybutu reprezentowanego przez wybrany nagłówek. W każdej dostępnej kolumnie można zobaczyć różne atrybuty każdego pliku:

   • Nazwa: nazwa pliku dziennika. Usługa przypisuje każdemu plikowi dziennika nazwę z tym wzorcem postgresql_yyyy_mm_dd_hh_00_00.log.
   • Czas ostatniej aktualizacji: sygnatura czasowa ostatniego przesłania każdego pliku dziennika. Pliki dziennika są przekazywane co około 10 minut.
   • Rozmiar: rozmiar w bajtach zajmowanych przez plik dziennika.
   • Typ dziennika: dziennik serwera wskazuje, że plik odpowiada dziennikowi serwera PostgreSQL. Dziennik uaktualniania wskazuje, że plik odpowiada dziennikowi uaktualniania wersji głównej.

   

4. Zawartość tabeli nie jest automatycznie aktualizowana. Aby wyświetlić najnowsze informacje, możesz wybrać pozycję Odśwież.

   

CLI

Możesz wyświetlić listę przechwyconych dzienników serwera PostgreSQL i dzienników uaktualniania wersji głównej za pomocą polecenia az postgres flexible-server-logs list .

Aby wyświetlić listę wszystkich przechwyconych dzienników dostępnych do pobrania, które zostały zaktualizowane w ciągu ostatnich 72 godzin (wartość domyślna), użyj następującego polecenia:

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

Aby wyświetlić listę wszystkich przechwyconych dzienników dostępnych do pobrania, które zostały zaktualizowane w ciągu ostatnich 10 godzin, użyj następującego polecenia:

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

Aby wyświetlić listę wszystkich przechwyconych dzienników dostępnych do pobrania, których rozmiar jest poniżej 30 KiB, użyj następującego polecenia:

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

Aby wyświetlić listę wszystkich przechwyconych dzienników dostępnych do pobrania, których nazwa zawiera 01_07, użyj następującego polecenia:

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

Procedura pobierania przechwyconych dzienników

Portal

Korzystanie z portalu Azure:

1. Wybierz swoją instancję elastycznego serwera usługi Azure Database dla PostgreSQL.

2. W menu zasobów w sekcji Monitorowanie wybierz pozycję Dzienniki serwera.

   

3. Tabela zawiera wszystkie przechwycone pliki dziennika, które nie zostały jeszcze usunięte. Pliki przechwycone w pewnym momencie, ale zostały usunięte, ponieważ przekroczyły skonfigurowany okres przechowywania, nie są już widoczne ani dostępne. Korzystając z pól Wyszukaj pliki zawierające nazwy, Zakres czasu i Typ dziennika , można zdefiniować warunki filtrowania, aby zmniejszyć wyświetlane dzienniki. Wybierając nagłówek kolumny, można sortować listę widocznych plików dziennika w kolejności rosnącej lub malejącej według wartości atrybutu reprezentowanego przez wybrany nagłówek. Zidentyfikuj dziennik, który chcesz pobrać, a następnie w kolumnie Akcje wybierz pozycję Pobierz.

   

4. Jeśli chcesz jednocześnie pobrać wiele plików dziennika, wybierz wszystkie pliki, które chcesz pobrać, a następnie wybierz pozycję Pobierz na pasku narzędzi.

   

5. Zawartość tabeli nie jest automatycznie aktualizowana. Aby wyświetlić najnowsze informacje, możesz wybrać pozycję Odśwież.

   

CLI

Przechwycone dzienniki serwera PostgreSQL i dzienniki uaktualnienia wersji głównej można pobrać za pomocą polecenia az postgres flexible-server-logs download .

Aby pobrać jeden konkretny dziennik, użyj następującego polecenia:

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

Aby pobrać jeden konkretny dziennik, użyj następującego polecenia:

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

Note

• W przypadku nazw plików, dla których istnieją pliki dziennika z pasującymi nazwami dostępnymi do pobrania, plik lokalny jest tworzony z taką samą nazwą i zawartością.

• Jeśli którakolwiek z podanych nazw plików nie jest dostępna do pobrania, polecenie nie zgłasza żadnego błędu. Po prostu nie pobiera tego pliku.

Treści powiązane

• Konfigurowanie wysokiej dostępności.
• Skonfiguruj zaplanowaną konserwację.
• Tworzenie alertów dotyczących metryk przy użyciu portalu.