The NATS server provides various logging options that you can set via the command line or the configuration file.
The following logging operations are supported:
-l, --log FILE File to redirect log output.
-T, --logtime Timestamp log entries (default is true).
-s, --syslog Enable syslog as log method.
-r, --remote_syslog Syslog server address.
-D, --debug Enable debugging output.
-V, --trace Trace the raw protocol.
-VV Verbose trace (traces system account as well)
-DV Debug and Trace.
-DVV Debug and verbose trace (traces system account as well)
-DVflag enables trace and debug for the server.
nats-server -DV -m 8222 -user foo -pass bar
nats-server -DV -m 8222 -l nats.log
-T falsethen log entries are not timestamped. Default is true.
You can configure syslog with
nats-server -r udp://localhost:514
nats-server -r syslog://<hostname>:<port>
All of these settings are available in the configuration file as well.
Introduced in NATS Server v2.1.4, NATS allows for auto-rotation of log files when the size is greater than the configured limit set in
logfile_size_limit. The backup files will have the same name as the original log file with the suffix .yyyy.mm.dd.hh.mm.ss.micros.
You can also use NATS-included mechanisms with logrotate, a simple standard Linux utility to rotate logs available on most distributions like Debian, Ubuntu, RedHat (CentOS), etc., to make log rotation simple.
For example, you could configure
kill -SIGUSR1 `cat /var/run/nats-server.pid`
The first line specifies the location that the subsequent lines will apply to.
The rest of the file specifies that the logs will rotate daily ("daily" option) and that 30 older copies will be preserved ("rotate" option). Other options are described in logrorate documentation.
The "postrotate" section tells NATS server to reload the log files once the rotation is complete. The command
`kill -SIGUSR1cat /var/run/nats-server.pid``` does not kill the NATS server process, but instead sends it a signal causing it to reload its log files. This will cause new requests to be logged to the refreshed log file.
/var/run/nats-server.pidfile is where NATS server stores the master process's pid.
- The NATS server, in verbose mode, will log the receipt of
UNSUBmessages, but this does not indicate the subscription is gone, only that the message was received. The
DELSUBmessage in the log can be used to determine when the actual subscription removal has taken place.