#============================LOG日志==========================
#参见:
#============================相关概念==========================
# 日志的级别（level）
# DEBUG
# INFO
# NOTICE
# WARNING
# ERROR
# CRITICAL
# ALERT
# EMERGENCY
# 注意：不要频繁IO操作
# LOG的作用：调试、了解软件的运行情况、分析定位问题
# 日志信息：time、地点、level、内容
# 成熟的第三方日志：log4j、log4php、logging
#==========================Logging模块========================
# 日志级别
# 级别可自定义
# DEBUG
# INFO
# WARNING
# ERROR
# CRITICAL
# 初始化/写日志实例需要指定级别， 只有当级别等于或高于指定级别才被记录
# 使用方式
# 直接使用logging(封装了其他组件)
# logging四大组件直接定制
## logging模块级别的日志调用
import logging
logging.debug(msg, *args, **kwargs) #创建一条严重级别为DEBUG的日志记录
logging.info(msg, *args, **kwargs) #创建一条严重级别为INFO的日志记录
logging.warning(msg, *args, **kwargs) #创建一条严重级别为WARNING的日志记录
logging.error(msg, *args, **kwargs) #创建一条严重级别为ERROR的日志记录
logging.critical(msg, *args, **kwargs) #创建一条严重级别为CRITICAL的日志记录
logging.log(level, *args, **kwargs) #创建一条严重级别为level的日志记录# basicConfig对root logger进行一次性配置
# 只在第一次调用的时候起作用
# 不配置logger则使用默认值
# 输出： sys.stderr
# 级别： WARNING
# 格式： level:log_name:content
logging.basicConfig(**kwargs)
LOG_FORMAT = "时间:%(asctime)s,级别:%(levelname)s,信息：%(message)s"
logging.basicConfig(filename="../a.log", level=logging.DEBUG, format=LOG_FORMAT)# format参数:
# asctime %(asctime)s 日志事件发生的时间--人类可读时间，如：2003-07-08 16:49:45,896
# created %(created)f 日志事件发生的时间--时间戳，就是当时调用time.time()函数返回的值
# relativeCreated %(relativeCreated)d 日志事件发生的时间相对于logging模块加载时间的相对毫秒数（目前还不知道干嘛用的）
# msecs %(msecs)d 日志事件发生事件的毫秒部分
# levelname %(levelname)s 该日志记录的文字形式的日志级别（'DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'）
# levelno %(levelno)s 该日志记录的数字形式的日志级别（10, 20, 30, 40, 50）
# name %(name)s 所使用的日志器名称，默认是'root'，因为默认使用的是 rootLogger
# message %(message)s 日志记录的文本内容，通过 msg % args计算得到的
# pathname %(pathname)s 调用日志记录函数的源码文件的全路径
# filename %(filename)s pathname的文件名部分，包含文件后缀
# module %(module)s filename的名称部分，不包含后缀
# lineno %(lineno)d 调用日志记录函数的源代码所在的行号
# funcName %(funcName)s 调用日志记录函数的函数名
# process %(process)d 进程ID
# processName %(processName)s 进程名称，Python 3.1新增
# thread %(thread)d 线程ID
# threadName %(thread)s 线程名称
## logging模块的处理流程
# 四大组件
# 日志器(Logger): 产生日志的一个接口
# 处理器(Handler):把产生的日志发送到相应的目的地
# 过滤器(Filter): 更精细的控制哪些日志输出
# 格式器(Formatter): 对输出信息进行格式化
# Logger
# 实例化logger对象
logger = logging.getLogger("myLogger")
logger.setLevel() #设置日志器将会处理的日志消息的最低严重级别
logger.addHandler() #为该logger对象添加一个handler对象
logger.removeHandler() #为该logger对象添加移除一个handler对象
logger.addFilter() ##为该logger对象添加一个filter对象
logger.removeFilter() #为该logger对象移除一个filter对象
logger.debug #产生一条debug级别的日志，同理，info，error，等
logger.exception() #创建类似于Logger.error的日志消息
logger.log() #获取一个明确的日志level参数类创建一个日志记录#- Handler
# - 不需要实例化直接使用，Handler是基类
handler = logging.StreamHandler #将日志消息发送到输出到Stream，如std.out, std.err或任何file-like对象。
handler = logging.FileHandler #将日志消息发送到磁盘文件，默认情况下文件大小会无限增长
handler = logging.handlers.RotatingFileHandler #将日志消息发送到磁盘文件，并支持日志文件按大小切割
handler = logging.hanlders.TimedRotatingFileHandler #将日志消息发送到磁盘文件，并支持日志文件按时间切割
handler = logging.handlers.HTTPHandler #将日志消息以GET或POST的方式发送给一个HTTP服务器
handler = logging.handlers.SMTPHandler #将日志消息发送给一个指定的email地址
handler = logging.NullHandler #该Handler实例会忽略error messages，通常被想使用logging的library开发者使用来避免'No handlers could be found for logger XXX'信息的出现。
# 方法：
handler.setLevel() #设置handler将会处理的日志消息的最低严重级别
handler.setFormatter() #为handler设置一个格式器对象
handler.addFilter() #为handler添加一个过滤器对象
handler.removeFilter() #为handler删除一个过滤器对象
#- Filter类
# 可以被Handler和Logger使用
# 控制传递过来的信息的具体内容
logging.Filter(name='')
#- Format类
# 直接实例化
# 可以继承Format添加特殊内容
# 三个参数
# fmt：指定消息格式化字符串，如果不指定该参数则默认使用message的原始值
# datefmt：指定日期格式字符串，如果不指定该参数则默认使用"%Y-%m-%d %H:%M:%S"
# style：Python 3.2新增的参数，可取值为 '%', '{'和 '$'，如果不指定该参数则默认使用'%'
logging.Formatter(fmt=None, datefmt=None, style='%')
'''
1. 需求
现在有以下几个日志记录的需求：
1）要求将所有级别的所有日志都写入磁盘文件中
2）all.log文件中记录所有的日志信息，日志格式为：日期和时间 - 日志级别 - 日志信息
3）error.log文件中单独记录error及以上级别的日志信息，日志格式为：日期和时间 - 日志级别 - 文件名[:行号] - 日志信息
4）要求all.log在每天凌晨进行日志切割
2. 分析
1）要记录所有级别的日志，因此日志器的有效level需要设置为最低级别--DEBUG;
2）日志需要被发送到两个不同的目的地，因此需要为日志器设置两个handler；另外，两个目的地都是磁盘文件，因此这两个handler都是与FileHandler相关的；
3）all.log要求按照时间进行日志切割，因此他需要用logging.handlers.TimedRotatingFileHandler; 而error.log没有要求日志切割，因此可以使用FileHandler;
4）两个日志文件的格式不同，因此需要对这两个handler分别设置格式器；
'''
import logging
import logging.handlers
import datetime
# 定义logger
logger = logging.getLogger('mylogger')
logger.setLevel(logging.DEBUG)
#为两个不同的文件设置不同的handler
all_handler = logging.handlers.TimedRotatingFileHandler('all.log', when='midnight', interval=1, backupCount=7, atTime=datetime.time(0, 0, 0, 0))
all_handler.setFormatter(logging.Formatter("%(asctime)s - %(levelname)s - %(message)s"))
err_handler = logging.FileHandler('error.log')
err_handler.setLevel(logging.ERROR)
err_handler.setFormatter(logging.Formatter("%(asctime)s - %(levelname)s - %(filename)s[:%(lineno)d] - %(message)s"))
# 把相应的处理器组装到logger上
logger.addHandler(all_handler)
logger.addHandler(err_handler)
logger.debug('debug message')
logger.info('info message')
logger.warning('warning message')
logger.error('error message')
logger.critical('critical message')
