[Python系列]Python日志模块详解

参考：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实现，这里后续如果有具体的业务场景的话，可以再讲讲