Эта команда позволяет контролировать использование системных ресурсов. Ресурсы представлены различными показателями (метриками) связанными с хост системой и определенной ВМ. Например, показатель хост системы CPU/Load/User показывает процент времени которое использует CPU для работы в пользовательском режиме за определенный период.
Данные показателей коллекционируются и сохраняются внутри системы; вы можете получить их в любое время командой VBoxManage metrics query. Данные доступны в течении времени выполнения фонового процесса VBoxSVC. Этот процесс завершается вскоре после завершения работы всех виртуальных машин.
По умолчанию данные показателей не собираются. Сбор метрики не начинается пока он не будет инициализирован командой VBoxManage metrics setup, с указанием интервала и количества сохраняемых значений метрики. Интервал измерений указывается в секундах. Например, для включения сбора данных о процессоре хоста и использования памяти, с интервалом в 1 секунду с сохранением 5 последних значений ,используйте следующую команду:
VBoxManage metrics setup --period 1 --samples 5 host CPU/Load,RAM/Usage
Установленное в 0 значение интервала или количества сохраняемых значений отключает сбор данных. Заметьте, что команда VBoxManage metrics setup очищает все предыдущие собранные данные для выбранного множества объектов и показателей.
Хост и виртуальные машины имеют различное множество показателей. Доступные показатели можно получить командой VBoxManage metrics list.
Полное имя показателя может содержать агрегатную функцию. Имя имеет следующий вид: Category/Metric[/SubMetric][:aggregate] . Например, RAM/Usage/Free:min содержит минимальное количество доступной памяти.
Команда может применяться для всех объектов и показателей, или ограничиваться одним объектом и/или списком показателей. Если в параметрах не указано ни одного объекта или показателя, команда применяется для всех доступных показателей и объектов. Вы можете использовать знак умножения (" * ") для явного указания того, что команда применяется для всех объектов и показателей. Использование "host" как имя объекта ограничивает область действия команды показателями хоста. Для ограничения области действия множеством показателей, используется список показателей разделенных запятой.
Например, для вывода значений показателей работы CPU в режиме пользователя и ядра для виртуальной машины "test", вы можете использовать команду:
VBoxManage query test CPU/Load/User,CPU/Load/Kernel
Ниже приведен обзорный списмок доступных команд:
Эта команда показывает текущие настройки показателей. Заметьте, что показателей ВМ доступны только для работающих виртуальных машин.
Эта команда отображает с установленным интервалом между получением значений показателей и количество последних отображаемых значений. Сохраняемые данные отображаются командой query. С опцией --list показывается какие показатели будут изменены в результате выполнения команды.
Эта команда отображает текущие сохраненные значения показателей.
Команда query не удаляет и не "очищает" сохраненные данные. Если вы будете часто запрашивать данные, то увидите как постепенно старые значения заменяются новыми.
Эта команда отображает с установленным интервалом между получением значений показателей и количество последних отображаемых значений. Собранные данные непрерывно отображаются на экране до нажатия Ctrl-C если не указана опция --detach. С опцией --detach, эта команда работает так же как setup. Опция --list отображает какие показатели будут затронуты командой.