TaskMetricsResponse

Task metrics response - current performance statistics

by_type object[]required

Per-task-type breakdown

Array [

avg_duration_msnumber<double>required

Average duration in milliseconds

Example: 2500

avg_queue_wait_msnumber<double>required

Average queue wait time in milliseconds

Example: 150

bytes_processedinteger<int64>required

Total bytes processed

Possible values: >= 0

Example: 1073741824

error_rate_pctnumber<double>required

Error rate as percentage

Example: 5

executedinteger<int64>required

Number of executions

Possible values: >= 0

Example: 100

failedinteger<int64>required

Failed executions

Possible values: >= 0

Example: 5

items_processedinteger<int64>required

Total items processed

Possible values: >= 0

Example: 5000

last_errorstring | nullnullable

Most recent error message

last_error_atstring,null<date-time>nullable

When the last error occurred

max_duration_msinteger<int64>required

Maximum duration in milliseconds

Possible values: >= 0

Example: 15000

min_duration_msinteger<int64>required

Minimum duration in milliseconds

Possible values: >= 0

Example: 500

p50_duration_msinteger<int64>required

50th percentile (median) duration

Possible values: >= 0

Example: 2000

p95_duration_msinteger<int64>required

95th percentile duration

Possible values: >= 0

Example: 8000

retriedinteger<int64>required

Retried executions

Possible values: >= 0

Example: 10

succeededinteger<int64>required

Successful executions

Possible values: >= 0

Example: 95

task_typestringrequired

Task type name

Example: scan_library

throughput_per_secnumber<double>required

Throughput rate per second

Example: 25.5

]

queue objectrequired

Queue health metrics

oldest_pending_age_msinteger,null<int64>nullable

Age of oldest pending task in milliseconds

Possible values: >= 0

pending_countinteger<int64>required

Number of tasks waiting to run

Possible values: >= 0

Example: 25

processing_countinteger<int64>required

Number of tasks currently executing

Possible values: >= 0

Example: 4

stale_countinteger<int64>required

Number of stale/stuck tasks

Possible values: >= 0

Example: 0

retentionstringrequired

Current retention setting

Example: 30

summary objectrequired

Overall summary statistics

avg_duration_msnumber<double>required

Average duration in milliseconds

Example: 1500.5

avg_queue_wait_msnumber<double>required

Average queue wait time in milliseconds

Example: 250

tasks_per_minutenumber<double>required

Tasks processed per minute (recent average)

Example: 15.5

total_executedinteger<int64>required

Total tasks executed since last restart

Possible values: >= 0

Example: 1250

total_failedinteger<int64>required

Total failed tasks

Possible values: >= 0

Example: 50

total_succeededinteger<int64>required

Total successful tasks

Possible values: >= 0

Example: 1200

updated_atstring<date-time>required

When the metrics were last updated

Example: 2026-01-11T12:00:00Z

TaskMetricsResponse

{
  "by_type": [
    {
      "avg_duration_ms": 2500,
      "avg_queue_wait_ms": 150,
      "bytes_processed": 1073741824,
      "error_rate_pct": 5,
      "executed": 100,
      "failed": 5,
      "items_processed": 5000,
      "last_error": "string",
      "last_error_at": "2024-07-29T15:51:28.071Z",
      "max_duration_ms": 15000,
      "min_duration_ms": 500,
      "p50_duration_ms": 2000,
      "p95_duration_ms": 8000,
      "retried": 10,
      "succeeded": 95,
      "task_type": "scan_library",
      "throughput_per_sec": 25.5
    }
  ],
  "queue": {
    "oldest_pending_age_ms": 0,
    "pending_count": 25,
    "processing_count": 4,
    "stale_count": 0
  },
  "retention": "30",
  "summary": {
    "avg_duration_ms": 1500.5,
    "avg_queue_wait_ms": 250,
    "tasks_per_minute": 15.5,
    "total_executed": 1250,
    "total_failed": 50,
    "total_succeeded": 1200
  },
  "updated_at": "2026-01-11T12:00:00Z"
}