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]