Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

RDS for PostgreSQL 中的日志记录参数

您可以通过修改各种参数来自定义 RDS for PostgreSQL 数据库实例的日志记录行为。在下表中，您可以找到影响日志存储时间长度、何时轮换日志和是否以 CSV（逗号分隔值）格式输出日志的参数。您还可以找到发送到 STDERR 的文本输出以及其他设置。要更改可修改的参数的设置，请为以下项目使用自定义数据库参数组： RDS for PostgreSQL 实例。有关更多信息，请参阅Amazon RDS 数据库实例的数据库参数组。如表中所述，无法更改 log_line_prefix。

要识别应用程序问题，您可以在日志中查找查询失败、登录失败、死锁和致命的服务器错误。例如，假设您将旧版应用程序从 Oracle 转换为 Amazon RDS PostgreSQL，但部分查询可能未正确转换。这些格式不正确的查询会生成错误消息，您可以在日志中找到这些错误消息以帮助识别问题。有关日志记录查询的更多信息，请参阅 为您的 RDS for PostgreSQL 数据库实例开启查询日志记录。

在以下主题中，您可以找到有关如何设置各种参数（用于控制 PostgreSQL 日志的基本详细信息）的信息。

设置日志保留期

rds.log_retention_period 参数指定 RDS for PostgreSQL 数据库实例将其日志文件保留多长时间。原定设置为 3 天（4320 分钟），但您可以将此值设置为 1 天（1440 分钟）到 7 天（10080 分钟）之间的任意值。确保您的 RDS for PostgreSQL 数据库实例具有足够的存储空间，可将日志文件保留一段时间。

建议您将日志定期发布到 Amazon CloudWatch Logs，以便您可以在日志从 RDS for PostgreSQL 数据库实例中删除很久之后查看和分析系统数据。有关更多信息，请参阅 将 PostgreSQL 日志发布到 Amazon CloudWatch Logs。

设置日志文件轮换

原定设置情况下，Amazon RDS 每小时都会创建新的日志文件。计时由 log_rotation_age 参数控制。此参数的原定设置值为 60（分钟），但您可以将其设置为 1 分钟到 24 小时（1440 分钟）之间的任意值。轮换时，系统将创建一个新的不同日志文件。该文件根据 log_filename 参数指定的模式命名。

也可以根据日志文件的大小进行轮换（如 log_rotation_size 参数指定）。此参数指定在日志达到指定的大小（以千字节为单位）时应轮换日志。对于 RDS for PostgreSQL 数据库实例，log_rotation_size 未设置，也就是说，未指定任何值。但是，您可以将该参数设置为 0-2097151KB（千字节）之间。

日志文件名基于在 log_filename 参数中指定的文件名模式。此参数的可用设置如下：

有关更多信息，请参阅 PostgreSQL 文档中的 log_rotation_age 和 log_rotation_size。

设置日志目标（stderr、csvlog）

默认情况下，Amazon RDS PostgreSQL 以标准错误 (stderr) 格式生成日志。此格式是 log_destination 参数的原定设置。每条消息都使用在 log_line_prefix 参数中指定的模式作为前缀。有关更多信息，请参阅 了解 log_line_prefix 参数。

RDS for PostgreSQL 也可以按 csvlog 格式生成日志。csvlog 用于将日志数据作为逗号分隔值（CSV）数据进行分析。例如，假设您使用 log_fdw 扩展将日志作为外部表处理。在 stderr 日志文件上创建的外部表包含一个列，其中包含日志事件数据。通过向 csvlog 参数添加 log_destination，可以获得 CSV 格式的日志文件，其中对外部表的多个列进行了分界。您现在可以更轻松地对日志进行排序和分析。要了解如何将 log_fdw 与 csvlog 结合使用，请参阅 使用 log_fdw 扩展通过 SQL 访问数据库日志。

如果您为此参数指定 csvlog，请注意将同时生成 stderr 和 csvlog 文件。确保监控日志所占用的存储空间，同时考虑 rds.log_retention_period 以及影响日志存储和周转的其他设置。使用 stderr 和 csvlog 会使日志占用的存储空间增加一倍以上。

如果将 csvlog 添加到 log_destination 并想单独恢复到 stderr，则需要重置参数。为此，请打开 Amazon RDS 控制台，然后为您的实例打开自定义数据库参数组。选择 log_destination 参数，选择 Edit parameter（编辑参数），然后选择 Reset（重置）。

有关配置日志记录的更多信息，请参阅使用 Amazon RDS 和 Aurora PostgreSQL 日志：第 1 部分。

了解 log_line_prefix 参数

stderr 日志格式将由 log_line_prefix 参数指定的详细信息作为每条日志消息的前缀，如下所示。

%t:%r:%u@%d:[%p]:t

您无法更改此设置。因此，发送到 stderr 的每个日志条目都包含以下信息。