Trabajar con archivos Amazon RDS de registro de base de datos - Amazon Relational Database Service

Trabajar con archivos Amazon RDS de registro de base de datos

Puede ver, descargar y monitorear los registros de base de datos usando la Consola de administración de AWS, la AWS Command Line Interface (AWS CLI) o la API de Amazon RDS. Visualizar, descargar o monitorear registros de transacción no está permitido.

Visualización y descripción de archivos de registro de base de datos

Puede ver los archivos de registro de base de datos de su motor de base de datos con la Consola de administración de AWS. Puede ver los archivos de registro que están disponibles para su descarga o monitorización usando la AWS CLI o la API de Amazon RDS.

nota

Si no puede ver la lista de archivos de registro para una instancia de base de datos de Oracle, reinicie la instancia para ver la lista.

Para ver un archivo de registro de base de datos

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

  2. En el panel de navegación, seleccione Databases (Bases de datos).

  3. Seleccione el nombre de la instancia de base de datos que tiene el archivo de registro que desea visualizar.

  4. Seleccione la pestaña Logs & events (Registros y eventos).

  5. Desplácese hacia abajo hasta la sección Logs.

  6. En la sección Logs (Registros), elija el registro que quiera visualizar y, a continuación, elija View (Ver).

Para ver los archivos de registro de base de datos disponibles para una instancia de base de datos, use el comando describe-db-log-files de la AWS CLI.

El siguiente ejemplo devuelve una lista de los archivos de registro de una instancia de base de datos denominada my-db-instance.

ejemplo

aws rds describe-db-log-files --db-instance-identifier my-db-instance

Para ver los archivos de registro de base de datos de una instancia de base de datos, use la acción DescribeDBLogFiles de la API de Amazon RDS.

Descarga de un archivo de registro de base de datos

Puede usar la Consola de administración de AWS, la AWS CLI o la API para descargar un archivo de registro de base de datos.

Para descargar un archivo de registro de base de datos

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

  2. En el panel de navegación, seleccione Databases (Bases de datos).

  3. Seleccione el nombre de la instancia de base de datos que tiene el archivo de registro que desea visualizar.

  4. Seleccione la pestaña Logs & events (Registros y eventos).

  5. Desplácese hacia abajo hasta la sección Logs.

  6. En la sección Logs (Registros), elija el botón junto al registro que desee descargar y, a continuación, elija Download (Descargar).

  7. Abra el menú contextual (haga clic con el botón derecho) del enlace que se proporciona y elija Save Link As (Guardar enlace como). Escriba la ubicación en la que desee guardar el archivo de registro y elija Save (Guardar).

    
								visualización de archivo de registro

Para descargar un archivo de registro de base de datos, use el comando download-db-log-file-portion de la AWS CLI. De forma predeterminada, este comando solo descarga la última porción de un archivo de registro. Sin embargo, puede descargar un archivo entero especificando el parámetro --starting-token 0.

En el siguiente ejemplo se muestra cómo descargar todo el contenido de un archivo de registro llamado log/ERROR.4 y almacenarlo en un archivo local denominado errorlog.txt.

ejemplo

Para Linux, macOS o Unix:

aws rds download-db-log-file-portion \ --db-instance-identifier myexampledb \ --starting-token 0 --output text \ --log-file-name log/ERROR.4 > errorlog.txt

Para Windows:

aws rds download-db-log-file-portion ^ --db-instance-identifier myexampledb ^ --starting-token 0 --output text ^ --log-file-name log/ERROR.4 > errorlog.txt

Para descargar un archivo de registro de base de datos, use la acción DownloadDBLogFilePortion de la API de Amazon RDS.

Ver un archivo de registro de base de datos

Puede monitorear el contenido de un archivo de registro usando la Consola de administración de AWS.

Consola

Para monitorizar un archivo de registro de base de datos

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

  2. En el panel de navegación, seleccione Databases (Bases de datos).

  3. Seleccione el nombre de la instancia de base de datos que tiene el archivo de registro que desea visualizar.

  4. Seleccione la pestaña Logs & events (Registros y eventos).

  5. En la sección Logs (Registros), elija un archivo de registro y, a continuación, elija Watch (Ver).

Publicación de registros de base de datos en Amazon CloudWatch Logs

Además de ver y descargar registros de instancias de base de datos, también puede publicarlos en Amazon CloudWatch Logs. Con CloudWatch Logs, puede realizar análisis de los datos de registro en tiempo real, almacenar los datos en almacenamiento de larga duración y administrar los datos con el agente de CloudWatch Logs. AWS retiene los datos de registro publicados en CloudWatch Logs durante un periodo de tiempo indefinido a menos que especifique un periodo de retención. Para obtener más información, consulte Cambiar la retención de datos de registro en CloudWatch Logs.

Configuración de la integración con CloudWatch Logs

Antes de habilitar la publicación de datos de registro, asegúrese de que tiene un rol vinculado a servicios en AWS Identity and Access Management (IAM). Para obtener más información acerca de los roles vinculados a servicios, consulte Uso de roles vinculados a servicios de Amazon RDS.

Para publicar archivos de registro de base de datos en CloudWatch Logs, elija los registros que desea publicar. Realice esta selección en la sección Advanced Settings al crear una instancia de base de datos nueva. También puede modificar una instancia de base de datos existente para comenzar la publicación.


					Adición de CloudWatch Logs

Una vez habilitada la publicación, Amazon RDS transfiere continuamente todos los registros de la instancia de base de datos a un grupo de registros. Por ejemplo, hay un grupo de registros /aws/rds/instance/log type para cada tipo de registro que se publica. Este grupo de registros se encuentra en la misma región de AWS que la instancia de base de datos que genera el registro.

Después de publicar los registros, puede utilizar CloudWatch Logs para buscar y filtrar los registros. Para obtener más información sobre la búsqueda y el filtrado registros, consulte Búsqueda y filtrado de datos de registros. Para ver un tutorial que explique cómo supervisar los registros de RDS, consulte Crear una supervisión proactiva de bases de datos para Amazon RDS con Amazon CloudWatch Logs, AWS Lambda y Amazon SNS .

Información de registro específica del motor

Si necesita documentación relativa a los motores, consulte lo siguiente:

Lectura del contenido del archivo de registro mediante REST

Amazon RDS proporciona un punto de enlace REST que permite el acceso a los archivos de registro de instancia de base de datos. Esto resulta útil si necesita escribir una aplicación para transmitir el contenido del archivo de registro de Amazon RDS.

La sintaxis es la siguiente:

GET /v13/downloadCompleteLogFile/DBInstanceIdentifier/LogFileName HTTP/1.1 Content-type: application/json host: rds.region.amazonaws.com

Se requieren los siguientes parámetros:

  • DBInstanceIdentifier: el nombre asignado de la instancia de base de datos que contiene el archivo de registro que se desea descargar.

  • LogFileName: el nombre del archivo de registro que se va a descargar.

La respuesta incluye el contenido del archivo de registro solicitado como una secuencia.

En el siguiente ejemplo se descarga el archivo de registro denominado log/ERROR.6 para la instancia de base de datos denominada sample-sql en la región us-west-2.

GET /v13/downloadCompleteLogFile/sample-sql/log/ERROR.6 HTTP/1.1 host: rds.us-west-2.amazonaws.com X-Amz-Security-Token: AQoDYXdzEIH//////////wEa0AIXLhngC5zp9CyB1R6abwKrXHVR5efnAVN3XvR7IwqKYalFSn6UyJuEFTft9nObglx4QJ+GXV9cpACkETq= X-Amz-Date: 20140903T233749Z X-Amz-Algorithm: AWS4-HMAC-SHA256 X-Amz-Credential: AKIADQKE4SARGYLE/20140903/us-west-2/rds/aws4_request X-Amz-SignedHeaders: host X-Amz-Content-SHA256: e3b0c44298fc1c229afbf4c8996fb92427ae41e4649b934de495991b7852b855 X-Amz-Expires: 86400 X-Amz-Signature: 353a4f14b3f250142d9afc34f9f9948154d46ce7d4ec091d0cdabbcf8b40c558

Si especifica una instancia de base de datos no existente, la respuesta consta del error siguiente:

  • DBInstanceNotFound: DBInstanceIdentifier no hace referencia a una instancia de base de datos existente. (Código de estado HTTP: 404)