On-Premise OOM analysis
Running analysis when an OutOfMemoryError
occurs in an application is computationally intensive and requires an amount of RAM proportional to the number of objects in the JVM. Therefore, when running your own Plumbr Server on-premise, additional steps must be taken to find root causes for an OutOfMemoryError
.
Semi-automatic analysis
The OutOfMemoryError
meta-information snapshot will always be automatically sent by Plumbr Agent to the Plumbr Server after such error occurs. A corresponding Root Cause screen will appear in Plumbr Server, prompting you to do the following:
- Select or create a machine with an amount of RAM as specified on the page
- Download a
.jar
file that would perform the analysis to that machine - Run it, supplying the required amount of heap to the JVM by specifying the
-Xmx
argument
The program will automatically download the meta-information from Plumbr Server, run the analysis and upload a complete report back to Plumbr Server. This assumes two things:
- You have specified the
plumbr.server.url
property in the server properties or set it in the web interface - The machine that runs the analysis has access to the machine where Plumbr Server is running
In case condition (1) is not met, you can still run the analysis by supplying a property to the jar file: -Dportal.url=https://address-of-your-plumbr-server-installation
.
Running analysis from behind a firewall
In case access to the Plumbr Server is restricted by a firewall, some additional manual actions are required:
- Click on “Detailed information” on the Root Cause page to follow the instructions
- Copy the meta-information files named
oom_dump_v4.tbz2
andoom_dump_info.txt
to the target machine - Supply the path to the copied
.tbz2
file to the jar running command - Supply the path ot where the report should be saved, e.g.
report.bin
- Run the analysis, e.g.
java -Xmx1g -jar analyze-oom ~/oom-analysis/1/oom_dump.tar.bz2 report.bin
- Upload the
report.bin
file to the corresponding form on the Root Cause page
Data retention
By default, meta-information files will be immediately deleted upon successful analysis. Data files that date back more than 30 days will also be deleted, even if no analysis was performed on them. At any time you may manually delete the dumps from the ${plumbr.server.home}/data/dumps
folder.