> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/apist-dashboard.md).

# Dashboard

Explore the APIST dashboard to see an overview of your API security testing, what each widget displays, where it leads, and which filters apply.

The dashboard is the overview page for API Security Testing (APIST). It displays the status of your scans and runners, and the issues those scans find. Go to [Getting Started with APIST](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/getting-started-with-ast.md) for more details. It also displays your remediation progress and how much of your API inventory you test. You can use this information to assess your testing posture.

The dashboard helps you:

* Confirm that scans run as expected and that runners are available to pick them up.
* Track how many issues your scans find, how many remain open, and how quickly you resolve them.
* Measure how much of your discovered API inventory you test, and how many APIs carry open issues.
* Move from a summary number straight to the detailed page behind it, with the relevant filters applied.

## What you will learn from this topic

By the end of this topic, you will be able to understand:

* Widgets on the dashboard.
* How to use the environment, time window, and refresh actions.
* What each widget displays and where it takes you.
* Which filters each widget follows.

***

## Demo

The following demo walks you through the dashboard and how you can leverage the information in the widgets:

{% @arcade/embed url="<https://app.arcade.software/share/wN3CFLS7HkHwRTDi9a5F>" flowId="wN3CFLS7HkHwRTDi9a5F" %}

***

## Before you begin

Make a note of the following before you open the dashboard:

* You have permission to open the dashboard under **Testing**. Go to [Role-Based Access Control (RBAC)](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/settings/configuration/teams/role-based-access-control-rbac.md) for more details.
* A runner is installed to execute your scans. Go to [Software and Hardware Requirements](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/runners-and-cli/software-and-hardware-requirements.md) and [Installing a Runner](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/runners-and-cli/installing-a-runner.md) for more details.
* You have created and run at least one scan. Go to [Creating a Scan](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/creating-a-scan.md) for more details.
* Define the authentication mechanism for your application and enable APIST on the environments you want to test. Go to [Authentication](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/advanced-usage/authentication.md) and [Environment Config](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/advanced-usage/environment-config.md) for more details.
* Discovery lists your APIs. Go to [Discovery](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/discovery/discovery-1.md) for more details.

***

## Overview

The APIST dashboard displays widgets that help you monitor scan activity, review findings, track remediation progress, and assess API test coverage. Use these widgets to quickly find the metrics you need.

Navigate to **Testing** → **Dashboard** to open the dashboard. Harness RPA groups the widgets as follows:

* **Scans by Status**
* **Runners**
* Findings and remediation: **New Issues**, **Unresolved**, **Resolve Rate**, and **Issues Trend**
* Attack surface: **API Test Coverage** and **Vulnerable APIs**
* **Latest 10 Scan Runs**

You can hover over the information icon next to a widget name to view a brief description of the widget and the filters it supports.

{% hint style="info" %}
Widgets apply environment and time window filters where supported. Go to [Filter support by widget](#filter-support-by-widget) for more details.
{% endhint %}

<figure><img src="https://1414883571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdr7UJpJrdGkkSGT6AFTu%2Fuploads%2Fgit-blob-bec81b03d99879f82e660a5607fa342a4baca8b5%2FDashboard.png?alt=media" alt="traceable apist dashboard view"><figcaption><p>APIST Dashboard</p></figcaption></figure>

***

## Actions

The page actions at the top of the dashboard control the scope of the data that the widgets display. This helps you focus on one environment or one period, for example, the week after a release, and compare results across them.

* **Environment filter:** The environment filter scopes the widgets to one environment. Use it to review the testing posture of one application environment. Harness RPA updates every widget that follows the environment filter. Select *All Environments* to view data across every environment. You can select only one environment at a time.
* **Time filter**: The time window filter sets the period that the widgets cover. Harness RPA updates every widget that follows the time window filter. You can select a predefined time range, such as *Last 15 minutes* or *Last 30 days*, or set a *Custom* range according to your requirements.
* **Refresh**: Click to reload the data on the dashboard. This also displays when the dashboard was last updated.

{% hint style="info" %}
By default, the dashboard displays data for All Environments over the Last 1 week. You can customize these filters to suit your requirements.
{% endhint %}

***

## Widgets

The widgets summarize testing activity, findings, and coverage. This helps you spot what needs attention, such as a drop in coverage or a rise in unresolved issues, and open the page where you can act on it.

### Scans by Status

**Scans by Status** displays the number of scans by status. This helps you confirm that scheduled and ad hoc scans complete, and spot scans that are queued, paused, or aborted before they leave gaps in your testing.

The center of the chart displays the total number of scans for the selected time window and environment. You can see the number of scans in each of the following statuses:

* *Running*
* *Completed*
* *Aborted*
* *Queued*
* *Paused*

Click **All Scans** to open the **Scans** page. Go to [Scan Runs](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/scan-runs.md) for more details on scan statuses.

### Runners

**Runners** displays the availability of your runners. This helps you confirm that enough runners are free to pick up scans, and spot inactive runners that you need to restart or remove.

The center of the chart displays the total number of runners across all environments. You can see the number of runners in each of the following statuses:

* *Idle*
* *Busy*
* *Inactive*

Click **All Runners** to open the **Runners** page under **Testing**. Go to [Understanding Runners Dashboard](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/runners-and-cli/understanding-runners-dashboard.md) for more details on runner statuses.

### Findings and remediation

The findings and remediation widgets track the issues your scans find and how you resolve them. You can use them to triage recent findings, size your remediation backlog, and report remediation progress. Go to [APIST Issues](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/apist-issues.md) for more details on issues.

| Widget           | Overview                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **New Issues**   | Displays the issues recently identified for the first time. This helps you gauge the security impact of recent changes, such as a new release, and decide where to start triage.        | <p>Displays the number of newly identified issues in the selected environment, followed by a percentage change. The percentage change compares the current value with the value from 7 days earlier.<br>Click <strong>View Issues</strong> to open the <strong>Issues</strong> page, filtered by creation time. Go to <a href="https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/issues.md">Issues</a> for more details.</p>                                                                                                                                        |
| **Unresolved**   | Displays the issues that remain open and require remediation. This helps you size your remediation backlog and track whether it grows or shrinks over time.                             | <p>Displays the total number of unresolved issues across all scans and environments, followed by a percentage change. The percentage change compares the current value with the value held one selected time window ago. For example, when you select <em>Last 30 days</em>, the change displays how the value moved over those 30 days.<br>Click <strong>View Unresolved</strong> to open the <strong>Issues</strong> page, filtered by issue status. Go to <a href="https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/issues.md">Issues</a> for more details.</p> |
| **Resolve Rate** | Displays the percentage of identified issues that have been resolved. This helps you measure how effectively you remediate findings and report progress toward your remediation goal.   | <p>Displays the rate on a gauge, against a fixed target of <em>80%</em>. The dashboard calculates the rate across all available data in the selected environment:<br><code>Resolve rate = (Resolved issues / Detected issues) × 100</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Issues Trend** | Compares the issues identified and resolved over the selected period. This helps you see whether your remediation keeps pace with new findings and which severities drive your backlog. | Displays the *Total Issues, Critical, High, Medium,* and *Low* counts, each followed by a percentage change with respect to the time period. The chart also displays a line chart of *Open* and *Resolved* issues for the selected time window and environment.                                                                                                                                                                                                                                                                                                                                                                                                                           |

### Attack surface

The attack surface widgets measure how much of your API inventory you test and how much of it is exposed. You can use them to track progress toward your coverage goal and to prioritize the APIs to fix first. Go to [API Endpoints](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/discovery/discovery-1/inventory/api-endpoints.md) for more details on discovered APIs.

| Widget                | Overview                                                                                                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API Test Coverage** | Displays the number of discovered APIs that have been tested. This helps you measure how much of your API inventory your scans reach.                          | Displays the number of tested APIs for the selected time window and environment, followed by a percentage change against that time window. Go to [API Coverage](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/api-coverage.md) for more details on the coverage of a single scan.                                    |
| **Vulnerable APIs**   | Displays the APIs that carry at least one open issue. This helps you see how much of your tested attack surface is exposed and decide which APIs to fix first. | Displays the number of APIs with vulnerabilities identified during the selected time window, in the selected environment. Click **View APIs** to open the **Issues** page, grouped by asset and filtered by creation time. Go to [Issues](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/issues.md) for more details. |

### Latest 10 Scan Runs

**Latest 10 Scan Runs** displays the health of your 10 most recent scan runs. This helps you review recent results without opening each scan, and spot runs that found issues or tested little of your inventory.

The table lists the 10 most recent scan runs in the selected environment, and a scan that ran more than once can appear in several rows. The time window does not change the list. You can sort every column:

| Column                | Description                                                                         |
| --------------------- | ----------------------------------------------------------------------------------- |
| **Scan Run**          | Displays the scan name and run number, for example, *reachability-replay-scan #20*. |
| **Issues**            | Displays the number of issues found in the run, by severity.                        |
| **API Test Coverage** | Displays the percentage of APIs the scan run scanned.                               |
| **Tests Coverage**    | Displays the percentage of generated tests that the scan run executed.              |
| **Start Time**        | Displays the date and time the run started.                                         |

The **Issues** column uses the following severity labels:

* *C*: Critical
* *H*: High
* *M*: Medium
* *L*: Low
* *I*: Informational

Click a row to open the **Scan Runs** tab of the scan run, with the details of that run. Go to [Scan Runs](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/scan-runs.md) for more details on scan runs.

***

## Filter support by widget

Each widget follows the environment filter, the time window filter, both, or neither. This helps you read each widget correctly when you change the page actions.

In the table below, *Yes* means the value of the widget updates when you change that filter. *No* means the widget keeps the same value, whatever you select for that filter.

| Widget                  | Environment filter | Time window filter |
| ----------------------- | ------------------ | ------------------ |
| **Scans by Status**     | Yes                | Yes                |
| **Runners**             | No                 | No                 |
| **New Issues**          | Yes                | No                 |
| **Unresolved**          | No                 | No                 |
| **Resolve Rate**        | Yes                | No                 |
| **Issues Trend**        | Yes                | Yes                |
| **API Test Coverage**   | Yes                | Yes                |
| **Vulnerable APIs**     | Yes                | Yes                |
| **Latest 10 Scan Runs** | Yes                | No                 |

***

### Next steps

Use these pages to investigate dashboard data and act on findings:

* Go to [Understand Scans and Traffic Types](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/understanding-scans-and-traffic-types.md) for more details on scans and traffic types.
* Go to [Scan Details](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details.md) for more details on individual scan results.
* Go to [APIST Issues](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/apist-issues.md) for more details on triaging and remediation of issues.
* Go to [Understanding Runners Dashboard](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/runners-and-cli/understanding-runners-dashboard.md) for more details on managing scan runner availability.
