OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Locate Large Memory Objects inside PHP Processes (using OpenResty XRay)

tutorial openresty-xray php memory

• Problem: high memory usage
• Use the guided analysis feature of OpenResty XRay to find the largest Perl objects or values taking the most RAM
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 7 mins read

Use C++ to Dynamic-Trace C++ Applications

stl c++ ebpf openresty-xray dynamic-tracing

• Setting Up the Target C++ Program
• Crafting the C++ (or Y++) Analyzer
• Operationalizing the Target and Analyzer
• Advancing Support for Complex C++ Applications
• About the Debug Symbols

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

Pinpointing the hottest Erlang code paths with high CPU usage (using OpenResty XRay)

tutorial openresty-xray Erlang CPU

• Problem: high CPU usage
• Spot the CPU-hottest Erlang code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

How to Trace Exceptions inside Perl Applications (using OpenResty XRay)

tutorial openresty-xray Perl Exceptions

• How to detect and analyze exceptions inside Perl applications
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Analyze OpenResty/Nginx Applications without Debug Symbols (using OpenResty XRay)

tutorial openresty-xray debug-symbol nodwarf

• Problem: Debug Symbols are missing
• Automatically Analyze and Rebuild Debug Symbols
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 7 mins read

Automatic Core Dump Analysis (using OpenResty XRay)

tutorial openresty-xray core dump dynamic tracing eBPF

• Check the core dump file
• Use the guided analysis feature of OpenResty XRay to analyze the core file
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 4 mins read

Install OpenResty XRay’s Agents on Amazon Linux via Package Bundles

tutorial openresty-xray Amazon-linux2 Agent install

• Logging in to the Console
• Installing the Agent via Bundle Packages
• Configuring and Detecting Applications
• Initiating Analyzers and Viewing Insights
• Install Another Agent
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

Pinpointing the Hottest Go Code Paths with High Disk I/O (using OpenResty XRay)

tutorial openresty-xray go golang disk I/O

• Problem: high disk I/O
• Use the guidede analysis feature of OpenResty XRay to spot the problematic Go code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

How CPU Time is Spent inside Envoy Servers (using OpenResty XRay)

tutorial openresty-xray CPU Envoy

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the most CPU-intensive C++ code paths inside Envoy Servers
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Pinpointing the hottest PHP code paths with high CPU usage (using OpenResty XRay)

tutorial openresty-xray PHP CPU

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the CPU-hottest PHP code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

How to Locate Exceptions inside Go Applications (using OpenResty XRay)

tutorial openresty-xray Go Exceptions

• How to detect and analyze exceptions inside live Go applications
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

How CPU Time is Spent inside PHP Laravel Apps (using OpenResty XRay)

tutorial openresty-xray Laravel PHP

• Problem: high CPU usage
• Use the Guidede Analysis Feature of OpenResty XRay to Analyze CPU Distribution in Laravel Application
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

Find Blocking Perl Code Paths Holding back CPU Usage (Using OpenResty XRay)

tutorial openresty-xray perl off-cpu

• Problem: low CPU usage
• Use the guided analysis feature of OpenResty XRay to spot the blocking Perl code paths
• Automatic analysis and reports
• What is OpenResty XRay
• About The Author

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 4 mins read

How to Locate Exceptions inside Rust Applications (using OpenResty XRay)

tutorial openresty-xray Rust Exceptions

• How to detect and analyze exceptions inside live Rust applications
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

Pinpointing CPU-Hottest Go Code Paths Inside Prometheus (using OpenResty XRay)

tutorial openresty-xray prometheus garbage collection go golang

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the CPU-hottest Go code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

How to Diagnose HTTP 504 Timeout Errors using OpenResty XRay

tutorial openresty-xray 504 timeout

• Problem: HTTP 504 gateway timeout errors
• Use the guidede analysis feature of OpenResty XRay to diagnose these errors
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

How CPU Time is Spent inside Go’s CockroachDB (using OpenResty XRay)

tutorial openresty-xray cpu Go CockroachDB

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the most CPU-intensive Go code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Apr 10, 2026

OpenResty XRay Updated Apr 10, 2026 5 mins read

Performance Overhead of OpenResty XRay when Tracing Perl Apps

tutorial openresty-xray perl overhead

• Process Performance Before Running Analysis
• Performance Impact When the Analyzer is Running
• Impact Measurement on Throughput and Latency
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Locate Large Memory Objects inside Perl Processes (using OpenResty XRay)

tutorial openresty-xray perl memory

• Problem: high memory usage
• Use the guided analysis feature of OpenResty XRay to find the largest Perl objects or values taking the most RAM
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Apr 10, 2026

OpenResty XRay Updated Apr 10, 2026 2 mins read

Measuring the Performance Overhead of OpenResty XRay When Profiling Go Applications

tutorial openresty-xray go overhead

• Process Performance Before Running Analysis
• Performance Impact When the Analyzer is Running
• Impact Measurement on Throughput and Latency
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Install OpenResty XRay’s Agents on Ubuntu via Deb Packages

tutorial openresty-xray Ubuntu Agent install

• Logging in to the Console
• Installing the Agent via Deb Packages
• Checking the Agent Status and Logs
• Configuring and Detecting Applications
• Initiating Analyzers and Viewing Insights
• Install Another Agent
• What is OpenResty XRay

OpenResty XRay Apr 10, 2026

OpenResty XRay Updated Apr 10, 2026 2 mins read

Performance Impact of OpenResty XRay when Tracing PHP Apps

tutorial openresty-xray php overhead

• Process Performance Before Running Analysis
• Performance Impact When the Analyzer is Running
• Impact Measurement on Throughput and Latency
• What is OpenResty XRay

OpenResty XRay Apr 10, 2026

OpenResty XRay Updated Apr 10, 2026 2 mins read

Performance Impact of OpenResty XRay when Tracing Python Apps

tutorial openresty-xray python overhead

• Process Performance Before Running Analysis
• Performance Impact When the Analyzer is Running
• Impact Measurement on Throughput and Latency
• What is OpenResty XRay

OpenResty XRay Apr 10, 2026

OpenResty XRay Updated Apr 10, 2026 3 mins read

Tested in Production: The Performance Impact of OpenResty XRay When Tracing Rust Applications

tutorial openresty-xray rust overhead

• Process Performance Before Running Analysis
• Performance Impact When the Analyzer is Running
• Impact Measurement on Throughput and Latency
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 4 mins read

Dynamic-Tracing Custom Go Programs with Custom Ylang Analyzers (using OpenResty XRay)

tutorial openresty-xray ylang analyzer Go

• Insert two key-value Pairs into a Go Variable
• Write a Customize Ylang Analyzer to Dynamically Trace the Go program
• Test the Results
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

How Python Django's Application Uses Memory Internally (Using OpenResty XRay)

tutorial openresty-xray python memory django

• Problem: high memory usage
• Use the guidede analysis feature of OpenResty XRay to analyze the django application
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 4 mins read

Install OpenResty XRay’s Agents on CentOS via RPM Packages

tutorial openresty-xray CentOS Agent install

• Logging in to the Console
• Installing the Agent via RPM Packages
• Checking the Agent Status and Logs
• Configuring and Detecting Applications
• Initiating Analyzers and Viewing Insights
• Install Another Agent
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Find the largest Python objects or values taking the most RAM (using OpenResty XRay)

tutorial openresty-xray python memory

• Problem: high memory usage
• Use the guided analysis feature of OpenResty XRay to find the largest Python objects or values taking the most RAM
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

How CPU time is spent inside Rust’s Sled library (using OpenResty XRay)

tutorial openresty-xray cpu Sled Rust

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the most CPU-intensive Rust code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

How CPU time is spent inside Go's etcd server (using OpenResty XRay)

tutorial openresty-xray go cpu etcd

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the hottest Go code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

How CPU time is spent inside llama.cpp + LLaMA2 (using OpenResty XRay)

tutorial openresty-xray LLM cpu generative-AI llama2 llama.cpp profiling AI

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the hottest C++ code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Find Blocking Go Code Paths Holding back CPU Usage (Using OpenResty XRay)

tutorial openresty-xray go cpu

• Problem: low CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the blocking Go code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Pinpointing the hottest Go code paths with high CPU usage (using OpenResty XRay)

tutorial openresty-xray go cpu

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the hottest Go code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Pinpointing the blocking Python code paths (using OpenResty XRay)

tutorial openresty-xray python off-cpu

• Problem: low CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the blocking Python code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Two bugs in Linux kernels' tracing subsystem (found by OpenResty XRay)

openresty-xray dynamic-tracing linux-kernel bugs

• Kernel deadlocks in user-space memory reading
• Data races in x86 breakpoint insertion of the kernel
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Pinpointing hottest Perl code paths (using OpenResty XRay)

tutorial openresty-xray perl cpu

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the hottest Perl code paths
• Automatic analysis and reports
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 5 mins read

Pinpointing hottest Lua code paths in online OpenResty/Nginx servers (using OpenResty XRay)

tutorial openresty-xray lua cpu

• Problem: high CPU usage
• Use the guidede analysis feature of OpenResty XRay to spot the hottest Lua code paths
• Automatic analysis and reports

OpenResty XRay Apr 6, 2026

OpenResty XRay Updated Apr 6, 2026 5 mins read

How we solved a CPU bottleneck caused by Lua exceptions in a custom Kong plugin (using OpenResty XRay)

openresty-xray exceptions lua kong nginx cpu

• The problem: high CPU usage in Kong servers
• The analysis & report
• The result: improved performance and reduced CPU usage

OpenResty XRay Apr 6, 2026

OpenResty XRay Updated Apr 6, 2026 7 mins read

Memory and CPU usage statistics among Kong plugins online (using OpenResty XRay)

openresty-xray kong nginx lua memory cpu

• CPU usage among all Kong plugins in a server process
• Memory usage among all Kong plugins in a server process
• Extra overhead for the servers

OpenResty XRay Apr 6, 2026

OpenResty XRay Updated Apr 6, 2026 5 mins read

Troubleshooting the extra 200-ms request latency online

openresty-xray latency network smarkt-packet-capture nginx

• The Problem
• The Analsysis Process
• Fully-automated analysis
• What is OpenResty XRay

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

Pinpointing leaked Lua tables with OpenResty XRay's command-line tools

openresty memory-leak openresty-xray case-study

• How LuaJIT manages memory
• OpenResty XRay’s command-line tools
• An leaking example
• Analysis procedure
• lj-gco-ref analyzer
• Fully-automated analysis

OpenResty XRay Apr 6, 2026

OpenResty XRay Updated Apr 6, 2026 8 mins read

Real-Time Request Counting against Nginx Processes via YSQL

openresty-xray ysql nginx

• How to install the run-ysql tool
• Count total requests served in real time
• Filter out specific requests
• Using YSQL in the Web Console
• True non-invasive tracing

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 6 mins read

How to deploy the on-premises version of OpenResty XRay on Microsoft's Azure cloud

tutorial openresty-xray azure

• Create a subscription and a resource group
• Create the Azure Kubernetes service
• Prepare the environment variables
• Log in to Azure from the command line
• Create the namespace and secret for Kubernetes
• Create the Azure Disk
• Update the configuration file for the persistent volume
• Update the Kubernetes configuration file
• Create the persistent volume
• Deploy the Kubernetes service
• Configure the application gateway

OpenResty XRay Apr 6, 2026

OpenResty XRay Updated Apr 6, 2026 6 mins read

When Lua IPC Pipes Block OpenResty or Nginx's Event Loops

openresty-xray nginx lua off-cpu

• The Problem
• Analyses
• Solutions
• Results

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 26 mins read

The Wonderland of Dynamic Tracing (Part 1 of 3)

dynamic-tracing openresty-xray

• Dynamic Tracing
• What It Is
• Too Good to be True?
• How it Works
• Still Having Doubts?
• The Advantages of Dynamic Tracing
• DTrace
• SystemTap
• DTrace and SystemTap
• Applications of SystemTap in Production

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 15 mins read

The Wonderland of Dynamic Tracing (Part 2 of 3)

dynamic-tracing openresty-xray

• Flame Graphs
• Methodology
• Knowledge Is Power
• Open-Source and Debug Symbols

OpenResty XRay Jun 17, 2025

OpenResty XRay Updated Jun 17, 2025 7 mins read

The Wonderland of Dynamic Tracing (Part 3 of 3)

dynamic-tracing openresty-xray

• Dynamic Tracing Support in Linux Kernels
• Hardware Tracing
• Analyze Remains of Dead Process
• Traditional Debugging Technologies
• A Messy World of Debugging
• OpenResty XRay

OpenResty XRay Apr 6, 2026

OpenResty XRay Updated Apr 6, 2026 8 mins read

Optimize Memory Fragmentation due to Huge Nginx Configuration

openresty-xray reports cdn nginx memory-fragmentation

• Challenges
• Analyses
• Solutions
• Results

OpenResty XRay Feb 7, 2023

OpenResty XRay Updated Feb 7, 2023 1 min read

New FAQ Doc for OpenResty XRay

openresty-xray faq

We recently prepared a new FAQ document for OpenResty XRay

OpenResty XRay Aug 28, 2023

OpenResty XRay Updated Aug 28, 2023 10 mins read

Automatic Analysis Reports in OpenResty XRay

openresty-xray reports

• The Past
• The Present
• The Future