CloudTest and TouchTest dashboards can be filtered by any or all of the following (some filters may be unavailable depending on the dashboard):
- Collection Name
- Compare To
- Duration Timespan
- Element Status
- Element Type
- Parent Container
- Property Name
- Property Value
- Time Format
- Time Zone (deprecated)
For widgets, the following filters are available where relevant:
- Collection (for Collection widgets only)
- Collection Name (for Collection widgets only)
- Date/Time--filter by date/time window at the widget level
- Location--filter by the (Maestro) location
- Operation (for browser actions, app actions, and database operations)
- Duration Timespan
Refer to Filtering mPulse Dashboards for more information about beacon-specific filters.
Getting Started using Dashboard Filters
In the Result Details widget, the Element Status and Element Type filters are displayed on the widget surface by default. For all other widgets the display of filters on the widget title is optional.
- To filter a dashboard or widget, first invoke the Toggle Dashboard Edit Mode button to show the Edit Panel. The Edit Panel > Filter tab is used to filter dashboards or selected widgets.
When edit mode is on, the Edit Panel opens with the Dashboard node selected on the left. To filter the entire dashboard, click the Filter tab.
- To filter at the Widget level, first select a widget in the dashboard and then select "Widget" in the Edit Panel list. Additional widget options appear only if a selection is made. Widget selection can occur before or after invoking the Edit Panel. For widgets, the available filters will vary according to widget type.
- With the Widget node selected, click the Filter tab.
If the selected widget does not support filtering, the Filter tab displays that fact.
- For widgets that support filtering, check Apply all of the following criteria and then define filter criteria to apply by using the Attribute, Operator, and Value fields in the first row using the steps below.
Additional rows may be added, or rows subtracted, by clicking the Plus and Delete icons respectively.
- Optionally, click Display filter toolbar. This will display the Filter icon in the widget or dashboard title bar as shown on the right. One or more filters can be displayed.
- In the Attributes drop-down, select one of the available attributes.
- Select an operator to filter by. The available operators vary according to the attribute selection above. For time values an entry field appears.
- Optionally, click the green arrow to add a second row of criteria to filter by.
When the Widget node is selected in the dashboard above, the filter criteria are applied only to the selection.
- Click Apply when you’re ready to enact these changes on the dashboard or widget.
- Click OK or Cancel when done.
- For filters displayed on a widget or dashboard, click the blue link to show drop-down filters defined above. For example, the displayed filter on the right shows time ranges to filter by.
If more than one row to display was checked, its value also displays on the toolbar (if Display was checked).
For clips, select either All or one of the clips listed for the currently selected result.
For collections, select either Chain, Group, Page, Transaction, If, Switch, or All.
For collection names, select either All or one of the listed collections by name in the result.
The Date/Time filter applies to CloudTest, TouchTest, and mPulse equally.
Refer to mPulse Analytics: Time Windows for more about using the Date/Time filter in beacon-based dashboards.
For date/time, select either a pre-configured moving time window such as Last 24 Hours
- Dashboard result time – Filter the result by the specified time zone
- Today – Filter is set to the current calendar date
- On– Filter is set to the specified calendar date
- This week – Filter by the current calendar week that is underway
- This month – Filter by the current calendar month that is underway
- Last - Filter by the specified "Last" range. When this option is selected, the Time Selector Control appears.
TIP: The meaning of "Last X" will depend on the dashboard setting for the Time Format attribute. In this setting, the user can choose between absolute and relative time. For example, if Last 5 Minutes is defined using Date/Time, it can mean either the last 5 minutes from now (absolute time format option) or the last 5 minutes of the test (relative time format option).
Use the Slider to specify a moving time window of the given length. To set the value for Last, toggle between Current Time and Date/Time and select between the time windows orfrom among Dashboard result time, On, Between (e.g. to specify a time range).
- For Current Time, the current selection is indicated in the bottom row (e.g. Previous 60 minutes).
- For Date/Time, use a pre-configured moving time window, use a different time format (i.e., On) or create a custom time window.
- Between – Filter by the defined time window using the Time Selector Control (one each for start and end). You can also set a 'Between' time range by choosing 'Last', 'Date/Time', and then between (as shown above).
TIP: To ensure that your Date/Time filter is added to the Dashboard filter toolbar, check "Display filter toolbar" as you have always done.
Once defined and added to the filter toolbar, your Date/Time filter can be modified and/or redefined from the toolbar using the Time Selector Control.This control is the same whether utilized from the lower panel (during initial setup of a custom dashboard) or from the dashboard filter toolbar.
For distributions, select either All or one of the Distributions listed for the currently selected result.
For domains, select either All or the Domains listed for the currently selected result.
The Duration Timespan filter for dashboards and widgets allows users to track both full and effective duration for all containers.
The Duration Timespan filter appears on the dashboard edit panel's Filter tab, Attribute drop down for dashboards that use duration widgets and for the duration widgets themselves. This filter can be added to a dashboard or widget, but effective duration data can only be displayed for tests that were run after the introduction of this feature.
When Duration Timespan is used, the underlying Maestro server will provide a number that includes only transport times for each container type.
If no Duration Timespan filter exists then the default behavior is to show effective duration for tests created after the introduction of this feature and full durations for tests run prior to this.
At the widget level, the Duration Timespan filter appears only for duration widgets.
Duration widgets are found in the Widget Type Selection Panel's Widget Types, Charts, Durations category.
The possible operator values for Duration Timespan are: "Effective" and "Full."
Effective – Effective duration includes only that time it took to execute resources from point A to point B in time. This measure is the overall amount of time doing real work as opposed to the overhead created by ancillary tasks (i.e. time spent doing validations, scripts, IF statements, etc.). Users should note that parallel tasks (such as in the resources section of a page) are not counted separately.
For example, if a Page had two resources, which were sent in parallel, and one took 10 seconds to send and receive whiled the other took 15 seconds, the effective duration of the resources section of that page is 15, and not 25.
Full – The full amount of time including the overhead of ancillary tasks for the given container from beginning to end.
In the screenshot below, effective duration is applied at the dashboard level.
If the Duration Timespan, Effective Duration value is set on a dashboard or widget, and the displayed result does not have this data, then the dashboard will show "empty" (or, if it's a chart, "No Data", and, if it's a cell in an Analysis widget, then the same dash shown "-" for other non-applicable fields will be shown).
For element status, select either All or Errors Only.
For element type, select either All or Messages & Actions Only.
For locations, select either All or one of the locations listed for the currently selected result.
For operations, select either All or one of the operations listed for the currently selected result. Typical operations include the HTTP operations PUT, POST, GET as well as selectRange, and many others. Click the Values drop-down to investiate those available.
For parent container, select either All or the name of a specific parent container in the result.
For property name, select either All or the name of a specific property in the result.
For property value, select either All or the value of a specific property in the result.
The Series filter allows users to filter the various series in a result at both the dashboard level, and where applicable, at the widget level. This filter appears in all dashboards. Series filtering will only impact those charts that support it.
The Series filter appears in all dashboards. Series filtering will only impact those charts that support it.
The Series filter also appears in all charts that present comparative information in series form.
A chart series is one category of data presented in a chart as points on a timeline.
For example, in the shot below, note that the possible values to filter by are listed by the order of the number of points in the given series.
For targets, All or one of the targets listed for the current selected result.
For time, select a time period (e.g. Last 5 Minutes, etc.), Between (to specify a range), or Dashboard result time.
For Time Format, select the operator (either Absolute or Relative Time) and then specify whether to apply the value to All (clips) or the listed clips. For Relative Time, the X axis will go from 0 to the number of minutes of the test For Absolute time, the X axis will go from the actual clock time of day that the test started (e.g. 2:30:46) to when it ended.
For Time Zone, select a time zone value from the listed values.
For Track, select All or one of the tracks the listed values in the result.
Now, widgets for Clips and for Collections can also be filtered by track.
For TouchTest users, by-track filters can also be used as an equivalent of by-device filtering when there is one device per track (e.g. by selecting a device in the Track's Location drop-down). It should be noted that if devices are set at the clip-level, then using the track filter as an equivalent of "location" will not be possible.