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:

  1. Select or create a machine with an amount of RAM as specified on the page
  2. Download a .jar file that would perform the analysis to that machine
  3. 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-portal-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:

  1. Click on “Detailed information” on the Root Cause page to follow the instructions
  2. Copy the meta-information files named oom_dump_v4.tbz2 and oom_dump_info.txt to the target machine
  3. Supply the path to the copied .tbz2 file to the jar running command
  4. Supply the path ot where the report should be saved, e.g. report.bin
  5. Run the analysis, e.g. java -Xmx1g -jar analyze-oom ~/oom-analysis/1/oom_dump.tar.bz2 report.bin
  6. 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.