ONTAP 9 Manuals ( CA08871-402 )

Enable File System Analytics

To collect and display usage data such as capacity analytics, you need to enable File System Analytics on a volume.

About this task
  • Beginning with ONTAP 9.8, you can enable File System Analytics on a new or existing volume. If you upgrade a system to ONTAP 9.8 or later, ensure that all upgrade processes have completed before you enable File System Analytics.

  • The amount of time it takes to enable analytics depends on the size and contents of the volume. ONTAP System Manager displays progress and presents analytics data when complete. If you need more precise information about the initialization scan progress, you can use the ONTAP CLI command volume analytics show.

    • Beginning with ONTAP 9.14.1, ONTAP provides progress tracking for the initialization scan in addition to notifications about throttling events that affect the scan progress.

    • Beginning with ONTAP 9.15.1, you can conduct only four initialization scans concurrently on a node. You must wait for a scan to complete before initiating a new scan. ONTAP also enforces that there is enough available space available on the volume and presents an error message if there is not. Ensure that at least 5 to 8 percent of the volume’s available space is free. If the volume has autosize enabled, calculate the available size based on the maximum autogrow size.

    • For further considerations related to the initialization scan, see Scan considerations.

Enable File System Analytics on an existing volume

You can enable File System Analytics with ONTAP System Manager or the CLI.

Example 1. Step
ONTAP System Manager
In ONTAP 9.8 and 9.9.1 Beginning in ONTAP 9.10.1

1. Select Storage > Volumes.
2. Select the desired volume, then select Explorer.
3. Select Enable Analytics or Disable Analytics.

1. Select Storage > Volumes.
2. Select the desired volume. From the individual volume menu, select File System > Explorer.
3. Select Enable Analytics or Disable Analytics.

CLI
Enable File System Analytics with the CLI
  1. Run the following command:
    volume analytics on -vserver svm_name -volume volume_name [-foreground {true|false}]
    By default, the command runs in the foreground; ONTAP displays progress and presents analytics data when complete. If you need more precise information, you can run the command in the background by using the -foreground false option and then use the volume analytics show command to display initialization progress in the CLI.

  2. After successfully enabling File System Analytics, use ONTAP System Manager or the ONTAP REST API to display the analytic data.

Modify default File System Analytics settings

Beginning in ONTAP 9.13.1, you can modify SVM or clusters settings to enable File System Analytics by default on new volumes.

Example 2. Steps
ONTAP System Manager

If you are using ONTAP System Manager, you can modify the storage VM or cluster settings to enable capacity analytics and Activity Tracking at volume creation by default. Default enablement only applies to volumes created after you modify the settings, not existing volumes.

Modify File System Analytics settings on a cluster
  1. In ONTAP System Manager, navigate to Cluster settings.

  2. In Cluster settings, review the File System Settings tab. To modify the settings, select the Settings gear icon.

  3. In the Activity Tracking field, enter the names of the SVMs to enable Activity Tracking for by default. Leaving the field blank will leave Activity Tracking disabled on all SVMs.

    Uncheck the Enable on new storage VMs box to disable Activity Tracking by default on new storage VMs.

  4. In the Analytics field, enter the names of the storage VMs you want capacity analytics enabled for by default. Leaving the field blank will leave capacity analytics disabled on all SVMs.

    Uncheck the Enable on new storage VMs box to disable capacity analytics by default on new storage VMs.

  5. Select Save.

Modify File System Analytics settings on an SVM
  1. Select the SVM you want to modify then Storage VM settings.

  2. In the File System Analytics card, use the toggles to enable or disable Activity Tracking and capacity analytics for all new volumes on the storage VM.

CLI

You can configure the storage VM to enable File System Analytics by default on new volumes using the ONTAP CLI.

Enable File System Analytics by default on an SVM
  1. Modify the SVM to enable capacity analytics and Activity Tracking by default on all newly created volumes:
    vserver modify -vserver svm_name -auto-enable-activity-tracking true -auto-enable-analytics true

Top of Page