Live Stream

The Live Stream view provides information on the test executions currently running on devices in Perfecto. Administrator users see all executions. Other users only see their own executions.

 

To learn how to retrieve a list of the test executions in your lab via API, see Execution Manager API.

Live Stream overview

The Live Stream view displays a header with the total number of executions running and a Search field on the right. Two modes are available:

  • Grid: Default. Displays a table view of all executions currently running, provided you have permission to view them. Includes options to view the live video for an execution and to stop one or more executions. The grid shows the list of running test executions with the following information:

    • The Name and Owner of the execution, where the name is determined by the value of the scriptName capability defined in the test script.

    • The Time the execution started (in the browser's local timezone) and the Duration (the length of time the execution has been running) in minutes, seconds, and millisecond.

    • The characteristics of the device used for the test execution, as follows:

      • Device type: An icon that indicates whether the device is a mobile or desktop web device

      • Device model: For mobile, the device model; for desktop web, the VM operating system (Windows | Mac)

      • OS: The version of the operating system

      • Browser: If the test is running on a browser, an icon that indicates the type of browser and a number that indicates the browser version

      • Resolution: The display resolution of the device

      • More: Any additional information regarding the device, if applicable

  • Device dashboard:  Displays a video view of all executions currently running, provided you have permission to view them. Includes options to apply a filter, get more information on a specific execution, and view the video in full-screen view. 

Tip: By default, an automatic timeout occurs after 15 minutes of inactivity. If you intend to monitor the Live Stream view continuously on a board or wall, in either mode, you can turn off the automatic timeout feature by adding the following parameter to the URL: ?session-idle-limitation-disabled
For example: https://<your-cloud>.app.perfectomobile.com/executions?session-idle-limitation-disabled

You can also use the HTTP API to retrieve test execution information of currently running executions in JSON format or stop a specific test execution. For details, see Execution Manager API.

To switch between modes:

  • Click the grid icon for grid mode or the video icon for the device dashboard, respectively.

To search for specific executions:

  • In the Search field at the top right, enter any string included in the execution listing. For example, you can search by owner, platform, or device model.

    The Live Stream view updates dynamically as you type, showing only executions that match the entered string.

  • In device dashboard mode, use the filter pane to focus on executions of interest.

Restrictions

The following restrictions apply:

  • The Live Stream view is not available in hybrid clouds.

  • Due to a known limitation, the device dashboard is not available when viewed on Safari.

Device dashboard mode

By default, the device dashboard shows up to 8 devices. If more test executions are running, and if the current user has permission to view them, you can access them using the right and left arrows . The number of total executions running is shown at the top left.

Watch this short video to see how the device dashboard mode works.

The device dashboard mode includes a Filter panel where you can select:

  • The number of concurrent test executions to view on your screen
  • Specific devices to hide, per device type and operating system

To filter executions:

  1. In Device Dashboard mode, click the filter button  to open the filter panel.

  2. In the filter panel:

    • From the Number of Presented Screens list, select the number of screens to show on your display.

    • Under Executions List, clear the check mark for devices you want to hide. 

  3. To clear the filter, click the broom button  at the top right.

  4. To close the filter panel, click the x icon at the top right of the filter panel or the Show All link at the top left of the device dashboard.

For each device, you can view detailed information about the device, including the execution name, owner, start time, duration, type, operating system, version, and resolution.

To display device details:

  1. Move the pointer over the device.
  2. On the toolbar that appears, click the information button  to see details about the device.

You can switch the video to full-screen mode if needed. Switching to full-screen mode does not interfere with the actual device operation. It cannot influence the running scripts.

To watch in full-screen mode:

  1. Move the pointer over the device.

  2. On the toolbar that appears, click the zoom button .

  3. To close full-screen mode, click the x icon.

Grid mode

Watch this short video to see how the grid mode works.

By default, the list of executions is sorted by their start time (newest executions listed at the top). The column used to sort the list is indicated by a small triangle in the column header. The triangle points down for descending order and up for ascending order.

To change the sorting parameter:

  • Click the header of any column. The executions are sorted by that parameter.
  • Click a column header multiple times to switch between ascending and descending order.

You can select one or more executions from the list and stop them. You can also select the checkbox in the header row to select all executions in the list.

To stop executions:

  1. Click the required executions to select them.

    To select a number of executions listed consecutively:

    1. Click the first execution.
    2. While holding down the Shift key, select the last execution in sequence.

    A check mark to the left indicates that an execution is selected.

  2. Optionally, to clear all selections, click Clear Selection. You can also click a row again to clear a single selection.

  3. In the toolbar that appears above the grid, click Stop Execution.
    A progress message appears. While the message is available, you can click the Undo link, if needed, to stop the action and allow the executions to continue their run.
    Otherwise, the executions stop after a few seconds and disappear from the grid.

You can view a video of the ongoing fast web test executions in real time in a dedicated video panel. The video panel is a view-only interface and does not interfere with the actual device operation. It cannot influence the running scripts.

To view a live video:

  1. Move the pointer over an execution in the list to display the camera button .

    The icon is only available when the device information for the execution is available.

  2. Click the camera icon. The video panel opens on the right. It includes the ScriptName of the execution, information on the VM configuration, such as operating system and version, browser type and version, and resolution, and a live video stream of the execution.

  3. Click the frame button  to remove the frame around the device maximize the display.

  4. To view the video in full-screen mode, click the zoom button .

  5. To close full-screen mode or the video panel, click the x icon.