LogMon

📋 LogMon

Simple, automated log file monitoring with email notifications.

Scan your log files for errors, exceptions, and warnings — get instant email alerts when issues are detected.

✨ Features

Feature	Description
🔍 Smart Pattern Detection	Detects errors, exceptions, warnings, timeouts, and more using optimized regex
📧 Email Notifications	Instant HTML email alerts via secure SMTP/SSL
⚡ High Performance	Concurrent scanning with thread pools and compiled regex
🔄 Incremental Scanning	Only scans new content since last check — efficient for cron
📦 Standalone Executable	No Python required on your servers
🔧 Flexible Configuration	Environment variables or config file

🆕 What’s New in v1.3.2

Combined regex patterns for faster scanning
Concurrent file processing with thread pools
Improved configuration loading
Better debug output formatting

📦 Installation

Option 1: Download Standalone Executable (Recommended)

# Download the latest release
wget https://github.com/VGXConsulting/LogMon/releases/latest/download/log_monitor-linux-x86_64.tar.gz

# Extract
tar -xzf log_monitor-linux-x86_64.tar.gz

# Make executable
chmod +x log_monitor

# Configure
cp log_monitor.conf.example log_monitor.conf
nano log_monitor.conf

# Test
./log_monitor --debug

Option 2: Run with Python

# Clone the repository
git clone https://github.com/VGXConsulting/LogMon.git
cd LogMon

# Configure
cp log_monitor.conf.example log_monitor.conf
nano log_monitor.conf

# Run
python3 log_monitor.py --debug

🔧 Configuration

Edit log_monitor.conf with your settings:

[SMTP]
server = smtp.example.com
port = 465
username = your_smtp_username
password = your_smtp_password
from_email = monitoring@example.com
to_email = admin@example.com

[Paths]
log_dir = /var/log/myapp

Environment Variables

Environment variables override config file settings. Use the VGX_LM_ prefix:

Variable	Description
`VGX_LM_SMTP_SERVER`	SMTP server hostname
`VGX_LM_SMTP_PORT`	SMTP port (default: 465)
`VGX_LM_SMTP_USERNAME`	SMTP username
`VGX_LM_SMTP_PASSWORD`	SMTP password
`VGX_LM_SMTP_FROM`	From email address
`VGX_LM_SMTP_TO`	Recipient email address
`VGX_LM_LOG_DIR`	Directory to scan for *.log files

🔍 Detected Patterns

LogMon scans for these error indicators:

error, fail, exception, traceback, critical, fatal,
warning, not found, permission denied, connection refused,
timeout, unable to, could not, exit code, returned non-zero,
aborted, killed

⏰ Automation (Cron)

Add to crontab for automated monitoring:

# Edit crontab
crontab -e

# Run every 15 minutes
*/15 * * * * cd /path/to/logmon && ./log_monitor

# Or with debug logging
*/15 * * * * cd /path/to/logmon && ./log_monitor --debug >> /var/log/logmon.log 2>&1

📖 Usage

# Normal mode (silent unless errors found)
./log_monitor

# Debug mode (detailed output)
./log_monitor --debug

# Show version
./log_monitor --version

# Show help
./log_monitor --help

📧 Email Alert Example

When errors are detected, you’ll receive an HTML email like:

Log Monitor Alert: 3 error(s) detected

File Line Content Timestamp

/var/log/app/error.log 142 ERROR: Connection timeout 2026-01-22 10:15:32

/var/log/app/app.log 89 Exception in thread main 2026-01-22 10:15:32

File	Line	Content	Timestamp
/var/log/app/error.log	142	`ERROR: Connection timeout`	2026-01-22 10:15:32
/var/log/app/app.log	89	`Exception in thread main`	2026-01-22 10:15:32

🏗️ Building from Source

# Install build dependencies
pip install -r requirements.txt

# Build standalone executable
pyinstaller --onefile --name log_monitor log_monitor.py

# Executable will be at dist/log_monitor

📄 License

Unauthorized copying, modification, distribution, or use of this software is strictly prohibited.

Made with ❤️ by VGX Consulting