> 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/cd-building-blocks/executions/execution-history.md).

# Pipeline Execution History

Learn how to find pipeline execution history and what information it contains.

This topic describes how to access pipeline execution history and the information it contains.

### What you will learn from this topic

* Where to find [execution history](#where-can-i-find-execution-history) in the Harness UI.
* Understand the [execution reference](#execution-reference) details.
* How to [filter executions](#filter-executions) and use the [execution summary API](#execution-summary-api).

### Access execution history <a href="#where-can-i-find-execution-history" id="where-can-i-find-execution-history"></a>

You can find the execution history of a pipeline or all pipelines in a project in the following places in the Harness UI.

### Executions tab <a href="#executions-tab" id="executions-tab"></a>

The **Executions** tab in the left navigation lets you view the execution history of all pipelines in a project.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-3e29ea0ea00d85d23e7aa3be007bf30f4dc07d04%2Fleftnav-executions-tab.png?alt=media)

### Pipelines tab <a href="#pipelines-tab" id="pipelines-tab"></a>

You can also view the execution history of all pipelines in a project on the **Pipelines** tab.

In the Harness UI left navigation, select **Pipelines**. A list of pipelines in the project appears.

Select the **More** icon for the pipeline, then select **View Executions**.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-7cbcc03bb5021b88043e8fa0b1573b0793ccd181%2Fpipelinetab-executions.png?alt=media)

### Pipeline Studio <a href="#pipeline-studio" id="pipeline-studio"></a>

You can view the execution history of a specific pipeline using **Pipeline Studio**.

In the Harness UI left navigation, select **Pipelines**, then select the pipeline whose execution details you want to view.

Select **Execution History** in the top-right corner of the page.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-b5dc9892a94a9cc28a8d44eff554036f1b088380%2Fpipelinestudio-execution-history.png?alt=media)

### Execution reference <a href="#execution-reference" id="execution-reference"></a>

Each pipeline execution displays the following information.

* **Pipeline Name**
  * The name of the pipeline and execution ID.
  * When expanded, this column also shows the name of each stage in the pipeline.
* **Status**
  * Shows the status of the execution. The options are `SUCCESS`, `FAILED`, `ABORTED`, and `EXPIRED`.
  * When expanded, this column shows each stage's status as an emoji. Hover over an emoji for more information.
* **Trigger Summary**
  * This column shows the origin of each execution.
  * The origin is the trigger type that initiated the pipeline execution.
* **Update Summary**

  * This column shows **execution information** for CD and Database DevOps modules.
  * The Update Summary behaves differently based on the modules used in the pipeline:

  | Module          | Information Shown                                                                       | Example                       | On-hover                                                                                                                                                       |
  | --------------- | --------------------------------------------------------------------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | CD              | The update summary for CD shows **Service → Environment** mappings.                     | `service1 → environment1`     | Hovering over the service name displays the attached artifact version, tag, and path. Hovering over the environment name displays the attached infrastructure. |
  | Database DevOps | The update summary for Database DevOps shows **Schema Version → DB Instance** mappings. | `schema_v34 → orders-db-prod` | Hovering over the schema version displays the schema. Hovering over the DB instance displays the DB instance and tag, if any.                                  |

  * Click the `chevron-right` icon to expand the card, visualize the mappings, and view stage-wise execution details.

  ![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-e8888ac7e44d07bf64020b779d09de1df80d434d%2Fexecution-card-view.png?alt=media)

  * If there are more than three updates, a `View all n updates` indicator appears. Click it to open a panel with the full list of stage-wise updates. When there are three or fewer updates, click **View Details** to open the same panel. Select **View Execution Details** to view the execution details.

  ![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-3e1abbc0611924e12aef43467902866aa360ac24%2Fexecution-updates.png?alt=media)
* **Execution Start Time**
  * Shows the user, method, and start time of the execution.
* **More details**: The **More details** icon for each pipeline provides these actions:
  * [Add Execution Notes](https://developer.harness.io/harness-platform/use-harness-platform/pipelines/add-note-during-pipeline-execution)
  * Re-run from the stage
  * View Execution
  * View Pipeline
  * [Re-run Pipeline](https://developer.harness.io/harness-platform/use-harness-platform/pipelines/failure-handling/resume-pipeline-deployments)
  * [Abort Pipeline](https://developer.harness.io/harness-platform/use-harness-platform/pipelines/failure-handling/abort-pipeline)
  * [View Compiled YAML](https://developer.harness.io/harness-platform/use-harness-platform/pipelines/executions-and-logs/view-and-compare-pipeline-executions#view-compiled-yaml)
  * [Compare Pipeline Executions](https://developer.harness.io/harness-platform/use-harness-platform/pipelines/executions-and-logs/view-and-compare-pipeline-executions#compare-executions)
  * [Download Logs](https://developer.harness.io/harness-platform/use-harness-platform/pipelines/executions-and-logs/download-logs)

### Filter executions <a href="#filter-executions" id="filter-executions"></a>

You can filter pipeline executions using the filters in the **Execution History** or **Execution** tabs.

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

You can filter pipeline executions by **Status**, **Execution Mode**, **Trigger Type**, **Trigger Identifier**, **Timeframe**, **Deployment Type**, **Services**, **Environments**, **Artifacts**, or **Build Type**.

### Select your filters <a href="#select-your-filters" id="select-your-filters"></a>

{% tabs %}
{% tab title="Legacy Filter UI" %}
Use the default filter options shown at the top, such as **Status**, **Pipelines**, or **Select Repository**. To use more filter options, click the filter icon next to **Select a Saved Filter**.

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

Click **+ New Filter** to create and save filters for future use.
{% endtab %}

{% tab title="New Filter UI" %}
{% hint style="info" %}
You can use the new filter UI by enabling the feature flag `CDS_EXECUTION_LIST_FILTERS`. Contact [Harness Support](mailto:support@harness.io) to enable this feature.
{% endhint %}

Use the default filter options, such as **My Executions**, **Status**, or **Timeframe**. To use more filter options, click **+ Add Filter**.

![](https://3694223630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy1JhZ4oKIppwY7d5AhPj%2Fuploads%2Fgit-blob-1165bad02ced03aa2f02bbe1c690f771420065e5%2Fexecution-filter-3.png?alt=media)

Click **Save** to save your current filter settings. Click the filter dropdown icon in the top-right corner to view saved filters.
{% endtab %}
{% endtabs %}

***

### Status <a href="#status" id="status"></a>

Filter pipeline executions by status.

Available statuses include:

* Aborted
* Aborted By Freeze
* Expired
* Failed
* Not Started
* Paused
* Queued
* Running
* Success
* Suspended
* Resource Waiting
* Async Waiting
* Skipped
* Task Waiting
* Timed Waiting
* Errored
* Ignore Failure
* Discontinuing
* Approval Rejected
* Intervention Waiting
* Approval Waiting
* Pausing
* Input Waiting
* Wait Step Running
* Queued License Limit Reached
* Queued Execution Concurrency Reached

### View execution history <a href="#view-execution-history" id="view-execution-history"></a>

By default, the execution view lists all executions from the last 30 days, including re-runs and child pipelines. To view executions older than 30 days, select a custom time range on the **Execution** page.

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

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

Pipeline execution data is retained for a maximum of six months. If you filter for executions from the last six months, the data is available. Data older than six months is unavailable.
{% endhint %}

### Execution mode <a href="#execution-mode" id="execution-mode"></a>

Filter pipeline executions by execution mode:

* **Default**: Shows the latest execution for each retry, normal executions without retries, and rollbacks.
* **All**: Shows previous retries for retried executions and the default executions.
* **Rollback**: Shows only executions that ran in rollback mode.

Reference execution mode in your pipeline by using the expression `<+pipeline.executionMode>`. Go to [Pipeline expressions](https://developer.harness.io/harness-platform/use-harness-platform/variables-and-expressions/harness-expressions-reference#pipeline-expressions) to understand available pipeline expressions.

### Trigger type <a href="#trigger-type" id="trigger-type"></a>

Filter pipeline executions by trigger type.

Available trigger types include:

* MANUAL
* WEBHOOK
* WEBHOOK\_CUSTOM
* SCHEDULE\_CRON
* ARTIFACT
* MANIFEST

### Trigger identifier <a href="#trigger-identifier" id="trigger-identifier"></a>

Enter a trigger identifier to filter pipeline executions triggered by that trigger.

### Timeframe <a href="#timeframe" id="timeframe"></a>

Filter pipeline executions by time.

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

### Deployment type <a href="#deployment-type" id="deployment-type"></a>

Filter pipeline executions by the deployment type used in the pipeline.

Available deployment types include:

* Kubernetes
* Native Helm
* SSH
* WinRM
* Serverless Lambda
* Azure Web Apps
* Deployment Templates
* Amazon ECS
* Spot Elasticgroup
* Tanzu Application Service
* AWS Lambda
* AWS Sam

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

Filter pipeline executions by deployed service. Select services from the dropdown.

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

### Environments <a href="#environments" id="environments"></a>

Filter pipeline executions by the environment where you deployed the service.

### Artifacts <a href="#artifacts" id="artifacts"></a>

Filter pipeline executions by artifact.

### Build type <a href="#build-type" id="build-type"></a>

Filter pipeline executions by build type.

Available build types include:

* Pull Request/Merge Request
* Branch
* Tag

### Execution summary API <a href="#execution-summary-api" id="execution-summary-api"></a>

Harness provides an API to retrieve a summary of pipeline executions.

**Example: Sample cURL command**

```bash
curl --location 'https://app.harness.io/gateway/pipeline/api/pipelines/execution/summary?routingId=vpCkHKsDSxK9_KYfjCTMKA&accountIdentifier=vpCkHKsDSxK9_KYfjCTMKA&projectIdentifier=<your-project-id>&orgIdentifier=<your-org-id>&pipelineIdentifier=<your-pipeline-id>global&page=0&size=20&sort=startTs%2CDESC&myDeployments=false&searchTerm=' \
--header 'Authorization: Bearer <your-auth-token>' \
--header 'Content-Type: application/json' \
--data '{"filterType":"PipelineExecution","myDeployments":false,"timeRange":{"timeRangeFilterType":"LAST_30_DAYS"},"moduleProperties":{"ci":{},"cd":{}}}'
```

**Result limitations**

Due to the underlying technical implementation, the API cannot retrieve records beyond the 10,000th execution, even if you increase the page size. If the results exceed this limit, an error occurs.

If this limitation is encountered, an error message appears, as shown in the following example.

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

**Solution**

To avoid this limitation, apply additional filters, such as **Status** and **Time Range**, to narrow the result set. Go to the [Pipeline Execution API](https://apidocs.harness.io/tag/Pipeline-Execution-Details#operation/getListOfExecutions) to review the endpoint. Alternatively, use the [Pipeline Execution Outline API](https://apidocs.harness.io/tag/Pipeline-Execution-Details#operation/getListOfExecutionsOutline).

{% @harness-feedback/feedback %}
