From ce8d68c897495974693660fb070e66e2ebdd6646 Mon Sep 17 00:00:00 2001 From: zenfun Date: Sat, 3 Jan 2026 17:07:23 +0800 Subject: [PATCH] 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. --- .env.example | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.env.example b/.env.example index 009c96f..f1432ea 100644 --- a/.env.example +++ b/.env.example @@ -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）