All Products
Search

This Product

    File Storage NAS:View capacity monitoring

    Document Center

    File Storage NAS:View capacity monitoring

    Last Updated:Sep 07, 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.

    • Extreme NAS file systems created between January 19, 2024 and May 21, 2024 require an upgrade to support capacity monitoring. submit a ticket to proceed.

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

      The capacity monitoring page of a General-purpose NAS file system displays monitoring metric charts for Storage Space (Excluding Recycle Bin), File Count (Excluding Recycle Bin), Recycle Bin Storage Space, Infrequent Access Storage Traffic, Archive Storage Traffic, Penalized Archive File Deletion Operations, Penalized Archive File Truncate Operations, and Penalized Archive File Retrieval Operations.

      The capacity monitoring page of an Extreme NAS file system displays monitoring metric charts for four sections: Total Storage Space of Extreme NAS (GiB), Used Data of Extreme NAS (GiB), Maximum File Count of Extreme NAS (count), and Used File Count of Extreme NAS (count).

      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 File Storage NAS page, select the Region and File Storage NAS tabs, and then click the target file system 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