Skip to main content
Hitachi Vantara Knowledge

Using compression statistics

It is important to monitor compression-based storage to avoid running out of physical space.

NoteOnly VSP Unified F/G/N Series (with NAS modules) that are configured using FMD compression will report compression statistics. FMD compression information is not available from the system when used with HNAS gateways.

The following commands display and control statistics for compression-based storage:

  • span-list
  • span-dump
  • sd-list
  • span-set-cap-warn-thresh

The span-list -s, span-dump and sd-list --scsi commands all display the following statistics for compressed storage:

  • The amount of physical space that isn't in use

  • The total amount of physical space

  • The percentage saving by which compression has reduced the amount of physical space required to store data on the span

For example:

Compressed: 200GiB (0TiB) (3%) of 6843GiB (7TiB) is free; saving is 95% 

Using the span-list command

For all storage types except UVM, the span-list -s command also displays an 'available' figure, which is a conservative estimate of the amount of space that could be allocated from the stripeset.

For example:

Set 0: 4 x 2430GiB = 9720GiB, of which 9119GiB is free, 299GiB is vacated, 900GiB is available

Using the sd-list command

The sd-list command also contains the following options for compressed storage:

  • --compression
  • --is-compressed
  • --is-uncompressed

The --compression parameter reports the compression information in tabular form and can be combined with --hdp switch.

To view compressed or uncompressed SDs only, use the --is-compressed and --is-uncompressed switches (-e and -E), respectively.

To see which SDs are most urgently in need of new physical storage, a sort criterion is available:

sd-list --compression --sort e

This command sorts SDs by the percentage of physical space that is still free. Users can reverse the sort order by using an upper case E , and can combine this sort criterion with others.

Using the span-set-cap-warn-thresh command

Use the span-set-cap-warn-thresh command to set the capacity warning threshold for spans and compressed HDP pools.

This threshold controls:

  • The point at which span-list, trouble and the event log warn about low physical space.
  • The safety margin that span-list -s uses when calculating the available free space on a stripeset.
  • The point at which the server takes precautionary measures such as disabling filesystem auto-expansion and unmapping vacated chunks when physical space is low.

Low physical space

If the physical space on an HDP pool is exhausted, the HDP pool will fail, along with every span that uses it. Therefore, when physical space is low, the server automatically disables filesystem auto-expansion in order to help keep the system serving data.

The span enters this state when the percentage of free physical space plus the percentage threshold set by the span-set-cap-warn-thresh command is below 100. For example, with the capacity warning threshold at 90%, filesystem auto-expansion will be disabled when less than 10% of the physical space is free, and will be re-enabled when more physical free space is provided.

When a span is in this state, the sd-list command's Con column displays LPS (Low Physical Space), to show that auto-expansion is disabled.


  • Was this article helpful?