少于1分钟 | 最后修改: 0001-01-01, 0:00:00 am

Analyzer ngx-status-code-fgraph

Name

ngx-status-code-fgraph - Nginx Request Status Code Flame Graph

This analyzer profiles HTTP requests that result in specific status codes within Nginx-based applications including OpenResty, Kong, and APISIX. It captures C-level stack traces for requests matching the specified status code criteria (default: status >= 400), generating flame graphs that visualize the execution paths leading to error responses. The analyzer is essential for troubleshooting HTTP errors, identifying root causes of failed requests, and understanding the code paths that generate specific status codes.

Resource Category

Network I/O.

Application Type & Technical Stack

  • OpenResty
  • Nginx
  • Kong
  • APISIX

Command Line Syntax

The analyzer can be invoked directly on the command-line via the orxray utility from the openresty-xray-cli software package.

Alternatively, the analyzer can also be invoked manually or automatically on the web console UI of OpenResty XRay (like on the Advanced web page).

# PID is the target process PID.
orxray analyzer run ngx-status-code-fgraph -p PID

# trace a shell command directly
orxray analyzer run ngx-status-code-fgraph -c SHELL_CMD

# PGID is the process group ID or any process's PID within the target process
# group.
orxray analyzer run ngx-status-code-fgraph -p -PGID

# trace any processes started from the specified executable path.
orxray analyzer run ngx-status-code-fgraph --exe /path/to/exe/file

Tracing Multiple Processes

Supported.

Output Formats

  • Flame Graphs

Author

The OpenResty Inc. Team.

Copyright (C) by OpenResty Inc. All rights reserved.