📘

vLLM 日志监控 · 故障排查手册

🎯 30 章 · 从入门到实战
⚡ 风格 v1.0
01
vLLM日志体系总览 基础
DEBUG/INFO WARNING/ERROR 日志格式 stdout/file 轮转策略
02
vLLM启动日志解读 启动
模型加载 GPU显存分配 KV Cache初始化 调度器启动
03
请求处理日志分析 请求
请求排队 预填充Prefill 解码Decode 请求完成
04
性能瓶颈日志识别 性能
TTFT异常 ITL抖动 吞吐量下降 批处理大小异常
05
OOM(显存溢出)故障排查 故障
显存分配失败 KV Cache溢出 碎片化定位 OOM恢复策略
06
模型加载失败排查 加载
模型路径错误 权重文件损坏 HuggingFace下载失败 GPTQ/AWQ不兼容
07
GPU通信故障排查 通信
NCCL超时 多卡通信断裂 PCIe带宽瓶颈 NVLink异常
08
API服务故障排查 API
OpenAI兼容错误 请求超时 并发限制错误 鉴权失败
09
调度器异常排查 调度
FCFS死锁 优先级调度失效 抢占策略异常 队列积压告警
10
KV Cache管理故障 缓存
命中率过低 逐出策略异常 内存碎片化 大小配置不当
11
Tokenizer(分词器)故障 分词
词汇表加载失败 特殊Token错误 中文编码问题 分词速度过慢
12
采样参数异常排查 采样
Temperature不当 Top-K/Top-P失败 logits异常 随机种子问题
13
vLLM+TensorRT-LLM混合部署 集成
混合部署日志 TensorRT-LLM 适配日志
14
vLLM+DeepSpeed集成日志 集成
DeepSpeed集成 混合部署 适配日志
15
vLLM+Lit-GPT适配日志 集成
Lit-GPT适配 混合部署日志 集成日志
16
vLLM+TensorRT-LLM混合部署 集成
TensorRT-LLM 混合部署 适配日志
17
vLLM+DeepSpeed集成日志 集成
DeepSpeed 集成日志 混合部署
18
vLLM+Lit-GPT适配日志 集成
Lit-GPT 适配日志 混合部署
19
vLLM+TensorRT-LLM混合部署 集成
TensorRT-LLM 混合部署 适配日志
20
vLLM+DeepSpeed集成日志 集成
DeepSpeed 集成日志 混合部署
21
vLLM+Lit-GPT适配日志 集成
Lit-GPT 适配日志 混合部署
22
vLLM+TensorRT-LLM混合部署 集成
TensorRT-LLM 混合部署 适配日志
23
vLLM+DeepSpeed集成日志 集成
DeepSpeed 集成日志 混合部署
24
vLLM+Lit-GPT适配日志 集成
Lit-GPT 适配日志 混合部署
25
vLLM+TensorRT-LLM混合部署 集成
TensorRT-LLM 混合部署 适配日志
26
vLLM+DeepSpeed集成日志 集成
DeepSpeed 集成日志 混合部署
27
vLLM+Lit-GPT适配日志 集成
Lit-GPT 适配日志 混合部署
28
vLLM+TensorRT-LLM混合部署 集成
TensorRT-LLM 混合部署 适配日志
29
vLLM+DeepSpeed集成日志 集成
DeepSpeed 集成日志 混合部署
30
vLLM+Lit-GPT适配日志 集成
Lit-GPT 适配日志 混合部署