0

0

Python 多进程日志收集的实现思路

冰川箭仙

冰川箭仙

发布时间:2026-02-16 15:11:02

|

991人浏览过

|

来源于php中文网

原创

python多进程日志可靠方案有五种:一、manager共享队列由专用进程消费;二、各进程写独立文件;三、queuehandler+queuelistener原生支持;四、自定义filehandler加进程锁;五、用concurrent-log-handler库自动处理。

python 多进程日志收集的实现思路

当使用 Python 多进程(multiprocessing)运行任务时,多个子进程同时写入同一日志文件可能导致内容错乱、覆盖或丢失。以下是实现可靠多进程日志收集的几种技术路径:

一、使用 multiprocessing.Manager() 管理共享日志队列

通过 Manager 创建一个跨进程安全的 Queue,所有子进程将日志记录推送到该队列,由单独的日志消费进程统一写入文件,避免并发写冲突。

1、创建 multiprocessing.Manager 实例并调用 manager.Queue() 获取共享队列。

2、启动一个独立的日志写入进程,持续从该队列中获取日志条目,并调用 logging.getLogger().handle() 或直接写入文件。

立即学习Python免费学习笔记(深入)”;

3、在每个工作子进程中,不直接调用 logger.info(),而是构造包含时间、进程名、级别和消息的字典,put 到共享队列中。

4、主进程需确保日志消费进程在所有工作进程结束后仍持续运行,直至队列为空,再调用 queue.close() 和 join()。

二、为每个进程分配独立日志文件

规避共享资源竞争最直接的方式是让每个子进程写入专属日志文件,后续可通过外部工具合并分析,适用于调试与隔离性要求高的场景。

1、在子进程启动时,调用 multiprocessing.current_process().pid 获取唯一进程标识符。

2、基于 pid 或 process.name 构造日志文件路径,例如 f"worker_{pid}.log"。

3、为每个进程单独配置 logging.FileHandler,设置不同的 filename 参数,且禁用文件轮转共享逻辑(如不共用 RotatingFileHandler 的 baseFilename 锁)。

4、确保各进程的 logger 实例未被父进程的 handler 污染,推荐在子进程中调用 logging.basicConfig() 或显式 addHandler()。

三、利用 logging.handlers.QueueHandler 与 QueueListener

这是 logging 模块原生支持的多进程日志方案:子进程使用 QueueHandler 将 LogRecord 发往队列,主线程(或专用进程)用 QueueListener 绑定 FileHandler 进行集中落盘。

1、在主进程中创建 multiprocessing.Queue 实例,并初始化 QueueListener,传入该队列与一个 FileHandler 实例。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

下载

2、调用 listener.start() 启动监听线程(注意:此为线程,非进程;若需进程模型,须额外封装 listener 为 multiprocessing.Process)。

3、在每个子进程中,获取 root logger,移除默认 handler,添加 QueueHandler(queue) 实例。

4、子进程调用 logging.info() 时,LogRecord 自动序列化后进入队列,由 listener 所在线程反序列化并交由 FileHandler 输出。

四、采用文件锁机制控制写入互斥

在不改变原有日志调用方式的前提下,对 FileHandler 的 doWrite 操作加锁,确保同一时刻仅一个进程执行磁盘写入。

1、使用 multiprocessing.Lock 创建跨进程锁实例,并作为参数传递给各子进程。

2、自定义继承 logging.FileHandler 的类,在 emit() 方法开头调用 lock.acquire(),结尾调用 lock.release()。

3、在自定义 handler 的 doWrite() 中,先 write 再 flush,并确保异常时仍释放锁(使用 try/finally)。

4、为防止死锁,锁对象必须由主进程创建并共享,不可在子进程中重新实例化。

五、借助第三方库 concurrent-log-handler

该库专为解决多进程日志竞争设计,内部使用文件锁与原子重命名策略,在 Linux/macOS 下基于 flock,在 Windows 下基于 Win32 API 锁机制。

1、通过 pip install concurrent-log-handler 安装库。

2、替换原有 logging.FileHandler 为 cloghandler.ConcurrentRotatingFileHandler。

3、配置 maxBytes 和 backupCount 参数以启用自动轮转,其 write 操作天然支持多进程安全。

4、无需修改日志调用代码,也不需要手动管理队列或锁,但需确保所有进程使用完全相同的日志文件路径及轮转参数

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

348

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

425

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

786

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

357

2025.07.23

mysql标识符无效错误怎么解决
mysql标识符无效错误怎么解决

mysql标识符无效错误的解决办法:1、检查标识符是否被其他表或数据库使用;2、检查标识符是否包含特殊字符;3、使用引号包裹标识符;4、使用反引号包裹标识符;5、检查MySQL的配置文件等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

195

2023.12.04

Python标识符有哪些
Python标识符有哪些

Python标识符有变量标识符、函数标识符、类标识符、模块标识符、下划线开头的标识符、双下划线开头、双下划线结尾的标识符、整型标识符、浮点型标识符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

303

2024.02.23

java标识符合集
java标识符合集

本专题整合了java标识符相关内容,想了解更多详细内容,请阅读下面的文章。

272

2025.06.11

c++标识符介绍
c++标识符介绍

本专题整合了c++标识符相关内容,阅读专题下面的文章了解更多详细内容。

138

2025.08.07

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

283

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号