【Python日志模块全面指南】：记录每一行代码的呼吸，掌握应用程序的脉搏

logging 模块提供了一种灵活且易于使用的方式来记录应用程序的状态和调试信息。它允许将消息分发到多个处理程序（handlers），并支持不同级别的日志消息。

logging模块是Python内置的标准模块，主要用于输出运行日志，可以设置输出日志的等级、日志保存路径、日志文件回滚等；

在 logging 模块中，日志级别用于描述日志的重要程度。它们按照严重程度分为以下五个级别：
    DEBUG：最详细的日志信息，通常只在调试问题时使用；
    INFO：确认一切按预期运行；
    WARNING：表示发生了一些意外或异常情况，但是该软件还可以正常运行；
    ERROR：由于更严重的问题，软件已无法执行某些功能；
    CRITICAL：严重错误，表明程序本身可能无法继续运行。

# DEBUG
# 最详细的调试信息，通常只在开发阶段使用。通过记录变量值、函数参数、分支走向等信息帮助调试人员解决问题。

# INFO
# INFO 级别的日志通常用于确认系统正在按预期运行。例如，记录请求的处理时间、数据库操作数量、任务的完成状态等。

# WARNING
# WARNING 级别的日志表示出现了一些意外或异常情况，但是该软件还可以正常运行。例如，数据缺失或配置文件格式错误等。

# ERROR
# ERROR 级别的日志表示由于更严重的问题，软件已无法执行某些功能。例如，数据库连接失败、文件无法打开等错误。

# CRITICAL
# 最高级别的日志级别，用于记录严重错误，表明程序本身可能无法继续运行。例如，内存耗尽、服务器崩溃等。

# 开发应用程序或部署开发环境时，
# 可以使用DEBUG或INFO级别的日志获取尽可能详细的日志信息来进行开发或部署调试；
# 
# 
# 
# 应用上线或部署生产环境时，应该使用WARNING或ERROR或CRITICAL级别的日志来降低机器的I/O压力和提高获取错误日志信息的效率。
# 日志级别的指定通常都是在应用程序的配置文件中进行指定的。
# 
# 
# 
# 说明：
# 
# -上面列表中的日志等级是从上到下依次升高的，
#     即：DEBUG < INFO < WARNING < ERROR < CRITICAL，
#     而日志的信息量是依次减少的；
# 
# -当为某个应用程序指定一个日志级别后，
#     应用程序会记录所有日志级别大于或等于指定日志级别的日志信息，
#     而不是仅仅记录指定级别的日志信息，
#     nginx、php等应用程序以及这里的python的logging模块都是这样的。
#     同样，logging模块也可以指定日志记录器的日志级别，
#     只有级别大于或等于该指定日志级别的日志记录才会被输出，小于该等级的日志记录将会被丢弃。

import logging

# 创建一个 logger
logger = logging.getLogger('my_logger')
logger.setLevel(logging.INFO)


# 将 StreamHandler 添加到 logger 中 --- StreamHandler处理器：将日志消息输出到标准输出或标准错误流。
logger.addHandler(logging.StreamHandler())

# 记录一条日志消息
logger.info('This is an info message')

logger.setLevel(logging.DEBUG) # 记录所有级别的日志消息

import logging
 
# 创建一个 logger
logger = logging.getLogger('my_logger')
 
# 设置日志级别
logger.setLevel(logging.DEBUG)

# 将 StreamHandler 添加到 logger 中 --- StreamHandler处理器：将日志消息输出到标准输出或标准错误流。
logger.addHandler(logging.StreamHandler())
 
# 发布日志消息
logger.debug('This is a debug message')

# 创建了一个名为 'my_logger' 的 logger，设置其日志级别为 DEBUG，并发布了一条 DEBUG 级别的日志消息。

 """
    logging.log() 函数的参数说明：
		level：指定要记录的日志级别，可选的取值有 DEBUG、INFO、WARNING、ERROR、CRITICAL。
		*args：需要记录的一个或多个日志消息（字符串）。
		**kwargs：可选参数，包括 extra、exc_info、stack_info、etc.
"""		
import logging
# 创建一个 logger
logger = logging.getLogger('my_logger')
# 设置日志级别
logger.setLevel(logging.DEBUG)
# 将 StreamHandler 添加到 logger 中 --- StreamHandler处理器：将日志消息输出到标准输出或标准错误流。
# logger.addHandler(logging.StreamHandler())
# 将一条消息记录到日志文件或控制台
logging.log(logging.INFO, 'This is an info message')

# StreamHandler：将日志消息输出到标准输出或标准错误流。
# 
# FileHandler：将日志消息输出到指定的文件中。
# 
# RotatingFileHandler：类似于 FileHandler，但它可以自动轮换多个日志文件，以避免一个文件太大而无法存储问题。
# 
# SMTPHandler：向指定的邮件地址发送日志消息。
# 
# SysLogHandler：向系统日志服务（syslog）输出日志消息。
# 
# NTEventLogHandler：向 Windows 事件日志输出日志消息。

import logging
 
# 创建一个 logger
logger = logging.getLogger('my_logger')
logger.setLevel(logging.INFO)
 
# 创建一个 StreamHandler 并设置日志级别为 INFO
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)
 
# 将 StreamHandler 添加到 logger 中
logger.addHandler(console_handler)
 
# 记录一条日志消息
logger.info('This is an info message')

# 首先创建了名为 'my_logger' 的 logger 对象，将其日志级别设置为 INFO。
# 然后，创建了一个名为 console_handler 的 StreamHandler 并将它的日志级别设置为 INFO。
# 最后，将 handler 添加到 logger 中，并通过 logger.info() 方法发布一条 INFO 级别的日志消息。

import logging

# 创建一个 logger 对象，并设置其日志级别为 INFO
logger = logging.getLogger('my_logger')
logger.setLevel(logging.INFO)

# 创建一个 FileHandler，将日志记录到文件 'example.log' 中
fh = logging.FileHandler('example.log')

# 将 FileHandler 添加到 logger 中
logger.addHandler(fh)

# 创建一个 Formatter 对象并设置日志消息的格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
fh.setFormatter(formatter)

# 记录一条 INFO 级别的日志消息
logger.info('This is an info message')

# 创建了名为 'my_logger' 的 logger 对象，并将其日志级别设为 INFO。接着，创建了一个 FileHandler 对象并将其添加到 logger 对象中。然后，通过 Formatter 类创建了一个格式化记录对象 formatter，并将其设置为日志消息的格式。最后，将 formatter 对象添加到 FileHandler 对象中，以便对每条日志消息进行格式化处理。

# 当调用 logger.info() 方法写入日志消息时，该消息会被传递给已经设置了格式化记录的 FileHandler 对象并格式化为指定的字符串格式。例如，如果设置了 '%(asctime)s - %(name)s - %(levelname)s - %(message)s' 的格式化字符串，则会在每条日志消息中输出时间戳、logger 对象的名称、日志级别和消息内容。

import logging

# 创建一个 logger 对象，并设置其日志级别为 INFO
logger = logging.getLogger('my_logger')
logger.setLevel(logging.INFO)

# 创建一个 FileHandler，用于将日志记录到文件 'example.log' 中
fh = logging.FileHandler('example.log')

# 设置 FileHandler 的日志级别为 DEBUG
fh.setLevel(logging.DEBUG)

# 创建一个 Formatter 对象，用于设置日志消息的格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

# 将 Formatter 对象添加到 FileHandler 中
fh.setFormatter(formatter)

# 将 FileHandler 添加到 logger 对象中
logger.addHandler(fh)

# 记录一条 INFO 级别的日志消息
logger.info('This is an info message')

# 记录一条 DEBUG 级别的日志消息
logger.debug('This is a debug message')

# 首先创建了名为 'my_logger' 的 logger 对象，并设置其日志级别为 INFO。接着，创建了一个 FileHandler 对象，并指定要将日志记录到文件 'example.log' 中。然后，将 FileHandler 的日志级别设置为 DEBUG，并创建一个 Formatter 对象，以控制日志消息的格式。最后，将 Formatter 对象和 FileHandler 对象添加到 logger 中。

# 在 logger 对象准备就绪后，可以通过调用 logger.info() 和 logger.debug() 方法发布不同级别的日志消息。这些消息将分别记录在 'example.log' 文件中，其中 INFO 级别的消息包含时间戳、logger 名称、日志级别和消息内容等信息，而 DEBUG 级别的消息则包含更多的细节信息，例如变量值和程序状态等。

在 logging 模块中，可以使用 basicConfig() 函数或者通过编程的方式来配置 logger 对象的属性和行为。

通常情况下，在应用程序开始执行时调用 basicConfig() 函数即可完成全局的基本配置。

%Y 四位数的年份表示（000-9999）
%y 两位数的年份表示（00-99）
%m 月份（01-12）
%d 月内中的一天（0-31）
%H 24小时制小时数（0-23）
%I 12小时制小时数（01-12）
%M 分钟数（00-59）
%S 秒（00-59）
%p 上午AM 下午 PM

import logging
 
logging.basicConfig(filename='example.log', level=logging.DEBUG,
                    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
                    datefmt='%m/%d/%Y %I:%M:%S %p')
 
# 记录一条日志消息
logging.info('This is an info message')

# 首先调用了 basicConfig() 函数，并传递了一些参数来设置日志记录器的属性。例如，指定了要将日志消息记录到文件 'example.log' 中，设置了默认日志级别为 DEBUG，指定了日期时间格式，以及设置了一个自定义的日志消息格式。
# 之后可以通过标准的日志记录函数（如 logging.info()）来记录日志消息，这些函数都将根据 global basicConfig() 配置的内容记录日志。

需要注意的是，如果在多个模块或文件中使用相同的 logger 对象，则必须确保在所有地方都调用了 basicConfig() 函数，或者手动对所有 logger 对象进行配置。否则，可能会出现不同部分记录的日志信息不一致的问题。

总之，无论是使用 basicConfig() 函数还是编程方式来配置 logger 对象，都需要了解每个参数的含义和作用，并根据具体应用场景去设置它们。这些参数包括日志文件名、日志级别、日期时间格式、日志消息格式等方面。

import logging
 
# 配置全局日志记录器属性
logging.basicConfig(filename='example.log', level=logging.DEBUG,
                    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
                    datefmt='%m/%d/%Y %I:%M:%S %p')
 
# 创建一个 logger 对象
logger = logging.getLogger('my_logger')
logger.setLevel(logging.DEBUG)
 
# 给 logger 添加处理程序 ConsoleHandler，将日志消息输出到控制台
ch = logging.StreamHandler()
ch.setLevel(logging.DEBUG)
logger.addHandler(ch)
 
# 记录不同级别的日志消息
logger.debug('This is a debug message')
logger.info('This is an info message')
logger.warning('This is a warning message')
logger.error('This is an error message')
logger.critical('This is a critical message')

# 1、创建一个logger

# 2、设置下logger的日志的等级

# 3、创建合适的Handler(FileHandler要有路径)

# 4、设置下每个Handler的日志等级

# 5、创建下日志的格式

# 6、向Handler中添加上面创建的格式

# 7、将上面创建的Handler添加到logger中

# 8、打印输出logger.debug\logger.info\logger.warning\logger.error\logger.critical

import logging

# 配置全局日志记录器属性
#logging.basicConfig(filename='example.log', level=logging.DEBUG,format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',datefmt='%m/%d/%Y %I:%M:%S %p')

# 创建logger，如果参数为空则返回root logger
logger = logging.getLogger("nick")
logger.setLevel(logging.DEBUG)  # 设置logger日志等级

# 创建handler
fh = logging.FileHandler("example.log", encoding="utf-8")
ch = logging.StreamHandler()

# 设置输出日志格式
formatter = logging.Formatter(
    fmt="%(asctime)s %(name)s %(filename)s %(message)s",
    datefmt="%Y/%m/%d %X"
)

# 注意 logging.Formatter的大小写

# 为handler指定输出格式，注意大小写
fh.setFormatter(formatter)
ch.setFormatter(formatter)

# 为logger添加的日志处理器
logger.addHandler(fh)
logger.addHandler(ch)

# 输出不同级别的log
logger.warning("警告")
logger.info("提示")
logger.error("错误")