解决Python日志中datefmt导致时间戳不更新的问题

陌晨君_4574

陌晨君_4574

2025-11-27

929人浏览

原创

解决Python日志中datefmt导致时间戳不更新的问题

本文深入探讨了python `logging`模块中`datefmt`参数配置不当导致日志时间戳停滞的常见问题。当`datefmt`被设置为一个固定时间字符串而非格式化模式时,`%(asctime)s`将无法动态更新毫秒信息。教程将详细解释`%(asctime)s`和`datefmt`的工作原理,并提供一种结合`%(asctime)s.%(msecs)03d`与标准日期时间格式化字符串的解决方案,确保日志时间戳的准确性和动态性。

Python日志中datefmt与时间戳动态更新的挑战

在使用Python的logging模块配置日志系统时,开发者常常会遇到一个问题:即使在同一秒内产生了多条日志记录,它们的时间戳却显示完全相同,尤其是在尝试自定义datefmt以实现ISO格式时。这通常发生在datefmt参数被错误地配置为一个固定的时间字符串,而不是一个时间格式化模式。

问题分析:%(asctime)s与datefmt的交互

Python logging模块中的Formatter对象使用%(asctime)s来表示日志记录的时间。%(asctime)s的实际输出格式由datefmt参数决定。

  • %(asctime)s: 这是一个占位符,代表日志记录的时间。它会被Formatter在每次日志记录时动态地替换为当前时间。
  • datefmt: 这是一个可选参数,用于指定%(asctime)s的格式。它应该是一个遵循strftime()格式代码的字符串(例如'%Y-%m-%d %H:%M:%S')。如果datefmt未指定(即为None),logging模块会使用默认的ISO格式,通常包含毫秒。

问题的核心在于,当datefmt被设置为datetime.now().isoformat(...)时,datetime.now()会在配置加载时被一次性评估,生成一个固定的时间字符串(例如'2024-01-04T03:18:18.123456')。这个固定的字符串随后被赋给datefmt,而不是一个格式化模式。因此,%(asctime)s在每次日志记录时,都会尝试使用这个静态的字符串作为其格式,这显然是错误的,因为它本身不是一个格式字符串,而是一个已经格式化好的时间。

例如,原始配置中的datefmt: datetime.now().isoformat(sep='T',timespec='milliseconds')会生成一个类似'2024-01-04T03:18:18.123'的字符串。当logging系统初始化时,这个字符串就被固定下来作为datefmt的值。之后所有的%(asctime)s都会尝试使用这个固定值作为格式字符串,这导致所有日志记录的时间戳都相同,并且无法动态更新毫秒。

正确的解决方案:结合%(asctime)s.%(msecs)03d与标准datefmt

要实现ISO格式并确保时间戳包含动态更新的毫秒信息,应采取以下策略:

Jazz Music — Stream Jazz Concerts: Audio Analysis, Lyrics, Equations
Jazz Music — Stream Jazz Concerts: Audio Analysis, Lyrics, Equations

以数据形式体验爵士乐。AI代理流式处理和声分离、色度、音网。误差纳入已测量。

下载
  1. 在format字符串中使用%(asctime)s.%(msecs)03d:%(msecs)03d是一个专门用于显示毫秒的占位符,它会动态地获取当前日志记录的毫秒部分并格式化为三位数字(不足三位补零)。
  2. 将datefmt设置为一个标准的日期时间格式化字符串:这个字符串应包含年、月、日、时、分、秒,但不包含毫秒,因为毫秒将由%(msecs)03d处理。

以下是修正后的logging_config示例:

import logging
import sys
from datetime import datetime
from logging.config import dictConfig
import time

logging_config = dict(
    version=1,
    formatters={
        'verbose': {
            # 修正:在format中添加.%(msecs)03d来显示毫秒
            'format': ("%(asctime)s.%(msecs)03d %(levelname)s "
                       "[%(name)s:%(lineno)s] %(message)s"),
            # 修正:datefmt设置为一个标准的格式化字符串,不包含毫秒
            'datefmt': '%Y-%m-%dT%H:%M:%S'
        },
        'simple': {
            'format': '%(asctime)s.%(msecs)03d %(levelname)-8s %(message)s',
            'datefmt': '%Y-%m-%dT%H:%M:%S'
        },
    },
    handlers={
        'tte-logger': {'class': 'logging.FileHandler',
                       'formatter': 'verbose',
                       'level': logging.DEBUG,
                       'filename': '/home/abc/efg/logs/logtest_'+datetime.now().strftime("%Y%m%d-%H%M%S")+'.log'},
        'console': {
            'class': 'logging.StreamHandler',
            'level': 'DEBUG',
            'formatter': 'simple',
            'stream': sys.stdout,
        },
    },
    loggers={
        'logger': {
            'handlers': ['tte-logger', 'console'], # 确保这里引用了正确的handler名称
            'level': logging.DEBUG,
            'propagate': False # 避免重复日志
        },
    }
)

# 应用日志配置
dictConfig(logging_config)
logger = logging.getLogger('logger')

# 示例日志输出
logger.info("第一条日志")
time.sleep(0.005) # 模拟时间间隔
logger.info("第二条日志")
time.sleep(0.003)
logger.info("第三条日志")

通过上述修改,日志输出将变为:

2024-01-04T03:30:11.595 INFO     第一条日志
2024-01-04T03:30:11.598 INFO     第二条日志
2024-01-04T03:30:11.603 INFO     第三条日志

这里的关键是datefmt现在是一个真正的格式化字符串,%(asctime)s会根据这个格式生成时间(精确到秒),而%(msecs)03d则负责补充毫秒部分。这两者结合,确保了时间戳的动态性和完整性。

注意事项与最佳实践

  • datefmt=None的行为:当datefmt设置为None时,logging模块会使用其内部的默认格式(通常是'%Y-%m-%d %H:%M:%S,###',其中###表示毫秒),因此它能正确显示毫秒。这也是为什么原始问题中将datefmt设为None后能解决问题的原因。
  • 文件命名中的时间戳:在FileHandler的filename中,使用datetime.now().strftime(...)来生成文件名是正确的,因为文件名只需要在文件创建时确定一次。这里使用datetime.now()是合适的。
  • 避免在datefmt中使用datetime.now():再次强调,datefmt参数期望的是一个格式化字符串,而不是一个已经格式化好的时间值。
  • propagate属性:在loggers配置中,将propagate设置为False可以防止日志记录被传递给父级logger,从而避免重复输出。

总结

正确配置Python logging模块中的时间戳格式是实现有效日志记录的关键。理解%(asctime)s和datefmt之间的关系,以及%(msecs)03d的用途,能够帮助我们避免时间戳停滞的问题。通过将%(asctime)s.%(msecs)03d放入format字符串,并将datefmt设置为一个不含毫秒的标准格式化字符串,我们可以确保日志输出的时间戳既符合ISO标准,又能准确反映每一条日志记录的发生时刻。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python stream 常见问题 gate

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1889

3

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.06.27

1231

7

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1978

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3284

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6464

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

6729

6

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

2024.03.22

8234

16

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2024.04.29

12934

11

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.07.29

6739

17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程