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