学会充分利用Python中的日志，提升你的编程level

时间：2022-10-11 09:10:58

 为什么使用日志而不使用print()

学会充分利用Python中的日志，提升你的编程level

日志记录对于程序员来说是一个非常重要的功能。对于调试和显示运行时信息，日志记录同样有用。在本文中，我将介绍为什么以及如何在程序中使用python的日志模块。

打印语句和日志输出之间有一个关键的区别。通常，打印语句写到标准输出(stdout)，期望它是有用的信息或程序的输出。但是，日志被写入标准错误(stderr)。我们可以如下演示这个场景。

  1. import logging 
  2. logging.basicConfig(level=logging.INFO) #We'll talk about this soon! 
  3. logging.warning('Something bad could happen!') 
  4. logging.info('You are running the program') 
  5. logging.error('Aw snap! Everything failed.') 
  6. print("This is the program output") 

现在，如果我运行这个程序，我将在命令行中看到以下内容。

  1. $ python log_test.py 
  2. WARNING:root:Something bad could happen! 
  3. INFO:root:You are running the program 
  4. ERROR:root:Aw snap! Everything failed. 
  5. This is the program output 

然而，对于普通用户来说，这些信息太多了。尽管这实际上是在命令行中一起显示的，但数据被写入两个单独的流中。因此，典型的用户应该执行以下操作。

  1. $ python log_test.py > program_output.txt 
  2. WARNING:root:Something bad could happen! 
  3. INFO:root:You are running the program 
  4. ERROR:root:Aw snap! Everything failed. 
  5. $ cat program_output.txt 
  6. This is the program output 

在这里，通过重定向>，将有用的程序输出写入一个文件。这样我们就可以看到终端上发生了什么，并方便地在文件中获得输出。现在让我们尝试理解日志级别!

日志和日志级别

日志记录可能由于不同的原因而发生。这些原因分为以下严重程度。

  • 调试:为开发人员调试信息，如计算值、估计参数、url、API调用等。
  • 信息:信息，没什么严重的。
  • 警告:对用户的输入、参数等的警告。
  • 错误:报告由用户在程序中所做的事情或发生的事情引起的错误。
  • CRITICAL:最高优先级的日志输出。用于关键问题(取决于用例)。

最常见的日志类型有DEBUG、INFO和ERROR。但是，很容易出现python抛出版本不匹配警告的情况。

配置记录器和日志处理程序

记录器可以在不同的参数下配置。日志记录器可以配置为遵循特定的日志级别、文件名、文件模式和打印日志输出的格式。

配置日志采集器参数

日志记录器可以进行如下配置。

  1. import logging 
  2.  
  3. logging.basicConfig(filename='program.log', filemode='w', level=logging.DEBUG) 
  4. logging.warning('You are given a warning!') 

上面的设置要求记录器将日志输出到名为program.log的文件中。filemode= ' w '定义了写入文件的性质。例如，'w'打开一个新文件，覆盖在那里的任何东西。默认情况下，这个参数是'a'，它将以附加模式打开日志文件。有时，拥有一个日志历史记录是很有用的。level参数定义日志记录的最低级别。例如，如果将其设置为INFO，则不会打印调试日志。您可能见过，程序需要以inverbose=debug模式运行才能查看一些参数。默认级别为INFO。

创建日志处理程序

尽管上面的方法对于一个简单的应用程序来说很简单，但是对于生产就绪的软件或服务，我们需要一个全面的日志记录过程。这是因为很难在数百万的调试日志中找到特定的错误日志。此外，我们需要在整个程序和模块中使用单个日志记录器。这样我们就可以正确地将日志追加到同一个文件中。为此，我们可以为该任务使用具有不同配置的处理程序。

  1. import logging 
  2. logger = logging.getLogger("My Logger") 
  3. logger.setLevel(logging.DEBUG) 
  4. console_handler = logging.StreamHandler() 
  5. file_handler = logging.FileHandler('file.log', mode='w') 
  6. console_handler.setLevel(logging.INFO) 
  7. file_handler.setLevel(logging.DEBUG) 
  8. logger.addHandler(console_handler) 
  9. logger.addHandler(file_handler) 

您可以看到，我们首先得到一个传递名称的记录器。这使我们能够在程序的其他地方重用相同的日志程序。我们将全局日志记录级别设置为DEBUG。这是最低的日志级别，因此允许我们在其他处理程序中使用任何日志级别。

接下来，我们为控制台和文件编写创建两个处理程序。对于每个处理器，我们都提供了一个日志级别。这有助于减少控制台输出的开销，并将它们传输到文件处理程序。使以后处理调试变得容易。

格式化日志输出

日志不仅仅是打印我们自己的消息。有时我们需要打印其他信息，比如时间、日志级别和进程id。对于这个任务，我们可以使用日志格式。让我们看看下面的代码。

  1. console_format = logging.Formatter('%(name)s - %(levelname)s - %(message)s') 
  2. file_format = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') 
  3. console_handler.setFormatter(console_format) 
  4. file_handler.setFormatter(file_format) 

在向记录器添加处理程序之前，我们可以如上所述对日志输出进行格式化。还有更多的参数可以用于此。你可以在这里找到它们。

重用代码

下面是一个日志代码片段，我将继续在我的许多应用程序中使用它。我想这对作为读者的你可能有用。

  1. import logging 
  2.  
  3. logger = logging.getLogger('Program Name-Version') 
  4. logger.setLevel(logging.DEBUG) 
  5.  
  6. formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s') 
  7.  
  8. consoleHeader = logging.StreamHandler() 
  9. consoleHeader.setFormatter(formatter) 
  10. consoleHeader.setLevel(logging.INFO) 
  11.  
  12. fileHandler = logging.FileHandler(f"{output}/metabcc-lr.log") 
  13. fileHandler.setLevel(logging.DEBUG) 
  14. fileHandler.setFormatter(formatter) 
  15.  
  16. logger.addHandler(fileHandler) 
  17. logger.addHandler(consoleHeader) 

原文地址：https://mp.weixin.qq.com/s?__biz=MzI3NDk3MDgxMA==&mid=2247486705&idx=1&sn=737fddcf1d31eb6651305ea618c445cd&chksm=eb0aad24dc7d243293fcc382027e211521e99a9c86b7409de122e41b271d390a4d025aafabdb&mpshare=1&

标签：

相关文章