1. 等级
| 日志等级(level) |
描述 |
| DEBUG |
最详细的日志信息,典型应用场景是 问题诊断 |
| INFO |
信息详细程度仅次于DEBUG,通常只记录关键节点信息,用于确认一切都是按照我们预期的那样进行工作 |
| WARNING |
当某些不期望的事情发生时记录的信息(如,磁盘可用空间较低),但是此时应用程序还是正常运行的 |
| ERROR |
由于一个更严重的问题导致某些功能不能正常运行时记录的信息 |
| CRITICAL |
当发生严重错误,导致应用程序不能继续运行时记录的信息 |
- 日志等级是从上到下依次升高的,即:
DEBUG < INFO < WARNING < ERROR < CRITICAL,而日志的信息量是依次减少的
- 当指定日志级别后,应用程序会记录所有日志级别大于或等于指定日志级别的日志信息
2. 记录格式
- 事件发生时间
- 事件发生位置
- 事件的严重程度--日志级别
- 事件内容
3. 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进行一次性配置 |
I. logging.basicConfig()函数说明
该方法用于为logging日志系统做一些基本配置
logging.basicConfig(**kwargs)
-
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异常。 |
II. logging模块定义的格式字符串字段
| 字段/属性名称 |
使用格式 |
描述 |
| 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 |
线程名称 |
4. 使用示例
def __init__(self, filename):
self.filename = filename
self.log_filename = 'logs/' + self.filename
logging.basicConfig(filename=self.log_filename + '.txt', filemode='a+',
level=logging.DEBUG, format="%(asctime)s - %(levelname)s - %(message)s "
, datefmt="%m/%d/%Y %H:%M:%S %p")
logging.info("FILENAME:%s " % self.filename)
logging.info("*********************************************")