腾讯云分布式缓存数据库提供错误日志功能，可查看实例在执行命令过程中产生的错误记录，帮助用户快速定位客户端请求异常、排查命令执行失败等问题。本文将指导您如何在控制台上查看、搜索和导出错误日志。
操作场景
错误日志功能用于记录实例在执行命令过程中产生的错误信息，包括执行时间、客户端 IP、命令内容和返回的错误结果，帮助您快速还原错误上下文并定位失败根因。典型适用场景如下：
客户端请求异常排查：当业务代码写入或读取 Redis 报错时，通过错误日志查看失败命令的客户端 IP 和返回错误信息，快速判断是代码逻辑问题还是数据格式问题。
批量错误统计与根因分析：按时间范围筛选错误日志并结合命令类型和节点 ID 进行聚合，识别某个节点或某类命令是否集中报错，辅助根因定位。
命令兼容性验证：在版本升级或迁移前，检查历史错误日志中是否存在不兼容命令报错，提前评估兼容性风险。
功能说明
错误日志查询：支持按时间范围、关键字筛选，查看命令执行失败的详细记录。
错误日志导出：支持将查询结果导出为 Excel 文件，便于线下分析和归档。
错误信息回溯：每条错误记录包含执行时间、客户端 IP、命令、命令详情、返回结果和节点 ID，完整还原错误发生时的上下文。
使用限制
限制项 | 说明 |
产品版本 | Memcached 版不支持错误日志功能。 |
日志保留时间 | 错误日志保留15天。 |
查询时间范围 | 支持查询近15天内任意时间段的错误日志，建议缩小时间范围以提升查询速度。 |
导出数量 | 每次导出上限为10000条，超出部分请分次导出。 |
前提条件
数据库实例的状态为运行中。
操作步骤
步骤1：进入错误日志页面
1. 登录 腾讯云分布式缓存数据库控制台。
2. 在右侧实例列表页面上方，选择地域。
3. 在实例列表中，单击目标实例 ID，进入实例详情页面。
4. 在实例详情页面，单击慢查询页签，选择错误日志子页签。
步骤2：查询错误日志
1. 在错误日志子页签中，设置以下筛选条件：
时间范围：选择需要查询的时间段。支持自定义起始和结束时间，时间跨度不超过 15 天。
关键字搜索：在搜索框中输入关键字，支持按命令、客户端 IP 或命令详情进行精准查询，多个条件以回车键分隔。
2. 单击查询，系统将以列表形式返回符合条件的错误日志列表。
说明：
若查询结果返回缓慢，建议缩小时间范围或增加关键字过滤条件以提升查询效率。
步骤3：查看错误日志字段
查询结果以列表形式展示，每条记录包含以下字段：
字段名 | 说明 |
执行时间 | 命令执行出错的具体时间点，精确到秒，用于定位错误发生的时刻并与业务日志、监控曲线进行时间对齐，还原故障时间线。 |
客户端 IP | 发起该请求的客户端 IP 地址，用于定位报错来源的业务或应用节点，判断错误是否集中于某个调用方。 |
命令 | 触发错误的 Redis 命令类型，例如 incr、get、set 等，用于快速识别是哪类操作执行失败。 |
命令详情 | 命令的完整内容，包含 Key 及具体参数，可据此还原操作上下文、定位涉及的数据对象，判断错误是否与特定 Key 或参数有关。 |
返回结果 | 命令执行失败后 Redis 返回的错误信息，例如 ERR value is not an integer or out of range，是判断错误原因和类型的核心依据。 |
节点 ID | 产生该错误的节点标识。在集群架构下，可通过该字段区分错误来源，将问题定位到具体的分片或节点。 |
步骤4：导出错误日志
1. 在错误日志子页签右上方，单击
2. 在弹出的对话框中，确认导出限制说明，单击导出。
3. 系统将生成一个 Excel 文件并自动下载。打开文件即可查看导出时间段内的完整错误日志记录。
相关 API
常见问题
错误日志和慢查询有什么区别？
慢查询记录的是执行耗时超过指定阈值的命令，用于定位性能瓶颈。错误日志记录的是执行失败并返回错误信息的命令，用于排查功能异常和请求失败问题。两者关注维度不同，建议结合使用。
错误日志中为什么看不到某条命令的错误记录？
如何将错误日志持久化存储？
相关文档
日志投递
监控指标
