gelf驱动下uvicorn环境Python syslog日志上报异常咨询
根因拆解
- Docker GELF日志驱动的原生采集范围仅为容器内进程输出到标准输出(stdout)、标准错误(stderr)的内容,它不会主动扫描容器内的文件系统、读取rsyslog写入的本地日志文件。
- 你当前的rsyslog配置里,对所有
local0.*级别的日志触发了stop动作:rsyslog收到Python syslog模块发来的本地消息后,仅将内容写入/var/log/test.log,直接终止了后续所有日志处理流程——哪怕rsyslog默认配置里有将日志输出到stdout的通用规则,这部分被截断的local0日志也根本走不到这一步。这部分日志从始至终没有被输出到容器的stdout流,GELF驱动自然无法采集到。
对应你观察到的几个现象的直接解释:
- 为什么uvicorn的日志能正常上报:uvicorn自身的日志是直接写入进程stdout的,和rsyslog完全无关,GELF驱动可以直接抓取到这部分流内容,不受rsyslog配置影响。
- 为什么容器本地日志文件能看到syslog消息:Python内置syslog模块的默认传输路径是将消息发送到容器内
/dev/log这个Unix套接字,rsyslog作为监听该套接字的进程,收到消息后按配置写入本地文件,所以能在本地查到这部分内容。 - uvicorn是否会影响Python syslog的日志流转:完全不会。Python syslog的消息走的是本地Unix套接字到rsyslog的独立链路,和uvicorn写入stdout的日志链路完全隔离,两者没有任何交互,即便替换uvicorn为其他Web服务,只要代码中调用syslog模块发送local0日志,链路表现完全一致。
GELF驱动识别不到rsyslog日志的核心原因
本质是对Docker日志驱动的采集逻辑存在认知偏差:
重点提醒:所有Docker原生日志驱动(包括GELF、json-file、syslog等)的默认采集源,都是容器运行时绑定的、由PID 1进程继承的stdout/stderr管道。只有进程往这两个管道写的内容,才会被运行时捕获并转发给对应的日志驱动。rsyslog写入本地文件的日志、转发到其他UDP/TCP端口的日志,只要没有最终落到PID1的stdout/stderr管道上,Docker的日志驱动就完全感知不到。
你当前rsyslog配置里的stop动作,相当于给local0链路的日志直接做了截断,把日志锁在本地文件里,根本没走到容器的输出管道,GELF驱动自然没有办法识别到。
可落地的调整方案
按照改造成本从低到高排列:
- 修改rsyslog配置,解除对local0日志的截断,将rsyslog收到的local0日志同步输出到stdout。移除原有配置块里的
stop指令,增加omstdout输出动作,参考配置:
调整后rsyslog收到local0日志时,会同时写入本地文件和自身的stdout管道,只要rsyslog进程的stdout是绑定到容器的输出流(容器内常规启动rsyslog的场景下默认就是绑定的),GELF驱动就能正常抓取到这部分日志。local0.* { action(type="omfile" file="/var/log/test.log" fileOwner="syslog" fileGroup="syslog" fileCreateMode="0640") action(type="omstdout") } - 绕开rsyslog链路,直接让Python应用将syslog级别的日志输出到stdout。替代原来调用内置syslog模块的逻辑,使用Python标准logging模块配置日志输出到
sys.stdout,让日志直接被GELF驱动抓取,减少中间链路的故障点,也不需要额外调整rsyslog的配置。 - 保留原有rsyslog本地写文件的逻辑,给rsyslog增加直接转发到GELF服务的输出动作。不需要依赖Docker的GELF驱动转发这部分日志,由rsyslog自己通过UDP把收到的local0日志直接发送到日志服务实例,和Docker GELF驱动转发uvicorn日志的链路并行,互不干扰。
内容的提问来源于stack exchange,提问作者programmar
相关产品推荐
相关产品推荐

