Skip to content

About

Fast, deep log search and crash diagnosis CLI for Minecraft servers, Discord bots, and Linux syslogs. Reads raw and compressed (.gz) logs.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Deep Server Log Search & Crash Diagnostics CLI

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.

Node.js License Hosting


What It Solves

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.

Supported Diagnostic Signatures

  • 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 EADDRINUSE and 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.

Installation

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 --crashes

Usage Examples

1. Automated Crash & Diagnostics Scan

Scans all .log and .log.gz files in a folder for critical issues:

node bin/cli.js /path/to/server/logs --crashes

2. Search for Specific Error Pattern with Context Lines

node bin/cli.js /path/to/server/logs "NullPointerException" -C 3

3. Output Machine-Readable JSON

node bin/cli.js /path/to/server/logs --crashes --json

Infrastructure

Built for server owners and developers operating workloads on VexaNode. Join the developer community: discord.gg/devz


License

MIT License. Open source under VexaNode-Dev.

About

Fast, deep log search and crash diagnosis CLI for Minecraft servers, Discord bots, and Linux syslogs. Reads raw and compressed (.gz) logs.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages