quotengrote / mSYSLOG

simple centralized logging

           ______   ______  _     ___   ____
 _ __ ___ / ___\ \ / / ___|| |   / _ \ / ___|
| '_ ` _ \\___ \\ V /\___ \| |  | | | | |  _
| | | | | |___) || |  ___) | |__| |_| | |_| |
|_| |_| |_|____/ |_| |____/|_____\___/ \____|


 A simple centralized logging solution almost only with bash and gnu-tools.

Table of Contents

• Introduction
• Getting started
  • install msyslog-client
  • remove msyslog-client
• Usage client
  • Example client Configuration
• Usage server
• Build
• License

Introduction

mSYSLOG is a programm that collects logfiles and send it via netcat to a server.

Getting started

install msyslog-client

1. download deb
2. sudo apt install --fix-broken ./msyslog-client*.deb
3. check if service is running systemctl status msyslog-client.service

remove msyslog-client

1. apt remove --purge msyslog-client

Usage client

Usage:
  - msyslog-client.sh [OPTIONS]
  - systemctl start|stop|restart|status msyslog-client.service

Options:
    -h, --help                  Displays this text.
    -s, --status                Displays the current status of the script.

Example client Configuration

# configfile for msyslog-client

# files whose contents should be sent(comma-separated)
logfiles=/var/log/syslog,/var/log/messages,/var/log/test file,/var/log/secure

# fqdn and port to which the data should get send
log_receiver_fqdn=acng.server
log_receiver_port=12345

Usage server

ncat -l -k -p 12345

Build

The client packages get build with GitHub Actions and dpkg-deb.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.