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 create command 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 set name command to set the alert. Finally, commit your changes. In the example below, 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.
|
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.