Analyzer lua-gco-ref

Name

lua-gco-ref - GC Object Reference Flame Graph for Stand Lua

This analyzer profiles garbage collection object references in standard Lua applications and Redis with Lua scripting. It captures the reference chains and allocation sites of GC-managed objects in memory. The analyzer generates flame graphs that visualize object reference relationships and memory consumption patterns, helping identify memory leaks, excessive object retention, and memory optimization opportunities in Lua applications.

Resource Category

Memory.

Application Type & Technical Stack

  • Lua
  • Redis

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 lua-gco-ref -p PID

# trace a shell command directly
orxray analyzer run lua-gco-ref -c SHELL_CMD

Tracing Multiple Processes

Not supported.

Output Formats

  • Flame Graphs

Author

The OpenResty Inc. Team.

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