---
id: ee8252a9-bea1-461b-9b7d-bb7c115d70ee
---
# Host Memory Leak Incident
---

 A memory leak occurs when a program allocates memory but fails to release it when it is no longer needed, leading to a gradual increase in memory usage over time. This can eventually cause the program or system to become unstable or crash due to insufficient available memory.

### Parameters
```shell
export N="PLACEHOLDER"

export PID="PLACEHOLDER"

export PATH_TO_LOG_FILE="PLACEHOLDER"

export PROCESS_NAME="PLACEHOLDER"

export MEMORY_THRESHOLD="PLACEHOLDER"

export MEMORY_USED="PLACEHOLDER"
```

## Debug

### Get top processes by memory usage
```shell
ps aux --sort=-%mem | head -n ${N}
```

### Check memory usage of a specific process
```shell
pmap ${PID}
```

### Check available memory and swap usage
```shell
free -h
```

### Check system logs for out of memory errors
```shell
grep -i "out of memory" /var/log/syslog
```

### Memory leaks in the software running on the host machine.
```shell
#!/bin/bash

# Define variables

LOG_FILE="${PATH_TO_LOG_FILE}"

PROCESS_NAME="${PROCESS_NAME}"

MEMORY_THRESHOLD="${MEMORY_THRESHOLD}"



# Check if the process is running

if pgrep $PROCESS_NAME > /dev/null

then

    echo "Process $PROCESS_NAME is running."



    # Check memory usage

    MEMORY_USED=$(ps aux | grep $PROCESS_NAME | awk '{print $4}')

    MEMORY_USED=${MEMORY_USED} # Replace decimal point with comma

    MEMORY_USED_PERCENTAGE=$(echo "scale=2; $MEMORY_USED/1" | bc) # Convert to percentage



    echo "Memory usage: $MEMORY_USED_PERCENTAGE%"



    # Check if memory usage is above threshold

    if (( $(echo "$MEMORY_USED_PERCENTAGE > $MEMORY_THRESHOLD" | bc -l) ))

    then

        echo "Memory usage is above threshold of $MEMORY_THRESHOLD%."



        # Log the issue

        echo "$(date): Memory usage of $MEMORY_USED_PERCENTAGE% is above threshold of $MEMORY_THRESHOLD%." >> $LOG_FILE



        # Restart the process

        echo "Restarting $PROCESS_NAME..."

        systemctl restart $PROCESS_NAME

    else

        echo "Memory usage is below threshold of $MEMORY_THRESHOLD%."

    fi

else

    echo "Process $PROCESS_NAME is not running."

fi



exit 0
```


A memory leak occurs when a program allocates memory but fails to release it when it is no longer needed, leading to a gradual increase in memory usage over time. This can eventually cause the program or system to become unstable or crash due to insufficient available memory.


The Host Out of Memory (OOM) Incident occurs when a server or system runs out of memory, causing it to crash or become unresponsive. This can be caused by various factors, such as an unexpected surge in traffic or insufficient resources allocated to the system. Resolving this type of incident requires identifying the root cause of the memory issue and taking appropriate measures such as optimizing system resources or increasing memory capacity.


Host Out of Memory (OOM) Incident

Tomcat JVM OutOfMemory incident occurs when the Java Virtual Machine (JVM) running the Apache Tomcat server runs out of memory, which causes the server to crash or become unresponsive. This type of incident can happen due to a variety of reasons such as incorrect configuration settings, memory leaks, or insufficient memory allocation. When this incident occurs, it can impact the availability and performance of the web application running on the Tomcat server.


Tomcat JVM OutOfMemory Incident

This incident type refers to the situation where the Tomcat server is utilizing more memory than it should, causing system instability and performance issues. This can happen due to a variety of factors such as memory leaks, improper configuration, or application code issues. It is important to address this incident promptly to prevent system failures and ensure optimal application performance.


Excessive memory usage by Tomcat.

Apache Spark Out of Memory Error is a type of incident that occurs when the Apache Spark application running on a system is unable to allocate enough memory to perform its tasks. This can happen when the system's memory is insufficient or when there is a memory leak in the application's code. When this incident occurs, the application may crash, become unresponsive, or produce incorrect results. It is important to diagnose and resolve this issue as soon as possible to ensure the smooth functioning of the application.


Apache Spark Out of Memory Error incident.

This incident type indicates that there is a high latency issue in the execution of a Spark job. Spark is a distributed computing framework that is used for processing large datasets. High latency in this context means that the time taken to execute the Spark job is significantly longer than expected or normal. This can result in delays in processing data and can impact the performance of the application or system that is utilizing Spark.


High Latency Incident for Spark Job Execution.

```shell
export N="PLACEHOLDER"

export PID="PLACEHOLDER"

export PATH_TO_LOG_FILE="PLACEHOLDER"

export PROCESS_NAME="PLACEHOLDER"

export MEMORY_THRESHOLD="PLACEHOLDER"

export MEMORY_USED="PLACEHOLDER"
```


### Get top processes by memory usage

```shell
ps aux --sort=-%mem | head -n ${N}
```

### Check memory usage of a specific process

```shell
pmap ${PID}
```

### Check available memory and swap usage

```shell
free -h
```

### Check system logs for out of memory errors

```shell
grep -i "out of memory" /var/log/syslog
```

### Memory leaks in the software running on the host machine.

```shell
#!/bin/bash

# Define variables

LOG_FILE="${PATH_TO_LOG_FILE}"

PROCESS_NAME="${PROCESS_NAME}"

MEMORY_THRESHOLD="${MEMORY_THRESHOLD}"



# Check if the process is running

if pgrep $PROCESS_NAME > /dev/null

then

    echo "Process $PROCESS_NAME is running."



    # Check memory usage

    MEMORY_USED=$(ps aux | grep $PROCESS_NAME | awk '{print $4}')

    MEMORY_USED=${MEMORY_USED} # Replace decimal point with comma

    MEMORY_USED_PERCENTAGE=$(echo "scale=2; $MEMORY_USED/1" | bc) # Convert to percentage



    echo "Memory usage: $MEMORY_USED_PERCENTAGE%"



    # Check if memory usage is above threshold

    if (( $(echo "$MEMORY_USED_PERCENTAGE > $MEMORY_THRESHOLD" | bc -l) ))

    then

        echo "Memory usage is above threshold of $MEMORY_THRESHOLD%."



        # Log the issue

        echo "$(date): Memory usage of $MEMORY_USED_PERCENTAGE% is above threshold of $MEMORY_THRESHOLD%." >> $LOG_FILE



        # Restart the process

        echo "Restarting $PROCESS_NAME..."

        systemctl restart $PROCESS_NAME

    else

        echo "Memory usage is below threshold of $MEMORY_THRESHOLD%."

    fi

else

    echo "Process $PROCESS_NAME is not running."

fi



exit 0
```


Host Memory Leak Incident

Overview

Parameters

Debug

Get top processes by memory usage

Check memory usage of a specific process

Check available memory and swap usage

Check system logs for out of memory errors

Memory leaks in the software running on the host machine.

Learn more

Related Runbooks

Host Out of Memory (OOM) Incident

Tomcat JVM OutOfMemory Incident

Excessive memory usage by Tomcat.

Apache Spark Out of Memory Error incident.

Support