OpenTelemetry
OpenTelemetry metrics and tracing for Queuert job chains.
Queuert provides an OpenTelemetry adapter for metrics and tracing. Configure your OTEL SDK with desired exporters (Prometheus, OTLP, Jaeger, etc.) before using this adapter.
Install
Terminal
npm install @queuert/otelSetup
Create the observability adapter with your OTEL meter and tracer:
src/observability.ts
export const observabilityAdapter = createOtelObservabilityAdapter({
meter: metrics.getMeter("queuert"),
tracer: trace.getTracer("queuert"),
});Pass it as the observabilityAdapter option when creating your client:
src/index.ts
const client = createClient({
stateAdapter,
observabilityAdapter,
jobTypes,
});Configuration
createOtelObservabilityAdapter options
What it emits
- CountersWorker lifecycle, job attempts, completions, errors.
- HistogramsJob duration, chain duration, attempt duration.
- GaugesIdle workers per job type, jobs being processed.
- SpansPRODUCER spans for job creation and CONSUMER spans for processing, with span kinds modeled on OpenTelemetry messaging conventions.
Examples
OpenTelemetry
- observability/otel @queuert/otelGitHub@queuert/otel wiring for distributed tracing and metrics, viewed in otel-tui.Terminal 1: OTLP receiver
$ pnpm --filter example-observability-otel tuiTerminal 2: example$ pnpm --filter example-observability-otel startsrc/observability.tssrc/index.ts