logging模块

"""
logging 日志模块
    什么是日志?
    就像生活中的日记 用于记录什么时间发生了什么事情

    为什么要记日志?
        就是为了在以后程序出现问题的时候,能通过日志来找到问题的原因

    怎么记日志
        可以自己实现
        当然有功能更强大的logging模块
"""

import logging
# 最基本的用法
logging.debug("debug")
logging.info("info")
logging.warning("warning")
logging.error("error")
logging.critical("critical")

# logging模块将日志分为了五中级别

                                logging.debug() # 10
                                logging.info() # 20
                                logging.warning() # 30
                                logging.error()# 40
                                logging.critical() # 50

# 为什么要分级别? 是为了在后期查看日志时候方便定位
# logging的默认显示级别为WARNING,低于WARNING级别的都不会别显示
# 默认输出位置是终端
# 默认的输出格式 WARNING(级别):root(日志生成器的名字):warning(输出的日志消息)

# 修改默认行为
# 日志模块中的四种角色
"""
1.logger 日志生成器      生成一条日志
2.filter 日志的过滤器    对logger生成的日志进行过滤(需要涉及到面向对象)
3.formatter  处理格式的  设置日志的输出格式
4.handler 处理器         最终负责将日志输出到指定的位置

"""


# 自定义日志生成器
可用参数:

filename：用指定的文件名创建FiledHandler（后边会具体讲解handler的概念），这样日志会被存储在指定的文件中。
filemode：文件打开方式，在指定了filename时使用这个参数，默认值为“a”还可指定为“w”。
format：指定handler使用的日志显示格式。
datefmt：指定日期时间格式。
level：设置rootlogger（后边会讲解具体概念）的日志级别
stream：用指定的stream创建StreamHandler。可以指定输出到sys.stderr,sys.stdout或者文件，默认为sys.stderr。若同时列出了filename和stream两个参数，则stream参数会被忽略。

可用格式:

%(name)s：Logger的名字，并非用户名，详细查看

%(levelno)s：数字形式的日志级别

%(levelname)s：文本形式的日志级别

%(pathname)s：调用日志输出函数的模块的完整路径名，可能没有

%(filename)s：调用日志输出函数的模块的文件名

%(module)s：调用日志输出函数的模块名

%(funcName)s：调用日志输出函数的函数名

%(lineno)d：调用日志输出函数的语句所在的代码行

%(created)f：当前时间，用UNIX标准的表示时间的浮 点数表示

%(relativeCreated)d：输出日志信息时的，自Logger创建以 来的毫秒数

%(asctime)s：字符串形式的当前时间。默认格式是 “2003-07-08 16:49:45,896”。逗号后面的是毫秒

%(thread)d：线程ID。可能没有

%(threadName)s：线程名。可能没有

%(process)d：进程ID。可能没有

%(message)s：用户输出的消息

# 可以为生成器指定名字 是因为 可以存在多个生成器
logger = logging.getLogger("logger1")
# 设置日志级别
# logging模块内部使用整数区分级别
# 此处可以直接写对应整数,但是建议写常量
logger.setLevel(logging.WARNING)

# logger.warning("这是一个警告信息")

# 创建一个处理器
handler = logging.FileHandler("test.log","a",encoding="utf-8")

fm = logging.Formatter("%(asctime)s - %(name)s -%(filename)s - %(message)s")

handler.setFormatter(fm)

# 将handler与生成器绑定
# 可以为一个生成器指定多个处理器
logger.addHandler(handler)

logger.error("这是一个错误信息....")





使用字典配置logging

from conf import settings

# 一堆日志格式
standard_format = '[%(asctime)s][%(threadName)s:%(thread)d][task_id:%(name)s][%(filename)s:%(lineno)d]' 
                  '[%(levelname)s][%(message)s]' #其中name为getlogger指定的名字

simple_format = '[%(levelname)s][%(asctime)s][%(filename)s:%(lineno)d]%(message)s'

id_simple_format = '[%(levelname)s][%(asctime)s] %(message)s'




LOGGING_DIC = {
    'version': 1, #只能为1
    'disable_existing_loggers': False, # 是否禁用已经存在的生成器,通常为False
    'formatters': { # 不能修改 内部可以有多个格式处理器
        'standard': { # 是格式处理器的名字 可以自定义
            'format': standard_format # key不能修改
        },
    },
    'filters': {},
    'handlers': { # key不能修改
        #打印到终端的日志
        'console': { # 处理的名字 可以修改
            'level': 'DEBUG',
            'class': 'logging.StreamHandler',  # 打印到屏幕
            'formatter': 'standard' # 指定处理器的格式
        },
        #打印到文件的日志,收集info及以上的日志
        'default': {
            'level': 'DEBUG',
            'class': 'logging.handlers.RotatingFileHandler',  # Rotatin日志轮转 保存到文件
            'formatter': 'standard',
            'filename': settings.LOG_PATH,  # 日志文件的路径
            'maxBytes': 1024*1024*5,  # 日志大小 5M
            'backupCount': 5,# 最多存在五个日志文件
            'encoding': 'utf-8',  # 日志文件的编码，再也不用担心中文log乱码了
        },
    },
    'loggers': {
        #logging.getLogger(__name__)拿到的logger配置
        '': {  #设置为空
            'handlers': ['default', 'console'],  # 这里把上面定义的两个handler都加上，即log数据既写入文件又打印到屏幕
            'level': 'DEBUG',
            # 'propagate': True,  # 向上（更高level的logger）传递
        },
    },
}

# 以上字典中可能需要修改的地方
# 1.日志文件的路径
# 2.格式
# 3.生成器的名字


配置方法

import logging.config
logging.config.dictConfig(LOGGING_DIC)
logging.getLogger("aa").debug("测试")
# getLogger参数就是对应字典中loggers的key 如果没有匹配的key 什么都不做 很多情况我们的日志可能对应不同的业务模块 我们需要在日志中提现业务信息 那问题是 我的配置中不可能预先知道所有的业务名称 这时候我们可以将key设置为空 这样一样来 获取的时候如果找不到对应的就是用默认的 并且日志对象的名称会变成你传入的key