configuration objects¶
Note: configuration object parameters are case-insensitive.
Common Parameters¶
config.enable¶
New in version 8.33.0.
All configuration objects have a parameter “config.enable”.
For auto-generated configs, it is useful to have the ability to disable some
config constructs even though they may be specified inside the config. This
can be done via the config.enabled
parameter.
If set to on
or not specified, the construct will be
used, if set to any other value, it will be ignored.
This can be used together with the backtick functionality to enable or
disable parts of the configuration from either a file or environment variable.
Example:
Let’s say we want to conditionally load a module. Environment variable
LOAD_IMPTCP
will be either unset or off
.
Then we can use this config construct:
module(load="imptcp" config.enabled=`echo $LOAD_IMPTCP`)
If the variable is set to `off`
, the module will not be loaded.
global()¶
This is used to set global configuration parameters. For details, please see the rsyslog global configuration object.
input()¶
The input object is the primary means of describing inputs, which are used to gather messages for rsyslog processing.
module()¶
The module object is used to load plugins.
include()¶
The include object is use to include configuration snippets stored elsewhere into the configuration.
See also
If you would like to contribute to these docs, but are unsure where to start, please see the rsyslog-doc project README for an overview of the process. If you would like to contribute to the main source project, please review the contribution guidelines listed in the rsyslog project README.
If you have a question about these docs or Rsyslog
in general, please
see the following resources: