log
- 以下是 log() 方法的语法:
- import math
- math.log(x[, base])
- 参数
- x -- 数值表达式。
- base -- 可选,底数,默认为 e。
- 返回值
- 返回 x 的自然对数,x>0。
- logging
- 提供模块级别的函数纪录日志
- 包括四大组件
日志相关概念
- 日志
-
日志的级别(level)
-
不同用户关注不同的程序信息
级别 何时使用 DEBUG 详细信息,典型地调试问题时会感兴趣。 详细的debug信息。 INFO 证明事情按预期工作。 关键事件。 WARNING 表明发生了一些意外,或者不久的将来会发生问题(如‘磁盘满了’)。软件还是在正常工作。 ERROR 由于更严重的问题,软件已不能执行一些功能了。 一般错误消息。 CRITICAL 严重错误,表明软件已不能继续运行了。 NOTICE 不是错误,但是可能需要处理。普通但是重要的事件。 ALERT 需要立即修复,例如系统数据库损坏。 EMERGENCY 紧急情况,系统不可用(例如系统崩溃),一般会通知所有用户。
-
- IO操作-->不要频繁操作
- LOG的作用
- 调试
- 了解软件的运行情况
- 分析定位问题
- 日志信息
- time
- 地点
- level
- 内容
- 成熟的第三方日志
- log4j
- log4php
- logging
logging模块
- 日志级别
- 级别自定义
- DEBUG
- INFO
- NOTICE
- WARNING
- ERROR
- CRITICAL
- 初始化/写日志实例时需要指定级别,只有当级别等于或高于指定级别才被记录
- 使用方式
- 直接使用logging(封装了其他组件)
- logging四大组件直接定制
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的日志记录 logging.basicConfig(**kwargs) 对root logger进行一次性配置 - 其中logging.basicConfig(**kwargs)函数用于指定“要记录的日志级别”、“日志格式”、“日志输出位置”、“日志文件的打开模式”等信息,其他几个都是用于记录各个级别日志的函数。
- logging.basicConfig(**kwargs) 对root logger进行一次性配置
- 只在第一次调用时起作用
- logging.basicConfig()函数包含参数说明
参数名称 描述 filename 指定日志输出目标文件的文件名(可以写文件名也可以写文件的完整的绝对路径,写文件名日志放执行文件目录下,写完整路径按照完整路径生成日志文件),指定该设置项后日志信心就不会被输出到控制台了 filemode 指定日志文件的打开模式,默认为'a'。需要注意的是,该选项要在filename指定时才有效 format 指定日志格式字符串,即指定日志输出时所包含的字段信息以及它们的顺序。logging模块定义的格式字段下面会列出。 datefmt 指定日期/时间格式。需要注意的是,该选项要在format中包含时间字段%(asctime)s时才有效 level 指定日志器的日志级别 stream 指定日志输出目标stream,如sys.stdout、sys.stderr以及网络stream。需要说明的是,stream和filename不能同时提供,否则会引发 ValueError异常 style Python 3.2中新添加的配置项。指定format格式字符串的风格,可取值为'%'、'{'和'$',默认为'%' handlers Python 3.3中新添加的配置项。该选项如果被指定,它应该是一个创建了多个Handler的可迭代对象,这些handler将会被添加到root logger。需要说明的是:filename、stream和handlers这三个配置项只能有一个存在,不能同时出现2个或3个,否则会引发ValueError异常。
- logging模块中定义好的可以用于format格式字符串说明
字段/属性名称 使用格式 描述 asctime %(asctime)s 将日志的时间构造成可读的形式,默认情况下是‘2016-02-08 12:00:00,123’精确到毫秒 name %(name)s 所使用的日志器名称,默认是'root',因为默认使用的是 rootLogger filename %(filename)s 调用日志输出函数的模块的文件名; pathname的文件名部分,包含文件后缀 funcName %(funcName)s 由哪个function发出的log, 调用日志输出函数的函数名 levelname %(levelname)s 日志的最终等级(被filter修改后的) message %(message)s 日志信息, 日志记录的文本内容 lineno %(lineno)d 当前日志的行号, 调用日志输出函数的语句所在的代码行 levelno %(levelno)s 该日志记录的数字形式的日志级别(10, 20, 30, 40, 50) pathname %(pathname)s 完整路径 ,调用日志输出函数的模块的完整路径名,可能没有 process %(process)s 当前进程, 进程ID。可能没有 processName %(processName)s 进程名称,Python 3.1新增 thread %(thread)s 当前线程, 线程ID。可能没有 threadName %(thread)s 线程名称 module %(module)s 调用日志输出函数的模块名, filename的名称部分,不包含后缀即不包含文件后缀的文件名 created %(created)f 当前时间,用UNIX标准的表示时间的浮点数表示; 日志事件发生的时间--时间戳,就是当时调用time.time()函数返回的值 relativeCreated %(relativeCreated)d 输出日志信息时的,自Logger创建以 来的毫秒数; 日志事件发生的时间相对于logging模块加载时间的相对毫秒数 msecs %(msecs)d 日志事件发生事件的毫秒部分。logging.basicConfig()中用了参数datefmt,将会去掉asctime中产生的毫秒部分,可以用这个加上
- 不配用logger则使用默认值
- 输出:sys.stderr
- 级别:WARNING
- 格式:lever:log_name:content
- logging.basicConfig(**kwargs) 对root logger进行一次性配置
In [20]:
import logging
logging.debug("this is a debug log")
logging.info("this is a info log")
logging.warning("this is a warning log")
logging.error("this is a error log")
logging.critical("this is a critical log")
#另一种写法
logging.log(logging.DEBUG,"this is a debug log")
logging.log(logging.INFO,"this is a info log")
logging.log(logging.WARNING,"this is a warning log")
logging.log(logging.ERROR,"this is a error log")
logging.log(logging.CRITICAL,"this is a critical log")
#当不用logging.basicConfig指定级别时默认低于warning级别的不显示输出
WARNING:root:this is a warning log ERROR:root:this is a error log CRITICAL:root:this is a critical log WARNING:root:this is a warning log ERROR:root:this is a error log CRITICAL:root:this is a critical log
logging模块的处理流程
- 四大组件
- 日志器(logger):产生日志的一个接口
- 处理器(Handler):把产生的日志发送到相应的目的地
- 过滤器(Filter):更精细的控制那些日志的输出
- 格式器(Formatter):对输出的信息进行格式化
- logger
- 产生一个日志
- 操作
logger.setLevel(logging.ERROR) # 设置日志级别为ERROR,即只有日志级别大于等于ERROR的日志才会输出 logger.addHandler(handler_name) # 为Logger实例增加一个处理器 logger.removeHandler(handler_name) # 为Logger实例删除一个处理器 logger.addFilter()和logger.removeFilter()# 为Logger添加或者移除一个Filter logger.debug()#产生一条debug级别的日志,同理info,error等 logger.exception()#创建类似于logger.error的日志消息 logger.log()#获取一个明确的日志level参数类创建一个日志记录
- 如何得到一个logger对象
- 实例化
- logging.getLogger()
-
Handler
- 把log发送到指定位置
- 方法
- setLevel
- setFormat
- addFilter,removeFilter
- 不需要直接使用,Handler是基类
-
下面是一些常用的Handler:
Handler 描述 logging.StreamHandler 将日志消息发送到输出到Stream,如std.out, std.err或任何file-like对象。 logging.FileHandler 将日志消息发送到磁盘文件,默认情况下文件大小会无限增长 logging.handlers.RotatingFileHandler 将日志消息发送到磁盘文件,并支持日志文件按大小切割 logging.hanlders.TimedRotatingFileHandler 将日志消息发送到磁盘文件,并支持日志文件按时间切割 logging.handlers.HTTPHandler 将日志消息以GET或POST的方式发送给一个HTTP服务器 logging.handlers.SMTPHandler 将日志消息发送给一个指定的email地址 logging.NullHandler 该Handler实例会忽略error messages,通常被想使用logging的library开发者使用来避免’No handlers could be found for logger XXX’信息的出现。
- Format
- 直接实例化使用
- 可以继承Format添加特殊内容
- 三个参数
fmt:指定消息格式化字符串,如果不指定该参数则默认使用message的原始值 datefmt:指定日期格式字符串,如果不指定该参数则默认使用”%Y-%m-%d %H:%M:%S” style:Python 3.2新增的参数,可取值为 ‘%’, ‘{‘和 ‘$’,如果不指定该参数则默认使用’%’
- Filter
- 可以被Handler和Logger使用
- 控制传递过来的信息的具体内容