Skip to content

Latest commit

 

History

History
44 lines (29 loc) · 1.4 KB

readme.md

File metadata and controls

44 lines (29 loc) · 1.4 KB

Auto Heap Dump Script

Overview

This project contains a Bash script (auto_dump.sh) that monitors the heap memory usage of a Java service/container and triggers a heap dump if the usage exceeds a specified threshold.

Motivation

This script was developed to address scenarios where the -XX:+HeapDumpOnOutOfMemoryError option might not be sufficient. By running as a sidecar container, it proactively monitors heap memory usage and triggers a heap dump when the usage exceeds a specified threshold. This ensures that heap dumps are captured reliably, even in complex environments.

Features

  • Monitors heap memory usage of a Java process.
  • Triggers a heap dump when heap usage exceeds the defined threshold.
  • Runs the check in a continuous loop with a configurable interval.

Prerequisites

  • Bash shell
  • Java Development Kit (JDK) with jcmd tool
  • pgrep command

Usage

  1. Set the Threshold: Modify the THRESHOLD variable in the script to set the desired heap usage percentage threshold. The default is 95%.

    THRESHOLD=95

  2. Run the Script: Execute the script to start monitoring the heap memory usage.

    ./auto_dump.sh

License

This project is licensed under the GNU General Public License v2.0. You may obtain a copy of the License at:

GNU General Public License v2.0