14、NGINX调试、故障排除与性能调优指南

NGINX调试、故障排除与性能调优指南

1. 日志与追踪基础

在使用NGINX时，日志是理解应用程序运行状况的基础。NGINX为用户提供了强大的日志控制能力，可针对不同场景配置访问日志和错误日志，还能通过Syslog协议将日志转发到集中式服务器。此外，NGINX支持请求追踪，利用请求标识符实现端到端的请求跟踪。

1.1 OpenTelemetry与追踪配置

OpenTelemetry是用于生成和收集遥测数据的工具集，能与Jaeger和Prometheus等系统集成，为工程师提供精确的可观测性。在NGINX中，通过配置 otel_trace 和 otel_trace_context 指令实现请求追踪。以下是一个示例配置：

# above cases enable it
map "$trace_switch:$ratio_sampler" $request_otel {
  off:off  off;
  on:on     on;
  on:off    on;
  off:on    on;
}
server {
  location / {
    otel_trace $request_otel;
    otel_trace_context propagate;
    proxy_pass http://backend;
  }
  location /api {
    api write=on;
  }
}

在这个配置中， otel_trace_context 指令的 <