janeczku/remote_syslog2

Docker RemoteSyslog2

Docker RemoteSyslog2 leverages the deployment agility of Docker, the slickness of https://github.com/gliderlabs/docker-alpine and the conveniance of https://github.com/papertrail/remote_syslog2/ to bootstrap remote logging capabilities for both Docker hosts and containers.
It automates the collection and sending of logs to central log collectors or cloud-based log management services by tailing log files and emitting syslog messages over UDP, TCP or TCP/TLS.

Benefits

• Bootstrap remote log management for your servers by simply starting a RemoteSyslog2 container
• Forward logs to cloud-based log management services without the hassle of installing agents or configuring syslog
• Collect file-based logs from Docker containers

Usage examples

Configuration parameters can be passed both using environment variables and command line flags

Forward all logs from your Docker host to Loggly

docker run -d -v /var/logs:/host/logs janeczku/remote_syslog2 \
-d logs-01.loggly.com -p 514 /host/logs/*.log

Forward logs from a Nginx container to Papertrail over TCP with TLS

docker run -d --volumes-from nginx janeczku/remote_syslog2 \
-d logs.papertrailapp.com -p 54545 --tls=true /var/log/nginx/nginx-access.log

Compatible log management servers/services (non-exclusive list)

• Logstash
• Fluentd
• Splunk
• Papertrail
• Loggly
• Logentries
• Graylog ...

Configuration using command line arguments

Refer to the https://github.com/papertrail/remote_syslog2/ documentation

Configuration using environment variables

SYSLOG_HOST Required
Default:
Destination syslog hostname or IP

SYSLOG_PORT
Default: 514
Destination syslog port

SYSLOG_FILES Required
Default:
Space delimited list of log files to monitor (use absolute paths, wildcards allowed)
e.g.: /var/log/auth.log /var/log/nginx/*

SYSLOG_TCP
Default: false
Connect over TCP (no TLS)

SYSLOG_TLS
Default: false
Connect over TCP with TLS

SYSLOG_FACILITY
Default: user
Syslog Facility

SYSLOG_SEVERITY
Default: notice
Syslog Severity

SYSLOG_HOSTNAME
Default:
Override hostname