一、前提条件
如需投递至日志服务 CLS，前提条件如下：
·使用该功能前，请确保你已开通 日志服务 CLS。
·已 开通数据库审计。
·实例状态为运行中。
如需投递至 Ckafka 消息队列，前提条件如下：
·已 购买 Ckafka 实例。
·在 CKafka 实例下 添加路由策略。
·已 开通数据库审计。
·实例状态为运行中。
如需投递至 COS 对象存储，前提条件如下：
·使用该功能前，请确保你已开通 COS 对象存储。
·已 开通数据库审计。
·实例状态为运行中。
二、支持版本及架构
·MySQL 5.7、MySQL 8.0。
·实例形态为预置资源、Serverless。
三、日志投递计费说明
·TDSQL-C MySQL 版数据库审计日志投递至日志服务 CLS 的功能，涉及第三方独立计费云产品日志服务 CLS，计费标准请参见 日志服务 > 计费概述。
·TDSQL-C MySQL 版数据库审计日志投递至 Ckafka 消息队列的功能，涉及第三方独立计费云产品 Ckafka 消息队列，计费标准请参见 Ckafka 计费概述。
·TDSQL-C MySQL 版数据库审计日志投递至 COS 对象存储的功能，涉及第三方独立计费云产品 COS 对象存储，计费标准请参见 计费概述。
·TDSQL-C MySQL 版数据库审计启用日志投递功能后，涉及流量费用，按照投递的日志流量来收取，具体请参见下表。
注意：说明：
注意：启用日志投递功能后，此功能涉及流量费用，但无论你是仅开启一个日志投递路径（CLS、Ckafka 或 COS），还是开启多个日志投递路径（CLS、Ckafka 或 COS），此功能产生的流量费用系统仅收取一份。
| 计费项：审计日志流量 | |
| 中国大陆地域（元/GB） | 中国香港、其他国家和地域（元/GB） |
| 0.4 | 0.6 |
四、日志投递流量监控说明
启用日志投递功能后，你可以通过监控功能了解因日志投递而产生的实时投递流量情况。
| 监控指标名称 | 可调用指标名称 | 单位 | 指标说明 |
| 投递流量 | AuditDeliverRate | MB | 日志投递功能所产生的投递流量。 |
你可在审计实例列表，找到已开启日志投递功能的实例，在日志投递字段下，单击监控图标，进而查看投递流量监控情况。
五、日志投递状态显示说明
如上图所示，在 TDSQL-C MySQL 版数据库审计页面，在日志投递字段下会显示对应实例关于审计日志的投递状态，具体每个投递状态的说明如下。
·显示 Ckafka：表示当前实例的数据库审计开启了日志投递至 Ckafka 消息队列。
·显示 CLS：表示当前实例的数据库审计开启了日志投递至日志服务 CLS。
·显示 COS：表示当前实例的数据库审计开启了日志投递至 COS 对象存储。
·显示未开启：表示当前实例的数据库审计未配置日志投递。
六、相关操作
数据库审计日志投递至日志服务 CLS、投递至 Ckafka 消息队列以及投递至 COS 对象存储的相关操作步骤，请分别参考以下分页内的指引。
投递至日志服务 CLS 相关操作投递至 Ckafka 消息队列相关操作投递至 COS 对象存储相关操作
七、开启日志投递至 CLS
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页，单击审计存储状态选择已开启选项以过滤出已开启审计的实例。
4. 在审计实例列表里找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
5. （若已开通，可跳过此步骤）在弹出的侧边栏中，单击前往开通，跳转至日志服务侧进行开通。
6. （若已开通，可跳过此步骤）开通后返回数据库控制台，会弹出确认是否开通的弹窗，在弹窗下单击已完成开通。
注意：说明：
注意：开通过程中系统会进行服务开通成功校验，若提示开通失败，请稍后重新尝试开通。
7. （若已授权，可跳过此步骤）在侧边栏中，单击前往授权，在服务授权弹窗下单击同意授权。
注意：说明：
注意：授权过程中系统会进行服务角色授权成功校验，若提示服务角色授权失败，请稍后重新尝试开通。
8. 在侧边栏中，在投递至 CLS 日志服务下，单击立即启用。
9. 在开启日志投递弹窗下，完成如下配置，单击立即开启。
| 参数 | 说明 |
| 目标地域 | 选择日志投递的地域。若日志服务 CLS 侧支持数据库实例所在的地域，此项会默认选择实例所在地域，你也可以选择其他可选地域；若日志服务 CLS 侧不支持数据库实例所在的地域，你可选择其他 CLS 支持的地域。 |
| 日志主题操作 | 支持选择已有日志主题或者创建日志主题。 |
| 选择已有日志主题 | 若日志主题操作设置为“选择已有日志主题”，则需进一步选择已有的日志集和日志主题。日志集：日志集是对日志主题的分类，方便你管理日志主题，请在搜索框筛选已有的日志集。日志主题：日志主题是日志数据进行采集、存储、检索和分析的基本单元，请在搜索框筛选所选日志集下的日志主题。说明：在此步骤中可选择的日志主题，必须是在数据库控制台开启日志投递过程中，日志主题操作选择为“创建日志主题”时所创建的，不支持选择在 CLS 控制台创建的日志主题。 |
| 创建日志主题 | 若日志主题操作设置为“创建日志主题”，则需进一步自定义日志主题，然后将其归属到已有日志集或新创建的日志集。日志主题：日志主题是日志数据进行采集、存储、检索和分析的基本单元，请自定义要创建的日志主题。选择已有日志集：表示将创建的日志主题归属到已有的日志集下，选择此项后，你可在日志集的搜索框筛选已有的日志集。创建日志集：表示将创建的日志主题归属到新建的日志集，选择此项后，请自定义要创建的日志集。 |
八、查看日志投递至 CLS
实例的数据库审计开启日志投递至 CLS 功能后，可以查看该实例当前投递至 CLS 的情况（查看当前日志投递的日志集、日志主题）。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，可以查看当前的日志投递情况。
5. 单击日志集名称、日志主题名称、检索分析可跳转至 日志服务 CLS 控制台 查看日志投递相关情况。
九、关闭日志投递至 CLS
注意：说明：
注意：关闭日志投递后，将停止投递当前实例的数据库审计日志。需注意，关闭后仅会停止新增日志的投递，存量日志将持续存储在日志主题中直至过期，期间将持续产生 存储费用，如需删除日志主题，请前往 日志主题管理 删除。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，在投递至 CLS 日志服务右侧，单击关闭投递。
5. 在弹窗中阅读注意事项，勾选确认关闭，单击确认。
十、开启日志投递至 Ckafka 消息队列
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页，单击审计存储状态选择已开启选项以过滤出已开启审计的实例。
4. 在审计实例列表里找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
5. （若已开通，可跳过此步骤）在弹出的侧边栏中，单击前往开通，跳转至消息队列侧进行开通。
6. （若已开通，可跳过此步骤）开通后返回数据库控制台，会弹出确认是否开通的弹窗，在弹窗下单击已完成开通。
注意：说明：
注意：开通过程中系统会进行服务开通成功校验，若提示开通失败，请稍后重新尝试开通。
7. （若已授权，可跳过此步骤）在侧边栏中，单击前往授权，在服务授权弹窗下单击同意授权。
注意：说明：
注意：授权过程中系统会进行服务角色授权成功校验，若提示服务角色授权失败，请稍后重新尝试开通。
8. 在弹出的侧边栏中，在投递至 Ckafka 消息队列下，单击立即启用。
9. 在投递至 Ckafka 消息队列弹窗下，完成如下配置，单击确定。
| 参数 | 说明 |
| 目标地域 | 选择日志投递的地域。若 Ckafka 消息队列支持数据库实例所在的地域，此项会默认选择实例所在地域，你也可以选择其他可选地域；若 Ckafka 消息队列不支持数据库实例所在的地域，你可选择其他 Ckafka 消息队列支持的地域。 |
| Ckafka 实例 | 选择目标地域下的 Ckafka 实例。说明：仅 Ckafka 2.4.1及以上版本支持审计日志投递，其他版本 Ckafka 实例不支持。 |
| 主题 | 选择要投递的主题，若没有可选择的主题，你也可以重新创建一个主题，操作请参见 创建 Topic。 |
十一、查看日志投递至 Ckafka 消息队列
实例的数据库审计开启日志投递至 Ckafka 消息队列后，可以查看该实例当前投递至 Ckafka 消息队列的情况（查看当前日志投递的 Ckafka 实例、Ckafka Topic ID/名称、地域以及创建时间）。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，可以查看当前的日志投递情况。
5. 单击 Ckafka 实例 ID、Ckafka Topic ID/名称、消息查询可跳转至 消息队列控制台 查看投递实例详情以及进行消息查询。
十二、修改投递
实例的数据库审计开启日志投递至 Ckafka 消息队列后，如需更换投递的 Ckafka 实例、地域或者主题（Ckafka Topic ID/名称），你可参考如下操作。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，在投递至 Ckafka 消息队列右侧，单击修改投递。
5. 在投递至 Ckafka 消息队列弹窗下，重新选择 Ckafka 实例、地域或者主题（Ckafka Topic ID/名称），单击确定。
十三、关闭日志投递至 Ckafka 消息队列
注意：说明：
注意：关闭日志投递后，将停止投递当前实例的数据库审计日志。需注意，关闭后仅会停止新增日志的投递，存量日志将持续存储在 Ckafka 消息队列中直至过期，期间将持续产生存储费用，如需删除消息，请前往 消息队列控制台 进行配置。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，在投递至 Ckafka 消息队列右侧，单击关闭投递。
5. 在弹窗中阅读注意事项，勾选确认关闭，单击确定。
十四、开启日志投递至 COS 对象存储
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页，单击审计存储状态选择已开启选项以过滤出已开启审计的实例。
4. 在审计实例列表里找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
5. （若已授权，可跳过此步骤）在侧边栏中，单击前往授权，在服务授权弹窗下单击同意授权。
注意：说明：
注意：授权过程中系统会进行服务角色授权成功校验，若提示服务角色授权失败，请稍后重新尝试开通。
6. 在弹出的侧边栏中，在投递至 COS 对象存储下，单击立即启用。
7. 在投递至 COS 对象存储弹窗下，完成如下配置，单击确定。
| 参数 | 说明 |
| 目标地域 | 选择日志投递的地域。若对象存储 COS 侧支持数据库实例所在的地域，此项会默认选择实例所在地域，你也可以选择其他可选地域；若对象存储 COS 侧不支持数据库实例所在的地域，你可选择其他 COS 支持的地域。 |
| COS 存储桶 | 选择已有的 COS 存储桶，下拉框内支持快捷搜索。若不存在已有的 COS 存储桶，你可以在下拉框内选择 创建存储桶，若你之前并未开通过 COS 对象存储，则在创建存储桶过程中系统会指引你开通，然后你可继续完成创建存储桶操作。 |
| 文件命名 | 投递文件命名，默认为按投递时间命名。 |
| COS 路径 | 请在此项输入 COS 路径前缀（仅支持0～9、A～Z、a～z、/和_，且/、_不能在开头和结尾）。完整路径为：前缀/年/月/日/时，此完整路径表示投递的审计日志文件保存在 COS 存储桶中的地址。 |
| 投递路径样例 | 此项会根据以上的设置，自动生成 COS 存储桶目录，你可通过此项显示了解当前设置的 COS 存储桶目录。 |
| 投递文件大小 | 设置投递文件的大小，和投递间隔时间配合使用，哪个条件先触发，就按照哪个规则去压缩文件，然后投递到 COS。默认值为5MB，取值范围：5MB – 256MB。例如：配置256MB，15分钟，如果文件大小在5分钟就到了256MB，那么投递文件大小这个条件先触发投递任务。 |
| 投递间隔时间 | 指定间隔多长时间，触发一次投递，和投递文件大小配合使用，哪个条件先触发，就按照哪个规则去压缩文件，然后投递到 COS。默认值为15分钟，取值范围：5分钟 – 15分钟。例如：配置256MB，15分钟，如果文件大小在15分钟时仅为200MB，那么投递间隔时间这个条件先触发投递任务。 |
十五、查看日志投递至 COS 对象存储
实例的数据库审计开启日志投递至 COS 对象存储后，可以查看该实例当前投递至 COS 对象存储的情况（查看当前日志投递的 COS 存储桶、地域、创建时间等）。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，可以查看当前的日志投递情况。
5. 单击 COS 存储桶名称可跳转到对应 COS 存储桶的文件列表详情页，单击归档存储，可跳转至 COS 控制台 查看存储的投递文件。
十六、修改投递
实例的数据库审计开启日志投递至 COS 对象存储后，如需修改投递的配置，你可参考如下操作。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，在投递至 COS 对象存储右侧，单击修改投递。
5. 在投递至 COS 对象存储弹窗下，重新选择需要的配置，单击确定。
十七、关闭日志投递至 COS 对象存储
注意：说明：
注意：关闭日志投递后，将停止投递当前实例的数据库审计日志。需注意，关闭后仅会停止新增日志的投递，存量日志将持续保留在 COS 对象存储中直至过期，期间将持续产生存储费用，如需删除日志，请前往 COS 控制台 进行配置。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏选择 SQL 洞察（原数据库审计）。
3. 在上方选择地域后，在审计实例页找到目标实例（也可在搜索框通过资源属性筛选快速查找），在其操作列单击更多 > 配置日志投递。
4. 在弹出的侧边栏中，在投递至 COS 对象存储右侧，单击关闭投递。
5. 在弹窗中阅读注意事项，勾选确认关闭，单击确定。
十八、附录1：添加路由策略
如需将数据库审计日志投递至 Ckafka 消息队列，需要先在 Ckafka 实例下添加路由策略，否则在配置日志投递时可能出现报错“Ckafka 不存在支撑环境路由 PLAINTEXT 接入方式”。操作方法如下。
1. 登录 Ckafka 消息队列 控制台。
2. 在左侧导航栏单击实例列表，单击目标实例的“ID/名称”，进入基本信息页。
3. 在实例基本信息页面，单击接入方式模块中的添加路由策略。
4. 在弹窗中，路由类型选择为支撑环境，接入方式选择为 PLAINTEXT，单击提交。
十九、附录2：创建存储桶
开启日志投递至 COS 对象存储过程中，需要选择 COS 存储桶，若不存在已有的 COS 存储桶，可通过如下步骤创建存储桶后再进行选择。
1. 在下拉框内单击创建存储桶。
2. 在弹窗下，完成如下配置，单击创建。
| 参数 | 说明 |
| 所属地域 | 选择存储桶的所属地域。请选择与你业务相对集中的物理区域所对应的 COS 地域，与相同地域其他腾讯云服务可以内网互通，创建后不可更改地域。 |
| 名称 | 输入自定义的存储桶名称。仅支持小写字母、数字和 – 的组合，域名字数总和不能超过60字符，存储桶名一旦设置不能更改。 |
| 访问权限 | 选择访问权限。存储桶默认提供三种访问权限：私有读写、公有读私有写和公有读写，设置后仍可修改。详细信息请参见 存储桶访问权限。 |
| 存储桶标签 | 存储桶标签作为管理存储桶的一个标识，你可以为存储桶设置标签，便于分组管理存储桶，详情请参见 设置存储桶标签。 |
| 请求域名 | 此项展示设置完成后的请求域名，你可以使用该域名对存储桶进行访问。 |
20、相关文档
日志服务 CLS 相关文档如下：
·日志集
·管理日志主题
·仪表盘
·数据加工
·检索分析
Ckafka 消息队列相关文档如下：
查询消息
COS 对象存储相关文档如下：
·查询存储桶
·清空存储桶
·删除存储桶
·设置存储桶访问权限