NervMap: Single Command Server Service Discovery and Diagnostics Tool

What NervMap Does

NervMap is a command-line tool that provides comprehensive visibility into server services and their dependencies. It was created to address the pain point of manually running multiple commands like docker ps, systemctl, and ss -tlnp and cross-referencing configurations when troubleshooting server issues.

Key Features and Performance

The tool executes in 0.6 seconds and discovers:

• All Docker containers
• All systemd services
• All bare processes

It maps dependencies between these services using multiple detection methods with varying confidence levels:

• Docker Compose depends_on (100% confidence)
• TCP established connections via /proc/net/tcp (85% confidence)
• Environment variables like DATABASE_URL, REDIS_HOST (60% confidence)
• Docker network membership (30% confidence)

Diagnostic Capabilities

NervMap includes 15 diagnostic rules that identify issues with severity and impact analysis, plus fix suggestions. The diagnostics cover:

• Port conflicts
• OOM-killed containers
• Restart loops
• Failed systemd services
• Circular dependencies
• Disk pressure
• Exposed wildcard ports

Usage and Testing

The tool includes a --scope flag to focus on a single project. It has been tested on a production server with 263 services and reported zero false positives. Secrets are redacted by default in all output.

NervMap is available as a Linux binary and is free for personal use. The source is hosted on GitHub.