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.
Filesystem Capacity Warning – Head Node
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
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.
Warning
Immediate investigation is recommended to prevent escalation to a critical filesystem full condition.
Follow these steps when the alert is received.
Record the alert in the Alert Summary sheet
Open an incident ticket for tracking
If the issue appears significant:
Create an internal ticket
Inform L2 Engineer
After confirmation with L2:
Update the Issues Master Sheet
L2 engineers should perform deeper troubleshooting.
Run the following commands:
df -h
lsblk
free -h
This will show:
filesystem usage
storage device mapping
system memory usage
Determine which filesystem is consuming high storage.
Example:
du -sh /* 2>/dev/null
or
du -sh /var/* 2>/dev/null
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
Re-check usage:
df -h
Confirm that the filesystem utilization has reduced.
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)