> 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/continuous-delivery/use-continuous-delivery/monitor-deployments/monitor-cd-deployments.md).

# Monitor deployments and services in CD dashboards

Use DORA and other metrics for deployments and services in CD dashboards.

{% hint style="info" %}
This feature is in Beta[^1] and requires enablement. [View all early access features.](/release-notes/features.md)

{% @harness-feature-flag-access/request-feature-flag-access module="continuous-delivery" pagePath="continuous-delivery/use-continuous-delivery/monitor-deployments/monitor-cd-deployments" featureFlags="%5B%7B%22name%22%3A%22Simplified%20service%20dashboard%22%2C%22key%22%3A%22CDS\_SERVICE\_DASHBOARD\_SIMPLIFICATION%22%2C%22status%22%3A%22BETA%22%2C%22description%22%3A%22Simplifies%20the%20Service%20Dashboard%20to%20improve%20load%20times%20and%20overall%20performance%2C%20moving%20the%20graph%20previously%20shown%20at%20the%20top%20of%20the%20dashboard%20into%20a%20dedicated%20Analytics%20tab.%22%7D%2C%7B%22name%22%3A%22Service%20dashboard%20chart%20versions%20tab%22%2C%22key%22%3A%22CDC\_SERVICE\_DASHBOARD\_REVAMP\_NG%22%2C%22status%22%3A%22BETA%22%2C%22description%22%3A%22Adds%20a%20Chart%20Versions%20tab%20to%20the%20service%20dashboard%20showing%20tiles%20for%20each%20Helm%20chart%20used%20to%20deploy%20the%20service%2C%20for%20services%20deployed%20using%20Helm%20charts.%22%7D%5D" %}
{% endhint %}

This topic describes how to use DORA and other advanced metrics for deployments and services in CD Dashboards.

Deployments and services can be measured within the CD module (**Overview** and **Services** in the **Deployments** module) and using the Harness Platform Dashboards (**Dashboards**). Platform Dashboards also let you create highly advanced custom dashboards.

### What you will learn from this topic

* How to use the [Overview and Services dashboards](#overview-and-services-dashboards) in the CD module.
* How to view [individual service dashboards](#individual-service-dashboards).
* How to use [Platform Dashboards](#platform-dashboards) and the [built-in CD Dashboards](#built-in-cd-dashboards).
* How to create [Custom CD Dashboards](#custom-cd-dashboards).
* How to [monitor Harness and Jira approvals](#monitor-harness-and-jira-approvals-using-custom-cd-dashboards) and [deployment performance](#monitor-deployment-performance-using-custom-cd-dashboards) using custom CD dashboards.

### Before you begin

* Harness measures deployments and services within the CD module (**Overview** and **Services** dashboards) and uses the account-wide Platform Dashboards (**Dashboards**).

### Overview and services dashboards <a href="#overview-and-services-dashboards" id="overview-and-services-dashboards"></a>

Deployments are tracked in the **Overview** dashboard, and services are tracked in the **Services** dashboard.

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-28a877e8b980f017d432a37227406ee52e71047b%2Fmonitor-cd-deployments-17.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

### Overview dashboard <a href="#overview-dashboard" id="overview-dashboard"></a>

The Overview dashboard provides status for deployments and workloads, and an overall **Deployments Health** metric:

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-2229cd52d694c8353159a547ecd15df1da0a6800%2Fmonitor-cd-deployments-18.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

### Services dashboard <a href="#services-dashboard" id="services-dashboard"></a>

**What is a Harness service?** A Harness service is both a logical and a configuration view of the services you deploy.

The logical view is immutable and contains a name, a unique ID, and a description. The configuration view can be changed at each stage of a pipeline and contains the artifacts, manifests, repo URLs, etc., for that stage's service deployment.

**What is a service instance in Harness?** Harness licensing is determined by the service instances you deploy. A service instance represents your use of Harness to deploy a service and its underlying infrastructure. For example, it can be an instance of a Kubernetes workload where Harness creates the pods.

The **Services** dashboard provides an overview of all the services and service instances in your project:

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-e58efd8f06f4fef60f288592b23b525157d112ab%2Fmonitor-cd-deployments-19.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

{% hint style="info" %}
Harness has simplified the Service Dashboard to improve load times and overall performance. The graph previously shown at the top of the dashboard is now available under the **Analytics** tab. You can switch between the **Service** and **Analytics** tabs at the top right of the **Service Dashboard** page. This update is behind the feature flag `CDS_SERVICE_DASHBOARD_SIMPLIFICATION`. Contact [Harness Support](mailto:support@harness.io) to enable the feature flag.
{% endhint %}

### Individual service dashboards <a href="#individual-service-dashboards" id="individual-service-dashboards"></a>

Click a service in the **Total Services** table to drill down and show more service details:

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-4c50ac3b455ff61a1b45cdee1316448e148e34dd%2Fservice-dashboard.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

### Summary <a href="#summary" id="summary"></a>

Clicking any card in this dashboard filters the executions list to display executions relevant to the service and environment/artifact under the **Summary** tab.

An individual service's dashboard includes the following features.

{% hint style="info" %}
If you do not see the environment cards in the dashboard, you will see the message `There are no environments with instances in this service`. This appears when there are no environments with active instances for this service. You must perform an actual deployment to create active instances. Active services are those that were part of any pipeline execution (deployment) in the past 30 days.
{% endhint %}

**Open tasks**

The **See Open Tasks** banner will appear when there are deployments with the following statuses:

* Aborted
* Aborted by deployment freeze
* Expired
* Waiting
* Failed

Selecting **See Open Tasks** displays executions that require your attention.

The **See Open Tasks** button is displayed only if there are tasks from the last three days.

If the **See Open Tasks** button is not displayed, you can also see all tasks using the bell icon.

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-7e4c0470c1b1758da3c59e117598bbc5708bae54%2F9f67ae3af9c7f548f8bd9f802008e0d5d8710b167c9c4a00d4e8b611aa370401.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

**Environments tab**

The **Environments** tab lists the environments and environment groups where the service has been deployed by one or more pipelines.

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-d2a3d56107e98da3f82931d8d06bd7f48db8c79b%2F4e748162f05ea1d64ee5c64ca924fc41afe6c61fce81ccbbd7f1d32a64b40a90.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

Each environment card shows the following:

* **Latest artifact:** The latest artifact deployed by this service to this environment.
* **Drift detection:** Displays any differences between deployments within an environment group. For example, in this drift detection, two environments are using different artifacts with this service:

  <figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-7148d4c82b7973320d9f465721580b4886ae67fb%2F2f326c7718023be7ad2226f2ea3adb8a8eb772b7407304d134bbb3ffc8e473ad.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

  Drift detection helps identify inconsistencies. For example, when you deploy a service to an environment group, and there are failures in one of the environments, preventing artifacts from being deployed to it, or when someone performs a different deployment to one or more of the group's environments.
* **Instance details:** Details of the instances where the service was deployed.

  <figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-a7665f2c65a4be8d736d8e7080a048c13057fbae%2F7814890e535b27da5affb299c3bb5f38332a13a55056a2afb25b4963a17ac27c.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

  Select **Open Execution** in the instance details to see the pipeline execution that deployed the service instance.
* **Deployments:** each deployment to a selected environment or environment group. If you filter by **My Deployments**, you see only those deployments that your user account initiated.

**How instance information is obtained**

Harness runs a perpetual task that polls for the same combination of Harness service/artifact, Harness environment, and Harness infrastructure definition. The instance count and details are updated as a result of this polling.

The perpetual task is alive for 2 weeks, even after the instances are downsized/deleted.

**Deployed By** shows the email address of the Harness user who initiated the deployment.

**Deployed By** will show `AUTO_SCALED` instances scaled outside the Harness deployment. For example, if you log in to the Kubernetes cluster and manually scale instances.

**Artifacts tab**

The **Artifacts** tab shows how the service is mapped to multiple artifacts.

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-38f7cb99a955f2a7d0a6dfef1e13cae3770382b4%2F68c91f46f95bed7606ce6a593c8598eca5ecec3495011123113e2e5de0b55cd2.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

Each artifact card shows the following:

* **Artifacts:** each artifact used in a deployment of this service.
* **Environments:** each environment where an artifact was deployed with the service.
  * Clicking the artifact name opens details for all environments where the artifact was deployed.
  * Clicking the environment opens details for the specific environment where the artifact was deployed.
* **Drift detection:** displays any differences between deployments within an environment group. For example, if the artifact you select was deployed to an environment group, but one of the group's environments deployed a different artifact, or due to some failure, no artifacts were deployed to it, it is highlighted as drift:

  <figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-d61672ffdaeee0e4aabbd2d1f0f1ff0dd4f259fe%2Fb46ca573dd4b036c3ab5189e6edda2fd86207f6401e8337a52f365da443007a9.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

  Clicking the environment group name takes you to that group's settings. Clicking the execution date (in this example, `1 day ago`) takes you to the pipeline execution details.
* **Deployments:** each deployment of the service or a selected artifact. If you filter by My Deployments, you see only the deployments your user account initiated.

**View in table**

The **View in Table** setting shows all instances of the service across all environments used by the service.

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-c480e6417226fc256d09814c98338718d021736b%2Fd0bba45d5e8be50eeea30bcccbdffd4b0ed6d2900977782a2176257f53dc38ee.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

Select **Open Execution** in the instance details to see the pipeline execution that deployed the service instance.

**Custom sequencing**

In the **Environment** tab, you can use **Custom Sequence** to arrange the environment cards.

To use custom sequencing, do the following:

1. Select the **Environments** tab.
2. Select the gear icon next to **Custom Sequence**.

   <figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-f76d3b48043a7a14d110b41f089df92306ec9ad6%2F11ceac73896d71cbde9774efb01e64a8e42cc7d3f9470181116e58f809a91bd5.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>
3. In **Environment Sequence**, reorder the environment/group to create the desired sequence.
4. Select **Save**.

Now the environment cards are reordered.

You can disable custom sequencing by toggling it off.

**Chart Versions tab**

{% hint style="info" %}
**IMPORTANT NOTES**

* This information appears only for services that were deployed using Helm charts.
* This feature is behind the feature flag `CDC_SERVICE_DASHBOARD_REVAMP_NG`. Contact [Harness Support](mailto:support@harness.io) to enable the feature flag.
  {% endhint %}

The **Chart Versions** tab shows tiles for each Helm chart used to deploy the service (and a tile for any non-Helm deployments). Each tile shows the instances or artifact, environment, and latest deployment time.

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-01ef9d1fdc8baed22364092831386076f42f37eb%2Fcds-77310-charts-tab-callouts.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

To view details for a specific Helm chart, click the version link in the tile.

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-a867071e714fa79a4ad88666fc4cde6eea47b358%2Fcds-77310-chart-version-tile-callouts.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

### Metrics <a href="#metrics" id="metrics"></a>

The **Metrics** tab for a particular service provides details on service deployments, failure rate, deployment frequency, active service instances, the underlying environment and infrastructure for the service instance, and a summary of instances over a selected period.

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-daba73f6463df0f1be521387c58f17216be60f25%2Fservice-dashboard-metrics.png?alt=media" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

### Configuration <a href="#configuration" id="configuration"></a>

You can view the configuration of the selected service in Visual and YAML views under this tab.

### Referenced by <a href="#referenced-by" id="referenced-by"></a>

This tab lists all pipelines that use the selected service.

### Platform Dashboards <a href="#platform-dashboards" id="platform-dashboards"></a>

The account-wide Platform Dashboards in Harness include built-in dashboards that provide detailed insights into your deployments and services.

You can also create your own custom dashboards describing dimensions, aggregates, calculations, and data relationships.

The Platform Dashboards use [LookML](https://docs.looker.com/data-modeling/learning-lookml/what-is-lookml), a dependency-tracking tool that provides predefined data types and syntax for data modeling.

### Built-in CD Dashboards <a href="#built-in-cd-dashboards" id="built-in-cd-dashboards"></a>

Harness provides two built-in CD Dashboards: **Deployments** and **Services**.

To view these dashboards, in Harness, click **Dashboards**.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-b6c7e69c641b4faa988b4aa7e14f5b950777c4fa%2Fmonitor-cd-deployments-21.png?alt=media)

In **Dashboards**, click **Deployments** or **By Harness**.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-f35c50451a43f6d7730c6f88970485ca81b98bdd%2Fmonitor-cd-deployments-22.png?alt=media)

Look for the **Deployments Dashboard** and **Services Dashboard** in the dashboards that appear.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-c972aff1e7cb9a3504cf64085bb45b9f0ef028c5%2Fmonitor-cd-deployments-23.png?alt=media)

The following sections describe each dashboard.

**Deployments**

The Deployments dashboard provides detailed data on deployment frequency, status, and duration:

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-619647b94520b9de2a78ce7f4c0b460778ed5259%2Fmonitor-cd-deployments-24.png?alt=media)

Clicking data points, service names, or project names brings up data tables.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-d56ab522bdd339b048acaa1bd23c12efd345f532%2Fmonitor-cd-deployments-25.png?alt=media)

Click the Pipeline or Deployment and a new browser tab opens with the Pipeline or deployment from the record.

All data can be downloaded in multiple formats with multiple options.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-a1207edb99660cc887853b6b407069914a79420d%2Fmonitor-cd-deployments-26.png?alt=media)

**Services**

The services dashboard lets you measure the efficiency of your service deployments by Environment and overall.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-a51d34f94a058f3c112be4028761548611955fc5%2Fmonitor-cd-deployments-27.png?alt=media)

### Custom CD Dashboards <a href="#custom-cd-dashboards" id="custom-cd-dashboards"></a>

You can create custom CD dashboards that visualize deployment data by different dimensions and measures.

The following video shows how to create a CD custom dashboard:

{% embed url="<https://www.youtube.com/watch?v=9fqbYP6iK3g>" %}

Go to [Create Dashboards](https://developer.harness.io/harness-platform/use-harness-platform/harness-dashboards/dashboard-legacy/create-dashboards) to create a CD custom dashboard.

### Monitor Harness and Jira approvals using custom CD dashboards <a href="#monitor-harness-and-jira-approvals-using-custom-cd-dashboards" id="monitor-harness-and-jira-approvals-using-custom-cd-dashboards"></a>

Harness CD includes an extensive set of dashboard components that provide visibility into your Harness and Jira approvals. You can create custom dashboards that quickly answer questions such as:

* Which Harness and Jira Approval steps are currently waiting for approval?
* Which Jira Create and Update steps failed, and when?
* Which Jira tickets have been rejected in the Jira Approval step?
* Which deployments resulted in new or updated Jira tickets?
* How many approvals and rejections occurred in the specified time window?

{% hint style="info" %}
**IMPORTANT NOTES**

* Dashboard components for ServiceNow approvals are not available.
  {% endhint %}

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-84a0d2433b4aab341562c38c2dc80d1442ef67e1%2Fcd-approvals-dashboard-example.png?alt=media" alt=""><figcaption><p>CD approvals dashboard - example</p></figcaption></figure>

You can use the following components to monitor the performance of your deployment pipelines:

* Harness Approval
  * Step type
  * Duration
  * Status
  * Approver
  * Error messages
  * Approval message
* Jira Approval
  * Step type
  * Issue Type
  * Jira Ticket URL (or issue key and project if the URL is unavailable)
* JIRA Create/Update
  * Step type
  * Duration
  * Status
  * Error messages
  * Jira Ticket URL
  * Ticket Status

### Monitor deployment performance using custom CD dashboards <a href="#monitor-deployment-performance-using-custom-cd-dashboards" id="monitor-deployment-performance-using-custom-cd-dashboards"></a>

Harness CD includes an extensive set of dashboard components that provide visibility into your deployment pipelines' performance. You can create custom dashboards to answer questions such as:

* Which stages and steps contain performance bottlenecks?
* Which stages and steps have the most failures?
* How much time is spent deploying artifacts vs. waiting for Jira approvals and other manual interventions?

<figure><img src="https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-681ec14d56bf451cb18ab475ec91ea13f219fe23%2Fcd-performance-monitoring-dashboard.png?alt=media" alt="CD deployment performance dashboard - example"><figcaption><p>CD deployment performance dashboard - example</p></figcaption></figure>

You can use the following components to monitor the performance of your deployment pipelines:

* Manifest data (only for HelmChart Manifest type for Helm/K8S deployments)
  * Helm version
  * Chart Version
  * Manifest identifier
* Custom Stage Details
  * Stage type
  * Duration
  * Status
  * Failure message

{% @harness-feedback/feedback %}

[^1]: Beta features are feature-complete but still being validated. Available on request.