docs(config): add details for balancer log and stats

Add explanatory comments for EZ_BALANCER_LOG_SINK_ENABLED and
EZ_BALANCER_STATS_FLUSH_ENABLED to clarify default behavior and
production recommendations regarding monitoring and quota management.
This commit is contained in:
zenfun
2026-01-03 17:07:23 +08:00
parent 776eb98ebd
commit ce8d68c897

View File

@@ -110,6 +110,8 @@ EZ_BALANCER_TRUSTED_PROXIES=
# ------------------------------------------------------------------------------
# 是否启用日志上报
# 默认关闭Balancer 设计为无状态代理,可独立运行;启用后会将请求日志 HTTP 回写到 ez-api
# 生产环境建议启用,以便在 Control Plane 统一查看请求日志和用量统计
EZ_BALANCER_LOG_SINK_ENABLED=false
# 日志上报目标地址ez-api
@@ -123,6 +125,8 @@ EZ_BALANCER_LOG_SINK_TIMEOUT_SECONDS=3
# ------------------------------------------------------------------------------
# 是否启用实时计数回写
# 默认关闭:启用后 Balancer 会定期将 Token/Master 用量统计回写到 ez-api 数据库
# 生产环境建议启用,以便支持配额管理和用量报表
EZ_BALANCER_STATS_FLUSH_ENABLED=false
# 计数回写目标地址ez-api