# InjectDelayMode

Sets the flow-control classification applied to messages injected by imdiag.

This parameter applies to imdiag: Diagnostic instrumentation.

Name:

  InjectDelayMode

Scope:

  module

Type:

  string (`no`, `light`, `full`)

Default:

  module=no

Required?:

  no

Introduced:

  at least 5.x, possibly earlier

## Description

The diagnostics interface can inject messages into rsyslog’s queues on demand. InjectDelayMode assigns the flow-control policy used for those messages:

`no`

  Injected messages bypass delay throttling.

`light`

  Injected messages are marked “light delayable” so that queue congestion slows them while preserving capacity for non-throttleable inputs.

`full`

  Injected messages are fully delayable and subject to the strongest throttling when queues fill up.

Use this setting to prevent diagnostics traffic from overwhelming production inputs when the main queue is near capacity.

## Module usage

    module(load="imdiag" injectDelayMode="light")

### Legacy names (for reference)

Historic names/directives for compatibility. Do not use in new configs.

- $IMDiagInjectDelayMode — maps to InjectDelayMode (status: legacy)

## See also

See also imdiag: Diagnostic instrumentation.

Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project

Contributing: Source & docs: rsyslog source project

© 2008–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.