---
title: "Monitor and Troubleshoot Long-Running File IQ Scan and Aggregation Jobs"
slug: "monitoring-long-running-file-iq-scan-and-aggregation-jobs-exceeding-24-hours"
updated: 2026-04-27T14:24:08Z
published: 2026-04-27T14:24:08Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nasuni.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitor and Troubleshoot Long-Running File IQ Scan and Aggregation Jobs

The Nasuni File IQ appliance automatically scans each connected volume every 24 hours. If the scanning and internal aggregation processes for a volume take more than 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 volume-level scan progress.

**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 File IQ Long-Running Job Notifications Appear

If a volume sync 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 Long-Running File IQ Notifications

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

**Long Sync Notification:**Triggered when a volume sync operation exceeds 24 hours.

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

### When Notifications Repeat

Notifications fire at the following intervals:

- After 24 hours of continuous operation.
- Repeat every 24 hours if the condition persists.

### What the Notification Includes

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 Long-Running Job Notifications

**Long Sync Notification:**The Nasuni File IQ FS Metadata Service has detected a long-running volume sync: The scan execution for the Volume `&lt;volume_name&gt;` has been running since `&lt;start_time&gt;`. For more information, see the [**File IQ Service Support Dashboard**](/v1/docs/file-iq-dashboards#service-support)*.*

**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 `&lt;volume_name&gt;` has been running since `&lt;start_time&gt;`. For more information, see the [**File IQ Service Support Dashboard**](/v1/docs/file-iq-dashboards#service-support).

`&lt;volume_name&gt;` and `&lt;start_time&gt;` are dynamically replaced with actual values relevant to the alert.

### Example Notification Screenshot

![](https://cdn.document360.io/2adf6ce2-c120-4520-b135-0fc4463ddde3/Images/Documentation/image(749).png)

## Monitor Long-Running Scan and Aggregation Progress

### Use the 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 sync
- Last sync duration
- Date and time of the last scan
- Last scan duration
- Date and time of the last volume aggregation
- Last aggregation duration

![](https://cdn.document360.io/2adf6ce2-c120-4520-b135-0fc4463ddde3/Images/Documentation/image(827).png)

For more information on using this panel to monitor the progress of the current scan, refer to the [System Status Dashboard documentation](/v1/docs/file-iq-dashboards#system-status-dashboard).

### Use the Service Support Dashboard

The **Volume Scan State Logs** on the **Service Support** dashboard (located under the by-default collapsed **Volume Aggregation History** section at the bottom) provide a more detailed view 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 completed.

![](https://cdn.document360.io/2adf6ce2-c120-4520-b135-0fc4463ddde3/Images/Documentation/image(826).png)

For more information on using this panel to monitor the progress of the current scan, refer to the [Service Support Dashboard documentation](/v1/docs/file-iq-dashboards#service-support).
