python-logging

原文:
https://my.oschina.net/leejun2005/blog/126713
http://www.stamhe.com/?p=862

Python 使用logging模块记录日志涉及四个主要类,使用官方文档中的概括最为合适:

  • logger提供了应用程序可以直接使用的接口;
  • handler将(logger创建的)日志记录发送到合适的目的输出;
  • filter提供了细度设备来决定输出哪条日志记录;
  • formatter决定日志记录的最终输出格式。

模块级函数
logging.getLogger([name]):返回一个logger对象,如果没有指定名字将返回root logger:

  • logging.debug()、logging.info()、logging.warning()、logging.error()、logging.critical():设定root logger的日志级别
  • logging.basicConfig():用默认Formatter为日志系统建立
    *StreamHandler,设置基础配置并加到root logger中

logger:

每个程序在输出信息之前都要获得一个Logger。Logger通常对应了程序的模块名,比如聊天工具的图形界面模块可以这样获得它的Logger:
LOG=logging.getLogger(”chat.gui”)
而核心模块可以这样:
LOG=logging.getLogger(”chat.kernel”)

Logger.setLevel(lel):指定最低的日志级别,低于lel的级别将被忽略。debug是最低的内置级别,critical为最高
Logger.debug()、Logger.info()、Logger.warning()、Logger.error()、Logger.critical():可以设置的日志级别

Handlers:

handler对象负责发送相关的信息到指定目的地。
Python的日志系统有多种Handler可以使用。

  • logging.StreamHandler() 信息输出到控制台
  • logging.FileHandler() 把信息输出到文件
  • logging.handlers.HTTPHandler: 通过"GET"或"POST"远程输出到HTTP服务器
  • logging.handlers.SMTPHandler 远程输出日志到邮件地址

上面的方法返回一个Handler对象

  • addHandler() 可以通过方法添加多个handler.
  • Handler.setLevel(lel):指定被处理的信息级别,低于lel级别的信息将被忽略
  • Handler.setFormatter():给这个handler选择一个格式
  • Handler.addFilter(filt)、Handler.removeFilter(filt):新增或删除一个filter对象

example:

console = logging.StreamHandler()
# 打到屏幕上
console.setLevel(logging.INFO)
# 这个Level不起作用么??
formatter = logging.Formatter('%(name)-12s: %(levelname)-8s %(message)s')
# 日志格式
console.setFormatter(formatter)
# 选定格式
logging.getLogger('').addHandler(console)
# 添加多个Handler

Formatters

Formatter对象设置日志信息最后的规则、结构和内容,默认的时间格式为%Y-%m-%d %H:%M:%S,下面是Formatter常用的一些信息 :

火狐截图_2017-05-19T11-38-20.609Z.png

example:

# !/usr/bin/python
# encoding=utf-8
import logging

logging.basicConfig(level=logging.DEBUG,
            format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s',
            datefmt='%a, %d %b %Y %H:%M:%S',
            filename='myapp.log',
            filemode='w')
# level: logging.DEBUG  最低级别(会打印所有), 默认日志级别为logging.WARNING
# format:  asctime -> 当前时间  
#               filename -> 调用函数的文件名
#               lineno -> 调用日志输出的代码行
#               levelname -> 文本形式的日志级别
#               message -> 用户输出的信息
#               datefmt: 指定时间格式,同time.strftime()
# stream: 指定将日志的输出流,可以指定输出到sys.stderr,sys.stdout或者文件,默认输出到sys.stderr,当stream和       filename同时指定时,stream被忽略
# filename: 指定日志文件名
# filemode: 和file函数意义相同,指定日志文件的打开模式,’w’或’a’

logging.debug('This is debug message')
logging.info('This is info message')
logging.warning('This is warning message')

longging日志回滚

import logging
from logging.handlers import RotatingFileHandler
 
#################################################################################################
#定义一个RotatingFileHandler,最多备份5个日志文件,每个日志文件最大10M
Rthandler = RotatingFileHandler('myapp.log', maxBytes=10*1024*1024,backupCount=5)
Rthandler.setLevel(logging.INFO)
formatter = logging.Formatter('%(name)-12s: %(levelname)-8s %(message)s')
Rthandler.setFormatter(formatter)
logging.getLogger('').addHandler(Rthandler)
################################################################################################

从上例和本例可以看出,logging有一个日志处理的主对象,其它处理方式都是通过addHandler添加进去的。
logging的几种handle方式如下:

logging.StreamHandler: 日志输出到流,可以是sys.stderr、sys.stdout或者文件
logging.FileHandler: 日志输出到文件
 
日志回滚方式,实际使用时用RotatingFileHandler和TimedRotatingFileHandler
logging.handlers.BaseRotatingHandler
logging.handlers.RotatingFileHandler
logging.handlers.TimedRotatingFileHandler
 
logging.handlers.SocketHandler: 远程输出日志到TCP/IP sockets
logging.handlers.DatagramHandler:  远程输出日志到UDP sockets
logging.handlers.SMTPHandler:  远程输出日志到邮件地址
logging.handlers.SysLogHandler: 日志输出到syslog
logging.handlers.NTEventLogHandler: 远程输出日志到Windows NT/2000/XP的事件日志
logging.handlers.MemoryHandler: 日志输出到内存中的制定buffer
logging.handlers.HTTPHandler: 通过"GET"或"POST"远程输出到HTTP服务器


logging.config.fileConfig

上面的例子是将日志打印配置写在代码里的,实际上我们用的时候更多是将其写在单独的一个配置文件里,方便修改:

#logger.conf
 
###############################################
 
[loggers]
keys=root,example01,example02
 
[logger_root]
level=DEBUG
handlers=hand01,hand02
 
[logger_example01]
handlers=hand02
qualname=example01
propagate=0
 
[logger_example02]
handlers=hand01,hand03
qualname=example02
propagate=0
 
###############################################
 
[handlers]
keys=hand01,hand02,hand03
 
[handler_hand01]
class=StreamHandler
level=INFO
formatter=form02
args=(sys.stderr,)
 
[handler_hand02]
class=FileHandler
level=DEBUG
formatter=form01
args=('myapp.log', 'a')
 
[handler_hand03]
class=handlers.RotatingFileHandler
level=INFO
formatter=form02
args=('myapp.log', 'a', 10*1024*1024, 5)
 
###############################################
 
[formatters]
keys=form01,form02
 
[formatter_form01]
format=%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s
datefmt=%a, %d %b %Y %H:%M:%S
 
[formatter_form02]
format=%(name)-12s:%(asctime)s: %(levelname)-8s %(message)s
datefmt=%a, %d %b %Y %H:%M:%S

[formatter_form03]
format=%(name)-12s: %(levelname)-8s %(message)s
datefmt=

配置中
args=(sys.stderr) 屏幕打印
hand03中的RotatingFileHandler 当file满了10M时,会将log文件myapp.log 备份, 重新命名为myapp.log.1, 以此类推。
而FileHandler默认值保存一个文件, 不限大小

代码中调用日志配置文件:

logging.config.fileConfig("logging.conf")
# 读取配置文件
logger = logging.getLogger("example01")
# 返回一个logger对象,如果没有指定名字将返回root logger
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,711评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,932评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,770评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,799评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,697评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,069评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,535评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,200评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,353评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,290评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,331评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,020评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,610评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,694评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,927评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,330评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,904评论 2 341

推荐阅读更多精彩内容