> 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/resilience-testing/shared-capabilities/custom-dashboards.md).

# Dashboards

Use out-of-the-box dashboards and build your own custom dashboards in the Harness Resilience Testing module

The Resilience Testing (RT) module provides dashboards that visualize key metrics from your chaos testing operations. You access them under the **Dashboards** section of the **Insights** left navigation.

The module ships with out-of-the-box (OOTB) dashboards for a high-level view of chaos testing across an account, and you can also build your own custom dashboards from Harness Unified Data Platform (UDP) queries.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-cebd80f4bdfde056ac273d7658fbf186c667c596%2Frisk-insights-dashboards-nav.png?alt=media" alt="The Dashboards item under the Insights section of the Resilience Testing left navigation"><figcaption><p>Click to view full size</p></figcaption></figure>

*The Dashboards item under Insights in the Resilience Testing module.*

Selecting **Dashboards** opens the dashboards landing page.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-b84d463509f1043c47254560a93bc9739e6bcc18%2Fdashboards-landing.png?alt=media" alt="The Dashboards landing page in the Resilience Testing module"><figcaption><p>Click to view full size</p></figcaption></figure>

***

### Out-of-the-box dashboards <a href="#out-of-the-box-dashboards" id="out-of-the-box-dashboards"></a>

The OOTB dashboards fall under three categories:

* **Experiment Activity**
* **Experiment Outcomes & Scores**
* **Authoring & People**

The following dashboards ship out of the box:

| Dashboard                                         | Category                     | Key widgets                                                                                                                                                                                                                                                                           |
| ------------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chaos Experiments by Target**                   | Experiment Activity          | Total Chaos Experiment Runs, Experiment Runs by Status, Faults created per Infrastructure, Experiments created per Infrastructure, Chaos Experiment Runs (Daily/Weekly), Experiment Runs per Chaos Experiment, Average & Median Resilience score, Chaos Experiment Runs (Project/Org) |
| **Chaos Experiment Outcomes Summary**             | Experiment Activity          | Total Chaos Experiment Runs, Chaos Experiment Outcome Distribution, Weekly Chaos Experiment Run Trend, Chaos Experiment Run Outcomes (Project/Org/Infrastructure)                                                                                                                     |
| **Resilience Score Trend (per Chaos Experiment)** | Experiment Outcomes & Scores | Chaos Experiment Run trend, Latest Run (Per Experiment), Chaos Experiment Pass Rate, Experiment Resilience score variance                                                                                                                                                             |
| **Top Repeat-Failing Experiments**                | Experiment Outcomes & Scores | Repeat-failing experiments, Repeat failing experiments (User)                                                                                                                                                                                                                         |
| **Chaos Experiment Creation Trend by User**       | Authoring & People           | Chaos Experiments created by users, Experiment creation per user (weekly), Chaos experiment creation (new users), Chaos Experiment Runs Creation (User)                                                                                                                               |
| **Top Contributors & Hub Authors**                | Authoring & People           | Top Actions Contributors, Top Probe contributors, Top Hub contributors, Top Probe creation by Probe type                                                                                                                                                                              |

The following is an example OOTB dashboard:

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-c9a43413a093819c0f973e2e958b5fb70f1a72db%2Fexample-dashboard.png?alt=media" alt="An example out-of-the-box dashboard showing chaos experiment metrics"><figcaption><p>Click to view full size</p></figcaption></figure>

***

### Create a custom dashboard <a href="#create-a-custom-dashboard" id="create-a-custom-dashboard"></a>

You can create your own dashboards to visualize the metrics that matter to your team. Complete the following steps.

1. Select the nine-dot icon at the top of the left navigation bar.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-139557a13fc76ce994c1f8a96178fd611c43b34d%2Fnav-9-dot.png?alt=media" alt="The nine-dot icon at the top of the left navigation bar"><figcaption><p>Click to view full size</p></figcaption></figure>

2. At the bottom of the navigation bar, select **Dashboards**.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-ce3e1dcd5d2dfeda59d713a9ca2dc93667750a56%2Fdashboards-nav-item.png?alt=media" alt="The Dashboards item at the bottom of the navigation bar"><figcaption><p>Click to view full size</p></figcaption></figure>

{% hint style="info" %}
**SWITCH TO THE NEW EXPERIENCE**

If you see a prompt to switch experiences, use the dropdown and select **Switch to new experience**.

<img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-b04728b9e754266b3700865d7798fa2f59565343%2Fswitch-new-experience.png?alt=media" alt="Click to view full size" data-size="original">
{% endhint %}

You now see the dashboards home.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-b864bf8066a33c0a71eb2c01165ab10982bdf1b9%2Fdashboards-home.png?alt=media" alt="The dashboards home screen"><figcaption><p>Click to view full size</p></figcaption></figure>

3. Select **+ Create Dashboard**. A right-side drawer opens.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-a59b9ccd5953603421eebc891186f28af5caa997%2Fcreate-dashboard-drawer.png?alt=media" alt="The Create Dashboard drawer"><figcaption><p>Click to view full size</p></figcaption></figure>

4. Enter a name and description. Add two mandatory tags so the RT module can identify and classify the dashboard:
   * `Chaos`
   * `<Category>`, where the category is one of `Experiment Activity`, `Experiment Outcomes & Scores`, or `Authoring & People`.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-60d3822ffa49f469755e87a79e71f2273b343db5%2Fdashboard-tags.png?alt=media" alt="The dashboard tags, showing the mandatory Chaos tag and a category tag"><figcaption><p>Click to view full size</p></figcaption></figure>

{% hint style="warning" %}
**TAGS ARE REQUIRED**

The `Chaos` tag and a category tag are mandatory. Without them, the RT module cannot identify or classify the dashboard, so it does not appear in the module's Dashboards section.
{% endhint %}

5. Select **Submit**. You land on the new, empty dashboard.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-4d9ba60b8d81d46017c07cd63df5c39de114470d%2Fnew-dashboard-empty.png?alt=media" alt="The new empty dashboard after submit"><figcaption><p>Click to view full size</p></figcaption></figure>

6. Select **+ Add Widget** to start adding widgets (individual tables or graphs).

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-6f0488bfcfac81187b99c60b3887b92d8ab30e7c%2Fadd-widget.png?alt=media" alt="The Add Widget button on the dashboard"><figcaption><p>Click to view full size</p></figcaption></figure>

7. Select **Data Widget**.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-4903af3a2ac6c21c91f951e57fec4078d3943806%2Fdata-widget.png?alt=media" alt="The Data Widget option"><figcaption><p>Click to view full size</p></figcaption></figure>

8. Toggle **Code View**.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-ac89cadcf25dc37705176c243066125ca06d26a4%2Fcode-view.png?alt=media" alt="The Code View toggle on the widget editor"><figcaption><p>Click to view full size</p></figcaption></figure>

9. Enter a name and description for the widget, then write your query in the **Query** text area. Go to [Dashboard query schema](#dashboard-query-schema) to review the available event and entity types.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-3e0577de88c610348a7762ab6537cef428ba7217%2Fwidget-query.png?alt=media" alt="The widget name, description, and Query text area"><figcaption><p>Click to view full size</p></figcaption></figure>

10. Select **Run Query** to fetch data from Harness UDP.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-aa1efaae7592129b557e6ded3a06c9bc017325d7%2Frun-query.png?alt=media" alt="The Run Query result showing fetched data"><figcaption><p>Click to view full size</p></figcaption></figure>

11. Choose a visualization. The available visualizations are:

    * Table View
    * Metric Card
    * Donut Chart
    * Bar Chart
    * Column Chart
    * Line Chart
    * Area Chart
    * Scatter Chart

    This example uses a **Donut Chart**.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-7c7ddfd25d35d2ebf9d8ed913d061e5343071182%2Fdonut-chart.png?alt=media" alt="A Donut Chart visualization of the query results"><figcaption><p>Click to view full size</p></figcaption></figure>

12. Select **Add Widget** at the top right to save the widget.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-aa03c858b53243e3d75559e2f954f19269f1463d%2Fadd-widget-save.png?alt=media" alt="The Add Widget button at the top right of the widget editor"><figcaption><p>Click to view full size</p></figcaption></figure>

13. The dashboard shows the widget you added. Add any remaining widgets, then select **Save** at the top right.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-4f2892bf4690d4c98a97fcf51aae6e74a2dd04db%2Fwidget-added.png?alt=media" alt="The dashboard showing the newly added widget with the Save button"><figcaption><p>Click to view full size</p></figcaption></figure>

14. Return to the RT module from the left navigation bar.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-f254b2f5c13757592337151219e6c93043892bbc%2Fback-to-rt.png?alt=media" alt="The left navigation bar option to return to the Resilience Testing module"><figcaption><p>Click to view full size</p></figcaption></figure>

15. In the RT module, go back to the **Dashboards** page under **Insights**.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-19cbdc1363028fc24a445f8659b18b6660edadbb%2Fdashboards-page.png?alt=media" alt="The Dashboards page under Insights in the RT module"><figcaption><p>Click to view full size</p></figcaption></figure>

Your custom dashboard now appears in the **Dashboards** section, filtered under the category you tagged it with, and you can open it to see the widgets you created.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-4122e9139b4332825b26eaf0f1451ea9e6f35e6c%2Ftest-dashboard-visible.png?alt=media" alt="The custom Test Dashboard visible in the Dashboards section under its tagged category"><figcaption><p>Click to view full size</p></figcaption></figure>

***

### RBAC considerations <a href="#rbac-considerations" id="rbac-considerations"></a>

Dashboards fall under the **Shared Resources** category, with **View** and **Manage** permissions:

* **View:** Required to see the RT module in-product dashboards.
* **Manage:** Required to create your own dashboards.

<figure><img src="https://3217710372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRmV5EkLS9r45VPaoUnJZ%2Fuploads%2Fgit-blob-e4617939f99743e653b064bf0203bb19c4c7c143%2Frbac-permissions.png?alt=media" alt="The Shared Resources dashboard permissions, showing View and Manage"><figcaption><p>Click to view full size</p></figcaption></figure>

Go to [RBAC in Harness](/harness-ai/use-harness-platform/platform-access-control.md) to configure roles and permissions.

***

### Dashboard query schema <a href="#dashboard-query-schema" id="dashboard-query-schema"></a>

Custom dashboard widgets query Harness UDP using event and entity types. The following reference lists the available types and example queries.

#### Event types <a href="#event-types" id="event-types"></a>

**Chaos Experiment Runs (`chaos:experiment_run_event`)**

```sql
find event chaos:experiment_run_event | select { created_at, resiliency_score, db_id, unique_id, parent_unique_id, last_modified_at, phase, infrastructure_id, event_timestamp, org_identifier, updated_by, fk_experiment_id, cdc_operation_type, experiment_run_id, sequence, experiment_name, project_identifier, created_by, target_services, account_identifier, yaml, deleted } | filter event_timestamp > ago(1h) | limit 10
```

#### Entity types <a href="#entity-types" id="entity-types"></a>

**Chaos Action (`chaos:action`)**

```sql
find entity chaos:action | select { created_at, description, tags, type, identifier, db_id, unique_id, parent_unique_id, last_modified_at, name, org_identifier, updated_by, account_identifier, project_identifier, created_by, infrastructure_type, deleted } | limit 10
```

**Chaos Action Template (`chaos:action_template`)**

```sql
find entity chaos:action_template | select { created_at, description, tags, type, identifier, db_id, unique_id, hub_identifier, last_modified_at, parent_unique_id, name, org_identifier, updated_by, account_identifier, project_identifier, created_by, infrastructure_type, deleted } | limit 10
```

**Chaos Execution Node (`chaos:execution_node`)**

```sql
find entity chaos:execution_node | select { experiment_id, db_id, finished_at, status, infrastructure_id, name, org_identifier, step_type, last_updated_at, experiment_run_id, spec, account_identifier, project_identifier, infrastructure_type, started_at, deleted } | limit 10
```

**Chaos Experiment (`chaos:experiment`)**

```sql
find entity chaos:experiment | select { created_at, description, tags, experiment_id, identifier, db_id, unique_id, parent_unique_id, last_modified_at, infrastructure_id, name, org_identifier, updated_by, account_identifier, project_identifier, created_by, infrastructure_type, deleted } | limit 10
```

**Chaos Experiment Run (`chaos:experiment_run`)**

```sql
find entity chaos:experiment_run | select { created_at, resiliency_score, db_id, unique_id, parent_unique_id, last_modified_at, phase, infrastructure_id, org_identifier, updated_by, fk_experiment_id, experiment_run_id, sequence, experiment_name, project_identifier, created_by, target_services, account_identifier, yaml, deleted } | limit 10
```

**Chaos Experiment Template (`chaos:experiment_template`)**

```sql
find entity chaos:experiment_template | select { created_at, description, tags, identifier, db_id, unique_id, hub_identifier, last_modified_at, parent_unique_id, name, org_identifier, updated_by, is_default, account_identifier, project_identifier, created_by, revision, template_uid, yaml, infrastructure_type, deleted } | limit 10
```

**Chaos Fault (`chaos:fault`)**

```sql
find entity chaos:fault | select { created_at, description, tags, type, identifier, db_id, unique_id, parent_unique_id, last_modified_at, name, org_identifier, updated_by, account_identifier, project_identifier, created_by, infrastructure_type, deleted } | limit 10
```

**Chaos Fault Template (`chaos:fault_template`)**

```sql
find entity chaos:fault_template | select { created_at, description, tags, type, identifier, db_id, unique_id, hub_identifier, last_modified_at, parent_unique_id, name, org_identifier, updated_by, is_default, account_identifier, project_identifier, created_by, revision, template_uid, yaml, infrastructure_type, deleted } | limit 10
```

**Chaos Hub (`chaos:hub`)**

```sql
find entity chaos:hub | select { created_at, description, tags, identifier, db_id, unique_id, parent_unique_id, last_modified_at, hub_id, name, org_identifier, updated_by, account_identifier, project_identifier, created_by, deleted } | limit 10
```

**Chaos K8s Infrastructure V2 (`chaos:k8s_infrastructure_v2`)**

```sql
find entity chaos:k8s_infrastructure_v2 | select { created_at, description, tags, kind, identifier, db_id, unique_id, parent_unique_id, last_modified_at, environment_identifier, name, org_identifier, updated_by, api_version, account_identifier, project_identifier, created_by, deleted } | limit 10
```

**Chaos Linux Infrastructure (`chaos:linux_infrastructure`)**

```sql
find entity chaos:linux_infrastructure | select { created_at, start_time, tags, description, db_id, infra_id, is_active, parent_unique_id, last_modified_at, unique_id, environment_identifier, name, version, is_infra_confirmed, is_registered, updated_by, org_identifier, account_identifier, project_identifier, hostname, created_by, last_heartbeat, deleted } | limit 10
```

**Chaos Probe (`chaos:probe`)**

```sql
find entity chaos:probe | select { created_at, description, tags, type, identifier, db_id, unique_id, parent_unique_id, last_modified_at, name, org_identifier, updated_by, account_identifier, project_identifier, created_by, infrastructure_type, deleted } | limit 10
```

**Chaos Probe Template (`chaos:probe_template`)**

```sql
find entity chaos:probe_template | select { created_at, description, tags, type, identifier, db_id, unique_id, hub_identifier, last_modified_at, parent_unique_id, name, org_identifier, updated_by, account_identifier, project_identifier, created_by, infrastructure_type, deleted } | limit 10
```

***

### Related concepts <a href="#related-concepts" id="related-concepts"></a>

* Go to [Harness Dashboards](/harness-ai/use-harness-platform/harness-dashboards/dashboard-legacy/dashboard-best-practices.md) to review dashboard best practices.
* Go to [RBAC in Harness](/harness-ai/use-harness-platform/platform-access-control.md) to manage dashboard permissions.

{% @harness-feedback/feedback %}