Python logging模块使用示例详解

2025-05-18 02:50

本文主要是介绍Python logging模块使用示例详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《Pythonlogging模块使用示例详解》Python的logging模块是一个灵活且强大的日志记录工具,广泛应用于应用程序的调试、运行监控和问题排查,下面给大家介绍Pythonlogging模...

pythonlogging 模块是一个灵活且强大的日志记录工具,广泛应用于应用程序的调试、运行监控和问题排查。它提供了丰富的功能,包括多级日志记录、多种输出方式、灵活的格式配置等。以下是详细介绍:

一、为什么使用 logging 模块?

  • 替代 printprint 语句仅适合简单调试,而 logging 支持持久化、级别控制、异步写入等。
  • 分级日志:根据重要性区分日志(如 DEBUG、INFO、ERROR),便于过滤信息。
  • 灵活输出:可同时输出到控制台、文件、网络等。
  • 线程安全:适用于多线程/多进程环境。

二、核心组件

Logger(记录器)
应用程序直接调用的接口,负责产生日志。

  • 通过 logging.getLogger(name) 获取或创建 Logger 实例。
  • 支持层级结构(如 'parent.child' 继承父级配置)。

Handler(处理器)
决定日志的输出位置(如控制台、文件、邮件等)。

  • 常用 Handler:
    • StreamHandler:输出到流(如控制台)。
    • FileHandler:输出到文件。
    • RotatingFileHandler:按大小滚动日志文件。
    • TimedRotatingFileHandler:按时间滚动日志文件。
    • SMTPHandler:发送邮件。

Fiwww.chinasem.cnlter(过滤器)
提供更细粒度的日志过滤(如仅记录特定关键词的日志)。

Formatter(格式器)
定义日志的输出格式(时间、级别、消息等)。

常用格式字段:

'%(asctime)s - %(name)s - %(levelname)s - %(message)s'

三、日志级别

从低到高共 6 个级别(低于设定级别的日志将被忽略):

级别数值说明
DEBUG10详细调试信息
INFO20程序正常运行信息
WARNING30潜在问题,但程序仍运行
ERROR40严重错误,影响部分功能
CRITICAL50致命错误,可能导致程序终止

四、基本使用步骤

创建 Logger

import logging
logger = logging.getLogger(__name__)  # 推荐使用模块名作为Logger名称
logger.setLevel(logging.DEBUG)        # 设置记录的最低级别

配置 Handler 和 Formatter

# 创建控制台 Handler
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.WARNING)  # 控制台只输出 WARNING 及以上级别
# 创建文件 Handler
file_handler = logging.FileHandler('app.log')
file_handler.setLevel(logging.DEBUG)      # 文件记录所有 DEBUG 及以上级别
# 定义 Formatter
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelnamehttp://www.chinasem.cn)s - %(message)s')
console_handler.setFormatter(formatter)
file_handler.setFormatter(formatter)
# 将 Handler 添加到 Logger
logger.addHandler(console_handler)
logger.addHandler(file_handler)

记录日志

logger.debug('Debug 信息')
logger.info('程序启动')
logger.warning('磁盘空间不足')
logger.error('请求超时')

五、快速配置(basicConfig)

适用于简单场景的快速配置:

import logging
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(levelname)s编程 - %(message)s',
    handlers=[
        logging.FileHandler('app.log'),
        logging.StreamHjsandler()
    ]
)
logging.warning('警告信息')

六、高级用法

配置文件或字典
使用 logging.config 模块通过文件或字典配置:

import logging.config
config = {
    'version': 1,
    'formatters': {
        'default': {'format': '%(asctime)s - %(levelname)s - %(message)s'}
    },
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'formatter': 'default',
            'level': 'DEBUG'
        }
    },
    'root': {
        'handlers': ['console'],
        'level': 'INFO'
    }
}
logging.config.dictConfig(config)

捕获异常信息
使用 logger.exception 记录异常堆栈:

try:
    1 / 0
except Exception:
    logger.exception('发生异常:')

日志传播
子 Logger 默认将日志传递给父 Logger。可通过 logger.propagate = False 关闭。

七、常见问题

重复日志
原因:多次添加 Handler 或 basicConfig 被多次调用。
解决:确保 Handler 只添加一次,或在 basicConfig 中设置 force=True

性能优化
避免在高频代码中记录低级别日志(如 DEBUG),可预先检查级别:

if logger.isEnabledFor(logging.DEBUG):
    logger.debug(f'耗时操作: {time_consuming()}')

八、总结

loggingjs块通过灵活的配置和分级机制,满足了从简单到复杂的日志需求。掌握其核心组件(Logger、Handler、Formatter)和级别控制,能显著提升程序的可维护性。建议在项目中替代 print,合理利用日志进行调试和监控。

到此这篇关于Python logging模块使用示例详解的文章就介绍到这了,更多相关Python logging模块使用内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)!

这篇关于Python logging模块使用示例详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1154638

相关文章

Maven中的profiles使用及说明

《Maven中的profiles使用及说明》:本文主要介绍Maven中的profiles使用及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录主要用途定义 Profiles示例:多环境配置激活 Profiles示例:资源过滤示例:依赖管理总结Maven 中的

如何使用Haporxy搭建Web群集

《如何使用Haporxy搭建Web群集》Haproxy是目前比较流行的一种群集调度工具,同类群集调度工具有很多如LVS和Nginx,本案例介绍使用Haproxy及Nginx搭建一套Web群集,感兴趣的... 目录一、案例分析1.案例概述2.案例前置知识点2.1 HTTP请求2.2 负载均衡常用调度算法 2.

shell中set -u、set -x、set -e的使用

《shell中set-u、set-x、set-e的使用》本文主要介绍了shell中set-u、set-x、set-e的使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参... 目录✅ 1. set -u:防止使用未定义变量 作用: 示例:❌ 报错示例输出:✅ 推荐使用场景:✅ 2. se

Python循环结构全面解析

《Python循环结构全面解析》循环中的代码会执行特定的次数,或者是执行到特定条件成立时结束循环,或者是针对某一集合中的所有项目都执行一次,这篇文章给大家介绍Python循环结构解析,感兴趣的朋友跟随... 目录for-in循环while循环循环控制语句break语句continue语句else子句嵌套的循

Redis 配置文件使用建议redis.conf 从入门到实战

《Redis配置文件使用建议redis.conf从入门到实战》Redis配置方式包括配置文件、命令行参数、运行时CONFIG命令,支持动态修改参数及持久化,常用项涉及端口、绑定、内存策略等,版本8... 目录一、Redis.conf 是什么?二、命令行方式传参(适用于测试)三、运行时动态修改配置(不重启服务

Python变量与数据类型全解析(最新整理)

《Python变量与数据类型全解析(最新整理)》文章介绍Python变量作为数据载体,命名需遵循字母数字下划线规则,不可数字开头,大小写敏感,避免关键字,本文给大家介绍Python变量与数据类型全解析... 目录1、变量变量命名规范python数据类型1、基本数据类型数值类型(Number):布尔类型(bo

Python如何将OpenCV摄像头视频流通过浏览器播放

《Python如何将OpenCV摄像头视频流通过浏览器播放》:本文主要介绍Python如何将OpenCV摄像头视频流通过浏览器播放的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完... 目录方法1:使用Flask + MJPEG流实现代码使用方法优点缺点方法2:使用WebSocket传输视

Python的端到端测试框架SeleniumBase使用解读

《Python的端到端测试框架SeleniumBase使用解读》:本文主要介绍Python的端到端测试框架SeleniumBase使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全... 目录SeleniumBase详细介绍及用法指南什么是 SeleniumBase?SeleniumBase

Java继承映射的三种使用方法示例

《Java继承映射的三种使用方法示例》继承在Java中扮演着重要的角色,它允许我们创建一个类(子类),该类继承另一个类(父类)的所有属性和方法,:本文主要介绍Java继承映射的三种使用方法示例,需... 目录前言一、单表继承(Single Table Inheritance)1-1、原理1-2、使用方法1-

Android DataBinding 与 MVVM使用详解

《AndroidDataBinding与MVVM使用详解》本文介绍AndroidDataBinding库,其通过绑定UI组件与数据源实现自动更新,支持双向绑定和逻辑运算,减少模板代码,结合MV... 目录一、DataBinding 核心概念二、配置与基础使用1. 启用 DataBinding 2. 基础布局