Konfigurowanie przechwytywania dzienników serwera PostgreSQL i dzienników uaktualniania wersji głównej

DOTYCZY: Azure Database for PostgreSQL — serwer elastyczny

Dzienniki serwera PostgreSQL umożliwiają diagnozowanie określonych problemów występujących na serwerze elastycznym usługi Azure Database for PostgreSQL oraz uzyskiwanie szczegółowych informacji o działaniach uruchamianych na 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 przechwytywanie dzienników serwera do pobrania na serwerze elastycznym usługi Azure Database for PostgreSQL jest wyłączone. Jednak po włączeniu tej funkcji serwer elastyczny 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.

Włączanie przechwytywania dzienników serwera PostgreSQL i dzienników uaktualniania wersji głównej do pobrania

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz serwer elastyczny usługi Azure Database for PostgreSQL.

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

   

3. W obszarze Pobierz dzienniki serwera zaznacz pole wyboru Włącz .

   

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 (w dniach), aby dostosować się do żądanej konfiguracji.

   

5. Wybierz przycisk zapisywania.

   

6. Powiadomienie informuje, że usługa konfiguruje przechwytywanie dzienników do pobrania.

   

7. Po zakończeniu operacji zostanie wyświetlone powiadomienie informujące o zakończeniu konfiguracji przechwytywania dzienników do pobrania.

   

Interfejs wiersza polecenia

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 --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 --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]

Uwaga

• 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.

Wyłącz przechwytywanie dzienników serwera PostgreSQL i dzienników uaktualniania wersji głównej do pobrania

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz serwer elastyczny usługi Azure Database for PostgreSQL.

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

   

3. W obszarze Pobierz dzienniki serwera wyczyść pole wyboru Włącz .

   

4. Wybierz przycisk zapisywania.

   

5. Powiadomienie informuje, że usługa konfiguruje przechwytywanie dzienników do pobrania.

   

6. Po zakończeniu operacji zostanie wyświetlone powiadomienie informujące o zakończeniu konfiguracji przechwytywania dzienników do pobrania.

   

Interfejs wiersza polecenia

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

Wyświetlanie listy przechwyconych dzienników dostępnych do pobrania

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz serwer elastyczny usługi Azure Database for 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 plik dziennika, Zakres czasu dziennika 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 przekazania 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ż.

   

Interfejs wiersza polecenia

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

Pobieranie przechwyconych dzienników dostępnych do pobrania

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz serwer elastyczny usługi Azure Database for 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 plik dziennika, Zakres czasu dziennika 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ż.

   

Interfejs wiersza polecenia

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>

Uwaga

• 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.

Powiązana zawartość

• Uruchom ponownie wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.
• Uruchom wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.
• Zatrzymaj wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.
• Uruchom ponownie wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.
• Opcje obliczeniowe w usłudze Azure Database for PostgreSQL — serwer elastyczny.
• Opcje magazynu w usłudze Azure Database for PostgreSQL — serwer elastyczny.
• Limity w usłudze Azure Database for PostgreSQL — serwer elastyczny.