All Products
Search
Document Center

Cloud Parallel File Storage:View CPFS capacity monitoring

Last Updated:Jun 25, 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 your 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 time range. You can select 1 Hour, 1 Day, 7 Day, 14 Days, Current Month, or Last Month. You can also specify a custom time range. The time range cannot exceed 30 days. To view data for a period longer than 30 days, see View billing and usage data.

    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.

    • Number of Files: Includes metrics for the maximum number of files, allocated files, used files, files allocated to filesets, files used by filesets, files allocated to the root fileset, and files used by the root fileset.

    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 namespace of the cloud service. For CPFS, the namespace 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.