feat(loganalyzer): complete tool suite for analysing erupe logs.

tools/loganalyzer/QUICK_REFERENCE.md

@@ -0,0 +1,119 @@
+# Quick Reference Guide
+
+## Installation
+
+```bash
+cd tools/loganalyzer
+go build -o loganalyzer
+```
+
+## Quick Commands
+
+### View Statistics
+
+```bash
+./loganalyzer stats -f ../../erupe.log
+./loganalyzer stats -f ../../erupe.log -detailed
+```
+
+### Filter Logs
+
+```bash
+# Errors only
+./loganalyzer filter -f ../../erupe.log -level error
+
+# Last hour
+./loganalyzer filter -f ../../erupe.log -since 1h
+
+# Last 50 entries
+./loganalyzer filter -f ../../erupe.log -tail 50
+
+# Search message
+./loganalyzer filter -f ../../erupe.log -msg "connection reset"
+```
+
+### Analyze Errors
+
+```bash
+# Error summary
+./loganalyzer errors -f ../../erupe.log -summary
+
+# Detailed with stack traces
+./loganalyzer errors -f ../../erupe.log -detailed -stack
+```
+
+### Track Connections
+
+```bash
+# Connection stats
+./loganalyzer connections -f ../../erupe.log
+
+# Player sessions
+./loganalyzer connections -f ../../erupe.log -sessions
+
+# Specific player
+./loganalyzer connections -f ../../erupe.log -player "PlayerName" -sessions -v
+```
+
+### Follow Logs
+
+```bash
+# Like tail -f
+./loganalyzer tail -f ../../erupe.log
+
+# Only errors
+./loganalyzer tail -f ../../erupe.log -level error
+```
+
+## Common Workflows
+
+### Troubleshooting a crash
+
+```bash
+# 1. Check recent errors
+./loganalyzer filter -f erupe.log -level error -tail 20
+
+# 2. Analyze error patterns
+./loganalyzer errors -f erupe.log -detailed -stack
+
+# 3. Check what was happening before crash
+./loganalyzer filter -f erupe.log -since "2025-11-12T23:00:00Z" -tail 100
+```
+
+### Player investigation
+
+```bash
+# 1. Find player sessions
+./loganalyzer connections -f erupe.log -player "PlayerName" -sessions -v
+
+# 2. Check errors for that player
+./loganalyzer filter -f erupe.log -logger "*PlayerName*"
+```
+
+### Monitoring
+
+```bash
+# Real-time error monitoring
+./loganalyzer tail -f erupe.log -level error
+
+# Daily statistics
+./loganalyzer stats -f erupe.log -detailed
+```
+
+## Tips
+
+1. **Pipe to less for long output**: `./loganalyzer filter -f erupe.log | less -R`
+2. **Save to file**: `./loganalyzer stats -f erupe.log > stats.txt`
+3. **Combine with grep**: `./loganalyzer filter -f erupe.log -level error | grep "mail"`
+4. **Use -count for quick checks**: `./loganalyzer filter -f erupe.log -level error -count`
+5. **Time ranges**: `-since` accepts both absolute (RFC3339) and relative (1h, 30m) times
+
+## Output Format
+
+Default output is colorized:
+
+- Errors: Red
+- Warnings: Yellow
+- Info: Green
+
+Disable colors with `-color=false` for piping to files.