Package Exports

sysmon-linux
sysmon-linux/sysmon.py

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (sysmon-linux) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

sysmon - Linux System Monitor

A real-time Linux system monitoring tool that displays CPU, memory, processes, and uptime information in a clean, colorful interface.

Features

🖥️ Real-time System Monitoring

⏱️ System uptime and load average
💻 CPU usage percentage (accurate calculation)
📊 Process count with high CPU process detection (≥90%)
💾 Memory usage with color-coded alerts
🎨 Color-coded display based on resource usage levels

🔍 High CPU Process Detection

Shows detailed information about processes using ≥90% CPU
Displays process name, PID, and exact CPU percentage
Helps quickly identify resource-hungry applications

⚡ Performance Optimized

Uses /proc filesystem for fast data collection
No external dependencies beyond standard Python libraries
Lightweight and efficient

Installation

Quick Start

Clone or download the script:

cd /home/nmsglobal/DEVEL/CHATGPT5_PLAN/sysmon
chmod +x sysmon.py

Run directly:

./sysmon.py

System-wide Installation

sudo cp sysmon.py /usr/local/bin/sysmon
sudo chmod +x /usr/local/bin/sysmon

Usage

Basic Usage

# Default: updates every 60 seconds
sysmon

# Custom interval (e.g., 5 seconds)
sysmon -i 5

# Single display and exit
sysmon --once

# No color output
sysmon -n

Command Line Options

Option	Description	Default
`-i, --interval`	Update interval in seconds	60
`-n, --no-color`	Disable colored output	False
`--once`	Display once and exit	False
`-v, --version`	Show version information	-
`-h, --help`	Show help message	-

Examples

Monitor with 10-second updates

sysmon -i 10

Quick system check

sysmon --once

Continuous monitoring without colors (for logs)

sysmon -n -i 30 > system_monitor.log

Output Example

==================================================
    LINUX SYSTEM MONITOR
==================================================
Last Update: 2024-01-19 15:30:45
--------------------------------------------------
⏱  Uptime: 5d 3h 45m
📈 Load Average: 1.25 1.18 1.05
💻 CPU: 75.5% (4 cores)
📊 Processes: 245 total, 2 high CPU (≥90%)
   └─ stress-ng (PID 12345, 95.2% CPU)
   └─ python3 (PID 12346, 92.1% CPU)
💾 Memory: 4096MB / 8192MB (50.0%)
--------------------------------------------------
Refresh interval: 60s | Press Ctrl+C to exit

System Requirements

OS: Linux (tested on Ubuntu, Debian, CentOS)
Python: 3.6 or higher
Permissions: Read access to /proc filesystem

How It Works

The tool reads system information directly from the Linux /proc filesystem and uses system commands:

/proc/uptime - System uptime
/proc/loadavg - Load average information
/proc/stat - CPU usage calculation
/proc/meminfo - Memory statistics
ps aux - Real-time process CPU usage for high CPU detection (≥90%)

Color Coding

Memory usage is color-coded for quick status assessment:

🟢 Green: < 60% usage (healthy)
🟡 Yellow: 60-80% usage (moderate)
🔴 Red: > 80% usage (high)

Troubleshooting

Permission Denied

If you encounter permission errors, ensure you have read access to /proc:

ls -la /proc/uptime

No Color in Terminal

Some terminals may not support ANSI color codes. Use the -n flag to disable colors.

High CPU Usage

If monitoring at very short intervals (< 5 seconds), consider increasing the interval to reduce system load.

Development

Running Tests

python3 -m unittest test_sysmon.py

Contributing

Feel free to submit issues or pull requests for improvements.

License

MIT License - Feel free to use and modify as needed.

Author

System Monitor CLI Tool - Created as part of Linux system administration toolkit.

Version

1.0.0 - Initial release with core monitoring features