一、前提条件
·使用该功能前，请确保你已开通 日志服务 CLS。
·已 开通数据库审计。
·实例状态为运行中。
二、日志投递计费说明
·云数据库 PostgreSQL 数据库审计日志投递至日志服务 CLS 的功能，涉及第三方独立计费云产品日志服务 CLS，计费标准请参见 日志服务 > 计费概述。
·云数据库 PostgreSQL 数据库审计启用日志投递功能后，涉及流量费用，按照投递的日志流量来收取，具体请参见下表。
| 计费项：审计日志流量 | |
| 中国大陆地域（元/GB） | 中国香港、其他国家和地域（元/GB） |
| 0.4 | 0.6 |
三、审计日志投递字段及定义
| 字段 | 字段说明 |
| 时间 | 记录操作发生（SQL 执行）的开始时间。 |
| 客户端 IP | 记录发起数据库操作的客户端的 IP 地址。 |
| SQL 类型 | 记录 SQL 语句的类型，例如 SELECT、INSERT、UPDATE、DELETE 等。 |
| 数据库名 | 记录操作涉及的数据库名称。 |
| 执行语句 | 记录执行的具体 SQL 命令文本。 |
| 对象类型 | 记录被审计操作所作用的数据库实体类别，例如表、视图、函数等。 |
| 会话 ID | 记录客户端与数据库服务器的一次连接会话。 |
| 对象名称 | 记录被审计操作的数据库对象的全称。 |
| 执行时间（微秒） | 记录 SQL 语句从开始执行到结束所消耗的时间，以微秒为单位。这个数字可以帮助你了解查询的性能。 |
| 执行状态 | 记录 SQL 语句执行的最终结果。 |
| 影响行数 | 记录对数据表执行修改操作（例如 INSERT、UPDATE、DELETE）时实际影响的行数。这个数字可以帮助你了解操作的影响范围。 |
四、开启日志投递
1. 登录 云数据库 PostgreSQL 控制台。
2. 在左侧导航栏选择数据库审计。
3. 在上方选择地域后，在审计实例页，单击审计状态选择已开启选项过滤出已开启审计的实例。
4. 在审计实例列表里找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
5. （若已开通，可跳过此步骤）在弹出的侧边栏中，单击前往开通，跳转至日志服务侧进行开通。
6. （若已开通，可跳过此步骤）开通后返回数据库控制台，会弹出确认是否开通的弹窗，在弹窗下单击已完成开通。
注意：说明：
注意：开通过程中系统会进行服务开通成功校验，若提示开通失败，请稍后重新尝试开通。
7. （若已授权，可跳过此步骤）在侧边栏中，单击前往授权，在服务授权弹窗下单击同意授权。
注意：说明：
注意：授权过程中系统会进行服务角色授权成功校验，若提示服务角色授权失败，请稍后重新尝试开通。
8. 在侧边栏中，单击立即启用。
9. 在开启日志投递弹窗下，完成如下配置，单击立即开启。
| 参数 | 说明 |
| 目标地域 | 选择日志投递的地域。若日志服务 CLS 侧支持数据库实例所在的地域，此项会默认选择实例所在地域，你也可以选择其他可选地域；若日志服务 CLS 侧不支持数据库实例所在的地域，你可选择其他 CLS 支持的地域。 |
| 日志主题操作 | 支持选择已有日志主题或者创建日志主题。 |
| 选择已有日志主题 | 若日志主题操作设置为“选择已有日志主题”，则需进一步选择已有的日志集和日志主题。日志集：日志集是对日志主题的分类，方便你管理日志主题，请在搜索框筛选已有的日志集。日志主题：日志主题是日志数据进行采集、存储、检索和分析的基本单元，请在搜索框筛选所选日志集下的日志主题。 |
| 创建日志主题 | 若日志主题操作设置为“创建日志主题”，则需进一步自定义日志主题，然后将其归属到已有日志集或新创建的日志集。日志主题：日志主题是日志数据进行采集、存储、检索和分析的基本单元，请自定义要创建的日志主题。选择已有日志集：表示将创建的日志主题归属到已有的日志集下，选择此项后，你可在日志集的搜索框筛选已有的日志集。创建日志集：表示将创建的日志主题归属到新建的日志集，选择此项后，请自定义要创建的日志集。 |
五、查看日志投递
数据库审计功能开启日志投递后，可以查看相关实例关于数据库审计日志的投递情况。
1. 登录 云数据库 PostgreSQL 控制台。
2. 在左侧导航栏选择数据库审计。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，可以查看当前的日志投递情况。
单击日志集名称、日志主题名称、检索分析可跳转至 日志服务 CLS 控制台 查看日志投递相关情况。
六、关闭日志投递
注意：说明：
注意：关闭日志投递后，将停止投递当前实例的数据库审计日志。需注意，关闭后仅会停止新增日志的投递，存量日志将持续存储在日志主题中直至过期，期间将持续产生 存储费用，如需删除日志主题，请前往 日志主题管理 删除。
1. 登录 云数据库 PostgreSQL 控制台。
2. 在左侧导航栏选择数据库审计。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，单击关闭投递。
5. 在弹窗中阅读注意事项，单击确定。
七、附录：审计日志下载文件字段及示例
| Timestamp | InstanceId | DBName | User | Host | ThreadId | SqlType | Sql | SqlTemplate | SqlTemplateId | AffectRows | ExecTime | ObjectType | ObjectName | ErrCode | ErrorMessage |
| 2026-04-22T17:52:54.000Z | postgres-6yccctj9 | am | dbadmin | 169.1.1.1 | 69c89b71.12213 | CREATE TABLE | CREATE TABLE IF NOT EXISTS employees ( id SERIAL PRIMARY KEY, name VARCHAR(100) NOT NULL, department VARCHAR(50), salary NUMERIC(10, 2), hire_date DATE, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP) | | | 0 | 11611 | | | 00000 | |
八、相关文档
·日志集
·管理日志主题
·仪表盘
·数据加工
·检索分析