nellemann
/
syslogd
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 3 Wiki Activity
Small syslog server written in Java. Useful for testing, small installations or for forwarding messages to other logging solutions. Accepts RFC-3164 (BSD), RFC-5424 and GELF log messages on a configurable port, UDP and/or TCP. https://github.com/mnellemann/syslogd
33 Commits 2 Branches 27 Tags 599 KiB
Java 75%
Groovy 25%
Go to file
Mark Nellemann 49b8888032 Hopefully fix failing tests (due to timezone differences) 2021-01-27 20:31:25 +01:00
doc Improve rfc5424 parsing. 2021-01-27 01:29:38 +01:00
gradle/wrapper Enable forwarding of received syslog messaged. 2021-01-26 15:24:23 +01:00
src Hopefully fix failing tests (due to timezone differences) 2021-01-27 20:31:25 +01:00
.editorconfig Initial import 2020-09-22 20:33:22 +02:00
.gitattributes Initial import 2020-09-22 20:33:22 +02:00
.gitignore Cleanup. 2020-12-01 13:43:36 +01:00
LICENSE Add APACHE-2.0 license. 2020-09-22 20:45:16 +02:00
README.md Update instructions and provide systemd service example. 2021-01-26 16:08:37 +01:00
bitbucket-pipelines.yml Fix dynamic version lookup. 2020-10-07 15:09:59 +02:00
build.gradle Improve rfc5424 parsing. 2021-01-27 01:29:38 +01:00
gradle.properties Refactoring and more tests. 2021-01-27 15:18:46 +01:00
gradlew Initial import 2020-09-22 20:33:22 +02:00
gradlew.bat Initial import 2020-09-22 20:33:22 +02:00
settings.gradle Initial import 2020-09-22 20:33:22 +02:00
slf4j.simpleLogger.log Refactor forwarding logic. 2021-01-26 21:44:23 +01:00

README.md

Simple Syslog Server

Basic syslog server written in Java. All received messages are written to stdout or optionally forwarded to another syslog server.

The syslog server is able to listen on UDP and/or TCP and parses syslog messages in either RFC5424 or RFC3164 (BSD) format.

The default syslog port (514) requires you to run syslogd as root / administrator. If you do not wish to do so, you can choose a port number (with the -p flag) above 1024.

Usage Instructions

  • Install the syslogd package (.deb or .rpm) from downloads or build from source.
  • Run bin/syslogd, use the -h option for help :)
Usage: syslogd [-fhV] [--[no-]ansi] [--[no-]stdout] [--[no-]tcp] [--[no-]udp]
               [--rfc5424] [--forward-host=<hostname>] [--forward-port=<port>]
               [-p=<port>]
Simple Syslog Server
  -f, --forward       Forward messages (UDP RFC-3164) [default: false].
      --forward-host=<hostname>
                      Forward to host [default: localhost].
      --forward-port=<port>
                      Forward to port [default: 1514].
  -h, --help          Show this help message and exit.
      --[no-]ansi     Output ANSI colors [default: true].
      --[no-]stdout   Output messages to stdout [default: true].
      --[no-]tcp      Listen on TCP [default: true].
      --[no-]udp      Listen on UDP [default: true].
  -p, --port=<port>   Listening port [default: 514].
      --rfc5424       Parse RFC-5424 messages [default: RFC-3164].
  -V, --version       Print version information and exit.