Skip to content
Everruns Everruns

Get metrics time series

GET
/v1/durable/metrics/timeseries
 
curl --request GET \
  --url https://app.everruns.com/api/v1/durable/metrics/timeseries

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Metrics time series

Media type application/json

Metrics time series response.

In multi-instance deployments, each instance maintains its own metrics ring buffer. The instance_count field indicates how many instances are expected so consumers can aggregate or label appropriately.

object
instance_count

Number of expected control-plane instances (from EXPECTED_INSTANCES env). When >1, these metrics represent only this instance’s view.

integer format: int32
points
required
Array<object>

Single metrics data point

object
active_workers
required

Number of workers actively heartbeating (gauge).

integer
claimed_tasks
required

Number of tasks currently claimed by a worker (gauge).

integer
dlq_size
required

Size of the dead-letter queue (gauge).

integer
load_percentage
required

Aggregate worker load as a percentage of total max_concurrency (0.0-100.0).

number format: double
pending_tasks
required

Number of tasks waiting to be claimed by a worker (gauge).

integer
pending_workflows
required

Number of workflows waiting to be claimed by a worker (gauge).

integer
running_workflows
required

Number of workflows currently executing (gauge).

integer
tasks_completed_total
required

Cumulative count of tasks completed successfully since process start (monotonic counter).

integer format: int64
tasks_failed_total
required

Cumulative count of tasks that failed or were sent to the DLQ (monotonic counter).

integer format: int64
tasks_started_total
required

Cumulative count of tasks claimed at least once (monotonic counter).

integer format: int64
timestamp
required

Sampling timestamp for this data point (RFC 3339).

string format: date-time
workflows_completed_total
required

Cumulative count of workflows that completed successfully (monotonic counter).

integer format: int64
workflows_failed_total
required

Cumulative count of workflows that ended in failure (monotonic counter).

integer format: int64
workflows_started_total
required

Cumulative count of workflows that started (monotonic counter).

integer format: int64
resolution_seconds
required
integer format: int64
Example 
{
  "points": [
    {
      "active_workers": 4,
      "claimed_tasks": 28,
      "dlq_size": 3,
      "load_percentage": 62.5,
      "pending_tasks": 12,
      "pending_workflows": 7,
      "running_workflows": 42,
      "tasks_completed_total": 12843,
      "tasks_failed_total": 17,
      "tasks_started_total": 12873,
      "timestamp": "2026-05-27T15:30:00Z",
      "workflows_completed_total": 982,
      "workflows_failed_total": 3,
      "workflows_started_total": 1024
    }
  ]
}