参考:https://docs.python.org/2/library/logging.html
Logging模块介绍
- 模块:logging
- 类:
- Loggers:暴露直接给用户使用的接口
- Handler:可以指定日志的输出源(文件/console等)
- Filters:可以用于指定哪些日志可以输出
- Formatters:指定日志的格式
我们通过下面的场景和源码来理解Loggers/Handler/Formatters的作用和区别
场景一:输出单一文件日志
logging.basicConfig(level=logging.INFO,
format='%(asctime)s > %(message)s',
datefmt='%Y/%m/%d %H:%M:%S',
filename='testlog.log',
filemode='w')
# 输出日志
logging.info("test")
直接使用logging.info()通过root logger输出,且通过logging.basciConfig()可以指定root logger()的参数
场景二:输出单一文件日志和控制台日志
def __init_root_file_log():
logging.basicConfig(level=logging.INFO,
format='%(asctime)s > %(message)s',
datefmt='%Y/%m/%d %H:%M:%S',
filename='ui-test.log',
filemode='w')
return
def __init_console_log():
console = logging.StreamHandler()
console.setLevel(logging.INFO)
formatter = logging.Formatter('%(name)-12s: %(levelname)-8s %(message)s')
console.setFormatter(formatter)
logging.getLogger('').addHandler(console)
return
__init_root_file_log()
__init_console_log()
这里相比上一个场景,多了需要将日志输出到控制台,python是通过向logger对象添加一个handler对象(StreamHandler对象)实现的:
logger.getLogger('')获取root logger对象,然后addHandler(console)
场景三:输出多个文件日志(附带控制台日志)
例如:相比场景二,我需要添加一个process_monitor.log,用来专门写进程监控日志
loggers = {}
def init_log():
__init_root_file_log()
__init_process_log()
__init_console_log()
def __init_root_file_log():
logging.basicConfig(level=logging.INFO,
format='%(asctime)s > %(message)s',
datefmt='%Y/%m/%d %H:%M:%S',
filename='ui-test.log',
filemode='w')
return
def __init_console_log():
console = logging.StreamHandler()
console.setLevel(logging.INFO)
formatter = logging.Formatter('%(name)-12s: %(levelname)-8s %(message)s')
console.setFormatter(formatter)
logging.getLogger('').addHandler(console)
return
def __init_process_log():
loggerName = "processlog"
logger = logging.getLogger(loggerName)
fh = logging.FileHandler("process_monitor.log")
formatter = logging.Formatter("%(asctime)s > %(message)s")
fh.setFormatter(formatter)
logger.setLevel(logging.INFO)
logger.addHandler(fh)
loggers[loggerName] = logger
使用process_monitor.log输出日志的调用方式如下:
# 在整个应用开始时调用,初始化所有的logger对象
init_log()
# 输出日志
loggers['processlog'].info("process test")
效果如下:
- 控制台
- root logger:
- process_monitor.log:
�相比场景二的代码,�多了__init_process_log()方法,它的处理如下:
1.logging.getLogger()获取了一个logger对象,这里参数可以是任意字符串
2.向logger对象添加了format对象和handler对象(FileHandler对象)
3.指定logger对象的日志级别
4.【非必须】将创建的logger对象添加到loggers这个dict对象中,方便日志文件较多的时候对日志对象进行管理
上面的基本可以覆盖大部分的硬盘日志需求,如果涉及网络日志,可以看看Python的各种Handler实现,这里后续如果有具体的业务场景的话,可以再讲讲