错误日志是鑫旺物流移车管理系统中，面向开发/运维人员的核心问题排查工具，用于全量记录系统API接口的异常请求数据，精准定位接口调用失败的根因，支撑系统稳定性运维与问题快速修复。效果图如下：

错误日志操作手册

1. 功能概述

该模块自动采集系统全链路的接口异常信息，支持多维度筛选、明细追溯与状态管理，帮助技术人员高效排查接口故障、分析异常规律，保障系统服务的稳定运行。

2. 页面入口与布局

2.1 入口路径

登录系统后，在左侧导航栏依次点击：基础设施 → API日志 → 错误日志，即可进入本页面。

2.2 页面结构

区域	内容说明
顶部筛选区	多条件查询栏，支持按用户、应用、时间、状态等维度精准筛选日志
中间列表区	异常日志总览表，展示每条异常的核心信息与操作入口
操作列	提供日志详情查看、异常状态处理功能

3. 核心功能说明

3.1 多维度筛选查询

支持通过以下条件组合筛选目标异常日志，快速定位问题：

筛选字段	功能说明
用户编号	输入具体用户编号，精准定位该用户触发的接口异常
用户类型	下拉选择用户身份（如管理员、普通操作员），按角色维度筛选异常
应用名	输入服务应用名称（如phoenix-server），筛选指定服务的接口异常
请求地址	输入接口请求路径（如/app-api/infra/file/upload），定位指定接口的异常
异常时间	选择日期区间，筛选指定时间范围内的异常日志
处理状态	下拉选择「未处理 / 已处理 / 已忽略」，按异常处理进度筛选

操作说明

• 填写/选择筛选条件后，点击 搜索 按钮，列表将展示符合条件的异常日志。
• 点击 重置 按钮，清空所有筛选条件，恢复默认全量日志列表。

如下图所示：

3.2 异常日志列表字段说明

列表完整展示每条接口异常的核心信息，字段含义如下：

字段名	说明
日志编号	异常日志的唯一标识ID，用于日志追溯
用户编号	触发该异常请求的用户ID，可关联定位操作人
用户类型	触发请求的用户身份类型，辅助排查权限相关异常
应用名	处理该请求的后端服务应用名称，定位异常服务模块
请求方法名	接口请求方式（如POST、GET），明确接口调用类型
请求地址	接口完整请求路径，精准定位异常接口
异常发生时间	接口异常触发的精确时间，用于时序问题排查
异常名	接口抛出的异常类型（如SdkClientException），快速识别异常类别
处理状态	异常的处理进度，分为「未处理 / 已处理 / 已忽略」
操作	提供「详细」「已处理」「已忽略」操作入口

3.3 异常处理操作

（1）查看异常详情

点击操作列的 详细 按钮，可进入日志详情页，查看该异常的完整上下文信息，包括：

• 完整的异常堆栈信息
• 请求参数、请求头、响应数据
• 用户操作上下文、设备信息等

用于深度分析接口失败的具体原因，定位代码问题。

（2）标记异常状态

针对已排查的异常，可进行状态标记，实现异常闭环管理：

操作	说明
已处理	将异常状态标记为「已处理」，代表问题已修复、根因已定位
已忽略	将异常状态标记为「已忽略」，代表该异常为非严重问题、无需处理

状态标记后，可通过「处理状态」筛选器快速区分未处理的待排查异常。

4. 使用场景与价值

场景	价值说明
接口故障排查	当用户反馈接口调用失败时，通过用户编号/时间快速定位异常，查看堆栈信息定位代码问题
系统稳定性监控	通过统计异常接口、异常时间分布，分析高频故障接口，针对性优化系统性能
问题闭环管理	通过「处理状态」标记，实现异常从发现、排查到解决的全流程跟踪，避免问题遗漏
运维审计追溯	全量日志记录为系统运维、安全审计提供数据支撑，可追溯历史异常与处理记录

5. 使用注意事项

• 日志数据为系统自动采集，禁止手动删除，仅可通过状态标记区分处理进度。
• 针对高频重复异常（如phoenix-server服务的文件上传接口异常），需重点排查服务配置、依赖环境问题。
• 排查异常时，优先结合「异常名」「请求地址」「异常时间」定位问题，再通过「详细」查看完整堆栈。
• 建议定期（如每日）查看错误日志，及时处理未处理异常，保障系统稳定运行。