OpenTelemetry Metrics

OpenTelemetry counters, histograms, and gauges.

Queuert emits OpenTelemetry metrics through the @queuert/otel adapter. All metrics follow the naming pattern:

Text

queuert.{component}.{operation}[.{suboperation}]

The ObservabilityAdapter interface accepts milliseconds; the @queuert/otel adapter converts duration values to seconds per OTEL Messaging Semantic Conventions.

Counters

The row under each metric lists its attributes; worker counters have none.

Worker lifecycle

Job lifecycle

  • Job created.
    queuert.job.type queuert.chain.type
  • Job completed (by a worker or workerless). Use queuert.job.attempt.completed to count only worker-processed completions.
    queuert.job.type queuert.chain.type queuert.job.continued
  • Job blocked by incomplete blocker chains.
    queuert.job.type queuert.chain.type
  • Job unblocked after blocker chain completed.
    queuert.job.type queuert.chain.type
  • Job returned to pending: client reschedule, complete({ reschedule }), retry after a failed attempt, or reclaim from a worker that lost its lease, stopped or no longer runs it.
    queuert.job.type queuert.chain.type

Attempt lifecycle

  • Worker began processing an attempt.
    queuert.job.type queuert.chain.type
  • Attempt completed successfully (including complete({ reschedule })).
    queuert.job.type queuert.chain.type
  • Attempt failed (may retry).
    queuert.job.type queuert.chain.type
  • Attempt lost ownership before committing: taken by another worker, completed elsewhere, or deleted.
    queuert.job.type queuert.chain.type
  • Attempt rescheduled for retry from a worker that lost its lease, stopped or no longer runs it.
    queuert.job.type queuert.chain.type

Chain lifecycle

Adapter errors

Histograms

Histograms track duration distributions at three levels. Unit is seconds.

Durations

These form a hierarchy — chain duration encompasses job durations (plus wait time between continuations), and job duration encompasses attempt durations (plus wait time between retries):

durations

  • queuert.chain.duration
  • queuert.job.duration (head job)
  • queuert.job.attempt.duration (attempt 1)
  • queuert.job.attempt.duration (attempt 2, retry)
  • queuert.job.duration (continuation)
  • queuert.job.attempt.duration

Gauges

Two up-down counters track real-time worker state. They are incremented/decremented via delta values.

Gauges

Metric attributes

Metric attributes

esc

Search guides, integrations and every exported symbol.

↑ ↓ to navigate↵ to open