一、前提条件
使用该功能前，请确保：
·已完成 日志服务 CLS 开通。
·已为 PostgreSQL 创建服务角色，并完成授权。
二、错误日志定义
| 字段值 | 类型 | 说明 |
| Timestamp | – | CLS 的保留字段，代表日志产生时间。 |
| InstanceId | String | 数据库实例 ID，例如 postgres-xxx。 |
| Database | Long | 客户端连接数据库实例所使用的 database。 |
| UserName | String | 客户端连接数据库实例所使用的用户名。 |
| ErrMsg | String | 错误日志 SQL 原始日志。 |
| ErrTime | String | 错误发生时间。 |
三、慢日志定义
| 字段值 | 类型 | 说明 |
| Timestamp | – | CLS 的保留字段，代表日志产生时间。 |
| InstanceId | String | 数据库实例 ID，例如 postgres-xxx。 |
| DatabaseName | String | 客户端连接的 database。 |
| UserName | String | 客户端连接的 user。 |
| RawQuery | String | 慢日志内容。 |
| Duration | String | 持续时间。 |
| ClientAddr | String | 客户端地址。 |
| SessionStartTime | Unix 时间戳 | session 开始时间。 |
四、开启慢日志投递
1. 登录 云数据库 PostgreSQL 控制台，在实例列表，单击实例 ID 进入管理页面。
2. 在实例管理页，选择性能优化 > 日志投递。
3. 首次启用日志投递功能需要开通 CLS 日志服务和为 PostgreSQL 创建服务角色，并完成授权。具体操作如下。如果已完成，则忽略。
3.1 开通 CLS 日志服务
3.1.1 单击前往开通，前往 CLS 控制台 开通 CLS 日志服务。
3.1.2 单击立即开通，开通 CLS 日志服务。
3.2 为 PostgreSQL 创建服务角色，并完成授权。
3.2.1 单击前往授权。
3.2.2 单击同意授权，自动为 PostgreSQL 创建服务角色，并完成授权。
4. 在慢查询日志投递中，单击立即启用按钮。
5. 在弹窗内完成如下配置，单击立即开启。
| 参数 | 说明 |
| 目标地域 | 选择日志投递的地域，支持异地投递。 |
| 日志主题操作 | 日志主题是日志数据进行采集、存储、检索和分析的基本单元，支持选择已有日志主题或者创建日志主题。 |
| 选择已有日志主题 | 若日志主题操作设置为“选择已有日志主题”，则需进一步选择已有的日志集和日志主题。日志集：日志集是对日志主题的分类，方便你管理日志主题，请在搜索框筛选已有的日志集。日志主题：日志主题是日志数据进行采集、存储、检索和分析的基本单元，请在搜索框筛选所选日志集下的日志主题。 |
| 创建日志主题 | 若日志主题操作设置为“创建日志主题”，则需进一步自定义日志主题，然后将其归属到已有日志集或新创建的日志集。日志主题：日志主题是日志数据进行采集、存储、检索和分析的基本单元，请自定义要创建的日志主题。选择已有日志集：表示将创建的日志主题归属到已有的日志集下，选择此项后，你可在日志集的搜索框筛选已有的日志集。创建日志集：表示将创建的日志主题归属到新建的日志集，选择此项后，请自定义要创建的日志集。 |
注意：说明：
6. 成功开启慢日志投递后，你可在日志投递下看到慢日志投递状态为开启，单击日志主题名称，可跳转至 日志服务控制台 进行后续分析管理。
五、关闭慢日志投递
注意：说明：
注意：关闭慢日志投递后，已产生的慢日志投递数据，会跟随开启慢日志投递时所选择的保存时间而保存，过期后才会自动清除数据。
1. 登录 云数据库 PostgreSQL 控制台，在实例列表，单击实例 ID 进入管理页面。
2. 在实例管理页，选择性能优化 > 日志投递。
3. 在慢查询日志投递中，单击关闭投递。
4. 在弹窗内选择确认关闭，单击确认。
六、开启错误日志投递
1. 登录 云数据库 PostgreSQL 控制台，在实例列表，单击实例 ID 进入管理页面。
2. 在实例管理页，选择性能优化 > 日志投递。
3. 首次启用日志投递功能需要开通 CLS 日志服务和为 PostgreSQL 创建服务角色，并完成授权。如果已完成，则忽略。
3.1 开通 CLS 日志服务。
3.1.1 单击前往开通，前往 CLS 控制台 开通 CLS 日志服务。
3.1.2 单击立即开通，开通 CLS 日志服务。
3.2 为 PostgreSQL 创建服务角色，并完成授权。
3.2.1 单击前往授权。
3.2.2 单击同意授权，自动为 PostgreSQL 创建服务角色，并完成授权。
4. 在错误日志投递中，单击立即启用按钮。
5. 在弹窗内完成如下配置，单击立即开启。
| 参数 | 说明 |
| 目标地域 | 选择日志投递的地域，支持异地投递。 |
| 日志主题操作 | 日志主题是日志数据进行采集、存储、检索和分析的基本单元。支持选择已有日志主题或者创建日志主题。 |
| 选择已有日志主题 | 若日志主题操作设置为“选择已有日志主题”，则需进一步选择已有的日志集和日志主题。日志集：日志集是对日志主题的分类，方便你管理日志主题，请在搜索框筛选已有的日志集。日志主题：日志主题是日志数据进行采集、存储、检索和分析的基本单元，请在搜索框筛选所选日志集下的日志主题。 |
| 创建日志主题 | 若日志主题操作设置为“创建日志主题”，则需进一步自定义日志主题，然后将其归属到已有日志集或新创建的日志集。日志主题：日志主题是日志数据进行采集、存储、检索和分析的基本单元，请自定义要创建的日志主题。选择已有日志集：表示将创建的日志主题归属到已有的日志集下，选择此项后，你可在日志集的搜索框筛选已有的日志集。创建日志集：表示将创建的日志主题归属到新建的日志集，选择此项后，请自定义要创建的日志集。 |
注意：说明：
6. 成功开启错误日志投递后，你可在日志投递下看到错误日志投递状态为开启，单击日志主题名称，可跳转至 日志服务控制台 进行后续分析管理。
七、关闭错误日志投递
注意：说明：
注意：关闭错误日志投递后，已产生的错误日志投递数据，会跟随开启错误日志投递时所选择的保存时间而保存，过期后才会自动清除数据。
1. 登录 云数据库 PostgreSQL 控制台，在实例列表，单击实例 ID 进入管理页面。
2. 在实例管理页，选择性能优化 > 日志投递。
3. 在错误日志投递中，单击关闭投递。
4. 在弹窗内选择确认关闭，单击确认。
八、附录1：慢 SQL 列表下载文件字段及示例
| 执行时间 | 慢 SQL 语句 | 总耗时（秒） | 客户端 IP | 数据库 | 账号 |
| 2026/4/21 11:37:57 | SELECT settle_month / 100 AS month, COALESCE(SUM(assess_gross_profit), 0) AS value FROM income WHERE (industry_tree_l3 = '云数据库 PostgreSQL') AND settle_month / 100 IN (202409, 202410, 202411, 202412, 202501, 202502, 202503, 202504, 202505, 202506, 202507, 202508, 202509, 202510, 202511, 202512, 202601, 202602, 202603) AND 1 = 1 GROUP BY 1 ORDER BY 1 | 1.718 | 10.*.*.*:55568 | business_analysis | postgres_admin |
九、附录2：错误日志下载文件字段及示例
| 时间 | 数据库 | 账号 | 日志内容 |
| 2026/4/21 9:30:23 | postgres | postgres_admin | wal_num must be between 1 and 500, got 1000,,,,0,,SELECT COUNT(*) FROM tencentdb_wal_stat(1000); |
十、相关文档
·日志集
·管理日志主题
·仪表盘
·数据加工
·检索分析