一、为什么使用日志 logging

通过记录日志，可以了解系统、程序的运行情况；某些情况下，日志还可以记录用户的操作行为、类型爱好等可以用来分析。日志可以在程序发现问题后让开发人员或运维人员快速定位问题所在。总而言是，日志在开发调试、定位故障、了解程序运行情况等方面发挥重要作用。

二、日志输出形式

1. 输出到控制台，适合开发阶段

import logging

logging.info('it is start !')
logging.warning('it is run ?')

运行以上程序你只会看到
WARNING:root:it is run ?
这是因为 python 默认的输出日志等级为 WARNING, 而 INFO的等级低于WARNING，被过滤不进行输出。

2. 写入磁盘文件，适合生产阶段

import logging

logging.basicConfig(filename='example.log',level=logging.DEBUG)
logging.debug('this is debug ')
logging.info('this is info')
logging.warning('this is warning')

由于设置了level=logging.DEBUG，所以三条日志消息都会写入日志文件中，filename='example.log'定义了日志文件位置，这里使用了相对路径。

三、什么时候使用日志

print 比较适合命令行测试或者一下代码片段，而当你准备开发一个程序或者完整的项目的时候就应该使用日志。

四、日志等级

日志功能应以所追踪事件级别或严重性而定。各级别适用性如下（以严重性递增）：

默认的级别是WARNING，意味着只会追踪该级别及以上的事件，除非更改日志配置。

五、对日志进行设置 basicConfig()

使用logging.basicConfig(**kwargs)可以对日志进行设置，如上设置日志的输出模式、日志记录等级。有以下可选参数：

详解
1）filename，如果指定 filename ，则认为是将日志输出到磁盘文件（还可以使用 stream 将日志输入到流，使用流处理，这里不介绍 流处理 相关内容；两者不兼容，一个日志处理器只能采用一种模式）

2）filemod，指定 open 打开文件的读写模式。一般使用默认的追加模式filemod = 'a'，这时候对程序运行3次，则日志会累计3次（输出到指定文件中）；如果使用filemod = 'w'，则打开日志发现只记录了一次，这是因为后续的日志会覆盖前面的日志。

3）format，格式日志字符串

# test.py
import logging

logging.basicConfig(level=logging.DEBUG,
    format = '%(asctime)s - %(levelname)s - %(message)s - %(lineno)d'
)
logging.info('ok !')

你将会看到打印以下内容

>>>2019-08-05 10:22:40,817 - INFO - ok ! - 6

其中 2019-08-05 10:22:40,817 是我们设置的 %(asctime)s，也就是格式化时间
INFO 是 %(levelname)s，日志等级
ok ! 是 %(message)s，logging 输出信息
6 是%(lineno)d ， 日志输出所在行。
-是我们自己设置的分割符，可以根据自己的习惯设定，例如

format = '[%(asctime)s] [%(filename)s]  [%(message)s]  [%(lineno)d]'

这里介绍一些常用的格式化选项，更多可以看 python 日志模块

4）datefmt
datefmt 是作为%(asctime)s的补充，在 format 设置格式化时间后，可以进行更精准的格式输出，更多可以参考 time.strftime

# test.py
import logging

def main():
    logging.basicConfig(level=logging.DEBUG,
                        format='[%(asctime)s]  [%(funcName)s]  [%(message)s]  [%(lineno)d]',
                        datefmt='%Y/%m/%d %I:%M:%S')
    logging.info('ok')

if __name__ == '__main__':
    main()

输出如下：

>>>[2019/08/05 11:25:18]  [main]  [ok]  [10]

5）style
格式化字符串的风格，使用默认值即可，无需改动

六、从多个模块记录日志

如果你的程序包含多个模块，你并不需要在每个模块引进 logging 后都设置进行配置，而是在主函数入口设置一次即可。

# mylib.py
import logging

def do_something():
    logging.info('Doing something')

# myapp.py
import logging

# 具体导入时根据你自己模块的路径，我这里是根据我自己的运行环境，最好从模块 根路径 导入，而不要使用相对路径
from learn_test.log.mylib import do_something

def main():
    logging.basicConfig(level=logging.INFO,
        format='[%(asctime)s]  [%(funcName)s]  [%(message)s]  [%(lineno)d]',
        datefmt='%Y/%m/%d %I:%M:%S')

    logging.info('Started')
    do_something()
    logging.info('Finished')

if __name__ == '__main__':
    main()

在程序入口设置的basicConfig，在 mylib.py 的do_something() 函数中也会起作用

七、日志进阶 记录器Logger

未完待续......

参考文件
https://docs.python.org/zh-cn/3.7/howto/logging.html
https://docs.python.org/zh-cn/3.7/library/logging.html