Go to file
Daniel afx 16e1724f31 split local and discord destinations and add network security 2021-01-30 04:24:55 +02:00
etc split local and discord destinations and add network security 2021-01-30 04:24:55 +02:00
tools split local and discord destinations and add network security 2021-01-30 04:24:55 +02:00
.gitignore split local and discord destinations and add network security 2021-01-30 04:24:55 +02:00
Dockerfile split local and discord destinations and add network security 2021-01-30 04:24:55 +02:00
README.md split local and discord destinations and add network security 2021-01-30 04:24:55 +02:00
discord.sh split local and discord destinations and add network security 2021-01-30 04:24:55 +02:00
docker-compose.yml split local and discord destinations and add network security 2021-01-30 04:24:55 +02:00

README.md

Logmonitor based on syslog-ng on Alpine Linux

A small Alpine container running syslog-ng configured to log to /var/log/messages and optionally to an SQL database.

Usage

Basic usage with the default local destination:

docker build -t logmonitor .
docker run --env WEBHOOK=https://discordapp.com/api/webhooks/... -p 514:514/udp -d --name logmonitor --rm logmonitor:latest ; docker logs logmonitor --follow
docker stop logmonitor ; docker rm logmonitor
docker run -d --name syslog-ng -p 514:514/udp -p 601:601/tcp -p 6514:6514/tcp logmonitor

Environment variables

  • ENABLE_LOCAL - set True to log to /var/log/system.log in container (default: False)

  • ENABLE_DISCORD - set True to log to Discord in container (default: False)

  • ALLOWED_SUBNET - Define allowed network. (default: 10.0.0.0/24)

  • SQL_HOST - the IP or domain of the destination SQL server

  • SQL_PORT - the port the destination SQL server runs on (defaults to 3306 if not specified)

  • SQL_USER - the user name used to access the destination SQL server

  • SQL_PASSWORD - the password for the destination SQL server

The SQL destination is enabled automatically when any SQL_* environment variable is set, otherwise it is disabled by default.

Persisting data

If you're using the local destination you could mount /var/log/messages as a volume (e.g. add -v syslog-ng_messages:/var/log/messages to the run command).

The configuration files for destinations are in /etc/syslog-ng/conf.d/, however the d_sql.conf and d_local.conf files are created and deleted as the container starts up, depending on how environment variables are set. If you want to make persistent changes to destinations you'll need to modify the templates these configuration files are created from and these are in /etc/syslog-ng/templates/. You can safely add new configuration files for other destinations directly to /etc/syslog-ng/conf.d/

The configuration for sources are in /etc/syslog-ng/syslog-ng.conf. This file is not modified at container statup so you can make persistent changes there if it's mounted as part of a volume.