# Health Dashboard


RudderStack's **Health** dashboard provides an intuitive UI to monitor all your Event Stream and Reverse ETL pipelines. It also provides realtime observability metrics for the tracking plans linked to your sources, including validation errors, violation types, etc.

To access this dashboard, log in to your [RudderStack account](https://app.rudderstack.com/) and go to **Monitor** > **Health** in the left navigation bar.

## Overview

In the **Overview** section, you get a quick summary of the following:

- Number of destinations with failures across your Event Stream pipelines, including [cloud]({{< ref "destinations/streaming-destinations/_index.md" >}}) and [warehouse]({{< ref "destinations/warehouse-destinations/_index.md" >}}) destinations.
- Number of [Reverse ETL]({{< ref "sources/reverse-etl/_index.md" >}}) connections facing issues related to sync runs.
- Number of event violations for all the [tracking plans]({{< ref "data-governance/tracking-plans/_index.md" >}}) linked to your sources.

You can filter these metrics by period - one day, one week, or one month - depending on your requirement.

{{< image src="images/features/health-dashboard/health-dashboard-overview.webp" alt="Health dashboard overview" >}}

## Active alerts

In the **Overview** section of the Health dashboard, you also see the active alerts (symbolized by the bell icon) - these are **unresolved** alerts that RudderStack triggered (based on the thresholds set by the customers at the [workspace]({{< ref "monitor/alerts.md#workspace-level-alerts" >}}) or [resource]({{< ref "monitor/alerts.md#resource-level-alerts" >}}) level).

Note that the number next to the bell icon signifies the number of resources across which active alerts are present:

- For [**Event Stream**](#event-stream), it denotes the number of destinations.
- For [**Reverse ETL**](#reverse-etl), it denotes the number of connections.
- For [**Tracking Plans**](#tracking-plans), it denotes the number of sources.

To view the active alerts:

1. Click the bell icon next to the resource.

{{< image src="images/features/health-dashboard/active-alerts-1.webp" alt="Active alerts for resource" >}}

2. From the resulting pane, go to that resource via the **View destination** or **View source** button.
3. Click the bell icon on the top right of the resource page to view the alert.

{{< image src="images/features/health-dashboard/active-alerts-2.webp" alt="Active alerts for resource" >}}

{{< image src="images/features/health-dashboard/active-alerts-3.webp" alt="Active alerts for resource" >}}

## Event Stream

{{< info >}}
The health dashboard shows event delivery and failure metrics for [cloud mode]({{< ref "destinations/rudderstack-connection-modes.md#cloud-mode" >}}) connections only. It does not include data for the [device mode]({{< ref "destinations/rudderstack-connection-modes.md#device-mode" >}}) connections.
{{< /info >}}

In this view, you get a list of all the Event Stream destinations in your workspace with the following details:

{{< image src="images/features/health-dashboard/event-stream-overview.webp" alt="Event stream destinations overview" >}}

| Metric | <div style="width:300px">Description</div> |
| :---| :----|
| Events delivered | Number of successfully delivered events, sortable by count or [rate of change](#change-percentage-calculation).<br /><br /> {{< image src="images/features/health-dashboard/sorting-options.webp" alt="Event stream destinations sorting options" >}} | 
| Failures | Number of event failures (due to processing, transformation, or delivery errors) sortable by count or [rate of change](#change-percentage-calculation). |
| Failure rate | RudderStack calculates the failure rate as follows: <br /><br /> {{< image src="images/features/health-dashboard/failure-rate-calculation.webp" alt="Event stream destinations failure rate calculation" >}} |
| P95 latency <br/> <span style="color: #4D4DFF;font-size:12px;">Enterprise plan only</span> | Maximum latency for 95% of the events to reach the destination. <br /><br />See [P95 latency alerts]({{< ref "monitor/alerts.md#p95-latency-alerts" >}}) for more details. |

You can also compare the metrics for the current selected period (day, week, or month) against the previous period:

{{< image src="images/features/health-dashboard/compare-metrics.webp" alt="Event stream destinations compare metrics" >}}

RudderStack provides a toggle to filter your destinations by [Cloud]({{< ref "destinations/streaming-destinations/_index.md" >}}) and [Warehouse]({{< ref "destinations/warehouse-destinations/_index.md" >}}). Click the **Failures** tab to view only the destinations that have event failures.

{{< image src="images/features/health-dashboard/event-stream-toggle.webp" alt="Filter toggle for event stream destinations" >}}

You can also filter metrics for only the enabled/disabled destinations by clicking the filter option in the **Destination** column:

{{< image src="images/features/health-dashboard/enabled-disabled-destinations.webp" alt="Filter for enabled/disabled  destinations" >}}

### Get failure metrics

Click any row to get the destination-level data for event failures. A panel pops up on the right with the following information:

- An alerts section containing the following details:
  - Alert description.
  - Time and date from when the alert is active.
- Failure details.

{{< image src="images/features/health-dashboard/event-failure-metrics.webp" alt="Event failure metrics for cloud destinations" >}}

#### Cloud destinations

RudderStack provides the following details for the failed events associated with the cloud destination:

- **Event name**
- **Event type** (`identify`, `track`, `page`, etc.)
- **Source**
- **Count**: Number of failed events.
- **Last happened**: When the error last occurred.

Click the event to see a sample error and failed event payload.

{{< warning >}}
You **must** have the required [PII permissions]({{< ref "access-management/policies-overview.md#pii-permissions" >}}) to see the failed event payload.
{{< /warning >}}

{{< image src="images/features/health-dashboard/event-payload-error.webp" alt="Event payload and sample error" >}}

Click the **View Destination** button on the top right to go to the destination page.

{{< image src="images/features/health-dashboard/event-stream-view-destination.webp" alt="View destination button" >}}

#### Warehouse destinations

RudderStack provides the following details for the failed events associated with the warehouse destination:

- **Staging events**: These correspond to the errors that occur in the staging process (during transformation or object storage, for example) before the syncs start. You will see the following details in this tab:

  - **Event name**
  - **Event type** (`identify`, `track`, `page`, etc.)
  - **Source**
  - **Count**: Number of failed events with the **Event name**.
  - **Last happened**: When the error last occurred.

Click the event to see a sample error and failed event payload. For more details, click the **View Destination** button on the top right.

{{< warning >}}
You **must** have the required [PII permissions]({{< ref "access-management/policies-overview.md#pii-permissions" >}}) to see the failed event payload.
{{< /warning >}}

{{< image src="images/features/health-dashboard/warehouse-destination-staging-error.webp" alt="Warehouse destination staging error and sample payload" >}}

- **Syncs**: These correspond to the errors that occur during the warehouse syncs. You will see the following details:

  - **Error category**
  - **Source**
  - **Events count**
  - **Last happened**
  - **Status**

Click the event to see a sample error. You can also retry syncing the event to the warehouse by clicking the **Retry all** button.

{{< warning >}}
You **must** have the required [PII permissions]({{< ref "access-management/policies-overview.md#pii-permissions" >}}) to see the failed event payload.
{{< /warning >}}

{{< image src="images/features/health-dashboard/warehouse-sync-error-new.webp" alt="Sample error for warehouse syncs" >}}

### Change percentage calculation

RudderStack calculates the change percentage for the [Event Stream destinations](#event-stream-destinations) as follows:

| Metric | Change percentage equation |
| :---- | :----- |
| Events delivered | (Current period count - Prior period count) / Prior period count * 100 |
| Failures |  (Current period count - Prior period count) / Prior period count * 100 | 
| Failure rate |  Current percentage - Prior percentage |

Here, **period** is the time period by which you want to filter the metrics - one day, one week, or one month.

{{< image src="images/features/health-dashboard/time-period.webp" alt="Time period" >}}

## Reverse ETL

In this view, you get the following information on the latest syncs that are ongoing or completed across each Reverse ETL connection.

- Source-destination connection
- Status of the latest run (In progress, Completed without failures, Completed with failures, or Aborted)
- Duration of the sync
- Sync start time
- Failures (Percentage of deltas (new rows) that failed to sync)
- Invalids (Invalid records sent from the source)
- Summary of failed or aborted syncs in the selected duration (1 day, 1 week, or 1 month)

{{< image src="images/features/health-dashboard/retl-sync-overview.webp" alt="Reverse ETL tab overview" >}}

Each row corresponds to an individual connection with details on the latest sync and a summary of the failed or aborted syncs during the selected time period.

{{< info >}}
The **Aborted** status code implies an unsuccessful sync due to a number of reasons:

- Sync was aborted or stopped manually.
- RudderStack encountered issues while connecting to the warehouse due to incorrect configuration, changed credentials, or downtime.
{{< /info >}}

Hover over the **Failures** column to see percentage of failed deltas (new records since last sync). In the below image, the latest run status is **Completed, with failures** as some deltas failed to sync.

{{< image src="images/features/health-dashboard/failures-column.webp" alt="Reverse ETL tab overview" >}}

Hover over the **Invalids** column to see percentage of invalid records sent from the source. In the below image, the latest run status is **Completed, no failures** as RudderStack did not face any errors or failures while syncing the deltas. However, three out of six rows synced from the source were invalid.

{{< image src="images/features/health-dashboard/invalids-column.webp" alt="Reverse ETL tab overview" >}}

### Get sync details

Click any row to get the connection-level alerts and error details. A panel pops up on the right with the following information:

- An alerts section containing the following details:
  - Alert description.
  - Time and date from when the alert is active.
- Sync failure details

#### Aborted

The following image highlights a connection with an **Aborted** status and a **Fatal syncs** alert:

{{< image src="images/features/health-dashboard/retl-failure-metrics.webp" alt="Failure alerts and details for RETL source" >}}

#### Completed with failures

The following image highlights a connection with a **Completed, with failures** status. You can click a failed record to see a sample error and event payload.

{{< warning >}}
You **must** have the required [PII permissions]({{< ref "access-management/policies-overview.md#pii-permissions" >}}) to see the failed records.
{{< /warning >}}

{{< image src="images/features/health-dashboard/retl-failure-metrics-2.webp" alt="Failure details for RETL source" >}}

#### Completed with no failures

The following image highlights a connection with a **Completed, no failures** status.

{{< image src="images/features/health-dashboard/retl-no-failure-metrics.webp" alt="Failure details for RETL source" >}}

#### View syncs

Click the **View Syncs** button on the top right to get the additional sync-specific details like: 

- Sync type (full/incremental)
- Number of rows in source
- Number of deltas (new data since last sync)
- Invalid records

{{< image src="images/features/health-dashboard/individual-sync-details.webp" alt="Individual sync details" >}}

## Tracking plans

In this view, you get a list of all the sources connected to a [tracking plan]({{< ref "data-governance/tracking-plans/_index.md" >}}) in your workspace with the following details (along with the change percentage):

- Tracking Plan
- Events validated (sortable by count or rate of change)
- Violations (sortable by count or rate of change)

RudderStack also provides a **Violations** tab to view only the sources that have tracking plan violations.

{{< image src="images/features/health-dashboard/tracking-plan-overview.webp" alt="Tracking plans overview" >}}

### Validation error details

Click a row to get the validation error details. A panel pops up on the right with the following details:

- An alerts section containing the following details:
  - Alert description.
  - Time and date from when the alert is active.
- Events and violation details like:

  - **Event name**
  - **Event type** (`identify`, `track`, `page`, etc.)
  - **Events validated**
  - **Events dropped**
  - **Last occurred**: When the error last occurred.

{{< info >}}
Use the **Version** dropdown to view the metrics for a tracking plan version. This is helpful if your tracking plan has undergone revisions recently.
{{< /info >}}

{{< image src="images/features/health-dashboard/tracking-plan-version.webp" alt="Filter metrics by tracking plan version" >}}

Click the event to see the [violation type]({{< ref "data-governance/tracking-plans/violation-management.md#violation-types" >}}) along with a sample violation description and event payload.

{{< warning >}}
You **must** have the required [PII permissions]({{< ref "access-management/policies-overview.md#pii-permissions" >}}) to see the Tracking Plan violation samples.
{{< /warning >}}

{{< image src="images/features/health-dashboard/tracking-plan-violations.webp" alt="Tracking plans violation details" >}}

Click **View Source** to go to the source page. You will be redirected to the **Events** tab where you can view the detailed event ingestion and violation metrics.

{{< image src="images/features/health-dashboard/source-event-metrics.webp" alt="Source event details" >}}

<br />