25 python日志模板logging

--------1,日志的级别-------------------
Level    Numeric value
CRITICAL    50
ERROR    40
WARNING    30
INFO    20
DEBUG    10
NOTSET    0

值越小，打印出的日志越多
级别高低顺序：NOTSET < DEBUG < INFO < WARNING < ERROR < CRITICAL
如果把looger的级别设置为INFO， 那么小于INFO级别的日志都不输出， 大于等于INFO级别的日志都输出
-----------------------------
1.基本元素说明：

Logger：用于输出的日志的总对象
Handlers：用来指定log的输出方式
Formatters：设置日志信息的结构和内容格式，默认的时间格式为%Y-%m-%d %H:%M:%S
Filter：过滤器，用来过滤的输出内容（如：只输出debug以上的内容）

------------------------------
2，Logger 常用函数

LOG=logging.getLogger(”chat.gui”)   logging.getLogger([name])
Logger.setLevel(lel)            ##:指定最低的日志级别，低于lel的级别将被忽略。debug是最低的内置级别，critical为最高
Logger.addFilter(filt)、Logger.removeFilter(filt)        ##:添加或删除指定的filter
Logger.addHandler(hdlr)、Logger.removeHandler(hdlr)      ##：增加或删除指定的handler
Logger.debug()、Logger.info()、Logger.warning()、Logger.error()、Logger.critical()       ##：可以设置的日志级别
Logger.log(“debug”,”This is a bug”)                      ##:可以通过这个函数直接输出内容并选择对应的告警级别



3.Handlers 常用函数

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

---########################## 代码举例1 普通简单的##############################################
import logging
##logging.basicConfig(format='%(levelname)s:%(message)s', level=logging.DEBUG)   此名也是可以的
logging.basicConfig(filename="config.log",filemode="w",format="%(asctime)s-%(name)s-%(levelname)s-%(message)s",level=logging.INFO)
logging.debug('This message should appear on the console')
logging.info('This message should appear on the console')


filemode="w" --表示发覆盖的方式写
'a'  --- 表示追加


------############### 代码举例 ########################################################

import logging

# 创建一个logger
logger = logging.getLogger('mylogger')
    ## 返回一个logger实例，如果没有指定name，返回root logger。
    ##只要name相同，返回的logger实例都是同一个而且只有一个，即name和logger实例是一一对应的。
    ##这意味着，无需把logger实例在各个模块中传递。只要知道name，就能得到同一个logger实例。
logger.setLevel(logging.DEBUG)

# 创建一个handler，用于写入日志文件
fh = logging.FileHandler('test.log')
fh.setLevel(logging.DEBUG)

# 再创建一个handler，用于输出到控制台（通过handler对象可以把日志内容写到不同的地方）
#1 StreamHandler: 输出到控制台
#2 FileHandler:   输出到文件
#3 BaseRotatingHandler 可以按时间写入到不同的日志中。比如将日志按天写入不同的日期结尾的文件文件。
#4 SocketHandler 用TCP网络连接写LOG
#5 DatagramHandler 用UDP网络连接写LOG
#6 SMTPHandler 把LOG写成EMAIL邮寄出去
ch = logging.StreamHandler()
ch.setLevel(logging.INFO)

# 定义handler的输出格式 (参数，请参照后面的说明)
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
fh.setFormatter(formatter)
ch.setFormatter(formatter)

# 给logger添加handler
logger.addHandler(fh)
logger.addHandler(ch)

# 记录一条日志
logger.info('foorbar')
logger.debug('foorbar')

---输出说明：
    屏幕显示--由于定义的是INFO级别的日志，则只能打印出，级别高于等于INFO的信息
    文件打印--则可以打印出DEBUG及以上级别的日志



-------------举例 2 -----------------------------
#!/usr/local/bin/python
# coding=utf-8 + BOM

__author__ = 'Huang Yuan Yuan'

import logging

#用字典保存日志级别
format_dict = {
1:logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),
2:logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),
3:logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),
4:logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),
5:logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
}
print('xxx')

class Logger(object):
    def __init__(self, logname, loglevel, logger):
        '''
           指定保存日志的文件路径，日志级别，以及调用文件
           将日志存入到指定的文件中
        '''

    # 创建一个logger
        self.logger=logging.getLogger(logger)
        self.logger.setLevel(logging.DEBUG)

        # 创建一个handler，用于写入日志文件
        fh = logging.FileHandler(logname)
        fh.setLevel(logging.DEBUG)

        # 再创建一个handler，用于输出到控制台
        ch = logging.StreamHandler()
        ch.setLevel(logging.DEBUG)

        # 定义handler的输出格式
        #formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
        formatter = format_dict[int(loglevel)]
        fh.setFormatter(formatter)
        ch.setFormatter(formatter)

        # 给logger添加handler
        self.logger.addHandler(fh)
        self.logger.addHandler(ch)

    def getlog(self):
        return self.logger

p_log= Logger(logname='log.txt', loglevel=1, logger="1.py")
p_log.logger.info('aaaaaa')

---或者使用此方式
logger= Logger(logname='log.txt', loglevel=1, logger="1.py").getlog()
logger.info('cccc')


----------------------------------------------------------



















------######################### 说明  ##############################################
2.Handler种类

logging.StreamHandler
使用这个Handler可以向类似与sys.stdout或者sys.stderr的任何文件对象(file object)输出信息。
它的构造函数是：StreamHandler([strm])
其中strm参数是一个文件对象。
默认是sys.stderr
logging.FileHandler
和StreamHandler类似，用于向一个文件输出日志信息。不过FileHandler会帮你打开这个文件。
它的构造函数是：FileHandler(filename[,mode])
filename是文件名，必须指定一个文件名。
mode是文件的打开方式。
默认是’a’，即添加到文件末尾。
logging.handlers.RotatingFileHandler
这个Handler类似于上面的FileHandler，但是它可以管理文件大小。当文件达到一定大小之后，它会自动将当前日志文件改名，然后创建一个新的同名日志文件继续输出。比如日志文件是chat.log。当chat.log达到指定的大小之后，RotatingFileHandler自动把 文件改名为chat.log.1。不过，如果chat.log.1已经存在，会先把chat.log.1重命名为chat.log.2。。。最后重新创建 chat.log，继续输出日志信息。
它的构造函数是：RotatingFileHandler( filename[, mode[, maxBytes[, backupCount]]])
其中filename和mode两个参数和FileHandler一样。
maxBytes用于指定日志文件的最大文件大小。如果maxBytes为0，意味着日志文件可以无限大，这时上面描述的重命名过程就不会发生。
backupCount用于指定保留的备份文件的个数。比如，如果指定为2，当上面描述的重命名过程发生时，原有的chat.log.2并不会被更名，而是被删除。
logging.handlers.TimedRotatingFileHandler
这个Handler和RotatingFileHandler类似,不过,它没有通过判断文件大小来决定何时重新创建日志文件，而是间隔一定时间就 自动创建新的日志文件。重命名的过程与RotatingFileHandler类似，不过新的文件不是附加数字，而是当前时间。它的构造函数是：
TimedRotatingFileHandler( filename [,when [,interval [,backupCount]]])
其中filename参数和backupCount参数和RotatingFileHandler具有相同的意义。
interval是时间间隔。
when参数是一个字符串。表示时间间隔的单位，不区分大小写。它有以下取值：
S 秒
M 分
H 小时
D 天
W 每星期（interval==0时代表星期一）
midnight 每天凌晨
logging.handlers.SocketHandler
logging.handlers.DatagramHandler
以上两个Handler类似，都是将日志信息发送到网络。不同的是前者使用TCP协议，后者使用UDP协议。它们的构造函数是：
Handler(host, port)
其中host是主机名，port是端口名
logging.handlers.SysLogHandler
logging.handlers.NTEventLogHandler
logging.handlers.SMTPHandler
logging.handlers.MemoryHandler
logging.handlers.HTTPHandler
Formatters

参数    含义
%(name)s    Logger的名字
%(levelno)s    数字形式的日志级别
%(levelname)s    文本形式的日志级别
%(pathname)s    调用日志输出函数的模块的完整路径名，可能没有
%(filename)s    调用日志输出函数的模块的文件名
%(module)s    调用日志输出函数的模块名
%(funcName)s    调用日志输出函数的函数名
%(lineno)d    调用日志输出函数的语句所在的代码行
%(created)f    当前时间，用UNIX标准的表示时间的浮点数表示
%(relativeCreated)d    输出日志信息时的，自Logger创建以 来的毫秒数
%(asctime)s    字符串形式的当前时间。默认格式是 “2003-07-08 16:49:45,896”。逗号后面的是毫秒
%(thread)d    线程ID。可能没有
%(threadName)s    线程名。可能没有
%(process)d    进程ID。可能没有
%(message)s    用户输出的消息

--------------------------------------------------------------
1.python中配置logging有两种 方式：

　　第 一种：基础配置

　　logging.basicConfig(filename="config.log",filemode="w",format="%(asctime)s-%(name)s-%(levelname)s-%(message)s",level=logging.INFO)

　　basicConfig 用来在代码中配置日志
　　filename指定 日志被保存到某个具体的文件
　　filename设置 文件有写的权限
　　format设置记录的属性， 比如时间、等级、信息等
　　level指定记录 日志的等级(level以上)
　　第 二种：使 用配置文件的方式配置logging,使 用下面的函数来读取配置文件

　　fileConfig(filename,defaults=None,disable_existing_loggers=Ture )

　　2.在logging.basicConfig()函数中可通过具体参数来更更改logging模块默认行为，可用参数有:

　　filename： 用指定的文件名创建FiledHandler(后边会具体讲解handler的概念)，这样 日志会被存储在指定的文件中
　　filemode： 文件打开方式，在指定了filename时使 用这个参数，默认值为“a”还可指定为“w”
　　format： 指定handler使 用的 日志显示格式
　　datefmt： 指定 日期时间格式
　　level： 设置rootlogger(后边会讲解具体概念)的日志级别
　　stream： 用指定的stream创建StreamHandler。可以指定输出到sys.stderr,sys.stdout或者文件，默认为sys.stderr若同时列列出了filename和stream两个参数，则stream参数会被忽略。
　　3.format参数中可能用到的格式化：

　　(name)s Logger的名字 %(levelno)s 数字形式的日志级别 %(levelname)s 文本形式的日志级别
　　(pathname)s 调用日志输出函数的模块的完整路路径名，可能没有
　　(filename)s 调用日志输出函数的模块的 文件名
　　(module)s 调用日志输出函数的模块名
　　(funcName)s 调用日志输出函数的函数名
　　(lineno)d 调用日志输出函数的语句句所在的代码行行
　　(created)f 当前时间，用UNIX标准的表示时间的浮点数表示
　　(relativeCreated)d 输出日志信息时的，自Logger创建以 来的毫秒数 %(asctime)s 字符串串形式的当前时间。默认格式是 “2003-07-08 16:49:45,896”。逗号后面的是毫秒 (thread)d 线程ID。可能没有 %(threadName)s 线程名。可能没有 %(process)d 进程ID。可能没有 %(message)s 用户输出的消息