A fast, zero-dependency command-line utility for searching, diagnosing, and inspecting server logs. Designed for Minecraft servers, Discord bot runtimes, Pterodactyl panels, and Linux system services.
Server logs can be gigabytes in size, split into archived .log.gz files, and filled with thousands of lines of noise. Finding the actual root cause of a crash or rate limit is tedious.
server-log-analyzer streams through raw and gzipped log archives on the fly, extracts context lines around errors, and matches known failure patterns with actionable solutions.
- Minecraft Watchdog Freezes: Identifies tick loop hangs, stuck entities, and heavy redstone chunks.
- Out of Memory (OOM): Detects JVM Heap exhaustion and Node.js V8 memory crashes.
- Port Conflicts: Flags
EADDRINUSEand binding failures. - Discord Rate Limits: Spots 429 Too Many Requests and runaway endpoints.
- Missing Gateway Intents: Flags missing Message Content / Guild Member privileged flags.
- Corrupted Chunks: Highlights RegionFileException and bad NBT tags.
Run directly with npx or install globally:
# Direct run
npx @vexanode/server-log-analyzer ./logs --crashes
# Or clone and run locally
git clone https://github.com/VexaNode-Dev/server-log-analyzer.git
cd server-log-analyzer
node bin/cli.js /path/to/logs --crashesScans all .log and .log.gz files in a folder for critical issues:
node bin/cli.js /path/to/server/logs --crashesnode bin/cli.js /path/to/server/logs "NullPointerException" -C 3node bin/cli.js /path/to/server/logs --crashes --jsonBuilt for server owners and developers operating workloads on VexaNode. Join the developer community: discord.gg/devz
MIT License. Open source under VexaNode-Dev.