Skip to main content

NetSnoop: Real-Time Linux System Anomaly Monitor and Dashboard

Project description

🖥️ NetSnoop - Real-Time Linux System Monitor

NetSnoop is a real-time, low-level system activity visualizer for Linux systems. It detects process bursts, high CPU/memory usage, and memory usage — all displayed in a beautiful interactive dashboard built with Streamlit.


📦 Installation

pip install netsnoop

After installing the package, run the setup script to generate necessary files:

netsnoop-init

This will:

  • Install required packages (if not already)
  • Create anomalies.csv and netsnoop_persistent.txt
  • Add sample data
  • Create dashboard/monitor launcher scripts (.sh and .bat)

🛠️ How It Works

🔄 Architecture Flow:

acm_monitor.py → enhanced_anomaly_logger.py → dashboard.py
     ↓                      ↓                     ↓
  Detects              Stores to CSV         Displays data
 Anomalies                                   in Streamlit UI

🚀 Usage Guide

Step 1: Start the Monitor

python3 -m netsnoop.acm_monitor

This will begin real-time detection of:

  • High CPU/memory usage
  • Process bursts
  • System overloads

Anomalies will be saved to anomalies.csv and logs to netsnoop_persistent.txt.


Step 2: Launch the Dashboard

In another terminal:

streamlit run netsnoop/dashboard.py

Then open your browser to: http://localhost:8501


🧾 License

MIT License © 2025 Chitvi Joshi
See the LICENSE file for details.


🧠 Made For:

  • Linux users
  • System monitoring and anomaly visualization
  • Hackathons, research, devops dashboards

Born to Track. Built with ❤️.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netsnoop-0.1.4.tar.gz (20.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

netsnoop-0.1.4-py3-none-any.whl (21.5 kB view details)

Uploaded Python 3

File details

Details for the file netsnoop-0.1.4.tar.gz.

File metadata

  • Download URL: netsnoop-0.1.4.tar.gz
  • Upload date:
  • Size: 20.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for netsnoop-0.1.4.tar.gz
Algorithm Hash digest
SHA256 b4082f3af4b9f54c7dfd4835f7194455fc0cdd48d50818bcb546b47da748ea20
MD5 f43c347d0d48d947e6845090c8079d12
BLAKE2b-256 8df09f6d54914b49d7a8c4d65086009c0d25176c1e024f2dfb7b64a58a5a78ef

See more details on using hashes here.

File details

Details for the file netsnoop-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: netsnoop-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 21.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for netsnoop-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 fb4e951ca224fcca95fddf00ca659c1aa1f24542e9b99f10c4cfeeb08e0416f4
MD5 23e2cc26bd29e0c33d618c3e9d0c423d
BLAKE2b-256 6a2f76558b0eb9bb47f69b6bf001f2fe26b306a8a7a2c68c91dd0b8b4ef39e26

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page