1. 前言
尽管Airtest脚本运行过程中会输出非常丰富的log信息，并且Airtest报告也会把我们脚本的的运行步骤显示出来，但有时候，我们会需要在脚本里面，插入一些自定义的log内容（比如某些关键点），并且显示在Airtest报告中。
这里就要用到Airtest提供的 log() 接口了。
2. log接口的用法
我们建议大家使用最新版本的Airtest来体验这个 log() 接口，该接口支持传入字符串、非字符串和 traceback 对象：
1）记录一条简单的log
我们可以给 log() 接口传入1个字符串，来非常便捷接插入一条简单的log记录：
log("插入一条log记录") 复制代码
运行后，我们不仅可以在log查看窗的log日志中看到我们插入的log记录：
[16:02:07][INFO]<airtest.core.api> 插入一条log记录 复制代码
还可以在生成的Airtest报告中查看到这条log记录：
2）记录一条报错log
如果我们给log接口传入的是 traceback 对象，将会自动在报告中标记为报错步骤：
try: 1/0 except Exception as e: log(e) 复制代码
运行后，我们可以在log日志中看到1条报错的log：
[16:13:55][ERROR]<airtest.core.api> Traceback (most recent call last): File "D:\demo\test02.air\test02.py", line 10, in <module> 1/0 ZeroDivisionError: division by zero 复制代码
Airtest报告也会显示这个 traceback 的log，并且标记为错误步骤：
3）记录一条非字符串的log
上述2种log，已经可以满足我们大部分的log需求了，但是有时候，我们可能会有一些复杂log记录需求，比如 dict、list 这些，所以Airtest的 log() 接口也有支持传入非字符串的内容：
data = {"test": 123, "time": 123456} log(data,desc="记录1条复杂的log") 复制代码
在log日志中也会显示成一条 [info] 日志：
[16:22:27][INFO]<airtest.core.api> {'test': 123, 'time': 123456} 复制代码
同时，Airtest报告也能看到这条复杂log的标题和详细内容：
4）自定义当前log的时间戳
另外， log 接口还支持非常丰富的参数，比如自定义时间戳 timestamp ：
# 该条log的时间被定义为当前时间 log("自定义log的时间戳", timestamp=time.time()) # 该条log的时间被定义为5秒之前 t1 = time.time() time.sleep(5) log("自定义log的时间戳", timestamp=t1) 复制代码
5）自定义当前log的标题
如果是插入1条简单的字符串log，默认会取该字符串作为log的标题显示在报告步骤上；但我们也可以通过 desc 参数，来自定义一些复杂log的标题，像示例3）那样，就有自定义log的标题。
当然，这对传入普通字符串的log也是同样适用的：
log("123",desc="这是1条log") 复制代码
6）给当前log截取屏幕图像
有一些情况下，插入一些关键的log还不足以让我们去看到更多的信息，所以我们支持在保存log的同时，截取当前的屏幕画面，去获取更多的测试信息：
log("截图log",snapshot=True) 复制代码
3. 拓展-如何过滤大量的log日志
那其实在Airtest的log日志这块，同学们除了希望自定义log之外，还有一点是希望过滤掉一些不关注的log信息，比如，大部分同学可能只关注跑测过程的报错信息，而我们的Airtest脚本跑测过程，会输出大量的log信息：
但其实我们更关注报错信息，类似：
这个时候可以通过下述方式，来帮助我们过滤掉一些我们不关注的信息：
# -*- encoding=utf8 -*- __author__ = "user" import logging logger = logging.getLogger("airtest") logger.setLevel(logging.ERROR) from airtest.core.api import * auto_setup(__file__) 复制代码
这样只有在运行脚本的开头，会输出少量的log信息，后续都是同学们最关注的的ERROR信息了：
4. 小结
那今天我们介绍了增加自定义log的接口，以及如何过滤Airtest大量log里面我们不关注的部分，后续我们还会持续跟大家分享下，如何把log内容保存在文件中。
