Django日志模块logging的配置详解


Posted in Python onFebruary 14, 2017

前言

Django对于日志输出的信息是很完善的,request的信息,setting配置,trackback的信息,一应俱全,足够我们调试了。但是在线上环境,如果让用户看到这些信息,是很不安全的(暴露代码)。所以在线上我们要关闭Debug,但是又不能扔掉这些调试信息,这就要用到logging模块。

logging模块其实是Python的模块,在Django中有很多本地化的支持。

理解Logger

首先要理解logging的工作,这里面主要有四个东西:格式器formatter,过滤器filter,处理器handler,日志实例logger。

处理流程

formatter
logger ----> handler ----------------> files, emails
    filter

处理流程是这样的。首先,在代码中。我们拿到的是logger实例,通过这个实例来记录信息。

# import the logging library
import logging
 
# Get an instance of a logger
logger = logging.getLogger('django')
 
def my_view(request, arg1, arg):
 ...
 if bad_mojo:
 # Log an error message
 logger.error('Something went wrong!')

然后,名字是django的这个logger就会把信息交给相应的handler,handler把信息用formater和filter处理一下,提交log(保存到文件,数据库,或者发送邮件)。

一般来说,handler可以是send_email,error_file等负责处理的方式,在logger中可以重复使用handler。例如我们的django处理器使用了send_email, error_file 这两个处理器,request处理器使用error_file,info_file两个处理器,logger和handler可以理解成多对多的关系,嘻嘻。

配置方式

Python中可以使用多种格式配置logging,比如.conf, .ini等。

在Django中,我们是把有关logging的配置写到settings里面。相应的配置及解释如下(仅供参考)。

#管理员邮箱
ADMINS = (
 ('laixintao','*******@163.com'),
)
 
#非空链接,却发生404错误,发送通知MANAGERS
SEND_BROKEN_LINK_EMAILS = True
MANAGERS = ADMINS
 
#Email设置
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST= 'smtp.163.com'#QQ邮箱SMTP服务器(邮箱需要开通SMTP服务)
EMAIL_PORT= 25 #QQ邮箱SMTP服务端口
EMAIL_HOST_USER = '**********@163.com' #我的邮箱帐号
EMAIL_HOST_PASSWORD = '**************' #授权码
EMAIL_SUBJECT_PREFIX = 'website' #为邮件标题的前缀,默认是'[django]'
EMAIL_USE_TLS = True #开启安全链接
DEFAULT_FROM_EMAIL = SERVER_EMAIL = EMAIL_HOST_USER #设置发件人
 
#logging日志配置
LOGGING = {
 'version': 1,
 'disable_existing_loggers': True,
 'formatters': {#日志格式 
 'standard': {
  'format': '%(asctime)s [%(threadName)s:%(thread)d] [%(name)s:%(lineno)d] [%(module)s:%(funcName)s] [%(levelname)s]- %(message)s'} 
 },
 'filters': {#过滤器
 'require_debug_false': {
  '()': 'django.utils.log.RequireDebugFalse',
  }
 },
 'handlers': {#处理器
 'null': {
  'level': 'DEBUG',
  'class': 'logging.NullHandler',
 },
 'mail_admins': {#发送邮件通知管理员
  'level': 'ERROR',
  'class': 'django.utils.log.AdminEmailHandler',
  'filters': ['require_debug_false'],# 仅当 DEBUG = False 时才发送邮件
  'include_html': True,
 },
 'debug': {#记录到日志文件(需要创建对应的目录,否则会出错)
  'level':'DEBUG',
  'class':'logging.handlers.RotatingFileHandler',
  'filename': os.path.join(BASE_DIR, "log",'debug.log'),#日志输出文件
  'maxBytes':1024*1024*5,#文件大小 
  'backupCount': 5,#备份份数
  'formatter':'standard',#使用哪种formatters日志格式
 },
 'console':{#输出到控制台
  'level': 'DEBUG',
  'class': 'logging.StreamHandler',
  'formatter': 'standard',
 },
 },
 'loggers': {#logging管理器
 'django': {
  'handlers': ['console'],
  'level': 'DEBUG',
  'propagate': False 
 },
 'django.request': {
  'handlers': ['debug','mail_admins'],
  'level': 'ERROR',
  'propagate': True,
 },
 # 对于不在 ALLOWED_HOSTS 中的请求不发送报错邮件
 'django.security.DisallowedHost': {
  'handlers': ['null'],
  'propagate': False,
 },
 } 
}

以上的配置文件中,有三个日志处理器。分别是:

  1. ‘django.request':django的request发生error会自动记录,然后使用debug将信息记录到文件,还有mail_admins将信息通过邮件发送给管理员。这里邮件的功能非常棒!并不是一个纯文本信息,而是一个html文件,和我们在浏览器看到的错误页面一模一样!要正常使用邮件功能需要像我一样配置一下上面的邮件发件人信息。我是直接去网易申请了一个邮箱。要格外注意三点:1.一定要去邮件服务商开启SMTP服务;2.不同的邮件服务商可能有一些特殊的设置,比如网易,会给你一个客户端授权码,这个才是密码,而不是网页的登录密码。3 注意服务商有没有对发信频率的限制。
  2. ‘django':使用console处理器,将信息输出。在开发的时候就可以使用这个处理器(什么?print? 太low了!)
  3. 最后一个处理器见注释。

最后,不要忘了给日志的路径响应的权限。比如Apache2服务器,就需要给www-data写权限:

sudo chown -R [yourname]:www-data [log]
sudo chmod -R g+s [log]

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流。

Python 相关文章推荐
用Python从零实现贝叶斯分类器的机器学习的教程
Mar 31 Python
简介Django中内置的一些中间件
Jul 24 Python
windows 下python+numpy安装实用教程
Dec 23 Python
Python中的异常处理try/except/finally/raise用法分析
Feb 28 Python
Django网络框架之HelloDjango项目创建教程
Jun 06 Python
python pytest进阶之xunit fixture详解
Jun 27 Python
Python pip install如何修改默认下载路径
Apr 29 Python
Python通过文本和图片生成词云图
May 21 Python
Spring http服务远程调用实现过程解析
Jun 11 Python
Python应用实现处理excel数据过程解析
Jun 19 Python
keras 两种训练模型方式详解fit和fit_generator(节省内存)
Jul 03 Python
python字典进行运算原理及实例分享
Aug 02 Python
深入理解Python对Json的解析
Feb 14 #Python
Python 2与Python 3版本和编码的对比
Feb 14 #Python
利用Python爬虫给孩子起个好名字
Feb 14 #Python
python 出现SyntaxError: non-keyword arg after keyword arg错误解决办法
Feb 14 #Python
让python 3支持mysqldb的解决方法
Feb 14 #Python
python用装饰器自动注册Tornado路由详解
Feb 14 #Python
利用python程序生成word和PDF文档的方法
Feb 14 #Python
You might like
php 一元分词算法
2009/11/30 PHP
php在服务器执行exec命令失败的解决方法
2012/03/03 PHP
PHP 的异常处理、错误的抛出及回调函数等面向对象的错误处理方法
2012/12/07 PHP
ThinkPHP框架里隐藏index.php
2016/04/12 PHP
laravel5.0在linux下解决.htaccess无效和去除index.php的问题
2019/10/16 PHP
用jscript实现新建word文档
2007/06/15 Javascript
给应用部分的js代码设定一个统一的入口
2014/06/15 Javascript
JS获取下拉框显示值和判断单选按钮的方法
2015/07/09 Javascript
JS打字效果的动态菜单代码分享
2015/08/21 Javascript
Bootstrap4一次重大更新 几乎涉及每行代码
2016/05/16 Javascript
JS两个数组比较,删除重复值的巧妙方法(推荐)
2016/06/03 Javascript
ionic实现下拉刷新载入数据功能
2017/05/11 Javascript
使用DataTable插件实现异步加载数据
2017/11/19 Javascript
JS 实现分页打印功能
2018/05/16 Javascript
JavaScript设计模式之构造函数模式实例教程
2018/07/02 Javascript
vue单页面实现当前页面刷新或跳转时提示保存
2018/11/02 Javascript
详解如何在Node.js的httpServer中接收前端发送的arraybuffer数据
2018/11/11 Javascript
JavaScript ES6中的简写语法总结与使用技巧
2018/12/30 Javascript
判断“命令按钮”是否被鼠标单击详解
2019/07/31 Javascript
微信小程序实现滑动操作代码
2020/04/23 Javascript
基于javascript的无缝滚动动画1
2020/08/07 Javascript
Python中处理字符串之islower()方法的使用简介
2015/05/19 Python
python dataframe 输出结果整行显示的方法
2018/06/14 Python
Python使用numpy模块创建数组操作示例
2018/06/20 Python
python requests.post带head和body的实例
2019/01/02 Python
django 简单实现登录验证给你
2019/11/06 Python
python 使用建议与技巧分享(四)
2020/08/18 Python
Pycharm Available Package无法显示/安装包的问题Error Loading Package List解决
2020/09/18 Python
iframe在移动端的缩放的示例代码
2018/10/12 HTML / CSS
Linux如何为某个操作添加别名
2013/03/01 面试题
两则小学生的自我评价分享
2013/11/14 职场文书
纪念九一八爱国演讲稿600字
2014/09/14 职场文书
办公室禁烟通知
2015/04/23 职场文书
小学运动会宣传稿
2015/07/23 职场文书
2016年禁毒宣传活动总结
2016/04/05 职场文书
postgres之jsonb属性的使用操作
2021/06/23 PostgreSQL