Django 项目的日志系统

前言

一个 Web 项目,无论是在开发调试的时候,还是上线为用户提供服务以后,都需要保留下一些运行当中必要的信息用于日后的维护和故障的定位。Django 中使用 Python 内建的 logging 模块做日志的收集。

Django 中日志系统配置

logging 模块配置

logging 模块为用户提供了用于配置它的 api(接口函数)- logging.config.dictConfig(config)。这里需要传递一个config 参数(日志配置参数字典)。config 通过 DictConfigurator 类进行解析,其构造方法使用了 config,同时还有一个 configure() 方法。dictConfig() 方法内部调用 dictConfigClass 初始化一个 DictConfigurator 实例并调用 configure() 方法。

def dictConfig(config): 
    dictConfigClass(config).configure()

如果在 DJANGO 使用的话第一步需要在项目 setting.py 文件中定义这个上面说到的 config(日志配置字典),包括记录器(loggers)、处理器(handlers)、日志格式(formatters)、过滤器(filters)。

File:project/setting.py
LOGGING = {
    'version': 1, # 标示配置模板版本,int 类型,目前只接收 `1`这个值。
    'disable_existing_loggers': False, # 这个没太看明白什么意思,了解的朋友麻烦说明下
    'formatters': {
        'standard': {
             'format': '%(levelname)s %(asctime)s %(message)s',
        },
    },
    'filters': {
        # 这里是定义过滤器,需要注意的是,由于 'filters' 是 logging.config.dictConfig 方法要求在配置字典中必须给订的 key ,所以即使不使用过滤器也需要明确给出一个空的结构。
    },
    'handlers': {
         'mail_admins': {
            'level': 'ERROR',
            'class': 'django.utils.log.AdminEmailHandler',
            'formatter':'standard',
        },
        'tofile': {
            'level': 'ERROR',
            'class': 'logging.FileHandler',
            'formatter':'standard',
            'filename': 'project/app/log/view.log',
        },
    },
    'loggers': {
        'project.app': {
            'handlers': ['tofile'],
            'level': 'DEBUG',
            'propagate': True,
        },
    }
}

下一步需要在需要记录日志的地方创建 logger 实例。

File:project/app/views.py
import logging

logger = logging.getLogger(__name__) # 这里使用 __name__ 动态搜索定义的 logger 配置,这里有一个层次关系的知识点。

def log_test(request):
    logger.error("level error test")
    logger.info("level info test")

运行上面代码 "level error test" 会被写入 project/app/log/view.log,因为 logger 对象会根据层次搜索使用 setting.py 设置中的 project.app 记录器配置。由于 project.app 记录器配置绑定了 tofile 处理器,所以只会写入 error 以上的日志记录。

总结

到此是一个 Django 中使用日志 logging 模块的大致方法,细节还需要阅读官方文档,可能有不对的地方,日后慢慢更正。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,585评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,724评论 6 342
  • 本文首发于Gevin的博客 原文链接:Python 日志功能详解 未经 Gevin 授权,禁止转载 软件开发中通过...
    Gevin阅读 4,864评论 1 24
  • 不知道从什么时候开始 对你的想念开始平淡了 没有像以前那样疯狂了 也许是失落太多了吧! 也许是长时间没见面了吧! ...
    染情阅读 415评论 1 1
  • 狮泉河镇六年前我骑摩托车从拉萨去新疆路过这里,现在这里比六年前还要破败,所有街道路面破烂不堪,政府的事不说了, 继...
    野在外阅读 201评论 1 1