🐦 Parrot is a syslog server with a real-time web dashboard.
⚡ Parrot supports RFC3164, RFC5424, and RFC6587 over TCP, UDP, and/or Unix Sockets.
🔨 Support for forwarding received logs to another syslog server is planned in a future version.
⏬ Download the latest release and extract the appropriate binary to wherever you'd like (renaming it to parrot and placing it in /usr/local/bin seems nice for *nix systems).
💻 Just call the binary (parrot?) with the appropriate arguments.
-forward[tcp | udp | unix]://[host:port | path]- forward received logs to the specified syslog server (not yet implemented)
-listen[tcp | udp | unix]://[host:port | path]- listen for syslog messages on the specified location (required)
- specify multiple times for multiple listeners!
-silent(defaults tofalse)- specify to disable info-level logging
-webip:port- a
host:portfor the dashboard webserver to serve from (defaults to127.0.0.1:8080)
- a
- Listen for syslog messages on the same server sent to standard port 514 over UDP:
parrot -listen udp://127.0.0.1:514
- Listen for syslog messages from any interface sent to standard port 514 over TCP:
parrot -listen tcp://0.0.0.0:514
- Listen for syslog messages from a Unix socket:
parrot -listen unix:///var/tmp/parrot_syslog.sock
- Listen for syslog messages from any interface sent to TCP port 514 and UDP port 515:
parrot -listen tcp://0.0.0.0:514 -listen udp://0.0.0.0:515
- Listen for syslog messages on the same server sent to standard port 514 over UDP, while serving the web dashboard over any interface on port 8080:
parrot -listen tcp://127.0.0.1:514 -web 0.0.0.0:8080
Parrot is written in Golang 1.11 for the backend syslog listener, forward, and webserver. VueJS and Bulma are used for the dashboard, and are embedded into the executables.
- Tests
- Support for forwarding
- OSX support (untested; built for linux-amd64 only at the moment)
Parrot is licensed GNU GPL v3.
Parrot icon by Freepik from flaticon.com is licensed by CC BY 3.0