# DQ Report Summary

<figure><img src="/files/laom8p76gOVig7qvtXe2" alt="DQ Report Summary page showing scan results table with records scanned, failed, and % passed"><figcaption><p>DQ Report Summary — cross-asset view of monitor scan results with pass rate indicators.</p></figcaption></figure>

The DQ Report Summary page provides a cross-asset view of monitor scan results over a selected time period. It is accessible from the **Explore** section of the Telmai navigation.

Use this page to quickly identify which assets and monitors are producing failures, track overall data quality health, and drill into specific scan runs.

{% hint style="info" %}
DQ Report Summary only shows results from [Record Validation Rules](/telmai/monitoring-data/user-defined-monitors/record-validation-rules.md) and [SQL-based Rules](/telmai/monitoring-data/user-defined-monitors/sql-based-rules.md)
{% endhint %}

{% hint style="info" %}
This report can be published to external storage using the [DQ Reporting APIs](/telmai/api-reference/dq-reporting-apis.md)
{% endhint %}

{% hint style="warning" %}
If asset has metadata scans enabled & SQL-based rules, results will not show in DQ report — Future versions of Telmai will show results
{% endhint %}

### Filters

The following filters appear at the top of the page and apply to all summary statistics and table rows simultaneously.

| Filter              | Description                                                                    |
| ------------------- | ------------------------------------------------------------------------------ |
| **Project**         | Filter results to one or more projects. Defaults to all projects.              |
| **Connection Type** | Filter by the data source connection type (e.g., AWS S3, Snowflake, BigQuery). |
| **Assets**          | Filter to specific assets within the selected project and connection.          |
| **Period**          | Time window for scan results. Options: **1 week**, **2 weeks**, **1 month**.   |

***

### Summary Statistics

Four aggregate metrics are displayed at the top of the results view, reflecting all records matching the active filters.

| Metric                     | Description                                                                       |
| -------------------------- | --------------------------------------------------------------------------------- |
| **Total Records Scanned**  | Total number of records evaluated across all monitor scans in the period.         |
| **Total Records Failed**   | Total number of records that failed validation (`is_valid = 0`) across all scans. |
| **Total Assets Monitored** | Count of distinct assets with at least one scan result in the period.             |
| **Unique Monitors**        | Count of distinct monitors that produced scan results in the period.              |

***

### Results Table

Each row represents a single monitor scan run against an asset. Rows are sorted by **Scan Time** descending by default.

| Column              | Description                                                              |
| ------------------- | ------------------------------------------------------------------------ |
| **Scan Time**       | Timestamp of when the monitor scan completed.                            |
| **Project**         | The project the scanned asset belongs to.                                |
| **Asset**           | The name of the scanned asset.                                           |
| **Monitor**         | The name of the monitor that ran.                                        |
| **Records Scanned** | Number of records evaluated in that scan run.                            |
| **Records Failed**  | Number of records that did not pass validation.                          |
| **% Passed**        | Percentage of records that passed. Color-coded by threshold (see below). |

#### % Passed Color Coding

Pass rate is color-coded with fixed thresholds to give an at-a-glance health signal:

| Color     | Threshold       | Meaning         |
| --------- | --------------- | --------------- |
| 🟢 Green  | ≥ 90%           | Healthy         |
| 🟠 Orange | ≥ 70% and < 90% | Needs attention |
| 🔴 Red    | < 70%           | Critical        |

You can filter the table to a specific health band using the **Filter by % Success** toggle in the top-right of the results section (**All** / **≥ 90%** / **≥ 70%** / **< 70%**).

***

### Prerequisites

This page requires [Record Validation Rules ](/telmai/monitoring-data/user-defined-monitors/record-validation-rules.md)or [SQL Based Rules](/telmai/monitoring-data/user-defined-monitors/sql-based-rules.md) to be setup, and scans to run for results to show on this page.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.telm.ai/telmai/monitoring-data/dq-report-summary.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
