Capacity: Capacity Percent Used (CLI)

This statistic shows the used percentage for storage capacity, including data, metadata, and snapshots, except for reservations. It is used as a threshold alert and cannot be displayed in a graph. Unlike other statistics, it is updated every five minutes instead of every second. Various breakdowns are available to show the pool, project, and share capacity used.

For shares, the storage capacity is the quota, if one exists, or the maximum size on a dynamic LUN. If neither of those exist, the capacity is that of the parent project. For projects, the capacity is the quota, if one exists, or the raw size of the parent pool. For data pools, the capacity is the raw pool size.

To create a capacity alert for datasets in the CLI, navigate to the analytics datasets context. Next, use the command create to set the alert.

hostname:> analytics datasets
hostname:analytics datasets> create cap.percentused[name]

If using worksheets, navigate to the analytics worksheets context, select the desired worksheet, and then navigate to the dataset context. Next, use the command set name to set the alert. Finally, commit your changes. In the following example, the "\" character denotes a line break.

hostname:> analytics worksheets
hostname:analytics worksheets> select worksheet-000
hostname:analytics worksheets worksheet-000> dataset
hostname:analytics worksheets worksheet-000 dataset \
(uncommitted)> set name="cap.percentused[name]" 
hostname:analytics worksheets worksheet-000 dataset \
(uncommitted)> commit

For cap.percentused, substitute the appropriate parameters for [name] according to the following table.

Table 5-19 Parameters for Capacity Percent Used Alert

Parameter	Description
`[pool]`	Selects all pools
`[pool=poolname]`	Selects the pool named poolname
`[project]`	Selects all projects
`[project=projectname]`	Selects the project named projectname
`[pool=poolname][project]`	Selects all projects in poolname
`[pool=poolname][project=projectname]`	Selects the project named projectname in poolname
`[share]`	Selects all shares
`[share=sharename]`	Selects the share named sharename
`[pool=poolname][share]`	Selects all shares in poolname
`[pool=poolname][share=sharename]`	Selects the share named sharename in poolname
`[project=projectname][share]`	Selects all shares in projectname
`[project=projectname][share=sharename]`	Selects the share named sharename in projectname
`[pool=poolname][project=projectname][share]`	Selects all shares in projectname in poolname
`[pool=poolname][project=projectname][share=sharename]`	Selects the share named sharename in projectname in poolname

When to Check Capacity Percent Used

This statistic can be used as a threshold alert for the percentage of used storage capacity. If the threshold is exceeded and the alert is triggered, you can mitigate the situation before storage becomes too full and performance is impacted.

Capacity Percent Used Breakdowns

Pool - Name of the pool to set the alert on
Project - Name of the project to set the alert on
Share - Name of the share to set the alert on

Further Analysis

See Capacity: Capacity Bytes Used (CLI) for a threshold alert, in bytes, for the storage used capacity.