# startmsg.regex

Regex that marks the beginning of a new message for multiline processing.

This parameter applies to imfile: Text File Input Module.

Name:

  startmsg.regex

Scope:

  input

Type:

  string (see Rsyslog Parameter String Constants)

Default:

  none

Required?:

  no

Introduced:

  8.10.0

## Description

Permits the processing of multi-line messages. When set, a message is terminated when the next one begins and `startmsg.regex` matches the line that identifies the start of a message. It is more flexible than `readMode` but has lower performance. `startmsg.regex`, `endmsg.regex` and `readMode` cannot all be defined for the same input.

## Input usage

    input(type="imfile"
          File="/var/log/example.log"
          Tag="example"
          startmsg.regex="^start")

## See also

See also imfile: Text File Input Module.

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.