The rocket-fast system for log processing

How to bind a template

This little FAQ describe how to bind a template.
First with the new template format "list" and then with the old "legacy" format.

First off all you have to define a template for example for specify output.

Here is an example template in the list format:

template(name=”FileFormat” type=”list”) {
property(name=”timestamp” dateFormat=”rfc3339″)
constant(value=” “)
constant(value=” “)
constant(value=” “)
property(name=”msg” spifno1stsp=”on” )
property(name=”msg” droplastlf=”on” )

Then you have to bind the template to an action. The Syntax to bind a template is:


Here is an example action with a example-template:

*.* action(type="omfile" file="/var/log/all-messages.log");Name-of-your-template

In the configuration it should looks like this:

template(name="FileFormat" type="list") {
property(name="timestamp" dateFormat="rfc3339″)
constant(value=" ")
constant(value=" ")
constant(value=" ")
property(name="msg" spifno1stsp="on" )
property(name="msg" droplastlf="on" )
action(type="omfile" file="/var/log/all-msgs.log");FileFormat

Here is an example for the legacy format

Here is an example template in the legacy format:

$template ExampleFormat,”%timereported:::date-rfc3339% %HOSTNAME% %msg%"

Here is an example action with a example-template:

*.* /var/log/all-messages.log;Your-Template-Name

In the Configuration it looks like this:

"$template ExampleFormat,”%timereported:::date-rfc3339% %HOSTNAME% %msg%"
*.* /var/log/all-messages.log;ExampleFormat"

That’s it

6 thoughts on “How to bind a template

  1. different information in details leads always to misunderstanding and a unneeded timeconsuming experimenting.
    so, why is is not consitent with "" ?

    is it:
    action(template=TEMPLATENAME,type="omfile" file="/var/log/all-msgs.log")

    or is it:
    action(template="TEMPLATENAME",type="omfile" file="/var/log/all-msgs.log")

    or is both legal?

    why put all syntax in the source/binary, but not in the doku?

    by the way. i am missing full working examples for complex rainerscript — this would help a lot quicker understanding …

Comments are closed.