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

# How to Visualize Test Results

> View data quality test results by entity, test suite, or individual test case from the Data Quality page or directly on a table.

# How to Visualize Test Results

Collate gives you two main entry points for reviewing test results: the **Data Quality** page and the table page.

## From the Data Quality Page

Select the **Profile** icon and navigate to **Observability** > **Data Quality**. The page has three tabs:

* **Summary**: Data health, data dimensions, and overall test results.
* **Test Cases**: Every test case, with filters.
* **Test Suites**: Test results grouped by test suite.

![Data Quality page with the Summary, Test Cases, and Test Suites tabs](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/data-quality-summary-tab.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=e29d2a627a56dbcb36c36778d1a717b7)

### View Results by Test Suite

To look at your tests grouped by test suite, select the **Test Suites** tab. Use **Table Suites** and **Bundle Suites** to switch between the two kinds of suites. Each row shows the suite **Name**, the number of **Tests**, the **Success %**, and the **Owners**. To find a suite, enter its name in **Search Table Suites**.

![Test Suites tab with the Table Suites and Bundle Suites toggle, the search box, and the list of suites](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/data-quality-test-suites-tab.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=a7c7ae68ff23fe07be8e3d010037262e)

Select a test suite to visualize the results associated with it. The suite page opens on the **Data Observability** tab, with the **Data Quality** sub-tab selected. It shows the number of total, successful, failed, and aborted tests, and the **Test Cases** list of the suite.

![Test suite page with the Data Quality sub-tab, the test counts, and the Test Cases list](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/test-suite-results.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=6736bb5124e987db72da499dfb1eb3ac)

### Filter Test Cases by Status

On the **Test Cases** tab, the filter bar has **Advanced**, **Table**, **Type**, **Status**, and **Tags** filters. Select **Clear all** to reset them.

![Test Cases tab on the Data Quality page with the filter bar](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/test-cases-status-filter.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=5e7d1f15bcc4fa7ad2ea96738e74f2ff)

The **Status** filter accepts several values at once. To filter by more than one status:

1. Select **Status**.
2. Select one or more of **Aborted**, **Failed**, **Queued**, and **Success**.
3. Select **Apply**. The button shows how many statuses you selected, for example **Apply (2)**.

   ![Status filter with Queued and Success selected and the Apply (2) button](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/test-cases-status-dropdown.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=ce522c2f63896162ddc0b3ceb7e89de7)

A test case matches if it has any of the selected statuses. A number next to **Status** shows how many statuses are applied. Select **Clear all** in the dropdown to remove the selection, or **Cancel** to close it without changes.

To filter by several statuses through the API, see [Filter by Multiple Statuses](https://docs.getcollate.io/ai-2-0/developer-guide/api-reference/data-quality/test-cases/list.md#filter-by-multiple-statuses).

### Open Test Cases From the Summary Tab

In **Data Health** on the **Summary** tab, the **Healthy Data Assets** card has a **Healthy** segment and an **Unhealthy** segment. Select a segment to open the **Test Cases** tab with the matching statuses already applied:

* **Healthy**: `Success` and `Queued`.
* **Unhealthy**: `Failed` and `Aborted`.

![Healthy Data Assets card on the Data Quality Summary tab, showing Healthy and Unhealthy counts](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/data-health-healthy-assets.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=ad22eb2b5b3b05dffbe04602f1937889)

## From a Table Page

Open the table page and select the **Data Observability** tab. The sub-tabs are **Overview**, **Table Profile**, **Column Profile**, **Data Quality**, and **Incidents**. Select **Data Quality** to see the test results at the table level and the column level.

The page shows the number of total, successful, failed, and aborted tests. Below the numbers, the **Test Cases** list shows the **Status**, the **Failed/Aborted Reason**, the **Last Run** time, the **Name**, the **Column**, and the **Incident** of each test case. Use the **Type** and **Status** filters, or **Search test case**, to narrow the list.

![Data Quality sub-tab of a table page with the test counts and the Test Cases list](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/table-data-quality-subtab.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=9ca574375392ab88c89361865dacfd1c)

## Review Result History and Run Details

Open a test case from **Data Quality** > **Test Cases**, or from the **Data Quality** sub-tab of a table, to see how the test has performed over time. The **Test Case Results** tab shows:

* **Last run**: The latest status and a message with the measured value and the expected range. It also shows the **Result / Expected** values, the run time, and when the next run is due, or **Not Scheduled**.
* **Result history**: A chart of the measured value over time. The caption names what Collate measures and what it compares against, for example "Column count vs. allowed range 2–10". A dashed line marks the allowed limit. A key under the chart names each marker, and aborted runs appear as hollow markers.
* **Configuration**, **Description**, **Test Suites**, **Tags**, **Glossary Term**, and **Data Products** panels beside the chart.

![Test case details page showing the Last run banner, the Result history chart, and the date range picker](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/result-history-card.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=687866f33570744f7c3001b07d59ccf8)

### Change the Result History Time Window

By default, **Result history** covers the last 30 days and ends today. To change the time window:

1. Select the date range on the **Result history** card.
2. Choose a time range in one of two ways:
   * Select a preset: **Today**, **Yesterday**, **This week**, **Last week**, **This month**, **Last month**, **This year**, **Last year**, or **All time**.
   * Pick start and end dates on the calendars, or type them in the date fields.
3. Select **Apply**.

![Date range picker with presets, two calendars, start and end date fields, and the Cancel and Apply buttons](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/result-history-date-range.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=cc29908e9b6fc572cab9c5e62e03bb80)

### Read the Run Summary Tiles

Below the chart, five tiles summarize the selected time window:

| Tile | Meaning |
| - | - |
| **Runs** | All runs, including queued runs. |
| **Passed** | Runs that succeeded. |
| **Failed** | Runs that failed. |
| **Aborted** | Runs that ended with an error before producing a result. |
| **Success rate** | Passed runs as a share of all runs that aren't queued. |

Queued runs count toward **Runs** but not toward the success rate, so the tiles might not add up to **Runs**. The success rate shows a dash when no run has finished.

![Result history chart with the Runs, Passed, Failed, Aborted, and Success rate tiles and the Run Details card](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/result-history-tiles-run-details.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=236ebeeb4afaf8c7bd5e29568f6454cc)

### Review Run Details

Below the tiles, the **Run Details** card shows the latest run by default. Hover over a marker on the chart to see its time and status, and select the marker to show that run instead. The card then shows a **Selected run** label, and **Back to latest** returns to the latest run.

The card shows the following:

* The run status, the date and time of the run, and how long the run took. If the run timed out, the duration is marked **(timeout)**.
* **Test definition**: The test that ran.
* **Expected**: The value or range that the test expects.
* **Found**: The value that the run measured.
* **Difference**: How far the measured value is from what the test expects.

For an aborted run, **Found** and **Difference** show a dash, because the run didn't produce a result.

![Run Details card for an aborted run, with the Selected run label and the Back to latest link](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/run-details-aborted.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=c6218bc805197288e9195cd00e867671)

An aborted run also shows an **Execution error** section below those values. It shows the type of the error and the message from the failed run, for example a database connection error, and the traceback when the run recorded one. Long messages are shortened. Select **more** to read the rest.

![Run Details card of an aborted run with the Execution error section showing a DatabaseError message](https://mintcdn.com/collatedocs/0wzjqZSdelZkFiom/public/images/ai-2.0/data-observability/data-quality/execution-error.png?fit=max\&auto=format\&n=0wzjqZSdelZkFiom\&q=85\&s=32f860ad802e44141651e28084e91f9a)

> [!WARNING]
>
> **Warning**: The error text can include host names, SQL text, and file paths from the run. Treat it as sensitive when you share it.

From Collate 2.0.6, the run that executed an aborted test case also records it as an execution failure. A run whose tests couldn't execute no longer ends as successful, and its success percentage counts each aborted test as a failure.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.