Analyzer java-off-cpu
Name
java-off-cpu - Java-Land off-CPU Flame Graph
This analyzer profiles off-CPU time consumption in Java-land code execution within JVM applications. It captures stack traces when Java threads are blocked or waiting, such as during I/O operations, lock contention, or thread synchronization. The analyzer generates flame graphs that visualize blocking time distribution, helping identify concurrency issues, lock contention, and I/O bottlenecks in Java applications.
Resource Category
off-CPU.
Application Type & Technical Stack
- Java
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 java-off-cpu -p PID
# trace a shell command directly
orxray analyzer run java-off-cpu -c SHELL_CMD
# PGID is the process group ID or any process's PID within the target process
# group.
orxray analyzer run java-off-cpu -p -PGID
# trace any processes started from the specified executable path.
orxray analyzer run java-off-cpu --exe /path/to/exe/file
Tracing Multiple Processes
Supported.
Output Formats
- Flame Graphs
Author
The OpenResty Inc. Team.
Copyright
Copyright (C) by OpenResty Inc. All rights reserved.