python3 logging

https://docs.python.org/3.5/library/logging.html，先3.5是由于我当前的python 版本是3.5

之因此要来详细的写是由于以前学django时也有这个，不是很理解，因此这里就多了解下。

写到后面发现整个文章一点条理都没有，但因为内容比较多，就不从新整理了

logging框架中主要由四个部分组成：

    Loggers expose the interface that application code directly uses.
    Handlers send the log records (created by loggers) to the appropriate destination.
    Filters provide a finer grained facility for determining which log records to output.
    Formatters specify the layout of log records in the final output.

 

• Loggers: 提供应用直接调用的接口
• Handlers: 决定将日志记录发送至正确的目的地
• Filters: 提供更精细的决定哪些日志输出的能力，简单点说就是决定哪些输出哪些不输出
• Formatters: 制定最终输出的格式。

logger对象

事实上logger是不直接实例化的，可是咱们能够经过模块级别的函数logging.getLogger(name)来调用。若是屡次经过同一个名字调用getLogger()将只能获得对同一个对象的引用。

注意： logging.getLogger(name) 中的name是一个支持经过“.”（点号）分层级的值。

例如： 你定义一个logger: foo,那么foo.bar, foo.baz,就都算做它的子代，就是继承，有父子关系。

logger名字的层级与python中包的层级是一致的。因此为了区分它，若是你基于模块来组织logger,

那么建议你使用：logging.getLogger(__name__)这种形式，由于对于模块而言，在python

包的命名空间中__name__的值就是模块的名字。

 

经常使用方法：

Logger.setLevel(lvl)：

将logger的门限设置为lvl,低于此等级的信息将被忽略，当一个Logger被创造出来时，它的等级被设置为：

NOTSET(未设置) 这样的结果就是： 若是它是一个root logger,它将处理全部的信息，若是没有root logger

它将继承父级的logger等级。Note: root logger可经过level waring来建立,注意这里是个坑，

事实上默认root logger等级为warning，不要搞错了

 

 级别设定：前面是名字，后面是对应的数字值

 

Logger.exception(msg, *args, **kwargs)

以error级别来记录信息，异常信息也会被添加到信息（message）,须要exception handler调用才行

Logger.addFilter(filt)

添加指定的过滤器

Logger.removeFilter(filt)

移除指定的过滤器

这里的方法多得让人想撞死在屏幕上，之后慢慢更新吧。

Handler

• Handler.setLevel(lel):指定被处理的信息级别，低于lel级别的信息将被忽略
• Handler.setFormatter()：给这个handler选择一个格式
• Handler.addFilter(filt)、Handler.removeFilter(filt)：新增或删除一个filter对象

handler有多达15种，这里只说下常见的几种：

1.logging.StreamHandler 

发送信息到流，类文件对象便可，如终端，文件等

2.logging.FileHandler

发送信息到硬盘文件

3.logging.RotatingFileHandler
这个Handler相似于上面的FileHandler，可是它能够管理文件大小，轮询日志文件（不知道是否是检测日志文件大小）。

当文件达到必定大小以后，它会自动将当前日志文件更名，而后建立一个新的同名日志文件继续输出。

4.logging.handlers.TimedRotatingFileHandler

这个Handler和RotatingFileHandler相似,不过,它没有经过判断文件大小来决定什么时候从新建立日志文件，

而是间隔必定时间就 自动建立新的日志文件。

Formatter

Formatters 决定了记录格式。Formatter会将传递来的信息拼接成一条具体的字符串，

默认状况下Format只会将信息%(message)s直接打印出来。Format中有一些自带的LogRecord属性可使用，以下表格:

其中lineno,pathname，通过实测了，并非有些博客里说的什么当前日志记录的行号。后面会有实例。

这里有一个简单的应用 的例子，记录出错信息：

#!/usr/bin/env python
#coding:utf-8
# Created by Andy @ 2017/6/22


import logging


logging.basicConfig(level=logging.DEBUG,
        format='%(asctime)s %(pathname)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s ',
        datefmt='%a, %d %b %Y %H:%M:%S',
        filename=r'D:\Coding\oldboy\day13 module\test.log',
        filemode='w')


def login():
	while True:
		try:
			name = input('Input user name:')
			password = int(input('Input password:')) # 这里故意转成整型，触发异常
			if name == 'andy' and password == 'nopasswd':
				print('logging succeed!')
		except ValueError as e:
			logging.debug(e)
			break

if __name__ == '__main__':
	login()

 

 终端验证

Input user name:andy
Input password:nopasswd

Process finished with exit code 0

 打开test.log:

Fri, 23 Jun 2017 09:56:40 D:/Coding/oldboy/day13 module/log.py log.py[line:24] DEBUG invalid literal for int() with base 10: 'nopasswd' 

 注意看，lineno 并非在日志里面的行号，而是你代码的行号，在24行调用了logging.debug(e)

 这里现定义一个一simple_logger:

#!/usr/bin/env python
#coding:utf-8
# Created by Andy @ 2017/6/22


import logging
import os

log_path = os.path.join(os.getcwd(),'test.log')

logging.basicConfig(level=logging.DEBUG,
        format='%(asctime)s %(pathname)s line:%(lineno)d %(message)s ',
        datefmt='%Y-%m-%d %H:%M:%S', # 将日期格式化成正常模式
        filename=log_path,
        filemode='a') # 指定成追加模式,默认就是追加，因此这句非必须

simple_logger = logging.getLogger('simple')
fh = logging.StreamHandler() #输出到终端
fh.setLevel(level = logging.WARNING) #等级比默认的高，但调用时必须一致
formatter = logging.Formatter("%(asctime)s %(message)s %(levelname)s")
fh.setFormatter(formatter)
simple_logger.addHandler(fh)


def login():
	while True:
		try:
			name = input('Input user name:')
			password = int(input('Input password:')) # 这里故意转成整型，触发异常
			if name == 'andy' and password == 'nopasswd':
				print('logging succeed!')
		except ValueError as e:
			simple_logger.warning(e)
			break

if __name__ == '__main__':
	login()

 

 运行：

终端输出：

Input user name:andy
Input password:andy
2017-06-24 09:55:57,395 invalid literal for int() with base 10: 'andy' WARNING

 test.log文件：

2017-06-24 09:55:57 D:/Coding/oldboy/day13 module/log.py line:33 invalid literal for int() with base 10: 'andy' 

 这晨须要 注意的是：由于默认的logger等级是debug,因此它什么消息都会输出，而simple_logger则只输出比自身高等级的信息，

而且：调用simple_logger时必须比定义的等级高于或者等于定义的等级，这句话什么意思呢？看上面的例子，simple_logger

定义时的等级为warning,那么你调用时最少得warning等级，或者比它高的critical才能正常打印消息（它规定就是这样），不然你是看不到任何效果的

（这里坑了很久，一直没消息打印而找不到缘由，root logger默认等级是warning,而非Noset），可是若是你调用的等级比较低，

并不影响root 这个logger打印日志信息。

填坑来了：

若是没指定默认的logger的等级，那么默认的等级warning就会生效，因此才出现上面的状况，若是须要将debug等级的信息也输入，那么，这里须要加一条：

simple_logger.setLevel(logging.DEBUG)
# 若是不设置此logger的级别，那么handler的记录是从logger传过来的，也就是默认从logger的warning来的

 

 

 

 

下面是一个使用配置文件 的例子：

#!/usr/bin/env python
#coding:utf-8
# Created by Andy @ 2017/6/25


import logging
import logging.config

logging.config.fileConfig('logging.conf')

# create logger
logger = logging.getLogger('simpleExample')

# 'application' code
logger.debug('debug message')
logger.info('info message')
logger.warn('warn message')
logger.error('error message')
logger.critical('critical message')

 

 

 配置文件：

[loggers]
keys=root,simpleExample

[handlers]
keys=consoleHandler,simpleHandler

[formatters]
keys=consoleFormatter,simpleFormatter

[logger_root]
level=DEBUG
handlers=consoleHandler

[logger_simpleExample]
level=INFO
handlers=simpleHandler
qualname=simpleExample
propagate=1

[handler_consoleHandler]
class=StreamHandler
level=DEBUG
formatter=consoleFormatter
args=(sys.stdout,)

[handler_simpleHandler]
class=FileHandler
level=INFO
formatter=simpleFormatter
args=('simple.log','w')


[formatter_consoleFormatter]
format=%(levelname)s :%(message)s

[formatter_simpleFormatter]
format=%(asctime)s - %(name)s - %(levelname)s - %(message)s
datefmt=

 以前的例子没已经删除了，找到缘由：propagate=1 ，只有当propagate 为True时，logger的信息才能传到上一级logger，或者说父logger,若是你设置为0

那么，就只有文件中有写入，而终端不会有信息打印出来。