retry.ruleset¶

Names the ruleset where omhttp requeues failed messages when retry is enabled.

This parameter applies to omhttp: HTTP Output Module.

Name:: retry.ruleset
Scope:: input
Type:: word
Default:: input=none
Required?:: no
Introduced:: Not specified

Description¶

This parameter specifies the ruleset where this plugin should requeue failed messages if retry is on. This ruleset generally would contain another omhttp action instance.

Important - Note that the message that is queued on the retry ruleset is the templated output of the initial omhttp action. This means that no further templating should be done to messages inside this ruleset, unless retries should be templated differently than first-tries. An “echo template” does the trick here.

template(name="tpl_echo" type="string" string="%msg%")

This retry ruleset can recursively call itself as its own retry.ruleset to retry forever, but there is no timeout behavior currently implemented.

Alternatively, the omhttp action in the retry ruleset could be configured to support action.resumeRetryCount as explained above in the retry section. The benefit of this approach is that retried messages still hit the server in a batch format (though with a single message in it), and the ability to configure rsyslog to give up after some number of resume attempts so as to avoid resource exhaustion.

Or, if some data loss or high latency is acceptable, do not configure retries with the retry ruleset itself. A single retry from the original ruleset might catch most failures, and errors from the retry ruleset could still be logged using the errorfile parameter and sent later on via some other process.

Input usage¶

module(load="omhttp")

# This action enables the retry ruleset.
action(
    type="omhttp"
    template="tpl_omhttp_json"
    retry="on"
    retryRuleSet="rs_omhttp_retry"
)

# The "rs_omhttp_retry" ruleset itself could be defined as follows:
ruleset(name="rs_omhttp_retry") {
    action(
        type="omhttp"
        template="tpl_echo"
        batch="on"
        batchFormat="jsonarray"
        batchMaxSize="5"
    )
}

retry.ruleset¶

Description¶

Input usage¶

See also¶