Unix Domain Sockets (im_uds)
This module allows log messages to be received over a Unix domain socket. Unix systems traditionally have a /dev/log or similar socket used by the system logger to accept messages. Applications use the syslog(3) system call to send messages to the system logger.
We recommend disabling FlowControl when using this module to collect local syslog messages from the /dev/log Unix domain socket.
Otherwise, if the corresponding output queue becomes full, the syslog() system call will be blocked and programs trying to write to the system log may become unresponsive.
|
See the parse_syslog_bsd() procedure of the xm_syslog
module for more information on parsing syslog messages.
Configuration
The im_uds module accepts the following directives in addition to the common module directives.
File permissions
The following directives are for specifying permissions for the created socket, pipe, or, file.
Use this directive to set the group ownership for the created socket, pipe, or file. By default, this is the group NXLog Agent is running as, (which may be specified by the global Group directive). This directive is not currently supported on Windows. |
|
This directive specifies the permissions to use for the created socket or pipe or file. This must be a four-digit octal value beginning with a zero. By default, OS default permissions will be set. This directive is not currently supported on Windows. |
|
Use this directive to set the user ownership for the created socket, pipe, or file. By default, this is the user NXLog Agent is running as (which may be specified by the global User directive). This directive is not currently supported on Windows. |
Optional directives
If set to |
|
See the InputType directive in the list of common module directives.
This defaults to |
|
This specifies the path of the Unix domain socket. The default is |
|
This directive specifies the domain socket type.
Supported values are |
Examples
This configuration will accept logs via the specified socket and write them to a file.
<Input uds>
Module im_uds
UDS /dev/log
FlowControl False
</Input>
This configuration accepts logs via the specified socket. It also specifies the ownership and permissions to use for the socket.
<Input uds>
Module im_uds
UDS /opt/nxlog/var/spool/nxlog/socket
UDSOwner root
UDSGroup adm
UDSPerms 0660
</Input>