Archivos de registro de base de datos de MariaDB - Amazon Relational Database Service

Archivos de registro de base de datos de MariaDB

Puede monitorizar el registro de errores, el registro de consultas lentas y el registro general de MariaDB. El registro de error de MariaDB se genera de forma predeterminada. Para generar la consulta lenta y los registros generales, establezca parámetros en su grupo de parámetros de base de datos. Amazon RDS rota todos los archivos de registro de MariaDB; los intervalos para cada tipo se indican a continuación.

Puede monitorear los registros de MariaDB directamente desde la consola de Amazon RDS, la API de Amazon RDS, la CLI de Amazon RDS o los SDK de AWS. También puede obtener acceso a los registros de MariaDB dirigiéndolos a una tabla de la base de datos principal y consultando esa tabla. Puede usar la utilidad mysqlbinlog para descargar un registro binario.

Para obtener más información acerca de la visualización, descarga y vigilancia de los registros de bases de datos basados en archivos, consulte Supervisión de archivos de registro de Amazon RDS.

Acceso a los registros de errores de MariaDB

El registro de errores de MariaDB se escribe en el archivo <host-name>.err. Puede ver este archivo en la consola de Amazon RDS o recuperando el registro con la API de Amazon RDS, la CLI de Amazon RDS o los SDK de AWS. El archivo <host-name>.err se vacía cada 5 minutos y su contenido se agrega a mysql-error-running.log. El archivo mysql-error-running.log rota cada hora, y se conservan los archivos generados cada hora durante las últimas 24 horas. Cada archivo de registro tiene la hora a la que se generó (en UTC) agregada a su nombre. Los archivos de registro también tienen una marca temporal que ayuda a determinar cuándo se escribieron las entradas del registro.

MariaDB solo escribe en el registro de errores durante el inicio, el cierre y cuando encuentra errores. Una instancia de base de datos puede pasar horas o días sin que se escriban nuevas entradas en el registro de errores. Si no hay entradas recientes, se debe a que el servidor no ha encontrado ningún error que haya generado una entrada en el registro.

Acceso al registro de consultas lentas y al registro general de MariaDB

El registro de consultas lentas y el registro general de MariaDB se pueden escribir en un archivo o en una tabla de base de datos configurando parámetros del grupo de parámetros de base de datos. Para obtener información acerca de cómo crear y modificar un grupo de parámetros de base de datos, consulte Trabajo con los grupos de parámetros. Debe definir estos parámetros para poder ver el registro de consultas lentas o el registro general en la consola de Amazon RDS o a través de la API de Amazon RDS, la AWS CLI o los SDK de AWS.

Puede controlar lo que registra MariaDB con los parámetros de esta lista:

  • slow_query_log: para crear el registro de consultas lentas, use el valor 1. El valor predeterminado es 0.

  • general_log: para crear el registro general, use el valor 1. El valor predeterminado es 0.

  • long_query_time: para evitar que se registren consultas rápidas en el registro de consultas lentas, especifique el valor del tiempo de ejecución mínimo de una consulta, en segundos, para que se registre. El valor predeterminado es 10 segundos y el mínimo es 0. Si log_output = FILE, puede especificar un valor de punto flotante que llega a una resolución de microsegundos. Si log_output = TABLE, debe especificar un valor entero con resolución de segundos. Solo se registran las consultas cuyo tiempo de ejecución exceda el valor de long_query_time. Por ejemplo, si configura long_query_time como 0,1, evitará que se registren las consultas que tarden menos de 100 milisegundos en ejecutarse.

  • log_queries_not_using_indexes: para incluir en el registro de consultas lentas todas las consultas que no usen un índice, defina este parámetro como 1. El valor predeterminado es 0. Las consultas que no usen un índice se registran incluso si su tiempo de ejecución es inferior al valor del parámetro long_query_time.

  • log_output option: puede especificar una de las opciones siguientes para el parámetro log_output:

    • TABLE (predeterminada): las consultas generales se escriben en la tabla mysql.general_log y las consultas lentas en la tabla mysql.slow_log.

    • FILE: tanto los registros de las consultas generales como los de las consultas lentas se escriben en el sistema de archivos. Los archivos de registro se rotan cada hora.

    • NONE: deshabilitar registro.

Cuando el registro está habilitado, Amazon RDS rota los registros de las tablas o elimina los archivos de registro a intervalos regulares. Esta medida es una precaución para reducir el riesgo de que un archivo de registro grande bloquee el uso de la base de datos o afecte al rendimiento. El registro con las opciones FILE y TABLE emplea la rotación y eliminación del modo siguiente:

  • Cuando está activado el registro FILE, los archivos de registro se examinan cada hora, y los que tienen una antigüedad superior a 24 horas se eliminan. En algunos casos, el tamaño restante del archivo de registro combinado después de la eliminación puede superar el umbral del 2 por ciento del espacio asignado a una instancia de base de datos. En estos casos, los archivos de registro más grandes se eliminan hasta que el tamaño del archivo de registro no sobrepase el umbral.

  • Cuando el registro de tipo TABLE está habilitado, en algunos casos, las tablas de registro se rotan cada 24 horas. Esta rotación de produce cuando el espacio ocupado por los registros de tabla es superior al 20% del espacio de almacenamiento asignado o si el tamaño de todos los registros combinados es superior a 10 GB. Si la cantidad de espacio utilizada para una instancia de base de datos es superior al 90% del espacio de almacenamiento asignado a la instancia de base de datos, se reducen los umbrales de la rotación de registros. En este caso las tablas de registro rotan cuando el espacio ocupado por los registros es superior al 10% del almacenamiento asignado o si el tamaño de todos los registros combinados es superior a 5 GB.

    Cuando se rotan las tablas de registro, la tabla de registro actual se copia en una tabla de registro de copia de seguridad y las entradas de la tabla de registro actual se eliminan. Si la tabla de registro de copia de seguridad ya existe, se elimina antes de copiar la tabla del registro actual en la copia de seguridad. Puede consultar la tabla de registro de copia de seguridad si es necesaria. La tabla de registro de copia de seguridad para la tabla mysql.general_log se llama mysql.general_log_backup. La tabla de registro de copia de seguridad para la tabla mysql.slow_log se llama mysql.slow_log_backup.

    Para rotar la tabla mysql.general_log puede ejecutar el procedimiento mysql.rds_rotate_general_log. Para rotar la tabla mysql.slow_log puede ejecutar el procedimiento mysql.rds_rotate_slow_log.

    Los registros de tabla se rotan durante una actualización de la versión de la base de datos.

Amazon RDS registra la rotación de registros de TABLE y de FILE en un evento de Amazon RDS y envía una notificación.

Para trabajar con los registros desde la consola de Amazon RDS, la API de Amazon RDS, la CLI de Amazon RDS o los SDK de AWS, configure el parámetro log_output en FILE. Al igual que el registro de errores de MariaDB, estos archivos de registro rotan cada hora. Se conservan los archivos de registro que se generaron durante las 24 horas anteriores.

Para obtener más información acerca de los registros de consultas lentas y general, vaya a los siguientes temas de la documentación de MariaDB:

Publicación de registros de MariaDB en Amazon CloudWatch Logs

Se puede configurar una instancia de base de datos MariaDB para publicar datos de registro en un grupo de registros en Amazon CloudWatch Logs. Con CloudWatch Logs, puede realizar análisis en tiempo real de los datos de registro y utilizar CloudWatch para crear alarmas y ver métricas. Puede utilizar CloudWatch Logs para almacenar los registros de registros en almacenamiento de larga duración.

Amazon RDS publica cada registro de base de datos de MariaDB como un flujo de base de datos independiente en el grupo de registros. Por ejemplo, si configura la función de exportación para que incluya el registro de consultas lentas, los datos de consultas lentas se almacenan en un flujo de registros de consultas lentas en el grupo de registros /aws/rds/instance/my_instance/slowquery.

El registro de errores están habilitados de forma predeterminada. La tabla siguiente resume los requisitos para los otros registros de MariaDB.

Registro Requisito

Registro de auditoría

La instancia de base de datos debe usar un grupo de opciones personalizado con la opción MARIADB_AUDIT_PLUGIN.

Registro general

La instancia de base de datos debe usar un grupo de parámetros personalizado con la configuración del parámetro general_log = 1 para habilitar el registro general.

Registro de consultas lentas

La instancia de base de datos debe usar un grupo de parámetros personalizado con la configuración del parámetro slow_query_log = 1 para habilitar el registro de consultas lentas.

Resultado de registro

La instancia de base de datos debe usar un grupo de parámetros personalizado con la configuración del parámetro log_output = FILE para escribir registros en el sistema de archivos y publicarlos en CloudWatch Logs.

Para publicar registros de MariaDB en CloudWatch Logs desde la consola

  1. Abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

  2. En el panel de navegación, elija Databases (Bases de datos) y, a continuación, seleccione la instancia de base de datos que desee modificar.

  3. Elija Modify.

  4. En la sección Logs exports (Exportaciones de registros), elija los registros que desea comenzar a publicar en CloudWatch Logs.

  5. Elija Continue, seguido de Modify DB Instance en la página de resumen.

Puede publicar registros de base de datos MariaDB con la AWS CLI. Puede llamar al comando modify-db-instance con los parámetros siguientes:

  • --db-instance-identifier

  • --cloudwatch-logs-export-configuration

nota

Los cambios en la opción --cloudwatch-logs-export-configuration siempre se aplican a la instancia de base de datos inmediatamente. Por lo tanto, las opciones --apply-immediately y --no-apply-immediately no tienen ningún efecto.

También puede publicar registros de MariaDB si llama a los siguientes comandos de la AWS CLI:

Ejecute uno de estos comandos de la AWS CLI con las siguientes opciones:

  • --db-instance-identifier

  • --enable-cloudwatch-logs-exports

  • --db-instance-class

  • --engine

Podrían ser necesarias otras opciones en función del comando de la AWS CLI que ejecute.

ejemplo

En el siguiente ejemplo se modifica una instancia de base de datos MariaDB existente para publicar archivos de registro en CloudWatch Logs. El valor --cloudwatch-logs-export-configuration es un objeto JSON. La clave de este objeto es EnableLogTypes y su valor es una matriz de cadenas con cualquier combinación de audit, error, general y slowquery.

Para Linux, macOS o Unix:

aws rds modify-db-instance \ --db-instance-identifier mydbinstance \ --cloudwatch-logs-export-configuration '{"EnableLogTypes":["audit","error","general","slowquery"]}'

Para Windows:

aws rds modify-db-instance ^ --db-instance-identifier mydbinstance ^ --cloudwatch-logs-export-configuration '{"EnableLogTypes":["audit","error","general","slowquery"]}'

ejemplo

El siguiente comando crea una instancia de base de datos MariaDB y publica archivos de registro en CloudWatch Logs. El valor --enable-cloudwatch-logs-exports es una matriz de cadenas JSON. Las cadenas pueden ser cualquier combinación de audit, error, general y slowquery.

Para Linux, macOS o Unix:

aws rds create-db-instance \ --db-instance-identifier mydbinstance \ --enable-cloudwatch-logs-exports '["audit","error","general","slowquery"]' \ --db-instance-class db.m4.large \ --engine mariadb

Para Windows:

aws rds create-db-instance ^ --db-instance-identifier mydbinstance ^ --enable-cloudwatch-logs-exports '["audit","error","general","slowquery"]' ^ --db-instance-class db.m4.large ^ --engine mariadb

Puede publicar registros de MariaDB con la API de RDS. Puede realizar una llamada a la operación ModifyDBInstance con los parámetros siguientes:

  • DBInstanceIdentifier

  • CloudwatchLogsExportConfiguration

nota

Los cambios en el parámetro CloudwatchLogsExportConfiguration siempre se aplican a la instancia de base de datos inmediatamente. Por tanto, el parámetro ApplyImmediately no tiene efecto.

También puede publicar registros de MariaDB llamando a las siguientes operaciones de la API de RDS:

Ejecute una de estas operaciones de la API de RDS con los siguientes parámetros:

  • DBInstanceIdentifier

  • EnableCloudwatchLogsExports

  • Engine

  • DBInstanceClass

Podrían ser necesarios otros parámetros en función del comando de la AWS CLI que ejecute.

Tamaño del archivo de registro

El tamaño de los archivos de registro de consultas lentas, registro de errores y registro general de MariaDB está limitado al 2 por ciento del espacio de almacenamiento asignado a una instancia de base de datos. Para mantener este umbral, los registros se rotan automáticamente cada hora y los que tienen una antigüedad superior a 24 horas se eliminan. Si el tamaño combinado de los archivos de registro sobrepasa el umbral después de eliminar los archivos de registro antiguos, los archivos de registro más grandes se eliminan hasta que el tamaño del archivo de registro deje de sobrepasar el umbral.

Administración de registros de MariaDB basados en tablas

Para dirigir los registros general y de consultas lentas a tablas de la instancia de base de datos, cree un grupo de parámetros de base de datos y asigne al parámetro log_output del servidor el valor TABLE. Las consultas generales se registrarán entonces en la tabla mysql.general_log y las consultas lentas en la tabla mysql.slow_log. Puede consultar las tablas para obtener acceso a la información del registro. Al habilitar este registro, se incrementa la cantidad de datos que se escribe en la base de datos, lo que puede degradar el desempeño.

Tanto el registro general como los registros de consultas lentas están deshabilitados de manera predeterminada. Para habilitar el registro en tablas, también debe asignar a los parámetros general_log y slow_query_log del servidor el valor 1.

Las tablas de registro seguirán creciendo hasta que las actividades de registro respectivas se desactiven cambiando el valor del parámetro a 0. A menudo, se acumula una gran cantidad de datos, lo que puede consumir un porcentaje elevado del espacio de almacenamiento asignado. Amazon RDS no permite truncar las tablas de registro, pero sí mover su contenido. Al rotar una tabla, su contenido se guarda en una tabla de copia de seguridad y se crea una nueva tabla de registro vacía. Puede aplicar manualmente la rotación de las tablas de registro con los procedimientos de línea de comandos siguientes, en los que el símbolo del sistema se representa por PROMPT>:

PROMPT> CALL mysql.rds_rotate_slow_log; PROMPT> CALL mysql.rds_rotate_general_log;

Para eliminar por completo los datos antiguos y recuperar el espacio del disco, llame al procedimiento correspondiente dos veces consecutivas.

Formato de registro binario

MariaDB en Amazon RDS admite los formatos de registro binario basado en filas, basado en instrucciones y mixto. El formato de registro binario predeterminado es el mixto. Para obtener información detallada acerca de los formatos de registro binarios de MariaDB, consulte Binary Log Formats en la documentación de MariaDB.

Si tiene pensado utilizar la replicación, el formato de registro binario es importante porque determina el registro de los cambios de datos que se registra en la fuente y se envía a los objetivos de replicación. Para obtener más información acerca de las ventajas y desventajas de distintos tipos de formatos de registro binarios para la replicación, consulte Advantages and Disadvantages of Statement-Based and Row-Based Replication en la documentación de MySQL.

importante

La configuración del formato de registro binario como basado en filas puede generar archivos de registro binario muy grandes. Los archivos de registro binario grandes reducen la cantidad de almacenamiento disponible para una instancia de base de datos y pueden incrementar la cantidad de tiempo necesaria para llevar a cabo la operación de restauración de una instancia de base de datos.

La replicación basada en instrucciones puede causar incoherencias entre la instancia de base de datos de origen y la réplica de lectura. Para obtener más información, consulte Unsafe Statements for Statement-based Replication en la documentación de MariaDB.

Para configurar el formato de registro binario de MariaDB

  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

  2. En el panel de navegación, seleccione Parameter groups (Grupos de parámetros).

  3. Elija el grupo de parámetros utilizados por la instancia de base de datos que quiera modificar.

    No puede modificar un grupo de parámetros predeterminado. Si la instancia de base de datos emplea un grupo de parámetros predeterminado, cree un nuevo grupo de parámetros y asócielo con la instancia de base de datos.

    Para obtener más información acerca de los grupos de parámetros de base de datos, consulte Trabajo con los grupos de parámetros.

  4. En Parameter group actions (Acciones de grupos de parámetros), seleccione Edit (Editar).

  5. Establezca el parámetro binlog_format en el formato de registro binario de su elección (ROW, STATEMENT o MIXED).

  6. Elija Save Changes (Guardar cambios) para guardar los cambios realizados en el grupo de parámetros de base de datos.

Acceso a los registros binarios de MariaDB

Puede usar la utilidad mysqlbinlog para descargar los registros binarios en formato de texto desde las instancias de base de datos de MariaDB. El registro binario se descarga en su equipo local. Para obtener más información acerca del uso de la utilidad mysqlbinlog, vaya a Using mysqlbinlog en la documentación de MariaDB.

Para ejecutar la utilidad mysqlbinlog en una instancia de Amazon RDS, use las siguientes opciones:

  • Especifique la opción --read-from-remote-server.

  • --host: especifique el nombre de DNS del punto de conexión de la instancia.

  • --port: especifique el puerto que utiliza la instancia.

  • --user: especifique un usuario de MariaDB al que se haya asignado el permiso de esclavo de replicación.

  • --password: especifique la contraseña del usuario o no indique ninguna para que la utilidad pida una contraseña.

  • --result-file: especifique el archivo local que recibirá la salida.

  • Especifique los nombres de uno o varios de los archivos de registro binarios. Para obtener una lista de los registros disponibles, use el comando SHOW BINARY LOGS de SQL.

Para obtener más información acerca de las opciones de mysqlbinlog, vaya a mysqlbinlog Options en la documentación de MariaDB.

A continuación se muestra un ejemplo:

Para Linux, macOS o Unix:

mysqlbinlog \ --read-from-remote-server \ --host=mariadbinstance1.1234abcd.region.rds.amazonaws.com \ --port=3306 \ --user ReplUser \ --password <password> \ --result-file=/tmp/binlog.txt

Para Windows:

mysqlbinlog ^ --read-from-remote-server ^ --host=mariadbinstance1.1234abcd.region.rds.amazonaws.com ^ --port=3306 ^ --user ReplUser ^ --password <password> ^ --result-file=/tmp/binlog.txt

Normalmente, Amazon RDS limpia un registro binario lo antes posible, pero el registro binario debe seguir estando disponible en la instancia para que mysqlbinlog pueda obtener acceso a él. Para especificar el número de horas que RDS debe retener los archivos binarios, utilice el procedimiento almacenado mysql.rds_set_configuration y especifique un periodo lo bastante largo como para descargar los registros. Una vez que haya definido el periodo de retención, monitorice el uso del almacenamiento para la instancia de base de datos con el fin de asegurarse de que los registros binarios conservados no consumen demasiado almacenamiento.

En el siguiente ejemplo se define el periodo de retención en 1 día:

call mysql.rds_set_configuration('binlog retention hours', 24);

Para mostrar el valor actual, utilice el procedimiento almacenado mysql.rds_show_configuration.

call mysql.rds_show_configuration;

Anotación de registros binarios

En una instancia de base de datos de MariaDB, puede usar el evento Annotate_rows para incluir en un evento de fila una copia de la consulta de SQL que causó el evento de fila. Este enfoque proporciona una funcionalidad similar a la habilitación del parámetro binlog_rows_query_log_events en una instancia de base de datos de RDS para MySQL.

Puede habilitar globalmente las anotaciones de registros binarios creando un grupo de parámetros personalizado y definiendo el parámetro binlog_annotate_row_events como 1. También puede habilitar las anotaciones en el nivel de sesión llamando a SET SESSION binlog_annotate_row_events = 1. Use replicate_annotate_row_events para reproducir las anotaciones de registros binarios en la instancia réplica si el registro binario está habilitado en ella. No se requieren privilegios especiales para usar estos ajustes.

A continuación se muestra un ejemplo de una transacción basada en filas de MariaDB. El uso del registro basado en filas se dispara definiendo el nivel de aislamiento de transacciones como de lectura confirmada.

CREATE DATABASE IF NOT EXISTS test; USE test; CREATE TABLE square(x INT PRIMARY KEY, y INT NOT NULL) ENGINE = InnoDB; SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED; BEGIN INSERT INTO square(x, y) VALUES(5, 5 * 5); COMMIT;

Sin anotaciones, las entradas de los registros binarios de la transacción tendrán un aspecto similar al siguiente:

BEGIN /*!*/; # at 1163 # at 1209 #150922 7:55:57 server id 1855786460 end_log_pos 1209 Table_map: `test`.`square` mapped to number 76 #150922 7:55:57 server id 1855786460 end_log_pos 1247 Write_rows: table id 76 flags: STMT_END_F ### INSERT INTO `test`.`square` ### SET ### @1=5 ### @2=25 # at 1247 #150922 7:56:01 server id 1855786460 end_log_pos 1274 Xid = 62 COMMIT/*!*/;

La siguiente instrucción habilita las anotaciones de nivel de sesión para esta misma transacción y las deshabilita después de confirmar la transacción:

CREATE DATABASE IF NOT EXISTS test; USE test; CREATE TABLE square(x INT PRIMARY KEY, y INT NOT NULL) ENGINE = InnoDB; SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED; SET SESSION binlog_annotate_row_events = 1; BEGIN; INSERT INTO square(x, y) VALUES(5, 5 * 5); COMMIT; SET SESSION binlog_annotate_row_events = 0;

Con anotaciones, las entradas de los registros binarios de la transacción tendrán un aspecto similar al siguiente:

BEGIN /*!*/; # at 423 # at 483 # at 529 #150922 8:04:24 server id 1855786460 end_log_pos 483 Annotate_rows: #Q> INSERT INTO square(x, y) VALUES(5, 5 * 5) #150922 8:04:24 server id 1855786460 end_log_pos 529 Table_map: `test`.`square` mapped to number 76 #150922 8:04:24 server id 1855786460 end_log_pos 567 Write_rows: table id 76 flags: STMT_END_F ### INSERT INTO `test`.`square` ### SET ### @1=5 ### @2=25 # at 567 #150922 8:04:26 server id 1855786460 end_log_pos 594 Xid = 88 COMMIT/*!*/;