policyWatch

Enables automatic reload of the configured policy file when it changes.

This parameter applies to JSON Dotted Key Transformer (mmjsontransform).

Name:

policyWatch

Scope:

input

Type:

boolean

Default:

off

Required?:

no

Introduced:

8.2604.0

Description

When enabled together with policy, mmjsontransform watches the configured YAML policy file and reloads it after the configured debounce interval. This is useful for targeted policy updates that should not wait for a full HUP cycle.

The watcher monitors the file’s parent directory and matches the configured basename, so common write-temp-and-rename editor save patterns also trigger a reload.

If watch support is unavailable in the current build or runtime environment, rsyslog logs a warning and continues with HUP-only reload behavior.

If the updated policy is invalid, the reload is rejected and the previous in-memory policy remains active.

Input usage

action(type="mmjsontransform"
       policy="/etc/rsyslog/mmjsontransform-policy.yaml"
       policyWatch="on"
       input="$!raw" output="$!normalized")

See also

See also the main mmjsontransform module documentation.

---

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.