日志投递
Download
聚焦模式
字号
腾讯云分布式缓存数据库提供日志投递功能，可用于捕获实例的慢日志和错误日志数据，并将其传送至日志服务（Cloud Log Service，CLS）进行分析。通过 CLS 丰富的检索分析和可视化能力，帮助用户更有效地识别性能瓶颈、回溯异常事件。本文将指导您如何在控制台上开启或关闭日志投递功能。
说明：
Memcached 版当前不支持将日志投递至 CLS。
操作场景
日志投递功能用于将实例的慢日志和错误日志持续投递至日志服务（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 独立计费 |
操作步骤
步骤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 统计访问分布等。具体信息，请参见 统计分析。
步骤5：关闭日志投递
说明：
关闭日志投递后，将不会继续上传日志至 CLS。但已投递的历史日志将继续存储在日志主题中，直至过期，期间将持续收取 CLS 日志存储费用。如需彻底停止计费，请在 CLS 控制台删除对应日志主题。
关闭慢日志投递
1. 在日志投递页面的慢日志投递区域，单击右上角的关闭投递。
2. 在弹出的关闭访问日志对话框中，了解关闭日志投递，将停止投递分布式缓存数据库日志，勾选确认关闭，了解关闭后影响，单击确认。
3. 等待任务执行完成即可。
关闭错误日志投递
1. 在日志投递页面的错误日志投递区域，单击右上角的关闭投递。
2. 在弹出的关闭访问日志对话框中，了解关闭日志投递，将停止投递分布式缓存数据库日志，勾选确认关闭，了解关闭后影响，单击确认。
3. 等待任务执行完成即可。
相关 API
常见问题
开启日志投递后，为什么在 CLS 中看不到日志数据？
请检查以下几点：CLS 服务是否已开通且服务角色已授权；日志集和日志主题是否创建成功；投递状态是否显示为已开启。若以上均正常，请稍等1 - 2分钟后刷新页面，日志数据可能存在短暂延迟。
错误日志和慢日志可以投递到同一个日志主题吗？
可以。慢日志投递和错误日志投递可以配置相同的日志集和日志主题。建议为不同类型日志创建独立的日志主题，以便分类管理和检索。
关闭日志投递后，CLS 还会继续收费吗？
关闭日志投递后，Redis 侧将不再上传新日志，但已投递的历史日志仍存储在日志主题中，CLS 会继续收取日志存储费用，直至日志过期或被手动删除。
相关文档
日志服务计费概述
文档反馈