Scrapy - 日志记录
描述
日志记录 表示跟踪事件,它使用内置日志记录系统并定义函数和类来实现应用程序和库。日志记录是一种现成的材料,可以与日志记录设置中列出的 Scrapy 设置一起使用。
Scrapy 将设置一些默认设置,并在运行命令时借助 scrapy.utils.log.configure_logging() 处理这些设置。
日志级别
在 Python 中,日志消息有五种不同的严重性级别。以下列表按升序显示标准日志消息 −
logging.DEBUG − 用于调试消息(最低严重性)
logging.INFO −用于信息性消息
logging.WARNING − 用于警告消息
logging.ERROR − 用于常规错误
logging.CRITICAL −对于严重错误(最高严重性)
如何记录消息
以下代码显示使用 logging.info 级别记录消息。
import logs logging.info("This is an information")
上述日志消息可以使用 logging.log 作为参数传递,如下所示 −
import logs logging.log(logging.INFO, "This is an information")
现在,您还可以使用记录器将消息封装起来,使用日志帮助程序 logs 来获取清晰显示的日志消息,如下所示 −
import logs logger = logs.getLogger() logger.info("This is an information")
可以有多个记录器,可以使用 logging.getLogger 函数获取其名称来访问它们,如下所示。
import logs logger = logs.getLogger('mycustomlogger') logger.info("This is an information")
可以使用包含模块路径的 __name__ 变量为任何模块使用自定义记录器,如下所示−
import logging logger = logging.getLogger(__name__) logger.info("This is an information")
从 Spider 记录日志
每个 Spider 实例中都有一个 记录器,可以按如下方式使用 −
import scrapy class LogSpider(scrapy.Spider): name = 'logspider' start_urls = ['http://dmoz.com'] def parse(self, response): self.logger.info('Parse function called on %s', response.url)
在上面的代码中,记录器是使用 Spider 的名称创建的,但您可以使用 Python 提供的任何自定义记录器,如下面的代码所示−
import logging import scrapy logger = logging.getLogger('customizedlogger') class LogSpider(scrapy.Spider): name = 'logspider' start_urls = ['http://dmoz.com'] def parse(self, response): logger.info('Parse function called on %s', response.url)
日志配置
记录器无法显示它们自己发送的消息。因此,它们需要"处理程序"来显示这些消息,处理程序会将这些消息重定向到各自的目的地,例如文件、电子邮件和标准输出。
根据以下设置,Scrapy 将为记录器配置处理程序。
日志设置
以下设置用于配置日志 −
LOG_FILE 和 LOG_ENABLED 决定日志消息的目的地。
当您将 LOG_ENCODING 设置为 false 时,它不会显示日志输出消息。
LOG_LEVEL 将确定消息的严重性顺序;那些严重性较低的消息将被过滤掉。
LOG_FORMAT 和 LOG_DATEFORMAT 用于指定所有消息的布局。
当您将 LOG_STDOUT 设置为 true 时,您进程的所有标准输出和错误消息都将重定向到日志。
命令行选项
可以通过传递命令行参数来覆盖 Scrapy 设置,如下表所示 −
Sr.No | 命令 &描述 |
---|---|
1 | --logfile FILE 覆盖 LOG_FILE |
2 | --loglevel/-L LEVEL 覆盖 LOG_LEVEL |
3 | --nolog 将 LOG_ENABLED 设置为 False |
scrapy.utils.log 模块
此函数可用于初始化日志记录默认值Scrapy。
scrapy.utils.log.configure_logging(settings = None, install_root_handler = True)
Sr.No | 参数与说明 |
---|---|
1 | settings (dict, None) 它创建并配置根记录器的处理程序。默认情况下,它是 None。 |
2 | install_root_handler (bool) 它指定安装根日志处理程序。默认情况下,它是 True。 |
上述函数 −
- 通过 Python 标准日志记录路由警告和扭曲日志记录。
- 将 DEBUG 分配给 Scrapy 并将 ERROR 级别分配给 Twisted 记录器。
- 如果 LOG_STDOUT 设置为 true,则将 stdout 路由到日志。
可以使用 settings 参数覆盖默认选项。如果未指定设置,则使用默认值。当 install_root_handler 设置为 true 时,可以为根记录器创建处理程序。如果设置为 false,则不会设置任何日志输出。使用 Scrapy 命令时,configure_logging 将自动调用,并且可以在运行自定义脚本时明确运行。
要手动配置日志的输出,您可以使用 logging.basicConfig(),如下所示 −
import logging from scrapy.utils.log import configure_logging configure_logging(install_root_handler = False) logging.basicConfig ( filename = 'logging.txt', format = '%(levelname)s: %(your_message)s', level = logging.INFO )