LogMaster - Smart Log File Analyzer

Stop grep-ing through logs! LogMaster analyzes, filters, and visualizes logs in seconds.

---

💖 Support This Project

If LogMaster saves you time debugging, consider sponsoring its development!

Your sponsorship helps:

• ⚡ Faster bug fixes and updates
• ✨ New log format support
• 📚 Better documentation
• 🆕 More free developer tools

🏢 Using LogMaster at work?

Consider a Business tier sponsorship for priority support and feature requests!

---

Why LogMaster?

The Problem: Finding issues in logs is painful

• grep through GBs of logs
• Miss important errors
• No statistics
• Hard to spot patterns

The Solution: Smart log analysis

• Instant error detection
• Statistics at a glance
• Smart filtering
• Generate reports

Installation

curl -sSL https://raw.githubusercontent.com/strabo231/logmaster/main/install.sh | bash

Quick Start

# Analyze log file
logmaster analyze app.log

# Show only errors
logmaster errors app.log

# Follow log with filter
logmaster tail app.log -f --filter "ERROR"

# Generate statistics
logmaster stats access.log

Search for pattern

logmaster search app.log "database"

## Commands

analyze Full analysis errors Show only errors warnings Show only warnings tail Smart tail with filters stats Generate statistics search Search for pattern report Generate HTML report

## Features

📊 **Smart analysis** - Errors, warnings, patterns  
🔍 **Advanced filtering** - By level, time, pattern  
📈 **Statistics** - Error rates, top errors, timelines  
🎯 **Multi-format** - Apache, Nginx, JSON, syslog, app logs  
⚡ **Fast** - Handle GB-sized logs  
📝 **Reports** - Generate HTML summaries  
🔴 **Live monitoring** - Tail with smart filters  

## Usage

**Analyze log:**
```bash
logmaster analyze app.log

═══════════════════════════════════════════════════════════════
                  LOG FILE ANALYSIS
═══════════════════════════════════════════════════════════════

File: app.log
Size: 45MB
Lines: 156,234
Format: app

Log Levels:
  ERROR:   234
  WARNING: 1,456
  INFO:    154,544

Top Errors:
  89 × Database connection timeout
  42 × API rate limit exceeded
  38 × Invalid JWT token

Show errors:

logmaster errors app.log --last 1h

Tail with filter:

logmaster tail app.log -f --filter "ERROR"

Real-time error monitoring!

Statistics:

logmaster stats access.log

Overview:
  Total lines:  1,234,567
  Errors:       234 (0.02%)
  Warnings:     1,456 (0.12%)

Top 5 IPs:
  12,345 192.168.1.100
   8,901 192.168.1.101
   5,678 192.168.1.102

Status Codes:
  1,123,456 200
     98,765 404
     12,346 500

Search:

logmaster search app.log "timeout"

Generate report:

logmaster report app.log --output report.html

Supported Formats

Application logs:

[2024-12-15 10:23:45] ERROR: Database connection failed
[2024-12-15 10:23:46] WARN: Slow query detected

Access logs (Apache/Nginx):

192.168.1.1 - - [15/Dec/2024:10:23:45] "GET /api HTTP/1.1" 200

JSON logs:

{"timestamp":"2024-12-15T10:23:45Z","level":"ERROR","msg":"Failed"}

Syslog:

Dec 15 10:23:45 server app[1234]: Error message

Use Cases

Debugging:

# Find all errors in last hour
logmaster errors app.log --last 1h

# Search for specific issue
logmaster search app.log "OutOfMemoryError"

Monitoring:

# Watch for errors in real-time
logmaster tail app.log -f --filter "ERROR"

Analysis:

# Get statistics
logmaster stats app.log

# Generate report for team
logmaster report app.log

Production Troubleshooting:

# Quick overview
logmaster analyze production.log

# Top errors
logmaster errors production.log | head -20

Requirements

• Bash 4.0+
• Standard Unix tools (grep, awk, sort)

License

MIT License

Author

Sean - @strabo231

---

Analyze logs. Find bugs. Ship faster. 📊