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.3.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.3-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: netsnoop-0.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 de215cf166f916f54ac7f10afdcbc9ba85a15088f9ac670a22d96efb01530f82
MD5 3ccf296934f9512ccd3783c379fc6edd
BLAKE2b-256 af59c8c6f26ead7981526d1c17ec2e104833a016cfed7a74296d2c9aa0ee76f0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: netsnoop-0.1.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 815bf1ae8ec8e8bc2e7d33d37c8e29cedb8ce1fa4944da27f030d9cc00b0c9c5
MD5 3d2ccf0e829754f21acedef732e05ce3
BLAKE2b-256 fd9f29651d04c22af2bad1f4ba31d6caf7265e4928ecd9d247918c7a4cfc2caf

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