title: NetBox: Background queues
agents: netbox
catalog: app/netbox
license: GPLv2
distribution: check_mk
description:
 One service per RQ queue (usually {default}, {high} and {low}) from
 {/api/core/background-queues/}. Reports the number of queued, started,
 deferred, scheduled, finished and failed jobs, how many workers listen on the
 queue, and the age of the oldest queued job.

 A rising backlog together with a rising "oldest queued job" age is the clearest
 signature of workers that are gone or wedged. By default the service is {CRIT}
 when no worker listens on the queue, {WARN} from 100 queued jobs or one failed
 job, and {WARN} when the oldest queued job is older than 30 minutes. All levels
 are configurable via the rule "NetBox background queues".

 NetBox restricts this endpoint to {superusers}. With a non-superuser token no
 queue services are created and the "NetBox Instance" service explains why.

item:
 The queue name, e.g. {default}.

discovery:
 One service per queue reported by NetBox.
