Capacity: Capacity Bytes Used (CLI)

This statistic shows the used bytes, in gigabyte units, 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.

To create this 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.bytesused[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.bytesused[name]" 
hostname:analytics worksheets worksheet-000 dataset \
(uncommitted)> commit

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

Table 5-17 Parameters for Capacity Bytes 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 Bytes Used

This statistic can be used as a threshold alert for the used storage capacity in bytes. 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 Bytes 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 Percent Used (CLI) for a threshold alert for the percentage of storage used capacity.