一:为什么使用日志
假如,在项目调试过程中,在某些地方加上了print()函数,输出了一些调试信息。在项目上线的时候,不要将调试信息暴露出去,但是调试信息还要用,该怎么办?项目测试运行在远端服务器上,没有控制台给你显示print输出的调试信息,怎么办?这时候日志的作用就体现出来了,日志就是记录调试和错误信息到文本的一种方式。
二:日志级别
日志为什么要分级别?目的是什么?举个简单的例子。
def test(): myprint("第一级别的信息",2) ret = 2 + 3 myprint(ret,2) info = input("输入信息:") myprint(info,3) def myprint(info,level): """ 通过level控制myprint函数中的信息输出 """ if level > 1: print(info) if __name__ == '__main__': test()
# 假如只想输出input的信息,其他两条信息价值是是无用信息,输出意义不大,怎么办,那么我只需要 把 if level > 1 改为 if level > 2
# 假如所有的信息都想输出,那么将 if level > 1 即可,因此可以通过级别,控制想输出的内容。
自己定义日志配置
'***************** 日志配置 ******************' # 日志文件存放路径 BASE_LOG_DIR = os.path.join(BASE_DIR, "log") # Logging配置 LOGGING = { 'version': 1, # 保留字 'disable_existing_loggers': False, # 是否禁用Django框架开发的时候已经存在的Logger实例 'formatters': { # 格式化器 'standard': { # 标准的格式 'format': '[%(asctime)s][%(threadName)s:%(thread)d][task_id:%(name)s][%(filename)s:%(lineno)d]' '[%(levelname)s][%(message)s]' }, 'simple': { # 简单的格式 'format': '[%(levelname)s][%(asctime)s][%(filename)s:%(lineno)d]%(message)s' }, 'collect': { # 自定义格式,这个名字可以随意起 'format': '%(message)s' } }, 'filters': { # 过滤器 'require_debug_true': { '()': 'django.utils.log.RequireDebugTrue', }, }, 'handlers': { # 处理器 'console': { # 定义一个在终端输出的处理器 'level': 'DEBUG', # 日志级别 'filters': ['require_debug_true'], # 只有在Django debug为True时才在屏幕打印日志 'class': 'logging.StreamHandler', # 日志流 'formatter': 'simple' # 用简单格式打印日志 }, 'SF': { # 定义一个名为SF的日志处理器(名字自己定义即可) 'level': 'INFO', # 日志级别 'class': 'logging.handlers.RotatingFileHandler', # 保存到文件,根据文件大小自动切 'filename': os.path.join(BASE_LOG_DIR, "info.log"), # 日志文件 'maxBytes': 1024 * 1024 * 50, # 日志大小 50M 'backupCount': 3, # 备份数为3 xx.log --> xx.log.1 --> xx.log.2 --> xx.log.3 'formatter': 'standard', # 用标准格式打印日志 'encoding': 'utf-8', }, 'TF': { # 定义一个名为TF的日志处理器(名字自己定义即可) 'level': 'INFO', 'class': 'logging.handlers.TimedRotatingFileHandler', # 保存到文件,根据时间自动切 'filename': os.path.join(BASE_LOG_DIR, "info.log"), # 日志文件 'backupCount': 3, # 备份数为3 xx.log --> xx.log.2018-08-23_00-00-00 --> xx.log.2018-08-24_00-00-00 --> ... 'when': 'D', # 每天一切, 可选值有S/秒 M/分 H/小时 D/天 W0-W6/周(0=周一) midnight/如果没指定时间就默认在午夜 'formatter': 'standard', 'encoding': 'utf-8', }, 'error': { 'level': 'ERROR', 'class': 'logging.handlers.RotatingFileHandler', # 保存到文件,自动切 'filename': os.path.join(BASE_LOG_DIR, "error.log"), # 日志文件 'maxBytes': 1024 * 1024 * 5, # 日志大小 50M 'backupCount': 5, 'formatter': 'standard', 'encoding': 'utf-8', }, 'collect': { 'level': 'INFO', 'class': 'logging.handlers.RotatingFileHandler', # 保存到文件,自动切 'filename': os.path.join(BASE_LOG_DIR, "collect.log"), 'maxBytes': 1024 * 1024 * 50, # 日志大小 50M 'backupCount': 5, 'formatter': 'collect', 'encoding': "utf-8" } }, 'loggers': { '': { # 日志实例对象默认配置 'handlers': ['SF', 'console', 'error'], # 使用哪几种处理器,上线之后可以把'console'移除 'level': 'DEBUG', # 实例的级别 'propagate': True, # 是否向上传递日志流 }, 'collect': { # 名为 'collect'的logger对象实例还单独处理 'handlers': ['console', 'collect'], 'level': 'INFO', } }, }
实例中的应用:选择collect为logger日志的入口。
视图中怎么使用日志呢?
import logging logger = logging.getLogger("setting.py中LOGGING中的loggers模块中自己定义的日志器的名字") logger.info("这是日志信息") # 输出到info级别的日志文件中 logger.error("这是日志信息") # 输出到errro级别的日志文件中 logger.warming("这是日志信息") # 输出到warming级别的日志文件中
日志配置
日志由四个部分组成:
LOGGING = { 'version': 1, 'disable_existing_loggers': False, # 是否禁用已经存在的日志器
formatters:描述文本的准确格式,通常由包含日志属性的python格式化字符串组成,也可以自定义formatters来实现格式化。是一个字典格式
'formatters': { # 日志信息显示的格式
verbose --- 详细信息,字典。 'verbose': { 'format': '%(levelname)s %(asctime)s %(module)s %(lineno)d %(message)s' },
simple --- 样例,样本,字典 'simple': {
levelname--(info,erro等) module --- 引用logging的模块名xxx.py 'format': '%(levelname)s %(module)s %(lineno)d %(message)s' },
# 自定义的格式输出格式
'aaa': {
'format':'%(message)s'
}, },
filters:过滤器 'filters': { # 对日志进行过滤 'require_debug_true': { # django在debug模式下才输出日志 '()': 'django.utils.log.RequireDebugTrue', }, },
handlers: 操作器 'handlers': { # 日志处理方法 'console': { # 向终端中输出日志 'level': 'INFO', # 输出级别 'filters': ['require_debug_true'], # 过滤器 'class': 'logging.StreamHandler', 'formatter': 'simple' # 输出格式---样例标准 }, 'file': { # 向文件中输出日志 'level': 'INFO', 'class': 'logging.handlers.RotatingFileHandler', 'filename': os.path.join(os.path.dirname(BASE_DIR), "logs/info.log"), # 日志文件的位置 'maxBytes': 300 * 1024 * 1024, 'backupCount': 10, 'formatter': 'verbose' # 输出格式---详细信息标准 }, },
loggers:日志系统的入口 'loggers': { # 日志器 'django': { # 定义了一个名为django的日志器,通过实例 logger = logging.getLogger("django")获取 日志器的实例对象,然后通过 logger.info("信息") 'handlers': ['console', 'file'], # 可以同时向终端与文件中输出日志 操作器可以操作的日志为两种,一种输出到终端,一种输出到文件 'propagate': True, # 是否继续传递日志信息 'level': 'INFO', # 日志器接收的最低日志级别 输出级别为info以上的信息都进行输出 }, } }
通过实例举例
# 实例验证