Эта команда позволяет контролировать использование системных ресурсов. Ресурсы представлены различными показателями (метриками) связанными с хост системой и определенной ВМ. Например, показатель хост системы 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
отображает какие показатели будут затронуты командой.