Skip to content

引擎环境变量

矩尺引擎支持通过 /opt/normae/images/.env 文件配置环境变量,用于控制调试日志和监控上报行为。修改后需重启引擎容器生效。

配置项

环境变量类型默认值说明
LOG_FILE_ENABLEbooleanfalse是否启用调试日志。设为 true 时,引擎会输出详细的 Lua 执行日志到 slb_error.log(如 browser_compliance、http_balance_phase 等),用于问题排查。设为 false 时,仅记录 WARN/ERROR 级别日志,INFO/DEBUG 级别日志不再输出,同时不写入日志文件
DISABLE_MONITORbooleanfalse是否禁用监控数据上报。设为 true 时,引擎停止向 Prometheus 上报并发连接数、请求速率等监控指标。适用于调试环境或需要减少监控开销的场景

配置示例

bash
# /opt/normae/images/.env
LOG_FILE_ENABLE=true
DISABLE_MONITOR=true

使用场景

  • 故障排查:将 LOG_FILE_ENABLE=true,重启引擎后复现问题,查看 /var/log/normae/slb_error.log 获取详细日志
  • 性能调优:在高流量环境下将 LOG_FILE_ENABLE=false(默认),减少日志 I/O 开销
  • 监控调试:将 DISABLE_MONITOR=true 暂时关闭监控上报,避免调试流量污染监控数据