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

# Exception Dashboard

> How to use the Exception Analytics dashboard to track exception volume, age, status distribution, and trends across assets and owners.

<script type="application/ld+json">
  {`{
            "@context": "https://schema.org",
            "@type": "TechArticle",
            "headline": "Exception Dashboard",
            "description": "How to use the Exception Analytics dashboard to track exception volume, age, status distribution, and trends across assets and owners.",
            "url": "https://docs.dqlabs.ai/architecture/exceptions/exception-dashboard",
            "publisher": {
              "@type": "Organization",
              "name": "DQLabs Inc",
              "logo": "https://media.brand.dev/332adc35-5bc4-4d2b-bf78-256aa4a5e414.svg"
            }
            }`}
</script>

The Exception Dashboard provides a real-time view of exception record health across the organization. Navigate to **Analytics → Exception** to access it.

All data is live — the dashboard queries exception records directly without relying on scheduled aggregation jobs. KPI cards and charts always reflect the current state of the exception table.

## AI Summary

At the top of the dashboard, an AI-generated summary calls out the most important signal in the current filter/date range in plain language — for example, flagging a high volume of open exceptions, an unusually old average age, or a slow resolution rate — and points to which widget to check first.

## KPI cards

| Card                    | What it shows                                                |
| :---------------------- | :----------------------------------------------------------- |
| **Open Exceptions**     | Count of records not yet resolved, closed, or auto-resolved  |
| **Resolved Exceptions** | Count of records in RESOLVED, CLOSED, or AUTO RESOLVE status |
| **Average Age (Open)**  | Mean age of all currently open exception records             |

<Note>
  Average Age is measured from the time a record was first created. The aging clock freezes when a record is resolved — the frozen timestamp is used for historical average calculations.
</Note>

## Charts

### Status distribution — all exceptions

A donut chart showing the proportion of records in each status (New, In Progress, Ready for Review, Blocked, Resolved, Rejected, Re Open, Auto Resolved), with a legend showing the count for each.

### Exception trend

A time-series line chart showing daily counts across three lines:

* **Open** — records created per day that remain unresolved
* **Resolved** — records manually resolved or closed per day
* **Auto Resolve** — records the system automatically resolved per day

Use this chart to see whether your remediation rate — manual or automatic — is keeping pace with new exceptions or falling behind over time.

### Exception count by metric

A table ranking the metrics generating the most exception records, with columns for the metric, its asset, source, and the user who created it, alongside an invalid/failure count. Useful for spotting which metrics are the noisiest sources of exceptions.

### Top stewards by open exceptions

A table showing which exception owners have the most open records and the longest average age:

| Column      | Description                                              |
| :---------- | :------------------------------------------------------- |
| **Steward** | Exception owner (assigned user), or **Unassigned**       |
| **Open**    | Count of open records assigned to this steward           |
| **Avg Age** | Average age of each open record assigned to this steward |

Use this to identify overloaded stewards, remediation bottlenecks, or a large unassigned backlog.

### Oldest unresolved exceptions

A table showing which metrics have the oldest outstanding exception records:

| Column     | Description                                       |
| :--------- | :------------------------------------------------ |
| **Metric** | Quality metric with long-standing open exceptions |
| **Source** | Data source connection                            |
| **Age**    | Age of the oldest open record for this metric     |

Sorted by age descending — metrics at the top have records that have been open the longest.

## Filters

Apply filters to scope the entire dashboard to a subset of your data:

| Filter              | Options                                  |
| :------------------ | :--------------------------------------- |
| **Domain**          | Business area                            |
| **Application**     | Source system or processing platform     |
| **Product**         | Data product                             |
| **Tag**             | Tag labels                               |
| **Source**          | Specific data source connections         |
| **Asset Type**      | Table, view, etc.                        |
| **Asset**           | Table or view                            |
| **Date Range**      | Preset or custom range                   |
| **Slice By**        | Break down results by a chosen dimension |
| **Previous Period** | Compare against the prior period         |

All charts and KPI cards update simultaneously when a filter is applied.

## Drill-through to records

Click a KPI card or a row in a table (e.g. a metric in **Exception count by metric**, a steward, or a metric in **Oldest unresolved exceptions**) to navigate directly to the **Exception Records** page with the corresponding filters pre-applied.
