Creating a New Dashboard

Document created by Chris Sommerstad Employee on Jul 21, 2017Last modified by Trishala Kalal on Aug 14, 2017
Version 2Show Document
  • View in full screen mode

SOASTA provides System Dashboards with pre-configured widget selections organized by data type. In the case of mPulse, your default dashboard will launch on login.

Any System Dashboard can be cloned, and used as a separate custom dashboard.

  • To create a custom dashboard from an existing dashboard, click the Properties button on the toolbar —and when prompted provide a name for the new dashboard—or, click the Toolbar Widget Selection Panel button on your dashboard and add a widgget. In either case, you'll be promopted to create a new dashboard when you attempt to make any change to a System Dashboard.

Whether you create a new custom dashboard from scratch or from a cloned System Dashboard, dashboard editing is the same—widgets are added via the left selection panel, and filters are applied via the (lower) Dashboard Edit Panel or (if the dashboard is already configured to use one) via a toolbar filter.

In the screenshot below, clicking the Properties icon (red box), or toggling the Widget Selection Panel (green box) on and dragging a widget into the workspace will cause a prompt to create a new custom dashboard. When prompted, give the new custom dashboard a name to create the new custom dashboard.

  • To create a custom dashboard from scratch, use the steps below.

Note: It is not necessary to create a dashboard before you play your tests. SOASTA platform products, including CloudTest, TouchTest, and mPulse, provides a default dashboard that lets you get started right away.


Use the following steps to create a Dashboard:

  1. Click New with Dashboards selected in Central.


For CloudTest and TouchTest users, you can also click New with Compositions selected in Central and then proceed to create a new dashboard from with the Composition Editor, Play tab. Standalone-dashboards can also be created from Central > Dashboards using New.

  • To create a new dashboard from within the Composition Editor, Play tab, simply click the "+" link to the right of the last dashboard tab.

  • Whenever a composition begins to play, the Result Details dashboard appears unless there is already a different default dashboard associated with the test composition or user. The Result Details widget begins to populate as the test plays.
  • Whenever an mPulse user logs in, the mPulse Dashboard will appear unless there is a different default dashboard set by the user.

Use the Set As My Default Dashboard button in the Dashboard Edit Panel to use any dashboard as your default.

After choosing New, the Dashboard wizard appears with the New or Existing Dashboard page in display.

  1. Select Create a New Dashboard to define a new dashboard (you can opt to open an existing dashboard).

When you do so, the New Dashboard Setup page appears.

  1. In the New dashboard setup page:
  • Enter a dashboard name
  • Select a dashboard folder (optional)
  • Select a Widget Layout

Widgets you add will occupy the available vertical space within the dashboard. Available space is determined by how many widgets are already in a dashboard. The minimum height that a widget will shrink to is its default height. When If sufficient widgets are stacked in a dashboard, then Dashboard scroll bars will appear. Only a handful of widgets have a fixed height, including Fundamentals (CloudTest), Summary (mPulse), and Timers and Metrics (mPulse).

  1. Click Next. The new dashboard is created and opens in its own tab (if you're in the Composition Editor that tab is also within it). The Choose Widget dialog appears in two positions at the top of the dashboard.
  • The dashboard opens as a new tab with the Widget Selection Panel toggled on.

Click the Toolbar Widget Selection Panel button to toggle the Widget Selection Panel on or off. For new dashboards, the Widget Selection Panel appears automatically toggled on.

Adding Widgets

Widgets are presented in the Widget Type section of the Widget Selection Panel (on the left) from where they can be easily dragged into position in dashboards. Click the arrow of any widget category to expand its contents. Widgets from monitors and external data sources are included here. Choose from among Basic, Charts, Containers, Custom, Logging, Maps, Monitor, and Utilities (formerly Monitoring Utilities) widgets. Any external data sources configured appear at the bottom of this list.

Add widgets to the dashboard by dragging them from the list to the workspace, combine or correlate widgets by dropping them onto other widgets. Selected widgets in the dashboard automatically scroll this list to that selection. For example, expand the Basic widget category by clicking its right arrow.

Note: In the case of adding monitor widgets, first select the monitor from the Monitors section and optionally specify an Aggregation Level.

Place the mouse cursor over the widget to add, press and hold the left mouse button and drag the widget to a column in the dashboard workspace.

For more information about adding widgets to dashboards, see Adding a Widget to a Dashboard.

Specifying Results to Use in a Dashboard

Results can be specified for both dashboards and (separately) for selected widgets by selecting result items in either the Widget Selection Panel’s Dashboard Data or Widget Data sections.

Specifying Dashboard-Level Results

Result selection at the dashboard-level is performed within the Dashboard Data section.

  • With a dashboard open, and the Widget Selection Panel toggled on, expand the Dashboard Data section.

For a stand-alone dashboard, the default “Most recent from this Composition” will display “No Results Selected” in widgets.


For a composition dashboard, the current result selection applies. If the composition has not been played, then “No Result Selected” displays.