upstream_show
`upstream_show` 指令显示指定 upstream 块的当前配置。
NGINX module for syncing upstreams from consul or etcd
·
location
语法upstream_show;
默认值none
上下文location
参数none
说明
upstream_show 指令用于 NGINX 配置中的 location 块上下文中,尤其是在使用用于从 Consul 或 etcd 同步 upstream 的 NGINX 模块时。启用该指令后,它会输出已定义并从指定配置服务(如 Consul 或 etcd)同步的 upstream 服务器的配置详细信息。这对于调试和验证 upstream 的当前状态非常有用,无需重新加载配置或重启 NGINX 服务器。显示内容可以包括服务器权重、健康状态和连接状态,从而提供有关负载均衡配置以及后端服务潜在问题的见解。
upstream_show 指令的行为依赖于其读取并报告先前指令定义的现有 upstream 服务器配置的能力,主要是通过 upsync 指令配置的那些。通过在一个 location 中追加该指令,管理员可以在应用中拥有一个端点,当访问该端点时,会返回 upstream 服务器的当前状态,从而帮助快速诊断与服务相关的问题,而无需中断服务。由于它不需要任何参数或其他附加项,因此简化了在配置文件中的使用。
配置示例
location = /upstream_show {
upstream_show;
}⚠
确保 upstream_show 指令只在有效的 location 上下文中指定;否则,会导致配置错误。
⚠
不要期望 upstream_show 会修改任何上游配置,因为它仅用于显示当前状态。