Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Dec 16, 2019 21:59

Command: vitals

Subcommand: start

Supported Platforms: Native,UFT,Selenium,Appium

Supported OS: Android, iOS

Begins collecting Vitals, until the Vitals stop function is invoked or at script end.

Description

Starts collecting part/all of the real-time vitals data generated by the device until the Vitals stop command or script end.

This information helps to determine how efficient an application is at using resources, as well as measuring the general device performance.

Application vitals

It is also possible to collect application-specific vital measurements from mobile devices. Vitals will be separately collected for all of the selected services.

Available application vitals:

  • For Android: Memory Used, CPU Used, and CPU Kernel.
  • For iOS (8.0 and up): Memory Used, and CPU Total.

Vitals in automation and interactive

The Vitals start function performs the same operation as the Vitals feature in Interactive.

Important information when working with Automation and Interactive simultaneously:

  • Starting and stopping the vitals collection in Automation will not affect Interactive
  • Stopping the vitals collection in Interactive will stop the vitals collection in Automation
  • Running an Automation script with vitals collection will display the vitals in Interactive
  • Interactive and Automation will produce separate CSV files

A single, multiple or all vitals can be stopped at any point within the script.

Parameters

 * Mandatory parameter

Request & Response

JSON Request
https://mycloud.perfectomobile.com/services/executions/john@perfectomobile.com_controller_16-11-08_09_26_26_940?operation=command&securityToken=<your_token>&command=vitals&subcommand=start&param.deviceId=6370E775&param.vitals=all

JSON Response
{
  "reason": "Success",
  "timer.elapsed": "141",
  "returnValue": "{[DeviceVital: VitalId:outputs.monitors.memory.cache]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.cpu.user]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.cpu.kernel]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.network.wlan.in]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.network.mobile.out]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.network.mobile.in]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.network.wlan.out]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.memory.free]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.cpu.total]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED], [DeviceVital: VitalId:outputs.monitors.memory.used]=[CollectedMonitorStatusInfo: Message:null, Status:SUCCEEDED]}",
  "testGridReportUrl": "https://mycloud.reporting-stg.perfectomobile.com?externalId[0]=john@perfectomobile.com_controller_16-11-08_09_26_26_940",
  "description": "Success",
  "timer.system": "141",
  "completed": "true",
  "flowEndCode": "SUCCEEDED",
  "executionId": "john@perfectomobile.com_controller_16-11-08_09_26_26_940",
  "timer.ux": "0",
  "singleTestReportUrl": "https://mycloud.perfectomobile.com/nexperience/singletest/report/?reportRepositoryKey=PRIVATE:controller/161108/controller_16-11-08_09_26_26_940.xml&ownerId=john@perfectomobile.com&sharingCode=166ca97d-a844-443e-bb78-99da59f69f8f",
  "reportKey": "PRIVATE:controller/161108/controller_16-11-08_09_26_26_940.xml",
  "timer.device": "0"
}