Monitoring Long-Running File IQ Scan and Aggregation Jobs (Exceeding 24 Hours)

Prev Next

The Nasuni File IQ appliance automatically performs a scan every 24 hours for each connected volume. If the scanning and internal aggregation processes for a volume exceed 24 hours, a notification appears in the Nasuni Management Console (NMC) for that volume.

In addition to these NMC notifications, File IQ offers enhanced visibility into long-running scans and aggregation jobs through its dashboards:

System Status Dashboard: Use the Volume Scan Detailed Status panel to monitor scan progress on a volume basis.

Service Support Dashboard: Use the Current State of Volume Scan panel for real-time insights into ongoing scans.

Note: Extended scan durations are expected when a volume is first connected to the File IQ appliance or if there have been significant changes (for example, during a bulk file import to the volume). Volumes containing a large number of directories and files may require several days to complete initial scanning, depending on their size.

When Notifications Are Triggered

If a volume pull or a scan and aggregation process runs for more than 24 hours, the NMC displays a notification. These alerts are designed to keep you informed and enable proactive troubleshooting of extended operations.

Types of Notifications

The following are two types of long-running operation notifications:

Long Pull Notification: Triggered when a volume pull operation exceeds 24 hours.

Long Scan and Aggregation Notification: Triggered when the combined duration of a volume scan and its aggregation exceeds 24 hours.

Notification Timing

Notifications fire at the following intervals:

  • After 24 hours of continuous operation.

  • Repeat every 24 hours if the condition persists.

Notification Contents

Each notification includes the following information:

  • The name of the File IQ appliance that triggered the alert

  • The volume name associated with the extended scan

  • A direct link to this support document for further guidance

  • Quick access to the File IQ Service Support Dashboard for deeper investigation

Example Notification Messages

Long Pull Notification: The Nasuni File IQ FS Metadata Service has detected a long-running volume pull: The scan execution for the Volume <volume_name> has been running since <start_time>. For more information, see the File IQ Service Support Dashboard.

Long Scan and Aggregation Notification: The Nasuni File IQ FS Metadata Service has detected a long-running job execution (scan+aggregation): The job execution for the Volume <volume_name> has been running since <start_time>. For more information, see the File IQ Service Support Dashboard.

<volume_name> and <start_time> are dynamically replaced with actual values relevant to the alert.

Example Notification Screenshot

Monitoring Long-Running Scans and Aggregation Progress

System Status Dashboard

The System Status dashboard can be used to check the current activity of the scan and aggregation process on a volume basis using the Volume Scan Detailed Status panel. This panel provides a list of activities on a volume basis with some statistics:

  • Date and time of the last volume pull

  • Last pull duration

  • Date and time of the last scan

  • Last scan duration

  • Date and time of the last volume aggregation

  • Last aggregation duration

For more information on using this panel to monitor the progress of the current scan, refer to the System Status Dashboard documentation.

Service Support Dashboard

The Volume Scan State Logs of the Service Support dashboard (located under the by-default collapsed Volume Aggregation History section at the bottom) provide a means to gain a more detailed understanding of current scan and aggregation activities. This view can be used when a long-running scan is in progress to ensure that the scan for a given volume progresses as expected.
The volume scan and certain aggregations display detailed progress indicators, enabling you to estimate the percentage of the task that has been completed.

For more information on using this panel to monitor the progress of the current scan, refer to the Service Support Dashboard documentation.