internal() source options
This section describes the options of the internal() source in syslog-ng OSE.
The internal() driver has the following options:
host-override()
| Type: | string |
| Default: |
Description: Replaces the HOST part of the message with the
parameter string.
log-fifo-size()
| Type: | number |
| Default: | Use global setting. |
Description: The number of messages that the output buffer can store.
log-iw-size()
| Type: | number |
| Default: | 100 |
Description: The size of the initial source window, this value is used during
flow-control, applies only if flow-control() is enabled.
Note that when using disk-buffer(), the messages stored on disk are not included in the window size calculation.
For details about flow-control and the effects of this parameter, see Managing incoming and outgoing messages with flow-control.
NOTE: If dynamic flow-control is disabled (which is the default behavior), the value of the log-iw-size() option cannot be lower than 100. If dynamic flow-control is enabled, you can decrease the value of the log-iw-size() option (to the minimum of 1).
Make sure that log-iw-size() is larger than the value of log-fetch-limit().
normalize-hostnames()
| Type: | yes, no |
| Default: | no |
Description: If this option is set to yes (normalize-hostnames(yes)), syslog-ng OSE converts the hostnames to lowercase. This setting only applies to hostnames resolved from DNS. It has no effect if the keep-hostname() option is enabled, and the message contains a hostname.
| Accepted values: | yes | no|
|Default: |no|
NOTE: This setting applies only to hostnames resolved from DNS. It has no effect if the keep-hostname() option is enabled, and the message contains a hostname.
program-override()
| Type: | string |
| Default: |
Description: Replaces the ${PROGRAM} part of the message with the parameter string. For example, to mark every message coming from the kernel, include the program-override("kernel") option in the source containing /proc/kmsg.
tags()
| Type: | string |
| Default: |
Description: Label the messages received from the source with custom tags. Tags must be unique, and enclosed between double quotes. When adding multiple tags, separate them with comma, for example, tags(“dmz”, “router”). This option is available only in syslog-ng OSE 3.1 and later.
use-fqdn()
| Accepted values: | yes | no |
| Default: | no |
Description: Use this option to add a Fully Qualified Domain Name (FQDN) instead of a short hostname. You can specify this option either globally or per-source. The local setting of the source overrides the global option if available.
TIP: Set use-fqdn() to yes if you want to use the custom-domain() global option.
NOTE: This option has no effect if the keep-hostname() option is enabled (keep-hostname(yes)) and the message contains a hostname.
use-syslogng-pid()
| Accepted values: | yes, no |
| Default: | no |
Description: If this parameter is set to yes, syslog-ng OSE fills the value of the ${PID} macro with its own process ID.