腾讯云分布式缓存数据库日志投递

一、操作场景

日志投递功能用于将实例的慢日志和错误日志持续投递至日志服务（CLS），借助 CLS 的检索分析、可视化和告警能力，实现日志的长期存储与深度分析。典型适用场景如下：

·长周期性能趋势分析：将慢日志投递至 CLS，按命令、节点、客户端 IP 等维度进行聚合统计，发现频繁出现的慢命令模式，辅助容量规划与性能优化。

·异常回溯与根因分析：将错误日志投递至 CLS，在业务异常时回溯历史错误记录，结合错误码、时间戳和客户端 IP 还原问题时间线，缩短故障定位时间。

三、慢日志（Redis 慢日志）

字段名	字段类型	字段含义	字段示例
logType	String	日志类型	cache_slowlog
instanceId	String	实例 ID	crs-xxxx
role	String	慢日志产生的分片角色	master
createTime	Long	命令执行的时间戳（毫秒）	1710316968000
node	String	节点 ID	357baf233f4ce49515912xxxxxxx
cmd	String	命令	get / set / eval
details	String	具体命令内容	EVAL "for i=1,1000000 do redis.call('SET', 'k1' , 'v1') end" 0

四、慢日志（Proxy 慢日志）

字段名	字段类型	字段含义	字段示例
logType	String	日志类型	Proxy_slowlog
instanceId	String	实例 ID	crs-xxxx
take	Long	执行耗时（毫秒）	12
cmd	String	命令	get / set / eval
details	String	具体命令内容	EVAL "for i=1,1000000 do redis.call('SET', 'k1' , 'v1') end" 0
ip	String	客户端 IP	10.0.0.3
createTime	Long	命令开始执行时间（毫秒）	1710316968000

五、错误日志

字段名	字段类型	字段含义	字段示例
logType	String	日志类型	errlog
instanceId	String	实例 ID	crs-xxxx
createTime	Long	错误发生时间（毫秒）	1710316968000
cmd	String	触发错误的命令	incr
details	String	错误详细信息	ERR value is not an integer or out of range
ip	String	客户端 IP	10.0.0.3
node	String	节点 ID	357baf233f4ce49515912xxxxxxx

六、前提条件

·已创建腾讯云分布式缓存数据库实例。

·已开通日志服务 CLS。

七、使用限制

限制项	说明
产品版本	Memcached 版不支持日志投递至 CLS。
日志类型	仅支持慢日志（Cache 慢日志 + Proxy 慢日志）和错误日志三种类型。
保存时间	默认30天，支持1天 – 3600天，过期后自动清除。
CLS 独立计费	CLS 为独立计费产品，开启日志投递后 CLS 将按日志写入量、存储量和索引量独立计费，请参见日志服务计费概述。

九、步骤1：进入日志投递页面

1. 登录腾讯云分布式缓存数据库控制台。

2. 在右侧实例列表页面上方，选择地域。

3. 在实例列表中，单击目标实例 ID，进入实例详情页面。

4. 选择慢查询页签，选择日志投递子页签。

5. 进入日志投递页面，可看到慢日志投递和错误日志投递两个功能区域的投递状态。首次使用时，需单击前往授权，完成 CLS 服务开通与服务角色授权。

十、步骤2：开启慢日志投递

1. 在慢日志投递区域，单击立即启用，开启慢日志投递。

2. 在弹出的开启日志投递对话框中，配置日志投递参数，单击立即启用。配置参数说明，请参见下表。

参数	说明	示例
地域	选择日志投递的地域，支持异地投递。	广州
日志主题操作	日志主题（Topic）是 CLS 中日志数据采集、存储与检索分析的基本单元，日志数据实际存储于日志主题中，每个日志主题归属于一个日志集。支持选择已有日志主题或创建日志主题。选择已有日志主题：将日志投递至已创建的日志主题。创建日志主题：新建一个日志主题作为本次日志投递的目标。	创建日志主题
日志主题	日志主题操作为选择已有日志主题：在下拉列表中选择目标日志主题。日志主题操作为创建日志主题：按命名规则填写日志主题名称。具体要求，请参见 CLS 日志主题。	proxy_slow_log_topic
日志集操作	日志集（Logset）是 CLS 中对日志主题进行分类归组的项目管理单元，通常对应一个项目或业务，其本身不存储任何日志数据，一个日志集可包含多个日志主题。选择已有日志集：将上述日志主题归属到已创建的日志集下。创建日志集：新建一个日志集，用于归组本次投递所创建的日志主题。	创建日志集
日志集	日志集操作为选择已有日志集：在下拉列表中筛选目标日志集。日志集操作为创建日志集：根据命名要求编辑日志集名称。具体要求，请参见 CLS 日志集。	redis_slow_logset

3. 开启成功后，慢日志投递区域的投递状态显示为已开启。标题行同时显示"独立计费"标签（橙色），提示投递至 CLS 涉及独立计费。

·单击具体的日志集或日志主题，跳转至 CLS 控制台对应的日志集或日志主题详情页。

·单击检索分析，跳转至 CLS 检索分析页面。

十一、步骤3：开启错误日志投递

注意：说明：

注意：错误日志投递的日志集和日志主题可以与慢日志投递共用，也可以独立创建，以便对不同类型日志进行分类管理。

1. 在错误日志投递区域，单击立即启用，开启错误日志投递。

2. 在弹出的开启日志投递对话框中，配置日志投递参数，单击立即启用。参数说明与慢日志投递一致，请参见步骤2中的配置参数说明表。

3. 开启成功后，错误日志投递区域的投递状态显示为已开启。

·单击具体的日志集或日志主题，跳转至 CLS 控制台对应的日志集或日志主题详情页。

·单击检索分析，跳转至 CLS 检索分析页面。

十二、步骤4：查看与分析投递日志

在 CLS 检索分析页面，可对审计日志执行以下分析操作：

·配置索引：首次检索前，需为待检索的日志字段（如命令类型、客户端 IP、用户账号等）开启全文索引或键值索引，索引开启后日志方可被检索与统计。具体操作，请参见索引配置。

·检索日志：使用关键词进行全文检索，或按字段（命令类型、客户端 IP、执行时间等）进行键值检索，快速定位目标日志条目。具体信息，请参见检索分析。

·统计分析：使用 SQL 对检索结果进行聚合统计，例如按命令类型分组统计执行次数、按客户端 IP 统计访问分布等。具体信息，请参见统计分析。

·可视化与告警：基于分析结果构建可视化仪表盘，或配置告警策略，对高危命令执行、异常访问 IP 等行为实时预警。更多信息，请参见仪表盘与监控告警。

十三、步骤5：关闭日志投递

注意：说明：

注意：关闭日志投递后，将不会继续上传日志至 CLS。但已投递的历史日志将继续存储在日志主题中，直至过期，期间将持续收取 CLS 日志存储费用。如需彻底停止计费，请在 CLS 控制台删除对应日志主题。

十四、关闭慢日志投递

1. 在日志投递页面的慢日志投递区域，单击右上角的关闭投递。

2. 在弹出的关闭访问日志对话框中，了解关闭日志投递，将停止投递分布式缓存数据库日志，勾选确认关闭，了解关闭后影响，单击确认。

3. 等待任务执行完成即可。

十五、关闭错误日志投递

1. 在日志投递页面的错误日志投递区域，单击右上角的关闭投递。

2. 在弹出的关闭访问日志对话框中，了解关闭日志投递，将停止投递分布式缓存数据库日志，勾选确认关闭，了解关闭后影响，单击确认。

3. 等待任务执行完成即可。

十六、相关 API

API 接口名称	功能描述	接口文档链接
ModifyCloudProductLogCollection	修改实例日志投递配置	查看详情
DescribeCloudProductLogTasks	查询实例日志投递配置	查看详情

十八、开启日志投递后，为什么在 CLS 中看不到日志数据？

请检查以下几点：CLS 服务是否已开通且服务角色已授权；日志集和日志主题是否创建成功；投递状态是否显示为已开启。若以上均正常，请稍等1 – 2分钟后刷新页面，日志数据可能存在短暂延迟。

十九、错误日志和慢日志可以投递到同一个日志主题吗？

可以。慢日志投递和错误日志投递可以配置相同的日志集和日志主题。建议为不同类型日志创建独立的日志主题，以便分类管理和检索。

20、关闭日志投递后，CLS 还会继续收费吗？

关闭日志投递后，Redis 侧将不再上传新日志，但已投递的历史日志仍存储在日志主题中，CLS 会继续收取日志存储费用，直至日志过期或被手动删除。

21、相关文档

·慢查询（Redis/Valkey 版）

·日志服务 CLS 产品概述

·日志服务计费概述

·CLS 检索分析概述

腾讯云分布式缓存数据库 日志投递