分布式组件：入口网关功能

Author: PegasusWang

debug/index.rst

@@ -165,7 +165,8 @@ RPC/Web 框架
 
 日志错误
 ~~~~~~~~~~~~~~~~~~~~~~
-- 日志级别错误。线上使用了 debug 级别，可能导致磁盘被日志打满，如果没有滚动日志可能会导致服务器磁盘打满。一定要注意不同环境日志级别，推荐集中式日志收集系统。遇到过几次对方服务把日志打满服务不可用的情况
+- 日志级别错误。线上使用了 debug 级别，可能会产生大量日志，如果没有滚动日志可能会导致服务器磁盘打满。一定要注意不同环境日志级别，推荐集中式日志收集系统。
+  线上应该只打印重要的 info 和 error 级别日志，或者不重要的日志也可以使用一定采样率打印。遇到过几次对方服务把日志打满服务不可用的情况
 - 日志参数错误。日志语句对应的占位符要和传参的个数一致，类型要匹配，比如本来是数字的使用了 `"%s"` 而不是 `"%d"`
 - 缺少必要信息。如果是为了 debug 加上的日志一定要有足够的上下文信息、关键参数帮助排查问题，同时也要注意日志不要泄露敏感数据（比如密码等）
 - 日志过大：除了注意日志等级，还要注意是否输出了过大的日志导致磁盘 IO 飙升，适当精简日志量，或者提升线上日志等级只打印异常和ERROR。线上一定要关闭 DEBUG 日志

microservice_distribute/library.rst

@@ -86,6 +86,15 @@ RPC
 
 微服务网关
 ----------------------
+入口网关的功能：
+
+- 协议转换。为客户端提供统一的接入地址和协议，屏蔽掉后端服务不同的协议细节
+- 植入服务熔断、服务降级、流量控制、分流控制等服务治理相关的策略
+- 认证和授权。统一处理不同端的认证和授权，为后端服务屏蔽掉认证细节
+- 黑白名单限制
+
+常见组件：
+
 - Nginx
 - Netflix Zuul
 - Kong