Amazon Relational Database Service
用户指南 (API 版本 2014-10-31)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

Amazon RDS 数据库日志文件

您可以使用 Amazon RDS 控制台、AWS Command Line Interface (AWS CLI) 或 Amazon RDS API 查看、下载和观看数据库日志。不支持查看、下载或监视事务日志。

有关特定引擎的文档,请参阅以下内容。

数据库引擎 相关文档

MariaDB

您可访问错误日志、慢查询日志和常规日志。有关更多信息,请参阅 MariaDB 数据库日志文件

Microsoft SQL Server

您可访问 SQL Server 错误日志、代理日志和跟踪文件。有关更多信息,请参阅 Microsoft SQL Server 数据库日志文件

MySQL

您可访问错误日志、慢查询日志和常规日志。有关更多信息,请参阅 MySQL 数据库日志文件

Oracle

您可访问 Oracle 警报日志、审计文件和跟踪文件。有关更多信息,请参阅 Oracle 数据库日志文件

PostgreSQL

您可访问查询日志和错误日志。错误日志可包含 auto-vacuum 和连接信息以及 rds_admin 操作。有关更多信息,请参阅 PostgreSQL 数据库日志文件

查看和列出数据库日志文件

您可以使用 Amazon RDS 控制台查看适用于数据库引擎的数据库日志文件。您可使用 AWS CLI 或 Amazon RDS API 列出可下载或监控的日志文件。

注意

如果无法查看现有 Oracle 数据库实例的日志文件的列表,请重启该实例以查看列表。

AWS 管理控制台

要查看数据库日志文件,请执行以下操作

  1. 通过以下网址打开 Amazon RDS 控制台:https://console.amazonaws.cn/rds/

  2. 在导航窗格中,选择实例

  3. 单击要查看其日志文件的数据库实例的名称。

  4. 向下滚动到日志部分。

  5. Logs 部分中,选择要查看的日志,然后选择 View

CLI

要列出数据库实例的可用数据库日志文件,请使用 AWS CLI describe-db-log-files 命令。

以下示例将返回名为 my-db-instance 的数据库实例的日志文件列表。

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

API

要列出数据库实例的可用数据库日志文件,请使用 Amazon RDS API DescribeDBLogFiles 操作。

下载数据库日志文件

您可使用 Amazon RDS 控制台、AWS CLI 或 API 下载数据库日志文件。

AWS 管理控制台

要下载数据库日志文件,请执行以下操作

  1. 通过以下网址打开 Amazon RDS 控制台:https://console.amazonaws.cn/rds/

  2. 在导航窗格中,选择实例

  3. 单击要查看其日志文件的数据库实例的名称。

  4. 向下滚动到日志部分。

  5. 日志部分中,选择要下载的日志旁边的按钮,然后选择下载

  6. 打开提供的链接的上下文 (右键单击) 菜单,然后选择将链接另存为。键入您希望保存日志文件的位置,然后选择保存

     查看日志文件

CLI

要下载数据库日志文件,请使用 AWS CLI 命令 download-db-log-file-portion。默认情况下,此命令仅下载日志文件的最新部分;但是,您可通过指定参数 --starting-token 0 来下载整个文件。

以下示例演示如何下载一个名为 log/ERROR.4 的日志文件的全部内容并将其存储在一个名为 errorlog.txt 的本地文件中。

针对 Linux、OS X 或 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

对于 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

API

要下载数据库日志文件,请使用 Amazon RDS API DownloadDBLogFilePortion 操作。

监视数据库日志文件

您可使用 Amazon RDS 控制台监视日志文件的内容。

AWS 管理控制台

要监视数据库日志文件,请执行以下操作

  1. 通过以下网址打开 Amazon RDS 控制台:https://console.amazonaws.cn/rds/

  2. 在导航窗格中,选择实例

  3. 单击要查看其日志文件的数据库实例的名称。

  4. Logs (日志) 窗格中,选择一个日志文件,然后选择 Watch (监视)

将数据库日志发布到 Amazon CloudWatch Logs

除了查看和下载数据库实例日志之外,您还可以将日志发布到 Amazon CloudWatch Logs 以进行实时分析。利用 CloudWatch Logs,可以对日志数据进行实时分析,并且可以使用 CloudWatch 创建警报和查看指标。您可以使用 CloudWatch Logs 在高持久性存储中存储日志数据,并且可以使用 CloudWatch Logs 代理对日志数据进行管理。

AWS 会无限期地保留已发布到 CloudWatch Logs 的日志数据,除非您指定了保留期。有关设置 CloudWatch 日志保留期的更多信息,请参阅更改 CloudWatch Logs 中的日志数据保留

有关将数据库日志发布到 CloudWatch Logs 的更多信息,请参阅以下内容:

使用 REST 读取日志文件内容

Amazon RDS 提供允许访问数据库实例日志文件的 REST 终端节点。如果您需要编写应用程序来流式传输 Amazon RDS 日志文件内容,则这很有用。

语法如下:

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

以下参数为必需参数:

  • DBInstanceIdentifier - 包含要下载的日志文件的数据库实例的名称。

  • LogFileName - 要下载的日志文件的名称。

响应将包含流形式的请求日志文件的内容。

以下示例为 us-west-2 区域中名为 sample-sql 的数据库实例下载名为 log/ERROR.6 的日志文件。

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

如果您指定的数据库实例不存在,则响应将包含以下错误:

  • DBInstanceNotFoundDBInstanceIdentifier 不引用现有数据库实例。(HTTP 状态代码: 404)