自动化测试框架中如何记录日志更加已读 ?一文介绍使用loguru来管理日志的心得。

本文主要是介绍自动化测试框架中如何记录日志更加已读 ?一文介绍使用loguru来管理日志的心得。,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

只要做代码开发,记录日志必不可少的 ,对于像我这样的测试开发同学也是 ,你在编写自动化时如何记录日志 ?怎么要日志记录更容易已读 ?如何备份日志文件 ? 这都是我们在编写代码时要考虑的问题 ,如果你也遇到了这样的问题 ,不妨看看如下的这篇文章 。

目录结构

 

1. loguru介绍

1.1 什么是日志 ?

程序运行过程中,难免会遇到各种报错 。如果这种报错是在本地发现的 ,你还可以进行debug 。但是如果程序已经上线了 ,你就不能使用debug方式了 。这种情况下该如何解决呢 ?目前通用的方式就是在软件中记录主要的操作轨迹和数据,以便在软件报错时可以方便查找到报错原因 。这种记录程序的操作轨迹和数据的方式叫记录日志 。

目前记录日志,都是使用专门的日志模块来进行记录的。而不同的开发语言所使用的日志模块也有所不同 。像python最常用的两个日志模块就是logging和loguru .

相比logging而言 ,loguru使用起来更加简单并也能满足记日志的需求 ,接下来就来介绍下loguru的使用 。

1.2 loguru的作用

loguru是python 开发的一个第三方模块 , 主要用于记录python程序的日志 。其特点就是简单易用 、功能强大 。

1.3 安装与导入
# 下载与安装
pip install loguru
​
# 验证 :
pip show loguru
​
# 导入
from loguru import logger   
​
# 说明 :通过上述的导入,直接导入的是对象。而且是一个单例对象 ,即整个项目都可以使用这一个对象来操作,无需担心生成多份同样的日志

2.主要功能

在loguru中主要包括如下功能 :

  • 已经格式化后的日志

  • 日志着色

  • 输出不同级别的日志

  • 日志内容参数化,像format一样

  • 支持输出到文件,并支持分割、备份等操作 。

2.1 输出日志
# 导包
from loguru import logger
​
# 生成debug、info、success、warning、error日志
logger.debug("这是一条debug日志")
logger.info("这是一条info日志")
logger.success("这是一条success日志")
logger.warning("这是一条warning日志")
logger.error("这是一条error日志")

以上内容的输出为 :

通过以上可以看到 ,只要随便打印一条日志 ,它的日志已经有了默认的格式了 。以下为源代码中的默认日志格式 :

LOGURU_FORMAT = env("LOGURU_FORMAT",str,"<green>{time:YYYY-MM-DD HH:mm:ss.SSS}</green> | ""<level>{level: <8}</level> | ""<cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>",
)

以下为源码中的日志级别定义 ,级别日志依次为 :

LOGURU_TRACE_NO = env("LOGURU_TRACE_NO", int, 5)
LOGURU_TRACE_COLOR = env("LOGURU_TRACE_COLOR", str, "<cyan><bold>")
LOGURU_TRACE_ICON = env("LOGURU_TRACE_ICON", str, "✏️")  # Pencil
​
LOGURU_DEBUG_NO = env("LOGURU_DEBUG_NO", int, 10)
LOGURU_DEBUG_COLOR = env("LOGURU_DEBUG_COLOR", str, "<blue><bold>")
LOGURU_DEBUG_ICON = env("LOGURU_DEBUG_ICON", str, "🐞")  # Lady Beetle
​
LOGURU_INFO_NO = env("LOGURU_INFO_NO", int, 20)
LOGURU_INFO_COLOR = env("LOGURU_INFO_COLOR", str, "<bold>")
LOGURU_INFO_ICON = env("LOGURU_INFO_ICON", str, "ℹ️")  # Information
​
LOGURU_SUCCESS_NO = env("LOGURU_SUCCESS_NO", int, 25)
LOGURU_SUCCESS_COLOR = env("LOGURU_SUCCESS_COLOR", str, "<green><bold>")
LOGURU_SUCCESS_ICON = env("LOGURU_SUCCESS_ICON", str, "✔️")  # Heavy Check Mark
​
LOGURU_WARNING_NO = env("LOGURU_WARNING_NO", int, 30)
LOGURU_WARNING_COLOR = env("LOGURU_WARNING_COLOR", str, "<yellow><bold>")
LOGURU_WARNING_ICON = env("LOGURU_WARNING_ICON", str, "⚠️")  # Warning
​
LOGURU_ERROR_NO = env("LOGURU_ERROR_NO", int, 40)
LOGURU_ERROR_COLOR = env("LOGURU_ERROR_COLOR", str, "<red><bold>")
LOGURU_ERROR_ICON = env("LOGURU_ERROR_ICON", str, "❌")  # Cross Mark
​
LOGURU_CRITICAL_NO = env("LOGURU_CRITICAL_NO", int, 50)
LOGURU_CRITICAL_COLOR = env("LOGURU_CRITICAL_COLOR", str, "<RED><bold>")
LOGURU_CRITICAL_ICON = env("LOGURU_CRITICAL_ICON", str, "☠️")  # Skull and Crossbones

分别对日志级别进行说明 :

  • 日志共包括7个级别,分别是 :TRACE(5) < DEBUG(10) < INFO(20) < SUCCESS(25) < WARNING(30) < ERROR(40) < CRITICAL(50) .每个日志都用一个默认数字代替,说明它们的基本的高低 。

  • 每个级别代表一个数字 ,数字越小级别越小 ;同时数字越小 ,输出的日志越多 。输出的日志越多,代码运行速度越慢,故并非是越详细越好 。因为它们是包含的关系 ,若日志级别设置为>=5将会输出所有日志 。

  • 分别对以下几个日志的用途说明 :

    • TRACE : 程序每运行一步,都要记录一条日志 ,几乎不会用到。

    • DEBUG :主要用来调式bug使用,既然是调试bug,就必须记录的详细,一般可以理解每一步中的若个小步记录的日志

    • INFO : 可以理解为记录运行的流程步骤 。

    • SUCCESS : 可以理解为某个流程完成以后记录的成功日志 。

    • WARNING :记录潜在的错误 ,可以理解为标准之外的情况

    • ERROR :记录运行过程中出现的错误 。

    • CRITICAL :非常严重的错误事件, 相对来说用的较少。

2.2 日志内容参数化
# 3. 进行字符串参数化
logger.info("{}班有{}位同学".format('一',52))		# 使用format进行格式化
logger.info("{}班有{}位同学",'一',52)		# 使用日志中的参数化# 以上两种写法都输出
2023-07-09 17:28:55.263 | INFO     | __main__:<module>:39 - 一班有52位同学

可以看到,在日志内容中进行数据参数化,可以使用日志本身带的功能,只需要将数据作为参数传入即可。

2.3 输出到文件

输出到文件,主要使用到的方法就是add ,它有好几个参数 ,可以支持日志文件切割、备份、清理等操作 。

# add 方法说明 :
"""
add(filename,level,format,serialize,rotation,retention,compression):filename : 输出的日志文件名level  : 日志级别 ,传递7个日志级别中的1个format : 支持传递的格式化参数有:time level file module line message name funcation processretention : 定期清理rotation : 保留时长 comproession : 压缩 ,格式支持:"gz", "bz2", "xz", "lzma", "tar", "tar.gz", "tar.bz2", "tar.xz", "zip"
"""

参数演示 :

flname = 'a.log'		# 将日志输出到a.log中
logger.add(flname,level='DEBUG',format="{time:YYYY-MM-DD HH:mm:ss} | {level} | {file} | {module}|{line}|{process}|{message}",rotation='10Kb',compression='zip')		# 设置日志级别、日志压缩、压缩格式。logger.debug("这是一条debug日志")
logger.info("这是一条info日志")
logger.success("这是一条success日志")
logger.warning("这是一条warning日志")
logger.error("这是一条error日志")

其它参数

logger.add("file_1.log", rotation="500 MB") # 文件过大就会重新生成一个文件
logger.add("file_2.log", rotation="12:00") # 每天12点创建新文件
logger.add("file_3.log", rotation="1 week") # 文件时间过长就会创建新文件
logger.add("file_X.log", retention="10 days") # 一段时间后会清空
logger.add("file_Y.log", compression="zip") # 保存zip格式

3.如何记录日志

学习日志模块其实并不能 ,难的是如何让记录的日志发挥它的价值 。个人认为,要写记录日志,就要从三个方面入手,分别是如何记 ? 如何更好的阅读 ,如何做好日志留存 。

3.1 记录日志

做好日志记录是为了更方便、更高效的查看 ,所以第一步完全是为了第二步服务的 。该如何记录日志呢 ?这个应该跟你的业务系统有很大关系 。比如,我的日志记录就是为了自动化框架所使用 。为了在自动化运行报错后能很快速的定位到问题。所以,我设计的日志完全是为了适应这套框架 。

为了能使日志更易读 ,主要从以下的三个方面入手设计 ,分别是 :

  • 用例与用例之间的分界线,在用例之间输出分割线,能快速识别到每条用例的中间日志 。同时在开始处输出要运行用例的文件名和用例名,在结束处输出运行结果 。

  • 给系统中的日志级别设定一套规则 ,什么日志输出debug 、什么日志输出info ,必须给出明确定义 ,提高辨识度 。

  • 日志内容具有上下文识别, 同时相同类型的内容一定要使用相同关键字 。

个人设计了一套规则 ,用于框架的日志记录 。比如 :在自动化用例运行过程中,主要包括流程、子流程和流程上的节点 。那么,日志也是针对这些流程来设计不同日志级别 。

比如,以下是针对日志级别设计的一套规则。

包括要素说明对应日志级别
流程包括:setUp-执行用例-tearDown每成功运行一步都记录一个success级别的日志
子流程主要是每个流程中包含的子步骤,比如测试用例包含的步骤有解析请求参数 ,发送请求数据,断言等操作运行的每一步都记录一个info级别的日志。
流程中的节点主要是针对每一步骤中调用函数内部的日志输出。所调用函数的内部都记录为debug级别的日志 。
节点报错执行的节点出现报错的情况每一步都有报错的情况都记录为error级别。
不期望的值在执行的流程中,出现一些不期望的值出现出现不期望的值就可以记录warning级别的日志。

3.2 阅读日志

一份可读性强的日志能快速定位错误 ,从而提高解决问题的效率 。那么如何让日志更易阅读呢 ? 个人认为 ,要至少从以下三个方面入手 。

  1. 要有一套日志记录规则 ,并要有良好的记录日志习惯,严格按照日志规则来记录 ,这条就是第一点说的如何记录日志 ,故这里不再赘述 。

  2. 日志要按天分割,每天一个 ,按照日期也能快速找到是在那个文件中,每个日志文件中的内容不会太多,方便查找。

  3. 将最新的日志集成到测试报告中,以便在测试报告中也能打开日志文件,从而查找起来更加方便 。

其中第2点,日志按天分割,就是用到了rotation这个参数 。

logger.add("file_2.log", rotation="8:00") # 每天8点创建新文件

其中第3点就是会用到allure中的@allure.attachment() 这个装饰器 ,将日志文件传入到这个装饰器中。

3.3 备份日志

日志备份主要跟记录日志的业务系统有关系 ,比如你是负责公司产品的开发 ,那么日志备份的周期一定要长 ,备份一年也不为过 。

但是 ,如果仅仅是为了自动化测试用例记录日志 ,一年的日志备份就有点太夸张了 。

可以采取的策略为 :

  • 一周内的日志保留原样,每天生成一个日志文件 。

  • 一周以上到一个月内的日志进行打包压缩 ,保留压缩文件 。

  • 一个月的日志文件可以删除 ,因为对于自动化测试框架 ,这些日志文件已经没啥用了,可以删除释放空间。

4.项目集成日志

在项目中想要日志文件,只需要三步, 具体如下 :

  1. 在创建项目框架时,创建一个日志文件夹 。将日志文件写入该文件夹即可。

  2. 在入口脚本处,调用日志方法,将日志写入到具体文件中。

  3. 在项目的代码中,编写要实现日志 。

4.1 创建日志文件夹

4.2 入口中调用日志方法
3.在项目中写入日志

5.项目总结

至此,我们已经实现了五步了 ,分别是 :

第一 、如何编写一个接口自动化框架 ,在第一篇博文中介绍了 。

第二、如何编写测试用例 ,已经在第二篇博文中介绍了 。

第三、如何实现接口请求 ,并和测试用例如何对接 ,已经在第三篇博文中介绍了。

第四、如何使用yaml编写测试数据 ,已经在第四篇博文中介绍了 。

第五,如何使用allure生成测试报告,已经在第五篇博文中介绍了 。

第六 ,如何使用loguru记录日志 ,也就是本篇博文 。

这篇关于自动化测试框架中如何记录日志更加已读 ?一文介绍使用loguru来管理日志的心得。的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/220635

相关文章

性能测试介绍

性能测试是一种测试方法,旨在评估系统、应用程序或组件在现实场景中的性能表现和可靠性。它通常用于衡量系统在不同负载条件下的响应时间、吞吐量、资源利用率、稳定性和可扩展性等关键指标。 为什么要进行性能测试 通过性能测试,可以确定系统是否能够满足预期的性能要求,找出性能瓶颈和潜在的问题,并进行优化和调整。 发现性能瓶颈:性能测试可以帮助发现系统的性能瓶颈,即系统在高负载或高并发情况下可能出现的问题

中文分词jieba库的使用与实景应用(一)

知识星球:https://articles.zsxq.com/id_fxvgc803qmr2.html 目录 一.定义: 精确模式(默认模式): 全模式: 搜索引擎模式: paddle 模式(基于深度学习的分词模式): 二 自定义词典 三.文本解析   调整词出现的频率 四. 关键词提取 A. 基于TF-IDF算法的关键词提取 B. 基于TextRank算法的关键词提取

水位雨量在线监测系统概述及应用介绍

在当今社会,随着科技的飞速发展,各种智能监测系统已成为保障公共安全、促进资源管理和环境保护的重要工具。其中,水位雨量在线监测系统作为自然灾害预警、水资源管理及水利工程运行的关键技术,其重要性不言而喻。 一、水位雨量在线监测系统的基本原理 水位雨量在线监测系统主要由数据采集单元、数据传输网络、数据处理中心及用户终端四大部分构成,形成了一个完整的闭环系统。 数据采集单元:这是系统的“眼睛”,

使用SecondaryNameNode恢复NameNode的数据

1)需求: NameNode进程挂了并且存储的数据也丢失了,如何恢复NameNode 此种方式恢复的数据可能存在小部分数据的丢失。 2)故障模拟 (1)kill -9 NameNode进程 [lytfly@hadoop102 current]$ kill -9 19886 (2)删除NameNode存储的数据(/opt/module/hadoop-3.1.4/data/tmp/dfs/na

Hadoop数据压缩使用介绍

一、压缩原则 (1)运算密集型的Job,少用压缩 (2)IO密集型的Job,多用压缩 二、压缩算法比较 三、压缩位置选择 四、压缩参数配置 1)为了支持多种压缩/解压缩算法,Hadoop引入了编码/解码器 2)要在Hadoop中启用压缩,可以配置如下参数

Makefile简明使用教程

文章目录 规则makefile文件的基本语法:加在命令前的特殊符号:.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具,常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件

字节面试 | 如何测试RocketMQ、RocketMQ?

字节面试:RocketMQ是怎么测试的呢? 答: 首先保证消息的消费正确、设计逆向用例,在验证消息内容为空等情况时的消费正确性; 推送大批量MQ,通过Admin控制台查看MQ消费的情况,是否出现消费假死、TPS是否正常等等问题。(上述都是临场发挥,但是RocketMQ真正的测试点,还真的需要探讨) 01 先了解RocketMQ 作为测试也是要简单了解RocketMQ。简单来说,就是一个分

使用opencv优化图片(画面变清晰)

文章目录 需求影响照片清晰度的因素 实现降噪测试代码 锐化空间锐化Unsharp Masking频率域锐化对比测试 对比度增强常用算法对比测试 需求 对图像进行优化,使其看起来更清晰,同时保持尺寸不变,通常涉及到图像处理技术如锐化、降噪、对比度增强等 影响照片清晰度的因素 影响照片清晰度的因素有很多,主要可以从以下几个方面来分析 1. 拍摄设备 相机传感器:相机传

综合安防管理平台LntonAIServer视频监控汇聚抖动检测算法优势

LntonAIServer视频质量诊断功能中的抖动检测是一个专门针对视频稳定性进行分析的功能。抖动通常是指视频帧之间的不必要运动,这种运动可能是由于摄像机的移动、传输中的错误或编解码问题导致的。抖动检测对于确保视频内容的平滑性和观看体验至关重要。 优势 1. 提高图像质量 - 清晰度提升:减少抖动,提高图像的清晰度和细节表现力,使得监控画面更加真实可信。 - 细节增强:在低光条件下,抖

pdfmake生成pdf的使用

实际项目中有时会有根据填写的表单数据或者其他格式的数据,将数据自动填充到pdf文件中根据固定模板生成pdf文件的需求 文章目录 利用pdfmake生成pdf文件1.下载安装pdfmake第三方包2.封装生成pdf文件的共用配置3.生成pdf文件的文件模板内容4.调用方法生成pdf 利用pdfmake生成pdf文件 1.下载安装pdfmake第三方包 npm i pdfma