错误日志记录

Pingora 库设计时已考虑到网络中的常见问题,例如断开连接、超时和无效输入。记录这些问题的常见方式是将其输出到错误日志(STDERR 或日志文件)。

日志级别指南

Pingora 借鉴了 log 的设计理念,提供了五种日志级别:

  • error(错误): 当错误导致请求无法正确处理时使用此级别。例如,尝试连接的服务器离线。
  • warning(警告): 当发生错误但系统能够恢复时使用此级别。例如,主 DNS 超时但系统成功查询了备用 DNS。
  • info(信息): 用于记录服务器启动或关闭的事件。
  • debug(调试): 内部详细信息。在 release 版本中不会编译此日志级别。
  • trace(跟踪): 更细粒度的内部详细信息。同样,此日志级别在 release 版本中不会编译。

pingora-proxy crate 提供了一个定义良好的接口,用于记录错误,用户无需手动记录常见的代理错误。详情请参阅其指南。