Analyzer lj-live-coroutines

Name

lj-live-coroutines - dump the bts of the living Lua coroutines

This analyzer captures and visualizes the execution state of active Lua coroutines in OpenResty and Kong applications. It collects stack traces from all living coroutines, showing their current execution points and call chains. The analyzer generates flame graphs representing coroutine distribution and activity, helping diagnose concurrency issues and identify blocked or leaked coroutines in asynchronous request processing.

Resource Category

CPU.

Application Type & Technical Stack

  • OpenResty
  • 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 lj-live-coroutines -p PID

# trace a shell command directly
orxray analyzer run lj-live-coroutines -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.