Python Logger用法和说明

已于 2025-04-18 10:58:03 修改
阅读量795 收藏 13
点赞数 22
分类专栏： Python 文章标签： python 开发语言
于 2025-04-18 10:09:17 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_48465029/article/details/147321468
版权

Python Logger详细用法和说明

1. Logger简介

Logger是Python内置的logging模块中的一个重要组件，用于记录程序运行过程中的事件信息，包括错误、警告、信息以及调试信息。合理使用Logger可以极大提高程序的调试效率和可维护性。

2. Logger的基本用法

导入模块

import logging

创建Logger对象

# 创建Logger对象，通常使用模块名作为logger的名称
logger = logging.getLogger(__name__)
# 设置日志级别，只有级别高于等于该级别的日志才会被记录
logger.setLevel(logging.DEBUG)

Handler详解

Handler用于指定日志输出的位置，例如控制台、文件、网络等。

常用Handler：
  • StreamHandler: 输出日志到控制台（标准输出）
  • FileHandler: 输出日志到文件
使用StreamHandler（输出到控制台）
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.DEBUG)
使用FileHandler（输出到文件）
file_handler = logging.FileHandler('app.log')
file_handler.setLevel(logging.ERROR)

Formatter详解

Formatter用于定义日志消息的格式，例如包含时间、日志级别、日志消息等。

# 定义日志的输出格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

# 给handler设置formatter
console_handler.setFormatter(formatter)
file_handler.setFormatter(formatter)

将Handler添加到Logger

logger.addHandler(console_handler)
logger.addHandler(file_handler)

输出日志消息

logger.debug('这是一个调试信息')
logger.info('这是普通信息')
logger.warning('这是一个警告信息')
logger.error('这是一个错误信息')
logger.critical('这是一个严重错误信息')

3. Logger日志级别详细说明

Logger提供的日志级别有以下几种：

日志级别数值含义
DEBUG10详细信息，用于问题的调试与排查
INFO20普通信息，记录正常运行时的事件
WARNING30警告信息，可能导致问题的情况
ERROR40错误信息，程序运行出现的问题
CRITICAL50严重错误，通常导致程序崩溃

日志级别的顺序为：

CRITICAL > ERROR > WARNING > INFO > DEBUG

4. Logger的进阶配置

logging.config 的几种加载方式

Python提供logging.config模块进行集中化配置：

  1. fileConfig 加载INI格式配置文件：
import logging.config
logging.config.fileConfig('logging.conf')
  1. dictConfig 加载字典（推荐）：
import logging.config
logging.config.dictConfig(my_config_dict)
  1. 自定义代码方式配置：
    使用Python代码动态设置Logger（前文已演示）。

使用配置文件进行日志配置

创建配置文件（如logging.conf）用于Logger的配置。

logging.conf示例（包含两个handler）：

[loggers]
keys=root,myLogger

[handlers]
keys=consoleHandler,fileHandler

[formatters]
keys=simpleFormatter

[logger_root]
level=WARNING
handlers=consoleHandler

[logger_myLogger]
level=DEBUG
handlers=consoleHandler,fileHandler
qualname=myLogger
propagate=0

[handler_consoleHandler]
class=StreamHandler
level=DEBUG
formatter=simpleFormatter
args=(sys.stdout,)

[handler_fileHandler]
class=FileHandler
level=ERROR
formatter=simpleFormatter
args=('app.log', 'a')

[formatter_simpleFormatter]
format=%(asctime)s - %(name)s - %(levelname)s - %(message)s

loggers 字段的说明

在配置文件中，[loggers]部分定义了有哪些Logger实例。每个Logger都可以拥有独立的级别、处理器和名称。

  • root 是Python默认的顶级Logger。
  • 你也可以自定义Logger（如上例中的 myLogger），并通过 qualname 设置其名称。
  • 在代码中使用 getLogger('myLogger') 获取这个Logger。

这使得你可以为不同模块、不同用途设置不同的日志策略，实现更灵活的日志管理。

使用示例：

import logging.config

logging.config.fileConfig('logging.conf')
logger = logging.getLogger('myLogger')
logger.debug('这是自定义logger的调试日志')

使用字典配置Logger

import logging.config

logging_config = {
    'version': 1,
    'formatters': {
        'simpleFormatter': {
            'format': '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
        },
    },
    'handlers': {
        'consoleHandler': {
            'class': 'logging.StreamHandler',
            'formatter': 'simpleFormatter',
            'level': logging.DEBUG,
        },
        'fileHandler': {
            'class': 'logging.FileHandler',
            'formatter': 'simpleFormatter',
            'level': logging.ERROR,
            'filename': 'app.log',
        },
    },
    'loggers': {
        'myLogger': {
            'handlers': ['consoleHandler', 'fileHandler'],
            'level': 'DEBUG',
            'propagate': False,
        },
    }
}

logging.config.dictConfig(logging_config)
logger = logging.getLogger('myLogger')
logger.debug('输出到控制台')
logger.error('输出到控制台并记录到文件')

5. logging模块常见方法和配置

Logger对象常用方法：

  • logger.debug(msg)：记录调试信息
  • logger.info(msg)：记录普通信息
  • logger.warning(msg)：记录警告
  • logger.error(msg)：记录错误
  • logger.critical(msg)：记录严重错误
  • logger.exception(msg)：记录异常信息，自动附带堆栈（应在except块中使用）

常见配置项：

  • name: 日志器名称（通过 getLogger(name) 获取）
  • level: 级别过滤器
  • handlers: 所使用的输出通道
  • formatter: 日志格式控制器
  • propagate: 是否向父Logger传递日志（默认True）

6. 同时使用多个Handler的示例

实际应用中，通常需要日志同时输出到控制台和文件。

import logging

logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

console_handler = logging.StreamHandler()
console_handler.setLevel(logging.DEBUG)

file_handler = logging.FileHandler('app.log')
file_handler.setLevel(logging.ERROR)

formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
console_handler.setFormatter(formatter)
file_handler.setFormatter(formatter)

logger.addHandler(console_handler)
logger.addHandler(file_handler)

logger.debug('仅输出到控制台')
logger.error('同时输出到控制台和文件')

7. Logger的最佳实践

  • 尽可能选择合适的日志级别，避免记录大量无意义的日志。
  • 在实际生产环境中推荐使用配置文件进行管理，易于维护和修改。
  • 日志文件管理中，应考虑日志文件大小、轮转机制以及长期备份。
  • 利用多个Logger区分不同模块、用途，提高日志管理的灵活性。

8. 总结

Python中的Logger模块功能强大，理解Handler、Formatter、Logger本身的结构，以及配置方式（包括loggers字段的用途）、加载方法和常见函数使用，可以有效提升项目的可维护性和可观测性。

Logger日志工具使用
05-31
Github最强大的Log日志工具类开源项目,Eclipse版,附带本人中文说明.
python_logger
03-27
现在，我们可以使用`logger.info()`, `logger.warning()`, `logger.error()`等方法记录日志： ```python logger.info('This is an info message.') logger.warning('A warning has occurred.') logger.error('An ...
Python logger 的使用
weixin_45422352的博客
05-17 350
：Python-3.7， fastapi-0.64.0，uvicorn-0.13.4config.py主要是进行日志功能的相关环境的设置 logger.py主要是对 Python 原始的 logging 模块进行封装 main.py对封装的logger进行调用 log.log 打印内容如下
Python中logger模块的使用教程
思念殇千寻的博客
06-02 924
　　参考模块： 　　https://www.digitalocean.com/community/tutorials/how-to-use-logging-in-python-3 　　logger是python的内置模块，用以输出代码运行过程中的运行情况，极大的方便了我们的debug过程。参考资料中列出了使用logger相比于print优越的地方： 　　1. 使用print很难和代码的正常输出区...
PYTHON的logger包使用
weixin_52133252的博客
03-31 200
logger有5个级别：trace、debug、info、warining、error。logger日志分为五个级别，这里设定TRACE以下的级别会被保存。2. 添加标准错误流处理器（日志级别为TRACE）（2）日志文件log.txt。4.输出不同级别的日志。
Logger用法
weixin_30648587的博客
11-14 177
logger的输出有两种方式：①log.log(Level.INFO,"message")②log.info("mesage")其他级别的输出与此类似。 获得com.sample.LoggerSample这个类的logger对象。可设置其Level，这样在LoggerSample运行时会根据在LoggerSample中预先定义好的Level级别来输出log。 设置logger输出级别 各...
Python中logger日志模块详解
09-16
Python中的`logging`模块是用于生成和管理程序运行过程中日志信息的重要工具。这个模块提供了丰富的功能，使得开发者能够方便地记录、配置和控制日志输出。以下是对`logging`模块的详细介绍： **1. logging模块简介...
Python logging设置和logger解析
09-18
使用logger对象，你可以设置日志级别、添加和移除处理器以及过滤器。例如，设置日志级别为INFO： ```python logger.setLevel(logging.INFO) ``` 添加一个处理器到logger： ```python handler = logging.FileHandler...
Python实现Logger打印功能的方法详解
09-21
### Python 实现 Logger 打印功能的方法详解 #### 前言 在开发过程中，日志记录是一项重要的工作，它不仅有助于我们理解程序运行时的行为，还能帮助我们追踪错误、调试问题。Python 提供了内置的 `logging` 模块来...
对python中的logger模块全面讲解
09-20
在Python中，使用logger模块记录日志的基本步骤包括配置logger、创建handler、配置formatter以及将handler添加到logger。配置时还可以指定日志级别，只有高于或等于该级别日志消息才会被处理。 在给定的文件部分...
Logger的用法
opera95的博客
07-09 4259
日志记录器(Logger)是日志处理的核心组件。log4j具有5种正常级别(Level)。日志记录器(Logger)的可用级别Level (不包括自定义级别 Level)， 以下内容就是摘自log4j API (http://jakarta.apache.org/log4j/docs/api/index.html): static Level WARN WARN level表明会出现潜
Python 中logging使用
Python编程学习的博客
04-11 216
settings.py文件。
python日志logger
u014694915的博客
10-17 259
写代码过程中，为了方便问题定位，经常需要打印信息，但是太多的print()不好，所以可以用到loggerLogger通常分为两类：一类是StreamHandler，将日志信息输出到控制台；另一类是FileHandler，将日志信息输出到文件。Python标准库中的logging模块提供了强大的Logger功能。
python中的简单logger
刘鑫的专栏
12-20 1万+
在程序中经常要用到日志处理操作，如何进行呢？本文提供一种简单的处理方式。#-*-encoding:utf-8-*-import logginglogfile = log.txt         logger = logging.getLogger()hdlr = logging.FileHandler(logfile)formatter = logging.Formatter(%(ascti
Python logging模块怎么使用，你会了吗？
Tester_muller的博客
06-29 197
通过使用Python的logging模块，我们可以方便地进行日志记录并获得应用程序的运行时信息。我们可以设置不同的日志级别，根据需要记录调试信息、警告、错误等。此外，我们还可以将日志记录到文件中，以供后续查看和分析。使用logging模块进行日志记录可以帮助我们更好地理解应用程序的运行状况，并帮助我们快速定位和解决问题。建议在开发和维护Python应用程序时，充分利用logging模块进行日志记录。获取更多技术资料，请点击！
Python 中 logging 模块的基本用法
soft_ware_test的博客
07-07 957
Python 中 logging 模块的基本用法
Logger 基本用法
热门推荐
yy1713的博客
04-21 4万+
Logger 基本用法 简介 Simple, pretty and powerful logger for android 为Android提供的，简单、强大而且格式美观的工具 本质就是封装系统提供的Log类，加上一些分割线易于查找不同的Log；logcat中显示的信息可配置。最初的样子如下图 包含线程信息、Log所在的类、方法及所在行数。 这里我忍不住了，就先写...
Python中logging模块用法
tangsiqi130的博客
04-26 940
logging模块用法
python logging模块的使用总结
勿忘初心方得始终
12-08 1153
Python的logging模块是一个用于记录日志信息的标准模块。它提供了一种灵活的方式来记录错误信息、调试信息和其他有用的日志数据。
python中logger方法的用法
最新发布
04-03
<think>嗯，用户想了解如何在Python中使用logging模块的logger方法。首先，我需要回忆一下logging模块的基本结构。记得logging模块有四大组件：logger、handler、filter、formatter。其中logger是用户直接交互的部分，用来记录日志的。 用户提到的logger方法可能是指如何获取和配置logger对象。根据引用[4]，通常使用logging.getLogger()方法来获取logger实例，而不是直接实例化Logger类。那应该先解释这个方法的作用，比如传入名字参数，相同名字返回同一个实例，这样可以实现模块化的日志管理。 接下来，需要分步骤说明如何使用。首先是导入模块，然后获取logger对象。例如，logger = logging.getLogger('example')。然后需要配置日志级别，比如logger.setLevel(logging.DEBUG)。然后要添加handler，比如控制台的StreamHandler或者文件的FileHandler。每个handler可能需要设置自己的级别和格式。 格式方面，formatter可以使用logging.Formatter来定义日志输出的格式，比如时间、logger名、级别、消息。然后把这个formatter添加到handler，再把handler添加到logger。这样logger就可以用不同handler输出到不同地方了。 然后需要说明记录日志的方法，比如logger.debug(), logger.info()等，不同级别对应不同的方法。还要注意日志级别的重要性，比如如果logger的级别设为WARNING，那么DEBUG和INFO级别的消息不会被处理。 可能还要提到避免创建过多logger的方式，使用命名空间来组织，比如用__name__作为名字，这样可以继承父模块的配置。这也是引用[4]中提到的模块化日志管理的好处。 另外，引用[2]和[3]提到在自动化测试和大数据分析中的应用，可以举例说明在这些场景下如何有效使用logger，比如在测试框架中记录错误，或者将日志导入分析系统。 需要确保步骤清晰，先导入模块，创建logger，配置级别，添加handler和formatter，然后记录日志。最后给出完整的代码示例，让用户能直接复制使用。同时要提醒常见问题，比如多次添加handler导致重复日志，或者级别设置不当导致日志不显示。 可能用户还会疑惑为什么不用basicConfig，但根据引用[4]，getLogger()更适合模块化应用，而basicConfig适用于简单场景。所以需要比较两者的区别，帮助用户理解何时使用哪种方法。 总结来说，回答的结构应该是先介绍logger方法的作用，然后分步骤详细说明配置过程，给出代码示例，最后注意事项和应用场景。同时结合引用中的内容，强调模块化管理和不同组件的协作。</think>在Python中使用logging模块的`logger`方法需遵循以下步骤，通过模块化方式实现灵活、可扩展的日志管理： ### 一、创建Logger对象 1. **导入模块** ```python import logging ``` 2. **获取Logger实例** 使用`logging.getLogger(name)`方法创建或获取Logger对象。推荐使用`__name__`参数实现模块化日志管理[^4]： ```python logger = logging.getLogger(__name__) # 通常以模块名为标识 ``` --- ### 二、配置日志处理 #### 1. 设置日志级别 ```python logger.setLevel(logging.DEBUG) # 设置最低记录级别（DEBUG < INFO < WARNING < ERROR < CRITICAL） ``` #### 2. 添加处理器（Handler） 常用处理器类型： - **控制台输出** ```python console_handler = logging.StreamHandler() console_handler.setLevel(logging.WARNING) # 控制台仅显示WARNING及以上级别 ``` - **文件输出** ```python file_handler = logging.FileHandler('app.log') file_handler.setLevel(logging.DEBUG) # 文件记录所有DEBUG及以上级别 ``` #### 3. 定义日志格式 通过`Formatter`对象自定义输出格式： ```python formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') console_handler.setFormatter(formatter) file_handler.setFormatter(formatter) ``` #### 4. 绑定处理器 ```python logger.addHandler(console_handler) logger.addHandler(file_handler) ``` --- ### 三、记录日志 通过不同级别方法输出日志： ```python logger.debug('调试信息') # 记录详细运行状态 logger.info('常规信息') # 记录程序执行流程 logger.warning('警告信息') # 记录潜在问题 logger.error('错误信息') # 记录功能异常 logger.critical('严重错误') # 记录系统级故障 ``` --- ### 四、完整示例 ```python import logging # 创建Logger logger = logging.getLogger(__name__) logger.setLevel(logging.DEBUG) # 定义格式 formatter = logging.Formatter('%(asctime)s | %(levelname)-8s | %(message)s') # 控制台处理器 console_handler = logging.StreamHandler() console_handler.setLevel(logging.WARNING) console_handler.setFormatter(formatter) # 文件处理器 file_handler = logging.FileHandler('app.log') file_handler.setFormatter(formatter) # 添加处理器 logger.addHandler(console_handler) logger.addHandler(file_handler) # 使用示例 logger.info('服务启动') logger.warning('磁盘空间剩余10%') ``` --- ### 五、注意事项 1. **避免重复日志** 不要多次调用`addHandler()`添加相同处理器，否则会导致日志重复输出[^2] 2. **日志级别继承** 子Logger默认继承父Logger配置，可通过`logger.propagate = False`关闭 3. **性能优化** 高频日志场景建议使用`logging.handlers.RotatingFileHandler`实现日志轮转[^3] ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值