This chapter provides tips and guidelines about troubleshooting problems related to
As a general rule, first try to log the messages to a local file. Once this is working, you know that AxoSyslog is running correctly and receiving messages, and you can proceed to forwarding the messages to the server.
Always check the configuration files for any syntax errors on both the client and the server using the
If the AxoSyslog server does not receive the messages, verify that the IP addresses and ports are correct in your sources and destinations. Also, check that the client and the server uses the same protocol (a common error is to send logs on UDP, but configure the server to receive logs on TCP).
If the problem persists, use
tcpdumpor a similar packet sniffer tool on the client to verify that the messages are sent correctly, and on the server to verify that it receives the messages.
To find message-routing problems, run AxoSyslog with the following command
syslog-ng -Fevd. That way AxoSyslog will run in the foreground, and display debug messages about the messages that are processed.
If AxoSyslog is closing the connections for no apparent reason, be sure to check the log messages of
syslog-ng. You may also want to run
--debugcommand-line options for more-detailed log messages. You can enable these messages without restarting
syslog-ng-ctl verbose --set=oncommand. For details, see the The
Build up encrypted connections step-by-step. First create a working, unencrypted (for example, TCP) connection, then add TLS encryption, and finally, client authentication if needed.
If you use the same driver and options in the destination of your AxoSyslog client and the source of your AxoSyslog server, everything should work as expected. Unfortunately, there are some other combinations, that may seem to work, but result in losing parts of the messages. For details on the working combinations, see Things to consider when forwarding messages between AxoSyslog hosts.
In case you experience a problem that is not covered in this guide, send it to our mailing list.
To report bugs found in AxoSyslog, visit our GitHub issues page.
Precompiled binary packages are available for free from various third-parties. See the list of precompiled binary packages.