日志说明

FastDeploy 在部署过程中，会产生如下日志文件，各日志含义说明。默认日志目录为执行目录下的 log 文件夹，若需要指定可设置环境变量 FD_LOG_DIR。

日志通道划分

FastDeploy 将日志分为三个通道：

通道	Logger 名称	输出文件	说明
main	`fastdeploy.main.*`	`fastdeploy.log`	主日志，记录系统配置、启动信息等
request	`fastdeploy.request.*`	`request.log`	请求日志，记录请求生命周期和处理细节
console	`fastdeploy.console.*`	`fastdeploy.log` + 终端	控制台日志，启动信息等，同时写入 fastdeploy.log 并输出到终端

请求日志 (request.log) 支持 4 个级别，通过环境变量 FD_LOG_REQUESTS_LEVEL 控制：

级别	枚举名	说明	示例内容
0	LIFECYCLE	生命周期起止	请求创建/初始化、完成统计（InputToken/OutputToken/耗时）、流式响应首次和最后发送、请求中止
1	STAGES	处理阶段	信号量获取/释放、首 token 时间记录、信号处理（preemption/abortion/recovery）、缓存任务、预处理耗时、参数调整警告
2	CONTENT	内容和调度	请求参数、处理后的请求、调度信息（入队/拉取/完成）、响应内容（超长内容会被截断）
3	FULL	完整数据	完整的请求和响应数据、原始接收请求

默认级别为 2 (CONTENT)，记录请求参数、调度信息和响应内容。较低级别 (0-1) 只记录关键事件，级别 3 则包含完整原始数据。

环境变量	默认值	说明
`FD_LOG_DIR`	`log`	日志文件存储目录
`FD_LOG_LEVEL`	`INFO`	日志级别，支持 `INFO` 或 `DEBUG`
`FD_LOG_REQUESTS`	`1`	是否启用请求日志，`0` 禁用，`1` 启用
`FD_LOG_REQUESTS_LEVEL`	`2`	请求日志级别，范围 0-3
`FD_LOG_BACKUP_COUNT`	`7`	日志文件保留数量
`FD_DEBUG`	`0`	调试模式，`1` 启用时日志级别设为 `DEBUG`
`FD_TRACE`	`off`	Trace 模式：`off` 关闭，`local` 仅写 trace.log，`otel` 仅上报 OpenTelemetry，`all` 两者均启用

fastdeploy.log : 主日志文件，记录系统配置、启动信息、运行状态等，以及控制台输出日志（console_logger）
request.log : 请求日志文件，记录用户请求的生命周期和处理细节
trace.log : 追踪日志文件，记录请求处理各阶段的事件和时间戳，用于性能分析（需 FD_TRACE=local 或 all）
error.log : 错误日志文件，记录所有 ERROR 及以上级别的日志
worker_process.log : 合并的 worker 日志，包含引擎每轮推理数据、模型运行器信息、GPU Worker profiling 信息和 CudaGraph 状态
cache_manager.log : 合并的缓存日志，包含 KV Cache 分配信息、缓存命中状态和缓存传输管理器信息