logging模块

时间 2019-12-20

标签 logging 模块栏目 Log4j 繁體版

原文原文链接

"""
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：数字形式的日志级别spa

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

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

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

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

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

%(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