volume analytics show

Contributors

Display file system analytics information

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The volume analytics show command displays the file system analytics information for a volume. By default, the command displays the following information:

  • Vserver name

  • Volume name

  • File system analytics state

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver Name

If this parameter and the -volume parameter are specified, the command displays file system analytics information about the specified volume. If this parameter is specified by itself, the command displays information about volumes on the specified Vserver.

[-volume <volume name>] - Volume Name

If this parameter and the -vserver parameter are specified, the command displays file system analytics information about the specified volume. If this parameter is specified by itself, the command displays information about all volumes matching the specified name.

[-state <Analytics State>] - State

If this parameter is specified, the command displays information only about the volume or volumes that have the specified file system analytics state.

[-scan-progress <percent>] - Scan Progress

If this parameter is specified, the command displays information only about the volume or volumes that have the specified file system analytics progress percentage. This value will only be set if a file system analytics initialization scan is in progress.

[-tracked-dirs <integer>] - Tracked Directories

If this parameter is specified, the command displays information only about the volume or volumes that have the specified number of tracked directories.

[-tracked-files <integer>] - Tracked Files

If this parameter is specified, the command displays information only about the volume or volumes that have the specified number of tracked files.

[-tracked-items <integer>] - Tracked Items

If this parameter is specified, the command displays information only about the volume or volumes that have the specified number of tracked items. An item is either a file or a directory.

[-top-level-dirs <integer>] - Top Level Directories

If this parameter is specified, the command displays information only about the volume or volumes that have the specified number of top level directories.

[-average-files-per-dir <integer>] - Average Files Per Directory

If this parameter is specified, the command displays information only about the volume or volumes that have the specified average number of files per directory.

Examples

The following example displays the file system analytics information on a flexible volume named "flexvol" in Vserver "vs1":

cluster::*> volume analytics show -vserver vs1 -volume flexvol
Vserver Name: vs1
  Volume Name: flexvol
        State: on
Scan Progress: -