ZFS Pool Capacity Warning Alert - Troubleshooting Guide

KB 715314 - 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

Alert Description

This alert is triggered when ZFS pool utilization exceeds 85%, indicating that the storage pool is nearing capacity limits.
High utilization can lead to:
  1. Performance degradation
  2. Increased latency
  3. Risk of pool exhaustion
If not addressed, it may eventually result in:
  1. Write failures
  2. Application impact
  3. Potential service disruption

Severity

P3 – Medium Impact

Possible Causes

  1. High data ingestion or workload growth
  2. Lack of storage cleanup or retention policies
  3. Snapshot accumulation
  4. Inefficient storage utilization
  5. Unexpected data spikes

L1 Engineer Actions

Step 1 – Log the Alert

  1. Log in to the monitoring system
  2. Review alert summary and affected pool 

Step 2 – Create Ticket

  1. Inform L2 team
  2. Create an internal ticket including:
    1. Alert name
    2. Hostname
    3. Pool name
    4. Current utilization (%)
    5. Timestamp

Step 3 – Escalation (If required)

  1. Share alert details with L2 team for further analysis

Step 4 – Documentation

  1. After confirmation with L2:
    1. Update Issue Master Sheet
    2. Ensure proper tracking of the issue

L2 Engineer Actions

Step 1 – Log Pool Usage

  1. Record current pool utilization
  2. Identify growth trend if historical data is available

Step 2 – Check ZFS Pool Status

zpool status
zfs list
  1. Verify pool health
  2. Check space usage across datasets

Step 3 – Analyze Storage Consumption

  1. Identify:
    1. Large datasets
    2. Snapshot usage
    3. Unused or stale data

Step 4 – Take Preventive Actions

  1. Clean up unnecessary data (if applicable)
  2. Remove unused snapshots
  3. Plan for storage expansion if required

Step 5 – OEM Escalation (If required)

  1. If capacity issue is related to:
    1. Hardware limitation
    2. Expansion requirement
  2. Raise a request with OEM/vendor

Resolution

The issue is considered resolved when:
  1. ZFS pool utilization is reduced below threshold
  2. Adequate free space is available
  3. No risk of immediate capacity exhaustion
  4. Alert is cleared

Escalation

  1. L1 → L2: For analysis and validation
  2. L2 → OEM/Vendor: If storage expansion or hardware support is required



    • Related Articles

    • KB 715377 - ZFS Pool Capacity Critical Alert - Troubleshooting Guide

      Purpose This document provides a standardized approach for handling and troubleshooting the ZFS Pool Capacity Critical alert, enabling rapid response to prevent storage exhaustion, performance degradation, and potential service outages. Alert Name ...

    • KB 715260 - ZFS Pool Error Alert - Troubleshooting Guide

      Purpose This document provides a standardized approach for handling and troubleshooting the ZFS Pool Error alert, enabling L1 and L2 engineers to quickly identify disk-related issues, prevent data loss, and maintain storage reliability. Alert Name ...

    • KB 511966 - 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 ...

    • KB 905833 - Network Down Extern (P1 Critical Alert) - Troubleshooting Guide

      Purpose This document provides a standardized approach for handling and troubleshooting the Network Down - Extern alert, including L1 and L2 actions, escalation procedures, and resolution criteria for critical incidents. Alert Name Network Down - ...

    • KB 021137 - Network Down IB Alert - Troubleshooting Guide

      Purpose This document provides a standardized approach for handling and troubleshooting the Network Down – IB alert, including L1 and L2 actions, escalation process, and resolution criteria. Alert Name Network Down – IB Alert Description This alert ...

    • Recent Articles

    • KB-630208 | How to use Find and Locate to search for files in Linux

      Purpose To provide Linux administrators and Field Engineers with guidance on using the find and locate utilities to efficiently search for files and directories within a Linux filesystem based on criteria such as name, type, size, timestamps, ...

    • KB-630164 | How to use rsync to Synchronize Files

      Purpose To provide a clear and practical procedure for using the rsync utility to synchronize files and directories between local systems and remote hosts, including push and pull operations, while preserving file attributes and optimizing data ...

    • KB-630107 | How to create a Linux swap file

      Purpose To provide Field Engineers and Linux administrators with a standardized procedure for creating, configuring, and validating a Linux swap file. This procedure helps ensure sufficient virtual memory is available when physical RAM is exhausted ...

    • MSI All-in-One (AIO) PC – Physical Damage Policy for Warranty Claims

      MSI All-in-One (AIO) PC – Physical Damage Policy for Warranty Claims MSI's standard warranty does not cover physical or accidental damage to an All-in-One (AIO) PC. If the damage is determined to be caused by external factors rather than a ...

    • KB 134833 - Troubleshooting NVSM Alert NV-CPU-XX – Unrecoverable CPU Internal Error

      Purpose This document provides a general troubleshooting procedure for the NVIDIA System Management (NVSM) alert NV-CPU-XX, which indicates that a CPU has reported an internal error. The article outlines how to verify whether the alert represents an ...

    • Popular Articles

    • CP Plus Camera and NVR Configuration

      NVR Configuration The CP Plus Pro Series of NVRs have been meticulously designed for providing you with upgraded performance and higher recording quality in your IP video surveillance solution. The robust processor that has been inculcated in this ...

    • KB 775235 - Kerberos Authentication – Overview

      What is Kerberos? Kerberos is a secure authentication method used in our Active Directory (AD) environment (mbuzztech.com). It allows users to: Access multiple systems without re-entering passwords (Single Sign-On – SSO) Log in once Where We Use It ...

    • How to Remove and Reinstall NVIDIA Drivers on Ubuntu

      This article provides step by step guide to completely remove existing NVIDIA drivers and reinstall specific version of the NVIDIA driver on the Ubuntu system Prerequisites Administrative (sudo) access to the Ubuntu system. Internet access to ...

    • KB 692001 - Personal Computers and Servers - Classification and Point of Contact

      We can classify the computers that MBUZZ handles based on their form-factor as below: Tower Workstations, Desktops, Gaming PCs and SFF (Small form factor) PCs fall under this category. These are computers people would use on a desk and rarely move. ...

    • KB 298031 - M.2 SSD Tier List

      The sequential read and write speeds, which are usually the most advertised number, are not a proper benchmark of real-world performance or the quality of an SSD. This article categorizes and tiers SSDs based on factors like the type of NAND flash, ...