All Products
Search
Document Center

Cloud Parallel File Storage:View CPFS capacity monitoring

Last Updated:Aug 27, 2026

The capacity monitoring feature provides real-time data on storage usage and file counts for your General-purpose Cloud Parallel File Storage (CPFS) file systems. This topic describes how to view this data.

Prerequisites

Note

Capacity monitoring data is for reference only and is not used for billing calculations. For detailed usage and billing information, see View bills.

Limitations

Capacity monitoring is available only for General-purpose CPFS file systems, version 2.3.1 and later.

View data in the NAS console

  1. Log on to the NAS console.

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

  3. In the top navigation bar, select a region.

  4. On the Capacity Monitoring page, do the following to view capacity monitoring details for a CPFS file system:

    1. From the File System Type drop-down list, select CPFS.

    2. Select the ID of the file system from the File System ID drop-down list.

    3. Select a query time period (1 Hour, 1 Day, 7 Day, 14 days, Current Month, or Last Month), or select a custom date range in the custom time box. The date range cannot exceed 30 days. If you need to view capacity data for more than one month, see Resource usage and bills.

    The Capacity Monitoring page displays charts for two main categories: Storage Space and Number of Files.

    • Storage Space: includes metrics for total storage space and used space.

    • File count: includes maximum file count, allocated file count, used file count, fileset allocated file count, fileset used file count, root fileset allocated file count, and root fileset used file count.

    Note

    The root fileset is the default fileset of a file system. It contains all files that do not belong to any independently created filesets.

    For more information about the metrics, see Metrics.

View data in the CloudMonitor console

  1. Log on to the CloudMonitor console.

  2. In the navigation pane, choose Cloud Service Monitoring.

  3. On the Cloud Service Monitoring page, enter CPFS in the search box, and then click CPFS (Old version).

  4. On the CPFS (Old version) page, select a region, find the desired file system, and then click Monitoring Charts in the Actions column.

  5. On the Monitoring Charts page, click the File System Capacity tab to view the capacity monitoring details.

View data by using the CloudMonitor API

You can also query CPFS monitoring data by calling CloudMonitor API operations. Key API operations include:

  • DescribeMetricMetaList: queries the descriptions of available time-series metrics in CloudMonitor.

  • DescribeMetricList: queries the monitoring data of a time-series metric for an Alibaba Cloud service within a specified time period.

  • DescribeMetricLast: queries the latest monitoring data of a specified monitored object.

The following table describes the request parameters for CPFS.

Parameter

Description

Namespace

The data namespace of the cloud service. The namespace for CPFS is acs_nas.

MetricName

The name of the metric. Valid values:

  • File system instance

    • CPFSCapacity

    • CPFSCapacityUsed

    • CPFSInodeLimit

    • CPFSInodeAlloc

    • CPFSInodeUsed

  • fileset

    • FsetInodeUsed

    • FsetInodeAlloc

Dimensions

A map of dimensions for querying monitoring data from a specific resource. The format is as follows:

{"userId":"xxxxxx","fileSystemId":"cpfs-xxxxx","fSet:xxxxx"}.

Note

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

Related operations

  • You can configure an alert rule to receive prompt notifications about abnormal data. This allows you to respond to exceptions and restore services quickly. For more information, see Configure a basic alert rule.

  • You can also create an application group for multiple file systems to manage alert rules and view monitoring data at the group level. This simplifies management and improves monitoring efficiency. For more information, see Create an application group.