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)