Alibaba Cloud File Storage CPFS

Collect Alibaba Cloud File Storage CPFS monitoring data

Configuration¶

Install Func¶

It is recommended to activate Guance Integration - Extensions - DataFlux Func (Automata)

If you deploy Func by yourself, refer to Self-deployed Func

Activate Script¶

Note: Please prepare an Alibaba Cloud AK that meets the requirements in advance (for simplicity, you can directly grant the global read-only permission ReadOnlyAccess)

DataFlux Func (Automata) Activation Script¶

Log in to the Guance console
Click the [Integration] menu, select [Cloud Account Management]
Click [Add Cloud Account], select [Alibaba Cloud], fill in the required information on the interface. If you have already configured cloud account information before, ignore this step
Click [Test], after the test is successful, click [Save]. If the test fails, please check whether the relevant configuration information is correct and test again
Click the cloud account in the [Cloud Account Management] list to see the added cloud account, click the corresponding cloud account to enter the details page
Click the [Integration] button on the cloud account details page, find Alibaba Cloud CPFS in the Not Installed list, click the [Install] button, and install it in the pop-up installation interface.

Manual Activation Script¶

Log in to the Func console, click [Script Market], enter the Guance script market, search: integration_alibabacloud_cpfs
After clicking [Install], enter the corresponding parameters: Alibaba Cloud AK ID, AK Secret, and account name.
Click [Deploy Startup Script], the system will automatically create a Startup script set and automatically configure the corresponding startup script.
After activation, you can see the corresponding automatic trigger configuration in "Management / Automatic Trigger Configuration". Click [Execute] to execute it immediately without waiting for the scheduled time. Wait a moment, you can view the execution task records and corresponding logs.

Verification¶

In "Management / Automatic Trigger Configuration", confirm whether the corresponding task has the corresponding automatic trigger configuration, and you can also check the corresponding task records and logs to see if there are any exceptions
In Guance, check whether asset information exists in "Infrastructure / Custom"
In Guance, check whether there is corresponding monitoring data in "Metrics"

Metrics¶

File Storage CPFS metrics are under the aliyun_acs_nas measurement. The following are the metric details

MetricName	Metric Type	MetricDescribe	Dimensions	Statistics	Unit
CPFSCapacity	capacity	Total storage space	userId,fileSystemId	Value	B
CPFSCapacityUsed	capacity	Data volume	userId,fileSystemId	Value	B
CPFSInodeAlloc	capacity	Allocated files	userId,fileSystemId	Value	count
CPFSInodeLimit	capacity	Maximum files	userId,fileSystemId	Value	count
CPFSInodeUsed	capacity	Used files	userId,fileSystemId	Value	count
CPFSIopsRead	performance	Read IOPS	userId,fileSystemId	Value	IOPS
CPFSIopsWrite	performance	Write IOPS	userId,fileSystemId	Value	IOPS
CPFSThruputRead	performance	Read throughput	userId,fileSystemId	Value	bytes/s
CPFSThruputWrite	performance	Write throughput	userId,fileSystemId	Value	bytes/s
ClientReadIops	performance	Client read IOPS	userId,fileSystemId,hostname	Average,Minimum,Maximum	IOPS
ClientReadLatency	capacity	Client read average latency	userId,fileSystemId,hostname	Average,Minimum,Maximum	B
ClientReadThroughput	performance	Client read throughput	userId,fileSystemId,hostname	Average,Minimum,Maximum	B/s
ClientWriteIops	performance	Client write IOPS	userId,fileSystemId,hostname	Average,Minimum,Maximum	IOPS
ClientWriteLatency	performance	Client write average latency	userId,fileSystemId,hostname	Average,Minimum,Maximum	us
ClientWriteThroughput	performance	Client write throughput	userId,fileSystemId,hostname	Average,Minimum,Maximum	B/s
FsetInodeAlloc	capacity	Fileset allocated files	userId,fileSystemId,hostname	Value	count
FsetInodeUsed	capacity	Fileset used files	userId,fileSystemId,hostname	Value	count
IOPSExport	performance	Data flow export IOPS	userId,fileSystemId	Value	IOPS
IOPSImport	performance	Data flow import IOPS	userId,fileSystemId	userId,fileSystemId	IOPS
LatencyExport	performance	Data flow export latency	userId,fileSystemId	Value	us
LatencyImport	performance	Data flow import latency	userId,fileSystemId	Value	us
NFSReadIOPS	performance	NFS read IOPS	userId,fileSystemId	Value	IOPS
NFSReadThroughput	volume	NFS read throughput	userId,fileSystemId	Value	bytes/s
NFSWriteIOPS	performance	NFS write IOPS	userId,fileSystemId	Value	IOPS
NFSWriteThroughput	volume	NFS write throughput	userId,fileSystemId	Value	bytes/s
QPSExportMeta	performance	Data flow export read meta QPS	userId,fileSystemId	Value	count/s
QPSImportMeta	performance	Data flow import read meta QPS	userId,fileSystemId	Value	count/s
ThroughputExport	performance	Data flow export throughput	userId,fileSystemId	Value	B/s
ThroughputImport	performance	Data flow import throughput	userId,fileSystemId	Value	B/s

Object¶

The collected Alibaba Cloud file system CPFS object data structure can be seen in "Infrastructure - Custom"

{
  "measurement": "aliyun_cpfs",
  "tags": {
    "RegionId"                  : "i-0ec6548xxx",
    "ResourceGroupId"           : "cn-hangzhou",
    "FileSystemId"              : "cpfs-0093329e0e4xxxx",
    "FileSystemType"            : "cpfs",
    "ZoneId"                    : "cn-hangzhou-j",
    "Description"               : "test-zp"
  },
  "fields": {
    "VpcId"                     : "vpc-bp10raupoot1mkzxxxxxx",
    "Status"                    : "Running",
    "Version"                   : "2.3.4",
    "ChargeType"                : "PayAsYouGo",
    "StorageType"               : "advance_100",
    "ProtocolType"              : "standard",
    "MeteredIASize"             : "436207616",
    "Capacity"                  : "3600",
    "CreateTime"                : "2025-10-29 14:55:03",
    "Tags"                      : "{    Tag  []}",
    "MeteredSize"               : "436207616",
    "Bandwidth"                 : "360",
    "SupportedFeatures"         : "{    SupportedFeature[Fileset]}",
    "MountTargets"              : "{    MountTarget  []}",
    "EncryptType"               : "0",
    "Ldap"                      : "{}",
    "ExpiredTime"               : "1761729434674",
    "Packages"                  : "{    Package  []}",
    "AccessPointCount"          : "0"
  }
}