你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
使用 Azure Database for PostgreSQL 可以配置和访问 Postgres 的标准日志。 这些日志可用于识别、排除和修复配置错误和性能不佳问题。 可以配置和访问的日志记录信息包括错误、查询信息、autovacuum 记录、连接和检查点。 （无法访问事务日志）。
审核日志是通过 Postgres 扩展 pgaudit 提供的。 有关详细信息，请访问审核的概念一文。
配置日志记录
可以使用日志记录服务器参数在服务器上配置 Postgres 标准日志记录。 若要详细了解 Postgres 日志参数，请访问 Postgres 文档的何时记录日志和记录哪些内容部分。 大多数（但不是全部）Postgres 日志记录参数都可用于在 Azure Database for PostgreSQL 中进行配置。
若要了解如何在 Azure Database for PostgreSQL 中配置参数，请参阅 门户文档 或 CLI 文档。
注意
若要配置大量日志，可以显著增加性能开销。 例如，语句日志记录可能会影响性能。
访问日志
Azure Database for PostgreSQL 与 Azure Monitor 诊断设置集成。 诊断设置允许将 JSON 格式的 PostgreSQL 日志发送到 Azure Monitor 日志进行分析和警报。 还可以将它们流式传输到事件中心，或在 Azure 存储中存档它们。
日志的访问控制
通过 Azure Role-Based 访问控制（RBAC）控制对服务器日志的访问。 提供对服务器读取访问权限的任何角色也允许下载日志。 这包括内置角色，例如：
- 读取者
- 监视读取者
- Log Analytics 读者
- 或等效的自定义角色
警告
日志可能包含敏感信息，例如凭据，具体取决于日志记录配置。
数据保留策略和定价
对于发送到事件中心或存储帐户的日志，可以设置保留策略，以便在某个时间段后自动删除数据。 Log Analytics 成本取决于两个因素：
- 数据引入：费用根据引入到工作区中的数据量来确定。
- 数据保留：存储在 Log Analytics 工作区中的日志在前 31 天内免费保留。 除了此免费保留期之外，存储数据的费用取决于每月保留的数据量（以 GB 为单位）。
有关与数据引入和保留相关的成本明细，请访问 Azure Monitor 定价页。
日志格式
下表描述了 PostgreSQLLogs 类型的字段。 根据所选的输出终结点，包括的字段及其显示顺序可能会有所不同。
| 字段 | 说明 |
|---|---|
| TenantId | 租户 ID |
| SourceSystem | Azure |
| 生成时间 (TimeGenerated) [UTC] | 记录日志时的时间戳 (UTC) |
| 类型 | 日志类型。 始终是 AzureDiagnostics |
| SubscriptionId | 服务器所属的订阅的 GUID |
| ResourceGroup | 服务器所属的资源组的名称 |
| ResourceProvider | 资源提供程序的名称。 始终是 MICROSOFT.DBFORPOSTGRESQL |
| ResourceType | FlexibleServers |
| ResourceId | 资源 URI |
| 资源 | 服务器的名称 |
| 类别 | PostgreSQLLogs |
| OperationName | LogEvent |
| errorLevel_s | 日志记录级别，示例：LOG、ERROR、NOTICE |
| processId_d | PostgreSQL 后端的进程 ID |
| sqlerrcode_s | PostgreSQL 错误代码，遵循 SQL 标准版针对 SQLSTATE 代码的约定 |
| 消息 | 主要日志消息 |
| 详细信息 | 辅助日志消息（如果适用） |
| ColumnName | 列名称（如果适用） |
| SchemaName | 架构名称（如果适用） |
| DatatypeName | 数据类型名称（如果适用） |
| _ResourceId | 资源 URI |
已知的限制
- 日志事件大小：Azure Monitor 日志中未捕获大于 65 KB 的查询计划或日志消息。 这是平台范围的 Azure Monitor 限制。 因此，复杂的查询（例如，涉及嵌套视图的查询）可能会在服务器日志中生成不完整或缺失的查询计划输出。
- 其他约束：其他平台范围限制适用于 Azure Monitor 日志，例如警报规则配额和查询结果大小。 有关完整列表，请参阅 Azure Monitor 服务限制文档了解详细信息。