list-bandwidth

Lists bandwidth use for some system over some date range

This command outputs hourly or per-minute bandwidth usage stats for selected systems managed by Cloudmin. It provides the same information as the bandwidth graphs in the web UI, but in a format that can be parsed or graphed by other programs.

The date range to output is selected by the --start and --end flags, which must be followed by either a date in yyyy-mm-dd format, or a number of days into the past from the current date like -5. If the start date is not given, data from the time the system was created is output. If the end is omitted, data up to the current time is displayed.

By default, per-hour totals are shown. However, you can switch to per-minute data with the --minute flag. Also, output is by default rounded to the nearest MB or GB to make it more readable - but you can switch to showing the exact number of bytes with the --exact flag.

Example usage

  cloudmin list-bandwidth --host xencentos.home --start -2
  xencentos.home
   Date/time            Data in      Data out     Packets in   Packets out 
   29/Mar/2008 15:00    286.39 kB    1.53 MB      2683         1975        
   29/Mar/2008 16:00    292.49 kB    1.54 MB      2659         2026        
   29/Mar/2008 17:00    331.08 kB    1.67 MB      2791         2192        
   29/Mar/2008 18:00    305.04 kB    1.67 MB      2813         2142        
   29/Mar/2008 19:00    292.98 kB    1.67 MB      2716         2153        
   29/Mar/2008 20:00    351.39 kB    1.69 MB      3036         2388        
   29/Mar/2008 21:00    385.94 kB    1.71 MB      3311         2668        
   29/Mar/2008 22:00    294.53 kB    1.67 MB      2733         2136        

Command Line Help

Shows bandwidth usage by virtual system and time

cloudmin list-bandwidth [--start yyyy-mm-dd]
                        [--end yyyy-mm-dd]
                        [--all-hosts] | [--host name]*
                        [--group name]*
                        [--type real|kvm|gce|this]*
                        [--os oscode]*
                        [--owner name]*
                        [--status status-code|"up"|"wm"|"bad"]
                        [--host-on name]
                        [--minute]
                        [--exact]