All Products
Search

This Product

    File Storage NAS:View capacity monitoring

    Document Center

    File Storage NAS:View capacity monitoring

    Last Updated:Jun 30, 2026

    Apsara File Storage NAS (NAS) integrates with CloudMonitor to provide real-time capacity monitoring. This feature lets you track key usage metrics for your file systems, such as storage space, IA storage class traffic, file count, and data volume. This topic describes how to view capacity monitoring data for NAS file systems.

    Prerequisites

    Notes

    • Extreme NAS file systems created after May 21, 2024 support capacity monitoring by default.

    • If your Extreme NAS file system was created between January 19, 2024, and May 21, 2024, you must upgrade it to enable capacity monitoring. To request an upgrade, submit a ticket.

    • Extreme NAS file systems created before January 19, 2024 do not support capacity monitoring.

    NAS console

    1. Log on to the NAS console.

    2. In the left-side navigation pane, choose Monitoring Audit > Capacity Monitoring.

    3. At the top of the page, select a region.

    4. On the Capacity Monitoring page, follow these steps to view the capacity details for a file system:

      1. From the File System Type drop-down list, select the file system type.

      2. From the File System ID drop-down list, select the file system ID.

      3. Select a time range. You can select 1 Hour, 1 Day, 7 Days, 14 Days, Last Month, or Current Month, or specify a custom time range. A custom time range cannot exceed 30 days. To view data for more than one month, see Resource usage and bills.

      For General-purpose NAS file systems, the Capacity Monitoring page displays monitoring charts for metrics such as Storage Space (Excluding recycle bin), Number of Files, IA Storage Class Traffic, Archive Storage Class Traffic, Number of Delete Operations on Archived Files That Trigger Penalty, and Number of Truncate Operations on Archived Files That Trigger Penalty.

      For Extreme NAS file systems, the Capacity Monitoring page displays monitoring charts for metrics such as Total Storage Space of Extreme NAS File System, Data Volume of Extreme NAS File System, Maximum Number of Files in Extreme NAS File System, and Number of Used Files in Extreme NAS File System.

      For AgenticFS, capacity monitoring is available at both the file system and AgenticSpace levels. The monitoring charts include metrics such as Used Capacity of File System, Capacity Quota of AgenticSpace, Used Capacity of AgenticSpace, Used Inodes of File System, Inode Quota of AgenticSpace, and Used Inodes of AgenticSpace.

      Note

      • Capacity monitoring provides real-time data that is not used for billing. To view detailed metering data for billing, see Resource usage and bills.

      • To monitor storage capacity in real time, you can configure an alert rule based on capacity metrics to be notified of anomalies. For more information, see Configure a basic alert rule.

    CloudMonitor console

    1. Log on to the CloudMonitor console.

    2. In the left-side navigation pane, choose Cloud Resource Monitoring > Cloud Service Monitoring.

    3. On the Cloud Service Monitoring page, enter NAS in the search box and click Apsara File Storage NAS.

    4. On the Apsara File Storage NAS page, select a region and the Apsara File Storage NAS tab. Then, find the target file system and click its ID, or click Monitoring Charts in the Actions column.

    5. On the monitoring charts page, click the File System Capacity tab to view the file system's capacity details.

      By default, CloudMonitor displays monitoring data from the last hour. You can select a preset time range or specify a custom time range. The time range cannot exceed 30 days. To view data for more than one month, see Resource usage and bills.

      Note

      Capacity monitoring provides real-time data that is not used for billing. To view detailed metering data for billing, see Resource usage and bills.

    CloudMonitor API

    You can query monitoring data for NAS and AgenticFS by using the following CloudMonitor API operations:

    The following table describes the request parameters for NAS.

    Parameter

    Description

    Namespace

    The namespace of the cloud service. For NAS, set this parameter to acs_nas.

    MetricName

    The name of the metric. Valid values:

    • General-purpose NAS

      • AlignedSize

      • SecondaryAlignedSize

      • FileCount

      • OfflineReadQuantity

      • OfflineWriteQuantity

      • ArReadQuantity

      • ArWriteQuantity

      • ArDeletePenaltyOpCount

      • ArTruncatePenaltyOpCount

      • ArRetrievePenaltyOpCount

    • Extreme NAS

      • ExtremeCapacity

      • ExtremeCapacityUsed

      • ExtremeInodeLimit

      • ExtremeInodeUsed

    Dimensions

    A map of dimensions for querying the monitoring data of a specific resource.

    Format: {"userId":"xxxxxx","fileSystemId":"xxxxx"}

    Note

    The value of Dimensions must be a JSON string, and the key-value pairs must be in the specified order.

    The following table describes the request parameters for AgenticFS.

    Parameter

    Description

    Namespace

    The namespace of the cloud service. For AgenticFS, set this parameter to acs_nas.

    MetricName

    The name of the metric. Valid values:

    • AgenticFS (file system level):

      • AgenticFSCapacityUsed: The used capacity of the AgenticFS file system.

      • AgenticFSInodeUsed: The number of used inodes in the AgenticFS file system.

    • AgenticFS (AgenticSpace level):

      • AgenticSpaceCapacityLimit: The capacity quota of the AgenticSpace.

      • AgenticSpaceCapacityUsed: The used capacity of the AgenticSpace.

      • AgenticSpaceInodeLimit: The inode quota of the AgenticSpace.

      • AgenticSpaceInodeUsed: The number of used inodes in the AgenticSpace.

    Dimensions

    A map of dimensions for querying the monitoring data of a specific resource.

    File system level format: {"userId":"xxxxxx","fileSystemId":"xxxxx"}

    AgenticSpace level format: {"userId":"xxxxxx","fileSystemId":"xxxxx","AgenticSpaceId":"xxxxx"}

    Note

    The value of Dimensions must be a JSON string, and the key-value pairs must be in the specified order.

    Related documents