> ## Documentation Index
> Fetch the complete documentation index at: https://synthetiq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows

> Monitoring workflow executions and job health for deployed Synthetiq apps

## Workflows dashboard

Each app includes a workflows dashboard accessible at:

```
https://{your-app-url}/admin/workflows
```

<Frame caption="Workflows dashboard with system health, job status, and real-time backpressure monitoring">
  <img src="https://mintcdn.com/synthetiq/-jIlH6VGRYQP1yAa/images/platform-docs/deployments/monitoring/workflows-dashboard.png?fit=max&auto=format&n=-jIlH6VGRYQP1yAa&q=85&s=05c13ad99984eb238ea462507f3f8284" alt="Workflows dashboard showing job health and execution status" width="3540" height="2590" data-path="images/platform-docs/deployments/monitoring/workflows-dashboard.png" />
</Frame>

<Note>
  Access requires the `workflows:admin` scope. Assign this scope to admin roles in your app's access control configuration.
</Note>

### Dashboard overview

* **System health** — overall status (Healthy, Degraded, Idle) based on job success rate and queue pressure
* **Active jobs** — running and pending job counts
* **Success rate** — based on the last 48 hours
* **Job volume** — trend charts for completed and failed jobs
* **Backpressure** — real-time monitoring of queue pressure

### Job management

* Filter jobs by status (Running, Pending, Completed, Failed, Cancelled, Expired)
* Filter by scheduled vs manually triggered
* Cancel, pause, or resume individual jobs
* Bulk cancel all active jobs

<Frame caption="Job management with status filtering and lifecycle controls">
  <img src="https://mintcdn.com/synthetiq/-jIlH6VGRYQP1yAa/images/platform-docs/deployments/monitoring/workflows-jobs.png?fit=max&auto=format&n=-jIlH6VGRYQP1yAa&q=85&s=d3e473b69955c1bb8d03827b16674913" alt="Workflow jobs list with status filtering" width="3540" height="2600" data-path="images/platform-docs/deployments/monitoring/workflows-jobs.png" />
</Frame>

### Job details

* **Overview** — progress, timing, errors, and output tables with a live SQL query interface for exploring individual step results
* **Steps** — step-by-step execution details including status, timing, retries, and error logs
* **DAG** — visual dependency graph of workflow steps
* **Definition** — full workflow definition as JSON

<Frame caption="Workflow DAG view with realtime step-by-step progress and step details">
  <img src="https://mintcdn.com/synthetiq/-jIlH6VGRYQP1yAa/images/platform-docs/deployments/monitoring/workflows-job-detail.png?fit=max&auto=format&n=-jIlH6VGRYQP1yAa&q=85&s=5e21ffbe5cf0e51014e4afac0d4915e9" alt="Workflow job detail page showing progress, steps, and results" width="3542" height="2588" data-path="images/platform-docs/deployments/monitoring/workflows-job-detail.png" />
</Frame>

<br />

<Frame caption="Exploring individual step results for debugging and introspection">
  <img src="https://mintcdn.com/synthetiq/-jIlH6VGRYQP1yAa/images/platform-docs/deployments/monitoring/workflows-query-results.png?fit=max&auto=format&n=-jIlH6VGRYQP1yAa&q=85&s=edd558719290d92ea0d4b4a6f9a3722d" alt="Workflow job overview with SQL query interface for exploring step results" width="3540" height="2594" data-path="images/platform-docs/deployments/monitoring/workflows-query-results.png" />
</Frame>

### Schedules

* View and manage scheduled workflows
* Enable/disable schedules, modify cron expressions
* Track last run and next run timestamps

<Frame caption="Schedule management with cron configuration and run tracking">
  <img src="https://mintcdn.com/synthetiq/-jIlH6VGRYQP1yAa/images/platform-docs/deployments/monitoring/workflows-schedules.png?fit=max&auto=format&n=-jIlH6VGRYQP1yAa&q=85&s=7258a26406c3323b59c04e45b2cff4b1" alt="Workflow schedules management interface" width="3542" height="2592" data-path="images/platform-docs/deployments/monitoring/workflows-schedules.png" />
</Frame>

### Workers

* View active worker instances and their capacity
* Monitor worker heartbeats
* See which jobs are assigned to each worker

<Frame caption="Active worker instances with concurrency, active jobs, and heartbeat status">
  <img src="https://mintcdn.com/synthetiq/-jIlH6VGRYQP1yAa/images/platform-docs/deployments/monitoring/workflows-workers-list.png?fit=max&auto=format&n=-jIlH6VGRYQP1yAa&q=85&s=93c1ae361e0f52c4e7d0d90969274ba2" alt="Workflow workers list with status and capacity" width="3544" height="2594" data-path="images/platform-docs/deployments/monitoring/workflows-workers-list.png" />
</Frame>

<br />

<Frame caption="Worker detail view with claimed jobs and real-time capacity">
  <img src="https://mintcdn.com/synthetiq/-jIlH6VGRYQP1yAa/images/platform-docs/deployments/monitoring/workflows-worker-detail.png?fit=max&auto=format&n=-jIlH6VGRYQP1yAa&q=85&s=1039c1cef7d2ba4d3d24dabf43030de3" alt="Worker detail showing concurrency, heartbeat, and claimed jobs" width="3540" height="2596" data-path="images/platform-docs/deployments/monitoring/workflows-worker-detail.png" />
</Frame>

## Observability API

Workflow data is also available programmatically via the app's built-in API. See [Observability API](/docs/platform-docs/deployments/monitoring/observability-api) for available endpoints.