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
  • USB activity
  • 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.1.tar.gz (20.5 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.1-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: netsnoop-0.1.1.tar.gz
  • Upload date:
  • Size: 20.5 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.1.tar.gz
Algorithm Hash digest
SHA256 0d3365c70f6b3e826f45134db653060354b9fa02816b8a5625dd8f50484d75a0
MD5 4ebadca18f1a0f34cb98366b08b0d486
BLAKE2b-256 8c2e1ff1725f27a25a334561aa07cb444074b38486dc058e1b0b7ae940e180c4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: netsnoop-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 21.6 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cfc10a6eebf31a799267482560d4d45803cb5fdb9e48714c6fc9cb6ea1fd34b9
MD5 b3299f8c58b66fb1e5bb5760f5bbbe64
BLAKE2b-256 d8cd79cd67d7628193fec9c6f853097fe0efbbd977e867068d5679cc839480ab

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