Azure Python定时函数随机失败，如何排查日志错误？

问题场景 #

我有一个运行在Azure定时函数中的Python脚本，该脚本会随机出现失败情况。在监控选项卡中仅显示函数已失败，尝试用try-except语句记录异常但没有效果，代码如下：

import logging
try:
    # 业务逻辑代码
    ....
except Exception:
        logging.exception("Exception raised: ")

排查方案 #

• 确认try-except覆盖范围：确保try块包裹了所有可能抛出异常的代码，包括函数初始化、第三方服务调用、IO操作等。如果异常发生在try块之外（比如模块导入阶段、函数定义前），当前的捕获逻辑无法生效。

• 调整日志级别配置：Azure Functions默认日志级别可能限制了日志输出，需确保ERROR级别的日志能被正常采集。可在host.json中配置日志级别：

  {
      "logging": {
          "logLevel": {
              "default": "Error"
          }
      }
  }
  

• 使用Azure Functions内置日志对象：替换标准logging模块为Azure提供的func.logger，它能更稳定地将日志同步到Azure监控系统，修改代码如下：

  import azure.functions as func
  def main(mytimer: func.TimerRequest) -> None:
      try:
          # 业务逻辑代码
          ....
      except Exception as e:
          func.logger.exception(f"Exception raised: {str(e)}")
  

• 捕获更全面的异常类型：尝试捕获BaseException以覆盖更多异常场景，同时记录异常的类型和详细信息：

  import logging
  try:
      # 业务逻辑代码
      ....
  except BaseException as e:
          logging.exception(f"Exception details: {str(e)}, type: {type(e).__name__}")
  

• 查看详细执行日志：进入Azure门户的函数应用“日志”选项卡，切换到“跟踪日志”视图，这里能展示更完整的函数执行日志，包括未被捕获的异常信息。也可在本地环境模拟定时触发，复现异常进行调试。

内容的提问来源于stack exchange，提问作者Cai