讲师中心 微信公众号
AI工具推荐 视频效率加速

Python中的logging模块是什么 logging模块如何配置日志记录

老丽大大_5945

老丽大大_5945

发布时间:2025-06-30 20:31:01

|

428人浏览过

|

来源于php中文网

原创

如何使用python的logging模块进行日志记录?python的logging模块通过设置日志级别、格式化输出和选择处理器实现灵活的日志记录。1. 使用logging.basicconfig()配置基本参数,如日志级别和格式;2. 通过getlogger()获取logger实例用于记录信息;3. 利用exc_info=true记录异常堆栈跟踪;4. 自定义日志格式可通过修改format参数或使用formatter类实现;5. 将日志输出到不同目标需配置不同的handler,例如filehandler写入文件、smtphandler发送邮件;6. 在大型项目中可创建集中式日志配置模块以简化管理;7. 多进程环境下可使用queuehandler和queuelistener确保日志写入安全;8. 动态修改日志级别可通过setlevel()方法结合http端点实现。

Python中的logging模块是什么 logging模块如何配置日志记录

Python的logging模块是一个灵活且强大的内置库,用于在应用程序中记录事件,这对于调试、监控和问题诊断至关重要。它允许开发者将不同级别的日志信息(例如:调试、信息、警告、错误和关键错误)输出到不同的目标位置,如控制台、文件或网络服务器。配置日志记录涉及设置日志级别、格式化输出和选择合适的处理器。

Python中的logging模块是什么 logging模块如何配置日志记录

日志记录配置与使用

Python中的logging模块是什么 logging模块如何配置日志记录

logging模块的核心在于其可配置性。一个简单的配置可以像这样开始:

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

Python中的logging模块是什么 logging模块如何配置日志记录
import logging

# 配置logging的基本设置
logging.basicConfig(level=logging.INFO, 
                    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')

# 创建一个logger实例
logger = logging.getLogger(__name__)

# 记录一些信息
logger.info('程序开始运行')

try:
    result = 10 / 0
except Exception as e:
    logger.error('发生异常', exc_info=True) # 记录异常信息

logger.info('程序运行结束')

这段代码展示了如何设置基本的日志级别和格式,并如何使用logger实例记录信息和错误。exc_info=True参数在记录异常时非常有用,因为它会包含完整的堆栈跟踪信息。

如何自定义日志格式以满足不同需求?

自定义日志格式是logging模块的一个强大功能。默认的格式可能无法满足所有需求,因此了解如何创建自定义格式至关重要。你可以通过修改format参数来实现,例如:

logging.basicConfig(level=logging.DEBUG,
                    format='%(asctime)s - %(levelname)s - %(filename)s:%(lineno)d - %(message)s')

在这个例子中,我们添加了文件名和行号到日志格式中,这对于调试来说非常有用。更复杂的格式可能需要使用Formatter类,它可以让你完全控制日志消息的格式。

如何将日志信息输出到不同的目标位置?

除了控制台,你可能希望将日志信息输出到文件,甚至发送到远程服务器。这可以通过配置不同的Handler来实现。例如,要将日志输出到文件,你可以这样做:

import logging

# 创建一个logger
logger = logging.getLogger('my_app')
logger.setLevel(logging.DEBUG)

# 创建一个文件handler,并将日志级别设置为DEBUG
file_handler = logging.FileHandler('my_app.log')
file_handler.setLevel(logging.DEBUG)

# 创建一个formatter,并将其添加到handler
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(formatter)

# 将handler添加到logger
logger.addHandler(file_handler)

# 现在你可以使用logger记录信息了
logger.debug('这是一个debug级别的消息')
logger.info('这是一个info级别的消息')

这段代码创建了一个FileHandler,并将日志消息写入到my_app.log文件中。你还可以创建其他的Handler,例如SMTPHandler用于发送邮件,或者HTTPHandler用于发送到HTTP服务器。

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载

如何在大型项目中使用logging模块?

在大型项目中,手动配置每个模块的logger可能会变得非常繁琐。一种常见的做法是创建一个集中的日志配置模块,并在其他模块中引用它。例如,你可以创建一个名为logger_config.py的文件:

import logging

def setup_logger(name, log_file, level=logging.INFO):
    """To setup as many loggers as you want"""

    handler = logging.FileHandler(log_file)        
    formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
    handler.setFormatter(formatter)

    logger = logging.getLogger(name)
    logger.setLevel(level)
    logger.addHandler(handler)

    return logger

然后在你的其他模块中,你可以这样使用它:

from logger_config import setup_logger

# 创建一个logger
logger = setup_logger('my_module', 'my_module.log')

# 使用logger记录信息
logger.info('模块开始运行')

这种方法可以让你更轻松地管理和维护你的日志配置。

如何处理多线程或多进程环境下的日志记录?

在多线程或多进程环境中,需要特别注意日志记录的线程安全和进程安全。默认情况下,logging模块是线程安全的,但在多进程环境下,多个进程同时写入同一个文件可能会导致问题。为了解决这个问题,可以使用QueueHandler和QueueListener。

简单来说,一个进程将日志消息放入队列,另一个进程(通常是主进程)从队列中取出消息并写入文件。这可以避免多个进程同时写入文件的问题。

import logging
import logging.handlers
import multiprocessing
import queue

def worker_process(queue):
    # 为每个进程配置一个logger
    logger = logging.getLogger('worker')
    handler = logging.handlers.QueueHandler(queue)  # 使用QueueHandler
    logger.addHandler(handler)
    logger.setLevel(logging.INFO)

    logger.info('Worker process started')
    logger.info('Worker process finished')

def listener_process(queue):
    # 配置listener的logger
    logger = logging.getLogger('listener')
    logger.setLevel(logging.DEBUG)

    # 创建一个FileHandler,将日志写入文件
    file_handler = logging.FileHandler('multiprocess.log')
    formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
    file_handler.setFormatter(formatter)

    # 创建一个QueueListener,监听队列并将消息传递给handler
    listener = logging.handlers.QueueListener(queue, file_handler)
    listener.start()

    logger.info('Listener process started')
    listener.info('Listener process finished')
    listener.stop()

if __name__ == '__main__':
    # 创建一个队列
    log_queue = queue.Queue(-1)

    # 启动listener进程
    listener = multiprocessing.Process(target=listener_process, args=(log_queue,))
    listener.start()

    # 启动worker进程
    workers = []
    for i in range(2):
        worker = multiprocessing.Process(target=worker_process, args=(log_queue,))
        workers.append(worker)
        worker.start()

    # 等待所有worker进程完成
    for worker in workers:
        worker.join()

    listener.join()

这个例子展示了如何在多进程环境中使用QueueHandler和QueueListener来安全地记录日志。

如何动态修改日志级别?

有时候,你可能需要在不重启应用程序的情况下动态修改日志级别。这可以通过logging.getLogger().setLevel()来实现。例如,你可以创建一个HTTP端点,接收一个日志级别参数,并动态地修改日志级别。

from flask import Flask, request
import logging

app = Flask(__name__)

# 配置logging
logging.basicConfig(level=logging.INFO, 
                    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
logger = logging.getLogger(__name__)

@app.route('/log_level', methods=['POST'])
def set_log_level():
    level = request.form.get('level', 'INFO').upper()
    try:
        log_level = getattr(logging, level)
        logger.setLevel(log_level)
        return f"Log level set to {level}", 200
    except AttributeError:
        return "Invalid log level", 400

if __name__ == '__main__':
    app.run(debug=True)

这个简单的Flask应用允许你通过POST请求动态地修改日志级别。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
flask框架如何搭建
flask框架如何搭建

搭建步骤:1、安装Python和Pip;2、创建虚拟环境;3、安装Flask;4、创建Flask应用;5、运行应用;6、访问应用。想了解更多flask框架的相关内容,可以阅读本专题下面的文章。

2955

2024.06.27

Python Flask框架
Python Flask框架

本专题专注于 Python 轻量级 Web 框架 Flask 的学习与实战,内容涵盖路由与视图、模板渲染、表单处理、数据库集成、用户认证以及RESTful API 开发。通过博客系统、任务管理工具与微服务接口等项目实战,帮助学员掌握 Flask 在快速构建小型到中型 Web 应用中的核心技能。

4404

2025.08.25

Python Flask Web框架与API开发
Python Flask Web框架与API开发

本专题系统介绍 Python Flask Web框架的基础与进阶应用,包括Flask路由、请求与响应、模板渲染、表单处理、安全性加固、数据库集成(SQLAlchemy)、以及使用Flask构建 RESTful API 服务。通过多个实战项目,帮助学习者掌握使用 Flask 开发高效、可扩展的 Web 应用与 API。

276

2025.12.15

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1589

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1191

2024.06.27

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

4647

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2108

2023.08.10

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

4647

2023.07.18

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CMake 命令行手册
CMake 命令行手册

共0课时 | 0人学习

Composer 从入门到实战
Composer 从入门到实战

共1课时 | 161人学习

mysql8主从复制原理底层详解
mysql8主从复制原理底层详解

共1课时 | 698人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn