Table of Contents
25 Scatter plot
Overview
The Scatter plot widget displays the relationship between two metrics by plotting individual data points along an X and Y axis. This helps reveal patterns, clusters, correlations, and outliers in the data set.
Configuration
To configure, select Scatter plot as type:
Data set
The Data set tab allows selecting data for the scatter plot by adding data sets. Two types of data sets can be added:
- Item patterns - hosts with matching items are displayed as data points. You can pick a single base color or select a palette row to assign distinct colors to each host with the matched items.
- Item list - selected items are displayed as data points, where each point represents a pair of items (X and Y). You can choose each data set's color individually from the picker.
Data points are created only for those hosts/item pairs that have at least one value on both axes.
By default, an Item patterns data set is added.
| Data set | For Item patterns data set: Select or enter host and item patterns; data of items that match these patterns will be displayed on the scatter plot; up to 100 items may be displayed (50 on each axis for 50 hosts in total). Wildcard patterns may be used for selection (for example, * will return results that match zero or more characters).To specify a wildcard pattern, enter the string manually and press Enter. The wildcard symbol is always interpreted, so it is not possible to add, for example, an item named item* individually if there are other matching items (for example, item2, item3). Specifying host and item patterns is mandatory for "Item patterns" data sets. See also: Data set configuration details. For Item list data set: Select items for the scatter plot by clicking on the Add item button. You may also select compatible widgets as the data source for items by clicking on the Add widget button. Specifying items or widgets is mandatory for "Item list" data sets. See also: Data set configuration details. Note that only numeric item types are allowed. When configuring the widget on a template dashboard, the parameter for specifying host patterns is not available, and the parameter for specifying an item list allows to select only the items configured on the template. |
|
| Host groups | Select host groups. Alternatively, select a compatible widget as the data source for host groups. This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups. Specifying a parent host group implicitly selects all nested host groups. Host data from these host groups will be displayed in the widget; if no host groups are entered, all host groups will be displayed. This parameter is available only for Item patterns data sets and is not available when configuring the widget on a template dashboard. |
|
| Host tags | Specify tags to filter the hosts displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive. There are several operators available for each condition: Exists - include the specified tag names; Equals - include the specified tag names and values (case-sensitive); Contains - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive); Does not exist - exclude the specified tag names; Does not equal - exclude the specified tag names and values (case-sensitive); Does not contain - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive). There are two calculation types for conditions: And/Or - all conditions must be met, conditions having the same tag name will be grouped by the Or condition; Or - enough if one condition is met. This parameter is available only for Item patterns data sets and is not available when configuring the widget on a template dashboard. |
|
| Override host | Select a compatible widget or the dashboard host selector as the data source for hosts. This parameter is not available when configuring the widget on a template dashboard. |
|
| Marker | Choose the marker type and size for host data points in the data set. | |
| Time shift | Specify time shift if required. You may use time suffixes in this field. Negative values are allowed. |
|
| Aggregation function | Specify which aggregation function to use: min - display the smallest value; max - display the largest value; avg - display the average value; sum - display the sum of values; count - display the count of values (if at least one value exists on both axes); first - display the first value; last - display the last value; none - display all values (no aggregation). Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of all values. See also: Aggregation in graphs. |
|
| Aggregation interval | Specify the interval for aggregating values. You may use time suffixes in this field. A numeric value without a suffix will be regarded as seconds. Note that if the widget is configured to display historical data based on trends (History data selection is set to Trends or Auto), it is recommended to use an aggregation interval that is a multiple of 1 hour (e.g., 3600, 60m, 1h, 3h, etc.). Trends store hourly aggregated values, so using an aggregation interval that is not a multiple of 1 hour (e.g., 100s, 7min, 15min, 90min, etc.) may lead to results that are hard to interpret. Specifying an aggregation interval is mandatory. The aggregation interval determines the time interval and coordinates for a data point; for example, if X-axis items have 4 values and Y-axis items have 1 value, the coordinates reflect aggregating 4 on X and 1 on Y in the specified interval. |
|
Data set configuration details
Existing data sets are displayed in a list. You can rearrange, expand/collapse, change colors, and clone these data sets.
For more information, see data set configuration details in the Graph widget. These details also apply to the Scatter plot widget.
Displaying options
The Displaying options tab allows to define history data selection:
| History data selection | Set the source of scatter plot data: Auto - data are sourced according to the classic graph algorithm (default); History - data from history; Trends - data from trends. |
Time period
The Time period tab allows to set a time period for which to display data in the scatter plot:
| Time period | Select the data source for the time period: Dashboard - use the dashboard time period selector; Widget - use a compatible widget (set in the Widget parameter); Custom - use a custom time period set in the From and To parameters; if set, a clock icon will be displayed in the upper-right corner of the widget, indicating the set time on mouseover. Note that regardless of the widget's Time period configuration, compatible widgets can still use it as a data source for the time period. |
| Widget | Enter or select a compatible widget as the data source for the time period. This parameter is available if Time period is set to "Widget". |
| From | Enter or select the start of the time period. Relative time syntax ( now, now/d, now/w-1w, etc.) is supported.This parameter is available if Time period is set to "Custom". |
| To | Enter or select the end of the time period. Relative time syntax ( now, now/d, now/w-1w, etc.) is supported.This parameter is available if Time period is set to "Custom". |
Axes
The Axes tab allows to customize how axes are displayed:
| X-Axis/Y-Axis | Unmark this checkbox to hide X-axis/Y-axis (marked by default). |
| Min | Set the minimum value of the corresponding axis. |
| Max | Set the maximum value of the corresponding axis. |
| Units | Choose the unit for the scatter plot axis values from the dropdown: Auto - axis values are displayed using the unit of the first item in the data set; Static - axis values are displayed using the unit specified in the value input field; if the field is left blank, only numeric values are displayed. |
Legend
The Legend tab allows to customize the scatter plot legend:
| Show legend | Unmark this checkbox to hide the legend on the scatter plot (marked by default). |
| Show aggregation function | Mark this checkbox to show the aggregation function in the legend. |
| Rows | Select the display mode for legend rows: Fixed - the number of rows displayed is determined by the Number of rows parameter value; Variable - the number of rows displayed is determined by the amount of configured items while not exceeding the Maximum number of rows parameter value. |
| Number of rows/ Maximum number of rows |
If Rows is set to "Fixed", set the number of legend rows to be displayed (1-10). If Rows is set to "Variable", set the maximum number of legend rows to be displayed (1-10). |
| Number of columns | Set the number of legend columns to be displayed (1-4). This parameter is available if Display min/avg/max is unmarked. |
Thresholds
The Thresholds tab allows to configure thresholds that determine host marker colors:
| Color interpolation | Mark the checkbox to enable smooth transitioning between threshold colors for host markers. This parameter applies if two or more thresholds are set for either the X-axis, the Y-axis, or both axes simultaneously. |
| X-Axis/Y-Axis threshold | Click Add to add a threshold, select a threshold color from the color picker, and specify a numeric value. Thresholds can be applied to a single axis, both axes separately, or both axes simultaneously. For example, a single threshold with X=80 and Y=80 will color the markers when both conditions are met. The thresholds list will be sorted in ascending order when saved. Suffixes (for example, "1d", "2w", "4K", "8G") are supported. Value mappings are supported. |
The information displayed by the Scatter plot widget can be downloaded as a .png image using the widget menu.
A screenshot of the widget will be saved to the Downloads folder.