We recently announced the release of OpenResty XRay 25.10.11. This update brings a host of significant improvements and fixes.

Three Key Highlights

1. Significantly Expanded System Compatibility, now fully supporting CentOS 10, RockyLinux 10, AlmaLinux 10, Flatcar, and Linux kernel 6.6 and later versions.
2. New Professional Analysis Tools Introduced, including the ngx-brotli-* and ngx-zstd-* series for Brotli/Zstd compression analysis, nodejs-ftrace for Node.js function call tracing, and get-dlopen-libs for detecting dynamically loaded libraries.
3. Enhanced Core Diagnostic Capabilities and Stability, with added support for retrieving Lua call stacks in Redis 7/8, optimized container identification, and critical fixes for issues such as multi-process tool reusability and cgroup v2 CPU limit failures.

Enhanced Diagnostic Accuracy and Stability

• Resolved an issue where lj-c-on-cpu and lj-c-off-cpu failed to correctly capture the C call stack for LuaJIT programs. This ensures stable acquisition of C-language components within mixed call stacks when analyzing LuaJIT FFI calls in scenarios like OpenResty, effectively revealing cross-language performance bottlenecks.

• Fixed the problem of incomplete call stack capture for programs compiled with -fno-omit-frame-pointer. This improves compatibility with standard compilation options. Now, even when programs are compiled in debug-friendly modes that do not omit frame pointers, a complete and accurate function call stack is provided, preventing information loss.

• Introduced additional filtering parameters to mitigate incorrect process matching in exe mode. In high-density deployment environments or where multiple processes share the same name, this provides more precise filtering, ensuring the analysis tool accurately targets the intended processes, thereby preventing misidentification and improving diagnostic accuracy.

• Addressed a range of underlying issues, including opslang script timeouts and dwz file collection failures. This significantly bolsters the stability of the dynamic tracing engine, reducing the likelihood of analysis failures in extreme or edge cases (e.g., rapid command execution, compressed symbol files), leading to a smoother and more reliable diagnostic process.

Usability and Security Enhancements

• The SSH key pair for self-managed deployments is now generated at startup instead of being pre-generated. Adhering to the “security by default” principle, this change eliminates the risk of all self-managed instances sharing the same default key, significantly boosting the security of your on-premise deployment environment without requiring additional configuration.

• When uploading software packages, you can now search for operating systems by keyword input and receive alerts for abnormally sized packages. This streamlines the management process for offline analysis or Agent packages. The search functionality accelerates the identification of the correct OS, while size alerts effectively prevent time wasted due to uploading incorrect or corrupted software packages, thereby improving daily operational efficiency.

Beyond these highlights, this update also includes a series of important improvements focused on diagnostic accuracy, ease of use, and security, all designed to enhance your daily analysis experience. Click here to view the full release notes

How to Upgrade?

• Cloud Customers: As our cloud subscription customers, you will automatically gain access to the new version without any further action. The update is complete, and you can log in to the OpenResty XRay console at any time to utilize the new features and services.
• Self-Managed Customers: Please contact us to arrange your upgrade. Our experts will initiate the upgrade process and assist you in a smooth transition.

OpenResty is committed to providing the highest quality cloud service experience for our subscribers. We firmly believe that this update will significantly enhance user experience and service quality. If you have any questions, please feel free to contact us: support@openresty.com

What is OpenResty XRay

OpenResty XRay is a dynamic-tracing product that automatically analyzes your running applications to troubleshoot performance problems, behavioral issues, and security vulnerabilities with actionable suggestions. Under the hood, OpenResty XRay is powered by our Y language targeting various runtimes like Stap+, eBPF+, GDB, and ODB, depending on the contexts.