错误日志记录
Pingora 库设计时已考虑到网络中的常见问题,例如断开连接、超时和无效输入。记录这些问题的常见方式是将其输出到错误日志(STDERR 或日志文件)。
日志级别指南
Pingora 借鉴了 log 的设计理念,提供了五种日志级别:
error
(错误): 当错误导致请求无法正确处理时使用此级别。例如,尝试连接的服务器离线。warning
(警告): 当发生错误但系统能够恢复时使用此级别。例如,主 DNS 超时但系统成功查询了备用 DNS。info
(信息): 用于记录服务器启动或关闭的事件。debug
(调试): 内部详细信息。在release
版本中不会编译此日志级别。trace
(跟踪): 更细粒度的内部详细信息。同样,此日志级别在release
版本中不会编译。
pingora-proxy
crate 提供了一个定义良好的接口,用于记录错误,用户无需手动记录常见的代理错误。详情请参阅其指南。