⚡ Atlas Pulse

Instant, Zero-Overhead Infrastructure & App Observability
The Datadog & New Relic Killer — 100% Free, Zero-Telemetry, Self-Hosted.

🏛️ Vision

Commercial observability stacks (Datadog, New Relic, Dynatrace) have become outrageously expensive, bloated, and closed. Simple host monitoring shouldn't cost thousands of dollars per month or consume 500MB of host RAM just to collect metrics.

Pulse is engineered from first principles by Atlas Research Labs:

• 🆓 100% Free & Open Source — No paywalls, no agent license fees, no credit cards.
• ⚡ Zero-Overhead — < 15MB RAM footprint, < 0.2% CPU overhead. Zero external dependencies.
• 🖥️ Dual Interfaces — Interactive live Terminal UI (pulse top) + Gorgeous Embedded Web Dashboard (pulse dashboard).
• 📡 Synthetic Probes — Microsecond-level DNS, TCP, TLS, and TTFB latency benchmarking.
• 🚨 Instant Webhook Alerts — Native dispatch to Discord, Slack, and custom HTTP webhooks.
• 🌍 Cross-Platform — Seamless out of the box on Linux, macOS, and Windows.

🚀 Quick Start

Run instantly without installation:

npx pulseio

Or install globally:

npm install -g pulseio

💻 CLI Commands

1. Interactive Terminal Monitor (pulse top / pulse monit)

Launches a high-refresh ANSI terminal UI displaying real-time gauges for CPU (per core), memory, disk mount points, network throughput, and top processes:

pulse top

2. Embedded Visual Web Dashboard (pulse dashboard)

Spins up a lightweight, responsive, real-time web dashboard powered by Server-Sent Events (SSE) and SVG charts:

pulse dashboard
# Web UI running at http://localhost:9988

Custom port and host:

pulse dashboard --port 8080 --host 0.0.0.0

3. Instant Health Check (pulse check)

Evaluates system bottlenecks and alerts in one shot:

pulse check

Or export as structured JSON for automation & CI/CD:

pulse check --json

4. Synthetic Endpoint Prober (pulse probe)

Benchmarks any external or internal web service with granular network breakdown:

pulse probe https://google.com

Output:

✓ PROBE SUCCESS [301 Moved Permanently]
  DNS Lookup:       12 ms
  TCP Connect:      28 ms
  TLS Handshake:    45 ms
  Time To 1st Byte: 94 ms
  Total Latency:    96 ms
  Payload Size:     220 bytes

🌐 REST & SSE Streaming API

When running pulse dashboard, the embedded HTTP server exposes programmatic observability endpoints:

| Endpoint | Method | Description | | :--- | :--- | :--- | | /api/metrics | GET | Complete instantaneous snapshot (CPU, RAM, Disks, Network, Processes, History) | | /api/health | GET | Concise status payload (healthy or degraded) with active alerts | | /api/processes?limit=25 | GET | Active process tree sorted by resident memory | | /api/probe?url=<target> | GET | On-demand synthetic network probe against target URL | | /api/stream | GET | Live Server-Sent Events (SSE) push stream (1 update/sec) |

🚨 Alerts & Webhooks

Configure threshold alerts and forward them automatically to your Discord or Slack channels:

pulse dashboard --webhook "https://discord.com/api/webhooks/YOUR/WEBHOOK/URL"

Or set via environment variable:

export PULSE_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/TOKEN"
pulse top

Thresholds:

• CPU: Triggers when overall CPU usage $\ge 90%$
• Memory: Triggers when memory utilization $\ge 90%$
• Disks: Triggers when any disk mount point $\ge 90%$ full

🏗️ Architecture

+------------------------------------------------------------------+
|                           ATLAS PULSE                            |
+------------------------------------------------------------------+
  │
  ├── Collector Layer (Native OS Syscalls /proc, statfs, netstat)
  │     ├── CPU Delta Engine (per core + overall)
  │     ├── Memory Allocator (total, free, used, swap)
  │     ├── Storage Mounts (fs.statfsSync across all drives)
  │     ├── Network Throughput (rx/tx throughput & counters)
  │     └── Process Scanner (PID, Memory RSS, session)
  │
  ├── Time-Series Sliding Window (60-second in-memory ring buffer)
  │
  ├── Alert Engine (Threshold evaluation + Discord/Slack webhooks)
  │
  ├── Terminal UI (`pulse top` interactive ANSI renderer)
  │
  └── Embedded Web Server (`pulse dashboard`)
        ├── REST Endpoints (/api/metrics, /api/health, /api/probe)
        ├── SSE Real-time Stream (/api/stream)
        └── Dark Glassmorphism Web App (SVG sparklines, inspector)

📜 License

MIT License © 2026 Atlas Research Labs
Built in India. Built for the World.