配置日志投递

最近更新时间:2026-07-01 18:07:03

我的收藏

操作场景

日志投递是腾讯云分布式缓存数据库(兼容 Redis)数据库审计的扩展能力,用于将审计采集到的审计日志近实时推送到腾讯云日志服务(Cloud Log Service,CLS)。审计日志完整记录实例的命令操作行为,包含执行的命令内容、执行时间、客户端 IP 和访问账号等关键信息。开启日志投递后,系统将该实例产生的审计日志自动推送至 CLS 中指定的日志集与日志主题,投递任务持续运行直至被手动关闭。借助 CLS 的日志检索、分析、告警与可视化能力,日志投递突破了内置审计存储的保留期上限,提供更长的日志保留与更灵活的日志使用方式。

功能说明

开启日志投递后,数据库审计将该实例按所配审计类型(如写命令)采集的审计日志近实时推送至 CLS 中指定的日志集与日志主题。投递到 CLS 后,您可使用 CLS 提供的以下能力:
检索分析:支持全文检索、键值索引检索与 SQL 检索,快速定位目标日志条目。
可视化:基于日志数据构建可视化仪表盘,展示命令执行分布、Top N 操作、客户端 IP 分布等。
告警:配置告警规则,检测到异常操作(例如高危命令执行、异常访问 IP 等)时实时推送告警。
数据加工:对日志数据进行清洗、转换与转发,满足个性化处理需求。

核心概念

日志集

日志集(Logset)是 CLS 中的顶层资源管理单元,用于对不同来源或不同项目的日志进行分组与隔离。每个日志集可包含多个日志主题,并支持配置保留周期与访问权限。审计日志投递时,日志集是日志存储的目标容器:您可选择已有日志集以聚合管理审计日志与其他服务日志,也可创建专用日志集独立存储审计日志。更多信息,请参见 日志集

日志主题

日志主题(Topic)是 CLS 中日志数据写入与管理的基本单元。每个日志主题是一条独立的数据流,支持独立配置分区、索引、保留周期等设置,写入同一主题的日志可被统一检索、分析与告警。日志主题是投递后审计日志实际存储与管理的最小单元:您可选择已有日志主题接收审计日志,也可创建专用日志主题独立存放,使后续检索与告警更具针对性。更多信息,请参见 日志主题

前提条件

条件类型
具体要求
审计状态
目标实例已开启数据库审计功能。具体操作请参见 开启数据库审计
实例状态
实例须处于"运行中"状态,处于"创建中"、"升级中"、"已隔离"、"已销毁"等状态的实例无法配置日志投递。
地域可用性
实例所在地域支持日志投递功能,具体支持的地域以控制台实际展示为准。
日志服务
已在目标地域开通腾讯云日志服务(CLS)。如需开通服务,请前往 CLS 控制台
说明:
CLS 为独立计费的腾讯云产品,其计费规则以 CLS 官方计费说明为准。具体信息,请参见 CLS 计费概述
权限要求
当前账号已被授予目标地域下 CLS 相关资源的操作权限,包含日志集的读取、日志主题的读写以及日志主题的创建权限。

使用限制

单个实例仅支持配置一个日志投递任务。如需更换投递目标,请先关闭已有投递任务后重新配置。
投递开启前已产生的历史审计日志不会自动投递至 CLS,投递任务仅推送开启后新产生的审计日志。

操作步骤

2. 在左侧导航栏选择分布式缓存(兼容 Redis)菜单下的数据库审计
3. 数据库审计页面,选择目标实例所在地域,将审计存储状态设置为已开启,页面将展示该地域下所有已开启审计功能的实例。
4. (可选)通过实例列表上方的搜索框过滤目标实例,支持按实例 ID实例名称标签键标签值进行检索。
5. 找到目标实例,单击操作列的更多,在下拉菜单中选择配置日志投递

6. 日志投递对话框中,查看投递至 CLS 日志服务的说明,确认信息无误后,单击立即启用

说明:
CLS 为独立计费的腾讯云产品,开启投递后将根据实际日志量产生 CLS 使用费用,具体计费规则以 CLS 官方计费说明为准。
7. 开启日志投递对话框中,设置日志投递的日志集与日志主题,单击立即开启

配置项
参数说明
目标地域
审计日志投递的目标地域。系统自动关联并展示 CLS 支持的地域,日志只能投递到所选地域下的日志集与日志主题。默认为当前实例所在地域。
日志主题操作
选择日志主题的操作方式。
选择已有日志主题:从下拉框中选择目标地域下已有的日志集与日志主题作为投递目标。适用于已在 CLS 中创建好资源并希望复用的场景。
创建日志主题:自定义填写日志集名称与日志主题名称,由您在目标地域下创建专用资源用于存放审计日志。适用于首次配置或需要独立存储空间的场景。
日志集
接收审计日志的日志集。
选择选择已有日志主题时,从下拉框中选择目标地域下已有的日志集。
选择创建日志主题时,在输入框中自定义填写日志集名称。
说明:
日志集名称须符合 CLS 命名规范,创建后可在 CLS 控制台进行查看、重命名或结构调整。
日志主题
接收审计日志的日志主题。
选择选择已有日志主题时,从所选日志集下选择已有的日志主题。
选择创建日志主题时,在输入框中自定义填写日志主题名称。
8. 开启成功后,显示如下页面,投递状态显示为已开启,标题行同时显示"独立计费"标签(橙色),提示投递至 CLS 涉及独立计费。
单击具体的日志集或日志主题,跳转至 CLS 控制台对应的日志集或日志主题详情页。
单击检索分析,跳转至 CLS 检索分析页面。


后续操作

在 CLS 检索分析页面,可对审计日志执行以下分析操作:
配置索引:首次检索前,需为待检索的日志字段(如命令类型、客户端 IP、用户账号等)开启全文索引或键值索引,索引开启后日志方可被检索与统计。具体操作,请参见 索引配置
检索日志:使用关键词进行全文检索,或按字段(命令类型、客户端 IP、执行时间等)进行键值检索,快速定位目标日志条目。具体信息,请参见 检索分析
统计分析:使用 SQL 对检索结果进行聚合统计,例如按命令类型分组统计执行次数、按客户端 IP 统计访问分布等。具体信息,请参见 统计分析
可视化与告警:基于分析结果构建可视化仪表盘,或配置告警策略,对高危命令执行、异常访问 IP 等行为实时预警。更多信息,请参见 仪表盘监控告警

关闭日志投递

如不再需要将日志投递到 CLS,可随时关闭已有投递任务:在投递详情页右上角单击关闭投递即可。关闭投递不影响审计功能本身的正常运行。

常见问题

开启日志投递是否会收取额外费用?

日志投递功能本身免费,但日志投递到 CLS 后将根据实际日志量产生 CLS 使用费用。CLS 为独立计费的腾讯云产品,计费详情请参见 CLS 控制台或官方计费说明。建议您根据业务规模预估日志量,并合理配置日志集的保留周期以控制成本。

是否支持投递到多个日志集或日志主题?

单个实例仅支持配置一个日志投递任务。如需将日志分发到多个目标,可在 CLS 控制台使用数据加工功能将日志转发至其他目标主题。

关闭日志投递是否会影响审计功能本身?

不会。日志投递是审计功能的扩展能力,关闭投递不影响审计功能的正常运行。关闭后,审计功能仍会按配置的保留时长持续采集与存储日志。需要注意的是,已投递到 CLS 的日志不会被自动删除,如需清理请在 CLS 控制台执行对应操作。