---
title: "Agent Runs"
description: "Monitor, inspect, and manage Cloud Agent run history."
diataxis: how-to
applies_to:
  product: "nirmata-ai-agents"
audience: ["platform-engineer"]
last_updated: 2026-04-16
url: https://docs.nirmata.io/docs/control-hub/agent-hub/cloud-agents/agent-runs/
---


Agent Runs is the unified view of all Cloud Agent executions — across every agent, every cluster, and every trigger source. Navigate to **Agent Hub → Cloud Agents → Agent Runs**.

## What You Can Do

### Filter and Find Runs

Filter the runs list by:

- **Status** — Running, Completed, Failed, Cancelled
- **Agent name** — view all runs for a specific agent
- **Trigger source** — Manual, Schedule, Copilot, Webhook, or Event
- **Cluster** — runs targeting a specific cluster
- **Date range** — narrow to a specific time window

### View Run Details

Click any run to open its detail view:

| Field | Description |
|-------|-------------|
| **Status** | Current state — Running, Completed, Failed, or Cancelled |
| **Triggered by** | Who or what started the run — a user name, schedule name, Copilot session, or webhook |
| **Target cluster** | The cluster the agent ran against |
| **Started / Completed** | Timestamps for when the run began and ended |
| **Duration** | Total execution time |
| **Inputs** | The parameters that were passed to the agent at launch |
| **Error details** | If the run failed, the error message and step where it failed |

### Follow Live Progress

For runs that are currently in progress, the detail view shows:

- **Live execution logs** — streamed in real time as the agent runs
- **Step-by-step progress** (for Workflow agents) — each step's status, duration, and output as it completes

### View and Share Reports

When a run completes successfully it produces a structured report. From the run detail view you can:

- **View the report** inline
- **Share** a link to the report with teammates
- **Download** the report as a file

### Delete Runs

Select one or more runs and click **Delete** to remove them from the history. Deleting a run also removes its associated report.

## Run Statuses

| Status | Meaning |
|--------|---------|
| **Running** | The agent is currently executing |
| **Completed** | The run finished successfully and a report is available |
| **Failed** | The run encountered an error; check the error details on the run |
| **Cancelled** | The run was manually cancelled before completing |
| **Retrying** | The run failed to reach the target cluster and is retrying automatically |