tracker-rs(1) System Tracker tracker-rs(1)

NAME tracker-rs - high-performance system monitoring tool

SYNOPSIS tracker-rs [OPTIONS]

DESCRIPTION tracker-rs is a high-performance, memory-safe system monitoring tool written in Rust. It provides real-time statistics for CPU, memory, disk I/O, and network traffic, along with process management and temperature monitoring.

   Designed as a drop-in replacement for the legacy Python implementation, it offers
   significant performance improvements (10-50x faster execution, reduced memory usage)
   while maintaining configuration compatibility.

OPTIONS -c, --continuous Run in continuous monitoring mode. The tool will repeatedly display statistics and log data based on the update interval.

   -i, --interval SECONDS
          Set the update interval in seconds. Default is 5 seconds.
          This option is primarily used with --continuous mode.

   --config FILE
          Path to the configuration file. Default is "config.json".
          If the file does not exist, internal defaults are used.

   -h, --help
          Print help message and exit.

   -V, --version
          Print version information and exit.

CONFIGURATION The tool is configured via a JSON file (default: config.json). The configuration file supports the following keys:

   update_interval (integer)
          Default refresh rate in seconds (overridden by -i).

   display (object)
          Toggle individual monitoring features on/off:
          - show_cpu (boolean)
          - show_memory (boolean)
          - show_disk (boolean)
          - show_network (boolean)
          - show_processes (boolean)
          - show_temperatures (boolean)

   process_limit (integer)
          Number of top CPU-consuming processes to display.

   alert_thresholds (object)
          Percentage thresholds for triggering alerts:
          - cpu_percent (float)
          - memory_percent (float)
          - disk_percent (float)

   Example config.json:
   {
       "update_interval": 5,
       "display": {
           "show_cpu": true,
           "show_memory": true,
           "show_disk": true,
           "show_network": true,
           "show_processes": true,
           "show_temperatures": true
       },
       "process_limit": 5,
       "alert_thresholds": {
           "cpu_percent": 80.0,
           "memory_percent": 85.0,
           "disk_percent": 90.0
       }
   }

OUTPUT tracker-rs outputs formatted system statistics to the console. In continuous mode, it updates at the specified interval.

   CPU Usage: 35.42%
   Memory: 58.21% (14.00GB / 24.00GB)
   Disk: 50.40% (464.07GB / 920.86GB)
   Network: Sent 4872.76MB | Recv 6633.56MB

   Top Processes by CPU Usage:
   PID       Name                          CPU%      Memory%
   ------------------------------------------------------------
   1234      chrome                        45.23     3.21

FILES config.json Default configuration file location.

   logs/tracker_YYYYMMDD.log
          Daily rotating log files containing system stats and alerts.

EXIT STATUS 0 Success. 1 Failure (e.g., invalid configuration).

EXAMPLES Run a single monitoring snapshot: $ tracker-rs

   Run continuously every 2 seconds:
          $ tracker-rs -c -i 2

   Use a custom configuration file:
          $ tracker-rs --config /etc/tracker/config.json

SEE ALSO top(1), htop(1), ps(1)

BUGS Report bugs to https://github.com/m1ngsama/tracker/issues

AUTHOR m1ngsama

LICENSE MIT License

v1.0.0 2025-12-18 tracker-rs(1)