Find Out How

1. Open the dashboard where the widget will be added.
• You can open a dashboard in the Composition Editor > Play tab.
• Or, from Central > Dashboards

2. 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.

3. In the Widget Selection Panel, locate the Widget Type list and expand the widget category to view its contents.

The Widget Type list presents the following categories for out-of-the-box widgets:

Each of the categories has many widgets. A brief description indicates the purpose of each widget.

• Basic
• Choose Basic to select from widgets that provide information such as environment demographics.
• Charts
• Choose Charts to select from a long list of charted information such as response times, data received or sent, and user counts. See Interacting with Charts.
• Containers
• Choose Containers to select from Dashboard Container and Monitor Container—you can use containers to add a new or existing dashboard to an already existing dashboard or to add resource monitors to a dashboard. See Adding a Monitor Container to a Dashboard and Adding a Dashboard Container to a Dashboard below.
• Custom
• Choose Custom to select from a list of user-defined widgets.
• Logging
• Choose Logging to display system logs on the dashboard.
• Maps
• Choose Maps to display activity maps for cloud-based tests with geographic distribution.
• Utilities
• Choose Utilities to select from utilities that control user-defined monitors.

Note: If external data services are configured, they appear at the bottom of the Widget Type list.

4. Expand the widget category you want to use by clicking its right arrow. For example, Basic. That category’s widgets are shown.

5. 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. 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 and drop it. The widget is added to the dashboard.

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

The dashboard columns appear gray when a dragged widget is over the workspace. Once dropped, the widget will be placed at the topmost available space for the given column.

6. Repeat these steps to add additional widgets and monitors to the dashboard.
7. To place an existing widget in the position of a current one, drag the new widget just above or below the widget as desired until the gray guideline appears to indicate that is where the widget will be placed if dropped from its current position.

Adding an External Data Chart to a Dashboard

Once configured, an External Data Source appears by name in dashboards via the Widget Selection Panel, Widget Type section. If an external data source has not been configured, refer to Creating an External Data Service

1. Click Toggle Widget Panel Selection in the dashboard toolbar if the panel is not visible.
2. Create a new dashboard (or open an existing dashboard) from Central > Dashboards, or, from the Composition Editor > Play tab. Expand the Widget Type list.

TIP: Once a widget from an external data source is in a dashboard, select it to also scroll to its location in the Widget Type list.

3. Expand the named external data source and locate one or more widgets to add. The external data reflects the same structure found in Introscope for the given user’s credentials.

4. Select the widget to add and then drag and drop it into the desired position on the dashboard.

The widget appears in position. For an existing dashboard or one associated with a test composition, an added widget inherits the result selection in effect for that dashboard.

• If the dashboard already has a result selection or a time range controller, the widget will inherit them.
• If there is no relevant information for the given selection, ““No Result Selected”” is shown.
• If no selection exists, the prompt to “Select a result or specify a time range controller” appears.
• Result selection persists between sessions and remains in effect the next time the user logs in.

Replacing a Widget in a Dashboard by Selection

Easily change a widget in a dashboard by selecting it to show the blue border and then by selecting different widgets from the Widget Type section, or keep the type and change the data in it by picking different results from the Widget Data section. This can be done to each contained widget separately.

1. To replace a widget in a dashboard, first select it. The Widget Type list scrolls to the selection automatically.

2. Select the replacement widget. The selection appears in the dashboard.

3. De-select the widget by clicking its title bar a second time.

Adding a Monitor Container to a Dashboard

The Monitor Container permits defined monitors to be easily added to new or existing dashboards while maintaining a separate time range from the other widgets in it. Monitor Container can be added to a composition using the same procedures described above.

In the screenshot on the right, the Widget Type > Containers list is shown.

1. Drag the monitor container to the dashboard workspace to add it.

2. The Choose Monitor screen appears. Select a monitor from the list and then click the green right arrow.

Note: The selection shown on the right is a previously defined Monitor Server Group.

The Specify Server and Group Filters screen appears.

3. Specify a selection and then click the green right arrow.

4. The Monitor Container appears in the place where it was dropped. Each one of the resources defined within the Monitor(s) or Monitor Server Group(s) selected above are included in the container.

If no time range or result is selected in the dashboard at this time, the widgets indicate that state with the posted message "No time range selected and time range controller disabled."

Adding a Dashboard Container to a Dashboard

Using a dashboard container, you can add a dashboard to another dashboard. A dashboard container can have a separate time range from the dashboard in which it is placed.

1. Open the dashboard to which the Dashboard Container will be added.
2. In the Widget Type list, select Containers, and then Dashboard Container.
3. Drag the Dashboard Container into position on the dashboard.

4. The New or Existing Dashboard screen appears in the dashboard space. Opt to create a new dashboard to insert into the current one or select an existing dashboard.

5. Choose an existing dashboard (other than one of the monitor dashboards). If you choose a new dashboard, refer to Creating a New Dashboard. The selected dashboard is placed into the Dashboard Container and is placed into the dashboard layout.