Настройка записи журналов сервера PostgreSQL и журналов обновления основных версий

ОБЛАСТЬ ПРИМЕНЕНИЯ: База данных Azure для PostgreSQL — гибкий сервер

Журналы серверов PostgreSQL можно использовать для диагностики конкретных проблем, возникающих на гибком сервере База данных Azure для PostgreSQL, а также для получения подробных сведений о действиях, выполняемых на серверах. Журналы обновления основных версий можно использовать для устранения ошибок, которые могут возникнуть во время попытки обновить сервер до более высокой основной версии PostgreSQL.

По умолчанию запись журналов сервера для скачивания на гибком сервере База данных Azure для PostgreSQL отключена. Однако после включения функции гибкий сервер База данных Azure для PostgreSQL начинает записывать журналы сервера в файлы, которые можно скачать для подробной проверки. Вы можете использовать команды портал Azure или Azure CLI для перечисления и скачивания этих файлов, которые могут помочь вам в устранении неполадок.

В этой статье объясняется, как включить и отключить функцию. В нем также описывается, как можно вывести список всех доступных журналов сервера и как можно скачать любой из них.

Включение записи журналов сервера PostgreSQL и журналов обновления основных версий для скачивания

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий сервер База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Мониторинг " выберите журналы сервера.

   

3. В разделе "Скачать журналы сервера" установите флажок "Включить ".

   

4. По умолчанию файлы журналов хранятся в течение трех дней, но можно настроить период хранения от 1 до 7 дней. Используйте срез периода хранения (в днях), чтобы настроить нужную конфигурацию.

   

5. Выберите кнопку Сохранить.

   

6. Уведомление сообщает, что служба настраивает запись журналов для скачивания.

   

7. После завершения операции уведомление сообщает, что служба завершила настройку записи журналов для скачивания.

   

CLI

Вы можете включить запись журналов сервера PostgreSQL и журналов обновления основных версий с помощью команды az postgres flexible-server parameter set .

Чтобы включить запись журналов для скачивания, используйте следующую команду:

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

Чтобы настроить период хранения для журналов, которые записываются для скачивания, используйте следующую команду:

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

Допустимые значения параметра сервера logfiles.retention_days могут составлять от 1 до 7 дней. Если вы попытаетесь задать для него другое значение, вы получите следующее сообщение об ошибке:

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

Примечание.

• Через несколько минут после включения записи журналов сервера для скачивания первый журнал будет доступен для скачивания.

• Первоначально и примерно в течение одного часа журналы сервера занимают место на диске данных. Затем они перемещаются в хранилище резервных копий и хранятся там в течение настроенного периода хранения.

Отключение записи журналов сервера PostgreSQL и журналов обновления основных версий для скачивания

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий сервер База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Мониторинг " выберите журналы сервера.

   

3. В разделе "Скачать журналы сервера" снимите флажок "Включить ".

   

4. Выберите кнопку Сохранить.

   

5. Уведомление сообщает, что служба настраивает запись журналов для скачивания.

   

6. После завершения операции уведомление сообщает, что служба завершила настройку записи журналов для скачивания.

   

CLI

Вы можете отключить запись журналов сервера PostgreSQL и журналов обновления основных версий с помощью команды az postgres гибкий набор параметров сервера.

Чтобы отключить запись журналов для скачивания, используйте следующую команду:

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

Список записных журналов, доступных для скачивания

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий сервер База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Мониторинг " выберите журналы сервера.

   

3. В таблице показаны все захваченные файлы журнала, которые еще не удалены. Файлы, которые были записаны в какой-то момент, но были удалены, так как они превысили настроенный период хранения, больше не видны или недоступны. С помощью полей поиска файла журнала, диапазона времени журнала и полей типа журнала можно определить условия фильтрации, чтобы уменьшить отображаемые журналы. Выбрав заголовок столбца, можно сортировать список видимых файлов журнала по возрастанию или убыванию по значению атрибута, представленного выбранным заголовком. В каждом доступном столбце можно увидеть различные атрибуты каждого файла:

   • Имя: имя файла журнала. Служба назначает каждому файлу журнала имя с помощью этого шаблона postgresql_yyyy_mm_dd_hh_00_00.log.
   • Время последнего обновления: метка времени последнего отправки каждого файла журнала. Файлы журналов отправляются примерно каждые 10 минут.
   • Размер: размер в байтах, занятых файлом журнала.
   • Тип журнала: журнал сервера указывает, что файл соответствует журналу сервера PostgreSQL. Журнал обновления указывает, что файл соответствует журналу обновления основной версии.

   

4. Содержимое таблицы не обновляется автоматически. Чтобы просмотреть последние сведения, можно выбрать "Обновить".

   

CLI

Вы можете вывести список записных журналов сервера PostgreSQL и журналов обновления основных версий с помощью команды az postgres flexible-server-logs list .

Чтобы получить список всех сохраненных журналов, доступных для скачивания, которые были обновлены за последние 72 часа (значение по умолчанию), используйте следующую команду:

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

Чтобы получить список всех сохраненных журналов, доступных для скачивания, которые были обновлены за последние 10 часов, используйте следующую команду:

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

Чтобы получить список всех захваченных журналов, доступных для скачивания, размер которого составляет менее 30 КиБ, используйте следующую команду:

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

Чтобы перечислить все захваченные журналы, доступные для скачивания, имя которого содержится 01_07, используйте следующую команду:

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

Скачивание захваченных журналов, доступных для скачивания

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий сервер База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Мониторинг " выберите журналы сервера.

   

3. В таблице показаны все захваченные файлы журнала, которые еще не удалены. Файлы, которые были записаны в какой-то момент, но были удалены, так как они превысили настроенный период хранения, больше не видны или недоступны. С помощью полей поиска файла журнала, диапазона времени журнала и полей типа журнала можно определить условия фильтрации, чтобы уменьшить отображаемые журналы. Выбрав заголовок столбца, можно сортировать список видимых файлов журнала по возрастанию или убыванию по значению атрибута, представленного выбранным заголовком. Определите журнал, который требуется скачать, и в столбце "Действия " выберите " Скачать".

   

4. Если вы хотите скачать несколько файлов журнала одновременно, выберите все файлы, которые требуется скачать, и нажмите кнопку "Скачать " на панели инструментов.

   

5. Содержимое таблицы не обновляется автоматически. Чтобы просмотреть последние сведения, можно выбрать "Обновить".

   

CLI

Журналы сервера PostgreSQL и журналы обновления основных версий можно скачать с помощью команды скачивания az postgres flexible-server-logs.

Чтобы скачать один конкретный журнал, используйте следующую команду:

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

Чтобы скачать один конкретный журнал, используйте следующую команду:

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

Примечание.

• Для имен файлов, для которых есть файлы журнала с соответствующими именами, доступными для скачивания, создается локальный файл с тем же именем и содержимым.

• Если какие-либо из указанных имен файлов недоступны для скачивания, команда не сообщает об ошибке. Он просто не скачивает этот файл.

Связанный контент

• Перезапустите экземпляр гибкого сервера База данных Azure для PostgreSQL.
• Запустите экземпляр гибкого сервера База данных Azure для PostgreSQL.
• Остановите экземпляр гибкого сервера База данных Azure для PostgreSQL.
• Перезапустите экземпляр гибкого сервера База данных Azure для PostgreSQL.
• Параметры вычислений в База данных Azure для PostgreSQL — гибкий сервер.
• Параметры хранения в База данных Azure для PostgreSQL — гибкий сервер.
• Ограничения в База данных Azure для PostgreSQL — гибкий сервер.