IgnoreInvalidStatefile

Controls whether omsendertrack recovers from empty or invalid persisted state.

This parameter applies to omsendertrack: Sender Tracking Output Module.

Name:

IgnoreInvalidStatefile

Scope:

action

Type:

boolean

Default:

action=on

Required?:

no

Introduced:

8.2610.0

Description

When on, an empty state file starts with empty statistics. A nonempty file that is not a complete valid sender-statistics JSON array is moved aside under a unique .corrupt.* name and rsyslog starts with empty statistics. If that backup cannot be made, rsyslog continues but disables later state-file writes for that action so the evidence is not overwritten.

When off, an empty or invalid existing state file causes rsyslog startup to fail and is left unchanged. A missing state file is always accepted as a normal first start.

Action usage

action(type="omsendertrack"
       stateFile="/var/lib/rsyslog/senderstats.json"
       ignoreInvalidStatefile="off")

YAML usage

actions:
  - type: omsendertrack
    stateFile: /var/lib/rsyslog/senderstats.json
    ignoreInvalidStatefile: off

See also

See also statefile.

---

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

Contributing: Source & docs: rsyslog source project

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