Filesystem Capacity Warning in Head Node - Troubleshooting Guide

Filesystem Capacity Warning in Head Node - Troubleshooting Guide

Purpose

Provide a troubleshooting and response procedure when a Filesystem Capacity Warning alert is triggered on a Head Node.

This KB helps engineers quickly identify the issue, perform basic checks, and escalate when required.


Alert Name

Filesystem Capacity Warning – Head Node


What the Alert Is

This alert indicates that the filesystem usage on the Head Node has crossed the warning threshold.

High filesystem utilization may lead to:

  • Application logging failures

  • Job scheduling issues

  • System instability

  • Potential service interruptions if capacity reaches critical levels


Summary

The monitoring system detects when the filesystem capacity approaches its configured limit.

The alert is generated to notify engineers so that corrective action can be taken before the filesystem becomes full.


Severity

Warning

Immediate investigation is recommended to prevent escalation to a critical filesystem full condition.


L1 Engineer Actions

Follow these steps when the alert is received.

Step 1 – Log the Alert

  • Record the alert in the Alert Summary sheet


Step 2 – Create Ticket

  • Open an incident ticket for tracking


Step 3 – Escalation (If Required)

If the issue appears significant:

  • Create an internal ticket

  • Inform L2 Engineer


Step 4 – Documentation

After confirmation with L2:

  • Update the Issues Master Sheet


L2 Engineer Actions

L2 engineers should perform deeper troubleshooting.

Step 1 – Check Filesystem Status

Run the following commands:

df -h
lsblk
free -h

This will show:

  • filesystem usage

  • storage device mapping

  • system memory usage


Step 2 – Identify High Usage Filesystem

Determine which filesystem is consuming high storage.

Example:

du -sh /* 2>/dev/null

or

du -sh /var/* 2>/dev/null

Step 3 – Clean Unnecessary Files

Free up space by removing unnecessary data such as:

  • old log files

  • temporary files

  • unused data

  • old core dumps

  • old kernel files

Common cleanup locations:

/var/log
/tmp
/var/tmp

Step 4 – Verify Filesystem After Cleanup

Re-check usage:

df -h

Confirm that the filesystem utilization has reduced.


Step 5 – OEM Escalation

If the issue persists or cannot be resolved internally:

Escalate to OEM / platform support team with:

  • node hostname

  • filesystem details

  • command outputs (df -h, lsblk)

    • Related Articles

    • Filesystem Capacity Critical in Head Node - Troubleshooting guide

      Purpose Provide a standard troubleshooting and resolution procedure when filesystem capacity on a Head Node reaches critical levels. When to Use Use this KB when the monitoring system triggers the alert: Filesystem Capacity Critical – Head Node This ...
    • ZFS Pool Capacity Warning Alert - Troubleshooting Guide

      Purpose This document provides a standardized approach for handling and troubleshooting the ZFS Pool Capacity Warning alert, helping L1 and L2 engineers prevent storage exhaustion and maintain system stability. Alert Name ZFS Pool Capacity Warning ...
    • Memory Filesystem Capacity Warning -- Troubleshooting guide

      Purpose Provide a standard troubleshooting and resolution procedure when filesystem capacity on any HGX Node reaches warning levels. When to Use Use this KB when the monitoring system triggers the alert: Memory Filesystem Capacity warning – For Any ...
    • Node Exporter Down - Troubleshooting Guide

      Purpose This document provides a standardized approach for handling and troubleshooting the Node Exporter Down alert, including L1 and L2 actions, escalation flow, and resolution criteria. Alert Name Node Exporter Down Alert Description This alert is ...
    • BeeGFS Capacity Warning – Troubleshooting Guide

      Purpose Provide a standard troubleshooting procedure for engineers when a BeeGFS Capacity Warning alert is triggered in the cluster. This guide ensures engineers follow consistent investigation and escalation steps. When to Use Use this KB when the ...