Creating Java Heap Dumps for JBoss EAP

Libraries: If you want this lab, consider one of these libraries.
Cloud

Creating Java Heap Dumps for JBoss EAP

While the JBoss Enterprise Application Platform makes managing our Java applications more effective, there are still some troubleshooting tactics for Java applications that we should be aware of. Our applications can be memory-intensive, and in instances of poor performance, we’ll often need to take and analyze a Java heap dump to discover the root cause of our memory issues.

Get started Contact sales

Lab Info

Level

Beginner

Last updated

Sep 23, 2025

Duration

15m

Challenge

Create Heap Dump
1. Find the process ID for Java:
```
pgrep java
```
1. Create a heap dump:
```
sudo jcmd [Your PID] GC.heap_dump -all=true heapcheck.hprof
```
1. Check that the heap dump has been created in /opt/jboss-eap:
```
ls /opt/jboss-eap
```
Challenge

Configure Automatic Heap Dump Creation
1. Create a directory to store heap dumps and move the heapcheck.hpof file to it:
```
sudo mkdir /opt/jboss-eap/heapdumps
sudo mv /opt/jboss-eap/heapcheck.hprof /opt/jboss-eap/heapdumps/
```
1. Configure JBoss to automatically generate a heap dump when there is an out-of-memory error; ensure it is saved to the newly-created directory:
```
export JAVA_OPTS="-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/jboss-eap/heapdumps/oomdump.hprof"
```
1. Restart JBoss:
```
sudo systemctl restart jboss-eap-rhel
```

Challenge

Parse the Heap Dump

Download the Eclipse Memory Analyzer:

cd
curl -O http://mirror.math.princeton.edu/pub/eclipse/mat/1.13.0/rcp/MemoryAnalyzer-1.13.0.20220615-linux.gtk.x86_64.zip

Extract the contents of the download:

unzip MemoryAnalyzer-1.13.0.20220615-linux.gtk.x86_64.zip

Run the script to parse the heap dump:

cd mat
sudo ./ParseHeapDump.sh /opt/jboss-eap/heapdumps/heapcheck.hprof

Confirm the heap dump has been parsed:

ls /opt/jboss-eap/heapdumps/

About the author

Pluralsight Skills

Pluralsight Skills gives leaders confidence they have the skills needed to execute technology strategy. Technology teams can benchmark expertise across roles, speed up release cycles and build reliable, secure products. By leveraging our expert content, skill assessments and one-of-a-kind analytics, keep up with the pace of change, put the right people on the right projects and boost productivity. It's the most effective path to developing tech skills at scale.

Real skill practice before real-world application

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Learn by doing

Engage hands-on with the tools and technologies you’re learning. You pick the skill, we provide the credentials and environment.

Follow your guide

All labs have detailed instructions and objectives, guiding you through the learning process and ensuring you understand every step.

Turn time into mastery

On average, you retain 75% more of your learning if you take time to practice. Hands-on labs set you up for success to make those skills stick.