Analyzer java-thread-pool

# Name

java-thread-pool - Java Thread Pool Waits and Activity

This analyzer recognizes standard JDK executor worker stacks, including ThreadPoolExecutor, ForkJoinPool, CompletableFuture, and ForkJoinTask paths. It reports observed worker-profile samples and worker-wait entries in a bar chart, then shows the futex-backed worker-wait distribution and a histogram of sampled worker-execution segments. It is a lightweight view of executor behavior, not a tracer for every submitted Runnable or Future.

# Resource Category

Latency.

# 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-thread-pool -p PID

# trace a shell command directly
orxray analyzer run java-thread-pool -c SHELL_CMD

# PGID is the process group ID or any process's PID within the target process
# group.
orxray analyzer run java-thread-pool -p -PGID

# trace any processes started from the specified executable path.
orxray analyzer run java-thread-pool --exe /path/to/exe/file

# Tracing Multiple Processes

Supported.

# Output Formats

• Bar Charts
• Histogram Bar Charts
• Plain Texts

# Author

The OpenResty Inc. Team.

# Copyright

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