echo_status

`echo_status` 指令在 NGINX 中输出请求处理的当前状态。

语法echo_status;
默认值none
上下文location, if in location
参数1

说明

echo_status 指令是 NGINX Echo 模块的一个组件,允许开发者在处理请求时输出调试和处理状态信息。被调用时,它会将请求的当前状态(包括各种延迟指标和状态信息)直接发送到客户端。这在应用开发、测试或在需要调试的生产环境中用于监控和诊断时尤其有用。

该指令可以放置在 location 块内,或在 location 中的 if 语句中有条件地使用,从而在状态更新的通信方式和时机上提供灵活性。虽然它只有一个参数,但该指令的主要功能是透明地输出状态,而不影响应用的主流程。由于它处理的是 NGINX 的请求处理的内部状态,所提供的值可以洞察性能和请求处理低效之处。

需要注意的是,在生产环境中大量使用该指令可能会导致日志输出增加,在高负载情况下可能会略微影响性能。

配置示例

location /status {
    echo_status;
}

echo_status 放在错误的上下文(例如,位于 location 之外)会导致配置错误。

在生产环境中大量使用此指令可能会导致冗长的日志记录,从而影响性能。

← 返回所有指令