LogWisp

Multi-stream log monitoring with real-time streaming over HTTP/SSE and TCP

LogWisp watches log files and streams updates to connected clients in real-time. Perfect for monitoring multiple applications, filtering noise, and centralizing log access.

🚀 Quick Start

# Install
go install github.com/yourusername/logwisp/src/cmd/logwisp@latest

# Run with defaults (monitors *.log in current directory)
logwisp

# Stream logs (from another terminal)
curl -N http://localhost:8080/stream

✨ Key Features

📡 Real-time Streaming - SSE (HTTP) and TCP protocols
🔍 Pattern Filtering - Include/exclude logs with regex patterns
🛡️ Rate Limiting - Protect against abuse with configurable limits
📊 Multi-stream - Monitor different log sources simultaneously
🔄 Rotation Aware - Handles log rotation seamlessly
⚡ High Performance - Minimal CPU/memory footprint

📖 Documentation

Complete documentation is available in the doc/ directory:

Quick Start Guide - Get running in 5 minutes
Configuration - All configuration options
CLI Reference - Command-line interface
Examples - Ready-to-use configurations

💻 Basic Usage

Monitor application logs with filtering:

# ~/.config/logwisp.toml
[[streams]]
name = "myapp"

[streams.monitor]
targets = [{ path = "/var/log/myapp", pattern = "*.log" }]

[[streams.filters]]
type = "include"
patterns = ["ERROR", "WARN", "CRITICAL"]

[streams.httpserver]
enabled = true
port = 8080

Run multiple streams:

logwisp --router --config /etc/logwisp/multi-stream.toml

📄 License

BSD-3-Clause

2.3 KiB Raw Blame History