The openresty-systemtap-toolkit is a collection of SystemTap-based scripts designed for real-time analysis and diagnostics of OpenResty and its core components, including NGINX, LuaJIT, and ngx_lua. It provides developers and system administrators with tools to trace performance bottlenecks, memory usage, request distribution, regex execution, Lua execution, and file I/O behaviors in production systems. The toolkit helps identify leaks, analyze TCP queues, inspect shared memory usage, and generate flame graphs for CPU and off-CPU profiling. Many scripts are specific to NGINX worker and master processes, while others are generic enough to be applied to any Linux user-space process. Although the toolkit is no longer actively maintained—development has shifted to OpenResty XRay—it remains a valuable set of examples and utilities for advanced users of OpenResty and NGINX.
Features
- Real-time tracing of NGINX requests, memory pools, and shared memory usage
- Tools for analyzing regex performance, PCRE JIT usage, and execution stats
- Sampling utilities for user-space and kernel-space backtraces with flame graph support
- Lua-specific backtrace and connection pool analysis for ngx_lua and LuaJIT processes
- TCP queue analysis tools for SYN, ACK, and receive queue performance
- General-purpose SystemTap scripts for file I/O, latency, and debug info inspection
Project Samples
