Log Analyzer
Analyze any text-based log file for error patterns, severity breakdown, and anomaly detection.
Quick Start
python3 scripts/analyze_logs.py <logfile>
python3 scripts/analyze_logs.py app.log --top 20 --severity ERROR
python3 scripts/analyze_logs.py server.log --json --since "2026-03-01"
Features
- Severity classification — auto-detects FATAL, ERROR, WARN, INFO, DEBUG from log lines
- Error fingerprinting — groups similar errors by stripping variable parts (IPs, UUIDs, PIDs, timestamps)
- Anomaly detection — flags hours with error rates >2x the average
- Timestamp parsing — handles ISO 8601, syslog, and nginx/apache formats
- Flexible output — human-readable report or
--jsonfor piping
Options
| Flag | Description |
|---|---|
--top N | Number of top error patterns (default: 15) |
--severity LEVEL | Minimum severity filter (FATAL, ERROR, WARN, INFO, DEBUG) |
--json | Output structured JSON |
--since TIMESTAMP | Only analyze lines after this timestamp |
Workflow
- Run the analyzer on the target log file
- Review severity breakdown for overall health
- Check top error patterns for recurring issues
- Look at anomaly hours for incident windows
- Use
--jsonoutput to feed into other tools or reports