Configuración de la captura de registros de servidor de PostgreSQL y registros de actualización de versiones principales

SE APLICA A: Azure Database for PostgreSQL con servidor flexible

Puede usar los registros del servidor PostgreSQL para diagnosticar problemas específicos experimentados en un servidor flexible de Azure Database for PostgreSQL y obtener información detallada sobre las actividades que se ejecutan en los servidores. Puede usar los registros de actualización de versiones principales para solucionar errores que pueden producirse durante un intento de actualizar el servidor a una versión principal superior de PostgreSQL.

De manera predeterminada, la captura de registros de servidor para su descarga en un servidor flexible de Azure Database for PostgreSQL está deshabilitada. Sin embargo, después de habilitar la característica, el servidor flexible de Azure Database for PostgreSQL comienza a capturar los registros del servidor en archivos, que puede descargar para una inspección detallada. Puede usar Azure Portal o comandos de la CLI de Azure para enumerar y descargar estos archivos que pueden ayudarle con cualquier esfuerzo de solución de problemas.

En este artículo se explica cómo habilitar y deshabilitar la característica. También describe cómo puede enumerar todos los registros de servidor disponibles y cómo puede descargar cualquiera de ellos.

Habilitación de la captura de registros de servidor de PostgreSQL y registros de actualización de versiones principales para su descarga

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Supervisión, seleccione Registros del servidor.

   

3. En Descargar registros del servidor, marque la casilla Habilitar.

   

4. De manera predeterminada, los archivos de registro se conservan durante tres días, pero puede ajustar el período de retención de 1 a 7 días. Use la segmentación período de retención (en días) para ajustarla a la configuración deseada.

   

5. Seleccione el botón Guardar.

   

6. Una notificación le informa de que el servicio está configurando la captura de registros para su descarga.

   

7. Una vez finalizada la operación, una notificación le informa de que el servicio completó la configuración de la captura de registros para su descarga.

   

CLI

Puede habilitar la captura de registros de servidor de PostgreSQL y registros de actualización de versión principal a través del comando az postgres flexible-server parameter set.

Para habilitar la captura de los registros para su descarga, use este comando:

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

Para ajustar el período de retención de los registros que se capturan para su descarga, use este comando:

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

Los valores permitidos para el parámetro de servidor logfiles.retention_days pueden estar entre 1 y 7 días. Si intenta establecerlo en un valor diferente, obtendrá este error:

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

Nota:

• Unos minutos después de habilitar la captura de registros de servidor para su descarga, el primer registro estará disponible para su descarga.

• Inicialmente, y durante aproximadamente una hora, los registros del servidor ocupan espacio en disco de datos. A continuación, se mueven al almacenamiento de copia de seguridad y se mantienen allí durante el período de retención configurado.

Deshabilitación de la captura de registros de servidor de PostgreSQL y registros de actualización de versiones principales para su descarga

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Supervisión, seleccione Registros del servidor.

   

3. En Descargar registros del servidor, desactive la casilla Habilitar.

   

4. Seleccione el botón Guardar.

   

5. Una notificación le informa de que el servicio está configurando la captura de registros para su descarga.

   

6. Una vez finalizada la operación, una notificación le informa de que el servicio completó la configuración de la captura de registros para su descarga.

   

CLI

Puede deshabilitar la captura de los registros de servidor de PostgreSQL y los registros de actualización de la versión principal a través del comando az postgres flexible-server parameter set.

Para deshabilitar la captura de los registros para su descarga, use este comando:

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

Enumerar los registros capturados disponibles para su descarga

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Supervisión, seleccione Registros del servidor.

   

3. En una tabla se muestran todos los archivos de registro capturados que aún no se eliminan. Los archivos que se capturaron en algún momento, pero se eliminaron porque superaron el período de retención configurado, ya no son visibles ni accesibles. Con el Buscar un archivo de registro, intervalo de tiempo de registroy cuadros de tipo de registro, puede definir condiciones de filtrado para reducir los registros mostrados. Al seleccionar un encabezado de columna, puede ordenar la lista de archivos de registro visibles, en orden ascendente o descendente, por el valor del atributo representado por el encabezado seleccionado. En cada columna disponible, puede ver los distintos atributos de cada archivo:

   • Nombre: nombre del archivo de registro. El servicio asigna a cada archivo de registro un nombre con este patrón postgresql_yyyy_mm_dd_hh_00_00.log.
   • Hora de la última actualización: marca de tiempo de la última vez que se cargó cada archivo de registro. Los archivos de registro se cargan, aproximadamente, cada 10 minutos.
   • Tamaño: tamaño en bytes ocupados por el archivo de registro.
   • Tipo de registro: registro del servidor indica que el archivo corresponde a un registro de servidor de PostgreSQL. Registro de actualización indica que el archivo corresponde a un registro de actualización de versión principal.

   

4. El contenido de la tabla no se actualiza automáticamente. Para ver la información más reciente, puede seleccionar Actualizar.

   

CLI

Puede enumerar los registros de servidor de PostgreSQL capturados y los registros de actualización de versiones principales a través del comando az postgres flexible-server-logs list.

Para enumerar todos los registros capturados disponibles para su descarga, que se actualizaron en las últimas 72 horas (valor predeterminado), use este comando:

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

Para enumerar todos los registros capturados disponibles para su descarga, que se actualizaron en las últimas 10 horas, use este comando:

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

Para enumerar todos los registros capturados disponibles para su descarga, cuyo tamaño es inferior a 30 KiB, use este comando:

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

Para enumerar todos los registros capturados disponibles para su descarga, cuyo nombre contiene 01_07, use este comando:

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

Descarga de registros capturados disponibles para su descarga

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en la sección Supervisión, seleccione Registros del servidor.

   

3. En una tabla se muestran todos los archivos de registro capturados que aún no se eliminan. Los archivos que se capturaron en algún momento, pero se eliminaron porque superaron el período de retención configurado, ya no son visibles ni accesibles. Con el Buscar un archivo de registro, intervalo de tiempo de registroy cuadros de tipo de registro, puede definir condiciones de filtrado para reducir los registros mostrados. Al seleccionar un encabezado de columna, puede ordenar la lista de archivos de registro visibles, en orden ascendente o descendente, por el valor del atributo representado por el encabezado seleccionado. Identifique el registro que desea descargar y, en la columna Acciones, seleccione Descargar.

   

4. Si desea descargar varios archivos de registro a la vez, seleccione todos los archivos que desea descargar y seleccione Descargar en la barra de herramientas.

   

5. El contenido de la tabla no se actualiza automáticamente. Para ver la información más reciente, puede seleccionar Actualizar.

   

CLI

Puede descargar los registros de servidor de PostgreSQL capturados y los registros de actualización de la versión principal a través del comando az postgres flexible-server server-logs download.

Para descargar un registro específico, use este comando:

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

Para descargar un registro específico, use este comando:

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

Nota:

• Para los nombres de archivo proporcionados para los que hay archivos de registro con nombres coincidentes disponibles para descargar, se crea un archivo local con el mismo nombre y contenido.

• Si alguno de los nombres de archivo proporcionados no está disponible para descargarse, el comando no notifica ningún error. Simplemente no descarga ese archivo.

Contenido relacionado

• Reiniciar una instancia del Servidor flexible de Azure Database for PostgreSQL.
• Iniciar una instancia de servidor flexible de Azure Database for PostgreSQL.
• Detener una instancia del servidor flexible de Azure Database for PostgreSQL.
• Reiniciar una instancia del Servidor flexible de Azure Database for PostgreSQL.
• Opciones de proceso en Azure DB for PostgreSQL: servidor flexible.
• Opciones de almacenamiento en Azure DB for PostgreSQL: servidor flexible.
• Límites en Azure Database for PostgreSQL: servidor flexible.