Syslogd

The syslogd that ships with BSD based systems allows for TCP forwarding. However UDP is only supported on OSX and a number of Linux platforms. To configure syslog to forward your logs to logentries you will need to modify your syslog config file (usually at /etc/syslog.conf) and restart syslog.

TCP Forwarding

The first thing you need to do is create a new Log using the Logentries Web UI.  You can add a new log by clicking on the Add New then Add a log. 

add_new
add_new_log

and then selecting Manual
 
add_manual
Once inside manual configuration, enter a name for your new log, Create a new set for this log or add it to an existing Set, select Plain TCP/UDP and select the options to Register the log.

add_new_log

Once all the details are filled out click Create Log Token button.

Upon successfully creating a new Log, you will receive a PORT number which is used in the below steps.  To forward via TCP you usually add the following line to your configuration file, although we recommend to check the documentation for your syslog distribution:
*.* @@data.logentries.com:PORT
For UDP syslog forwarding the following should be added:
*.* @data.logentries.com:PORT
Note the single @ for UDP.

Restart

In order to accept a new configuration, you will need to restart your syslog server:
/etc/init.d/syslog stop
/etc/init.d/syslog start
Another way to do this is to find the syslog process and send a HUP signal to it:
tparso-laptop# ps -ax |grep syslog
1334 ??   0:00.40 /usr/sbin/syslogd
tparso-laptop# kill -HUP 1334

Testing

To test if syslog has been set up correctly you can log an event to syslog using the logger command:
logger -t test "Here's an example log entry"
Next check your logs configured in Logentries to see if any events have been recorded.

Troubleshooting

Please refer to the syslog section for troubleshooting general syslog services.
Back to Top