日志功能
2023-08-31
当程序运行出现问题时，日志记录是一种非常有用的工具，它可以帮助我们追踪和定位问题。在 MicroPython 中，可以使用 log 模块来记录程序运行中的信息。本文将介绍 log 模块的使用方法和常见功能。
日志级别
log.DEBUG
常量，用来标识 LOG 等级，最详细的日志信息，通常只在开发和调试时使用。
log.INFO
常量，用来标识 LOG 等级，确认一切按预期运行。
log.WARNING
常量，用来标识 LOG 等级，表明发生了一些意外，或者指示可能出现问题的情况，但仍然可以继续执行。
log.ERROR
常量，用来标识 LOG 等级，由于更严重的问题，应用程序已不能执行某些功能。
log.CRITICAL
常量，用来标识 LOG 等级，指出应用程序中的严重错误，可能导致应用程序停止运行。
日志设置
log.basicConfig
设置日志输出级别，默认为 log.INFO，系统只会输出 level 数值大于或等于该 level 的的日志结果。
log.basicConfig(level)
参数描述：
level- 日志等级
返回值描述：
无
示例：
import log
log.basicConfig(level=log.INFO)
log.set_output
设置日志输出的位置，目前只支持 uart 和 usys.stdout
log.set_output(out)
参数描述：
out- 日志输出位置，输出到指定串口或者交互口，默认不设置为交互口输出，类型参考示例
返回值描述：
无
示例：
import log
log.basicConfig(level=log.INFO)
Testlog = log.getLogger("TestLog")
# 设置输出到debug口
from machine import UART
uart = UART(UART.UART0, 115200, 8, 0, 1, 0)
log.set_output(uart)
Testlog.info("this is a Test log") # 会输出带对应的uart口
# 从uart口切换成交互口输出
import usys
log.set_output(usys.stdout)
Testlog.info("this is a Test log") # 会输出到交互口
日志输出
log.getLogger
获取 log 对象，对象支持输出不同等级的 log 信息。
Testlog = log.getLogger(name)
参数描述：
name- 当前 log 对象的主题信息，字符串类型
返回值描述：
- log 操作句柄，也可理解成 log 对象，拥有 log 输出的方法。
log.debug
输出 DEBUG 级别的日志。
Testlog.debug(msg)
参数描述：
msg- 日志内容，字符串类型
log.info
输出 INFO 级别的日志。
Testlog.info(msg)
参数描述：
msg- 日志内容，字符串类型
log.warning
输出 WARNING 级别的日志。
Testlog.warning(msg)
参数描述：
msg- 日志内容，字符串类型
log.error
输出 ERROR 级别的日志。
Testlog.error(msg)
参数描述：
msg- 日志内容，字符串类型
log.critical
输出 CRITICAL 级别的日志。
Testlog.critical(msg)
参数描述：
msg- 日志内容，字符串类型
示例：
import log
# 设置日志输出级别
log.basicConfig(level=log.INFO)
# 获取logger对象，如果不指定name则返回root对象，多次使用相同的name调用getLogger方法返回同一个logger对象
Testlog = log.getLogger("Quec")
Testlog.error("Test error message!!")
Testlog.debug("Test debug message!!")
Testlog.critical("Test critical message!!")
Testlog.info("Test info message!!")
Testlog.warning("Test warning message!!")