Knowledge Base

[#1]

Dashboards can be added to test compositions or created independently of a given test composition. The widgets in dashboards can be moved, printed, popped out, maximized, and edited (for example, by having their colors changed, or by data toggled using checkboxes. Add or Remove Dashboards Each composition can have one or more dashboards arranged in any of the given layouts. In the example on the right there are two dashboards, Performance and Error Analysis. Additional dashboards can be added by clicking the Plus sign (+) to the right of the last added dashboard on the title bar. When you do so, the Dashboard wizard appears. To remove a dashboard from a test composition, simply click its Close icon to the right of the dashboard name in Composition Editor > Play tab (or Results tab).
SOASTA CloudTest provides a number of default dashboards, as well as a large selection of widgets categorized by type. To get started, you can click add a default dashboard to your test composition. For example, the Default Functional Dashboard. See Creating a New Dashboard for step-by-step instructions on dashboard creation.
Move or Remove Widgets To move a widget to a new location on a dashboard, select the title bar and hold the mouse down to drag the widget into its new position. When you do so, an icon representing this widget appears on the drag operation. This icon can be placed in the new widget location as desired.
See Combine and Correlate Charts for instructions on using drag-and-drop actions to combine like chart widgets. To remove a widget from a custom dashboard, place the mouse cursor over the top right portion of the widget until the widget control appears. Note: System dashboards are not editable. If you'd like to revise a system dashboard, you must first save it as a copy (or custom) dashboard.
Click the Delete (X) button to remove the widget.
Edit Widget or Dashboard Options
Toggle the Dashboard Edit Mode button to edit layout, color, and other settings for dashboards or for a selected widgets. When you do so, the Combined Edit Panel for widgets and dashboards appears in the lower portion of the dashboard workspace on the right.
Browse the General, Layout, Properties, and Filter tabs to view or change settings for the dashboard. Click to Apply any changes.
Viewing or Changing a Dashboard’s Settings Click the Toggle Dashboard Edit Mode button on the toolbar. If no widgets were selected, the Edit Panel appears below with only the Dashboard node selected and the General tab showing. When dashboard is selected only dashboard-level settings are presented.
General Dashboard Options Name - The dashboard name Display on dashboard surface - check to display the name on the dashboard surface Save Location - the repository location of this dashboard Set as my default dashboard - Click this button to make the current dashboard the default one
Layout Dashboard Options Browser Window Fit/Fill WIndow - select a sizing setting for the dashboard using the visual cues Layout type - select a column layout for the dashboard using the visual cues
Dashboard Properties Background Color - select a color for the dashboard background Widget Padding - increase internal and external space around the widget border Use Chart Timelines - chart timelines are linked across the dashboard by default, unchecking this will unlink them Enable widget animations - turn chart animations associated with real-time deltas on or off Hide widgets when not playing - conceal widgets when the test composition is not playing
Viewing or Changing a Widget’s Settings Toggle on the Widget Selection Panel. Click the widget whose settings you’d like to view or edit. The widget appears selected as indicated by the blue selection border and the Widget Type list scrolls to the selected widget.
Toggle the Dashboard Edit Mode button to edit layout, color, and other settings for dashboards or for a selected widgets.
The Edit Panel appears below with the Widget selected on the left and its properties showing on the right. The Title field in the right panel and the blue border above agree.
All charts have the following fields: Title—An editable text title Show Title bar checkbox—Uncheck this box to hide display of the chart's title bar Color—Select from among basic colors by clicking one to apply it to the widget's title bar Custom color field—Enter a hexadecimal code for a custom color in the text field below Color Height—Pick among radio buttons for Default, Custom (specified in pixels, and Use Remaining Space (stretches the widget to available space in the dashboard) options
Widgets with special settings display them in the Widget(s) tree. For example, the non-chart Fundamentals Widget’s Include settings appear at Widget(s), Fundamentals. If a chart has custom settings they are displayed as a child of the widget in the tree. The Save As option allows the combined (or any) widget to be saved and used in other dashboards. Clicking Save As… launches the Create a New Widget Type dialog box. The saved widget will be shown in the same category as the "saved" widget. For widget specific filtering instructions for the Fundamentals (or any other widget), refer to Filtering the Fundamentals Widget.
General Widget Options When Edit Widget is clicked for a given widget, its General options are displayed. Widget specific options are listed separately in the Widget(s) tree view. Tree view is shown for all widget types.
For charts, General options include the selection of a Theme for a widget. Selecting a theme selects the colors that will be used in the chart series. Selecting a radio button for a given theme makes the first color in that row the first color in the series. Click a color tile in any theme row to begin the series (of charts) with that color instead. The series will cycle through the remaining colors.
The selected color (e.g. yellow tile from the Spectrum) is assigned to the top-most subordinate chart that was listed first in the Widget(s) tree view and the Widget Order list (in the Edit Widget panel). The selection is the one that's "closest" to the user on the chart. Clicking the third tile in the Spectrum row will result in the chart colors shown on the right.
The default is for no vertical lines to display.
Checking the Show X axis grid lines checkbox turns on vertical grid lines for the widget.
Viewing or Changing Contained Widget Settings If the widget is a combined or correlated widget the contained nodes are also shown. For example, the Bytes Sent and Received and Average Response Time are Contained widgets with grouped properties to set that include Chart Type and Show data point markers (off by default).
The Widget Order is shown on the right. For combined widgets, multiple subordinate widgets will be shown. Use the Detach the subordinate widget button (to the right of the widget’s name) to detach it from the combined chart and add it independently to the dashboard. Combined widgets use transparency. The topmost widget in order is closest to the user—while the bottom most gets the background color.
With the Edit Widget Panel in view, select the Contained Widget(s) node to view settings at that level such as the order of widgets.
To change widget order, select a widget and use the up or down arrows to move it.
To remove a widget from a combined or correlated widget and return it to the dashboard as a separate widget, click the Detach contained widget button.
To remove a widget from a combined or correlated widget and delete it from the dashboard use the delete button. To change which contained widget gets the left- or right-x-axis, use the Axis drop-down list. Click Apply to save any changes made here. Click Toggle Dashboard Edit Mode a second time to exit the panel.
Chart Axis: Primary/Secondary The Axis and Primary/Secondary setting allows the Left y-axis and Right y-axis to be switched per subordinate chart. Check the Show data point markers checkbox to show dots on line chart as a user preference.
Changing Chart Types Select a widget name under the Contained Widget(s) node to set the following additional options: Chart Type The Chart Type drop-down offers: Line, Bar, Area, Scatter, and Pie options for each chart. Changing the type will change the presentation of its data to the given type. An Area chart is shown on the right.
The same information can be presented as a Bar chart (or any other available type).
Maximize, Restore, and Pop-Out a Widget You can maximize and restore a widget to increase and restore its visual space on the dashboard. Click Maximize to use the full dashboard space, click Restore to return the widget to its default size on the dashboard.
You can pop-out a widget to view it in a separate window. To do so, place the mouse in the widget's upper right corner and press the Pop-Out button.