nginx socketlog module

syntax: socketlog <peer name> <hostname>[:<port>]

default: none

severity: mandatory

context: main configuration file

Specifies the name of a log peer and it's BSD syslog hostname. Once specified, the peer name can be used in access_socketlog directives described below. hostname can be both domain name and IP address of a destination BSD syslog host. Syslog server must listen on TCP port 514 of this host.

syntax: access_socketlog <off>|<peer name> [<log format> [bare]]

default: none

severity: optional

context: http, server, location

Enables or disables logging into specified socketlog peer. Once enabled at certain level, same logging settings are inherited by subsequent levels. off argument disables logging into socket for specific location. Multiple peers are allowed at the same location. Log messages are then sent into all specified peers. bare specifies that no BSD syslog header must be used.

Example: access_socketlog test combined bare;

How to use

Download sources and unpack the archive:

$ unzip nginx-socketlog-module-1.0.0.zip

Configure nginx with additional module:

cd [path to nginx installation]
./configure --add-module=[path to socketlog module]
make
make install

error_log  logs/error.log  debug;

events {
    worker_connections  1024;
}

socketlog test localhost;

http {
    include       mime.types;
    default_type  application/octet-stream;

    sendfile        on;
    keepalive_timeout  65;

    server {
        listen       80;
        server_name  localhost;

        access_socketlog test;

        location /no_logging {
            access_socketlog off;
        }
    }
}

socketlog

syntax: socketlog <peer name> <hostname>[:<port>]

default: none

severity: mandatory

context: main configuration file

Specifies the name of a log peer and it's BSD syslog hostname. Once specified, the peer name can be used in access_socketlog directives described below. hostname can be both domain name and IP address of a destination BSD syslog host. Syslog server must listen on TCP port 514 of this host.

access_socketlog

syntax: access_socketlog <off>|<peer name> [<log format> [bare]]

default: none

severity: optional

context: http, server, location

Enables or disables logging into specified socketlog peer. Once enabled at certain level, same logging settings are inherited by subsequent levels. off argument disables logging into socket for specific location. Multiple peers are allowed at the same location. Log messages are then sent into all specified peers. bare specifies that no BSD syslog header must be used.

Example: access_socketlog test combined bare;