# KeepFailedMessages

Persist failed messages for resending after restart.

This parameter applies to omkafka: write to Apache Kafka.

Name:

  KeepFailedMessages

Scope:

  action

Type:

  boolean

Default:

  action=off

Required?:

  no

Introduced:

  at least 8.x, possibly earlier

## Description

If enabled, failed messages will be saved and loaded on shutdown/startup and resent after startup when Kafka is available. This setting requires `resubmitOnFailure` to be enabled.

## Action usage

    action(type="omkafka" KeepFailedMessages="on")

## Notes

- Originally documented as “binary”; uses boolean values.

## See also

See also omkafka: write to Apache Kafka.

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.