Dashlet properties

The Dashlet Properties dialog box allows you to configure various dashlet properties, like independent data source, content columns, etc.

To access the Dashlet Properties dialog box, right click anywhere in the dashlet and select Dashlet Properties from the context menu, or press Alt+Enter.

Dashboard and dashlet common properties and inheritance

A dashboard has a configuration layer that supercedes its dashlets. For properties that can be defined for both the dashboard and the dashlet, the dashlet inherits the dashboard properties. This lets you manage the layout and common properties of the dashlets.

A dashboard configuration defines default values for new dashlets and provides a means of changing common dashlet properties. A new dashlet inherits all the properties defined for the dashboard. Changes to inherited properties are automatically propagated to all dashlets in the dashboard, unless otherwise is set in dashlet properties. This simplifies the reuse of dashboard configurations for multiple applications.

Each common tab in the Dashlet Properties dialog box includes an option to Enable Dashlet specific <property>. If this option is not selected, you can click the tab's Edit Dashboard link to change the settings in the corresponding Dashboard Properties tab. When you save the dashboard changes, the settings are automatically changed in the Dashlet Properties.

The inheritable properties are marked with Inheritable in the descriptions below.

See also the Dashboard properties page.

Note

Some properties are available for a particular dashlet only.

General

The General tab of the Dashlet Properties dialog box allows you to view and configure basic dashlet properties.

Property Description
Name Defines the name of the dashlet.
Append filter Append the timeframe to the dashlet title.
Description Short description of the dashlet. It is displayed in reports or under dashlet header for the Customized header type.

You can insert a link to another dashboard here. To do so, click Add dashboard reference, select the required dashboard, and specify the text for the link.
Refresh Inheritable Dashlet inherits this property. To use it dashlet-specifically, select Enable dashlet specific refresh.

Defines the refreshing mode of the dashlet.
In the Manual mode dashlet data is only refreshed on click of the Refresh icon at the dashboard toolbar.
In the Auto mode dashlet data is refreshed automatically at defined interval. Note that the server load increases with shortage of the refresh interval.

Source

The Source tab of the Dashlet Properties dialog box allows you to select custom data source for the dashlet, and apply filtering.

Property Description
Use session independent data source Enables usage of server-wide data, regardless of the selected session. This works for Client-wide, dashboard-wide, and dashlet-specific data sources.
Default Data Source Inheritable Dashlet inherits this property. To use it dashlet-specifically, select Enable dashlet specific data source.

Defines server and System Profile for dashlet data.
Filter Inheritable Dashlet inherits this property. To use it dashlet-specifically, select Enable dashlet specific filter at the required tab of the Dashlet Filter dialog box.

Defines filtering of dashlet data. See Filter dashboard and dashlet data for more information about filtering.

Comparison

The Comparison tab of the Dashlet Properties dialog box allows you to select data source for session comparison. See Session Comparison.

Property Description
Compare Source Inheritable Dashlet inherits this property. To use it dashlet-specifically, select Enable dashlet specific compare source.

Defines server and System Profile for compare data.
Filter Inheritable Dashlet inherits this property. To use it dashlet-specifically, select Enable dashlet specific compare source.

Defines filtering of compare data. See Filter dashboard and dashlet data for more information about filtering.

Design

The Design tab of the Dashlet Properties dialog box allows you to customize appearance of the dashlet.

Property Description
Dashlet Options Inheritable Dashlet inherits this property. To use it dashlet-specifically, select Enable dashlet specific settings.

Defines the minimum dashlet dimensions in pixels.
Header Type Inheritable Dashlet inherits this property. To use it dashlet-specifically, select Enable dashlet specific settings.

Defines the type of the dashlet header:
  • Default: Tabs across the top of the dashboard display the dashlet names.
  • Customized: No tabs appear. The title and description of the active dashlet are displayed at the top of the dashlet. You can customize the font and alignment separately for the dashlet title and description. Only the header of the active dashlets is visible. To switch the active dashlet, press Ctrl+H to toggle through the header options until the tabs are visible, and then select the desired dashlet.
  • No Header: The active dashlet name is not displayed, and no tabs are displayed.

    The Customized style integrates the dashlet with the AppMon Client background. You should use the Design settings instead of Text and Image dashlet dashlets to create customized titles and descriptions. Keyboard Shortcuts are available for editing titles and descriptions inside the dashlets.

Measures

The Measures tab of the Dashlet Properties dialog box allows you to add measures to be displayed in the Dynamic Measure Matrix dashlet.

Each of the added measures is displayed in a separate column. The order of columns is the same as in the measures table. To change the order, select the required column and move it using Higher Priority and Lower Priority buttons.

Properties like units and aggregation are inherited from the measure itself. However, you can override them by selecting Override default settings, and configuring properties as you need.

Time Frames

The Time Frames tab of the Dashlet Properties dialog box allows you to configure comparison timeframes for the *Business Transaction Hotspots dashlet.

Select the timeframes from the lists. You can add up to 3 comparative timeframes.

Text style

The Text Style tab of the Dashlet Properties dialog box allows you to configure text appearance for Text and Image and Text and Measurement dashlets.

The Preview pane displays current configuration.

If you select Apply threshold violation colors option, the measure value in the Text and Measurement dashlet will be yellow if violating the Warning threshold, and red if violating the Severe threshold.

Background

The Background tab of the Dashlet Properties dialog box allows you to set and configure background image for Text and Image and Text and Measurement dashlets.

Select the background color, or background image in the appropriate fields. The background image is stored as a copy within the dashboard.

Background color may be inverted for the Night Mode.

Size

The Size tab of the Dashlet Properties dialog box allows you to configure dashlet height for Text and Image and Text and Measurement dashlets.

These options only work when dashlet is tied horizontally. In tabular view, the dahslet always has the same height as the Client window.

Options

The Options tab of the Dashlet Properties dialog box allows you to configure additional properties of memory snapshot creation.

Parameters Description Used in dashlet
Force Garbage Collection before creating snapshot Launches GC before creation memory snapshot, to reduce its size and get rid of unnecessary data. Selective Memory
Total Memory
Automatically Post-process memory snapshot Enables/disables automatic post-processing of newly created trending or leak analysis snapshots. To keep the overhead low, you can disable it, and start prost-processing manually. Total Memory
Capture String Values Enables/disables capture of string values. It is required for Duplicate String analysis, but the sanpshot takes more time to create and requires more disk space. Total Memory
Capture Primitive Values Enables/disables capture of primitive values. It provides more information, but the sanpshot takes more time to create and requires more disk space Total Memory

Analysis

The Analysis tab of the Dashlet Properties dialog box allows you to set the limit of displayed data. Note, that the server load increases with growth of the data allowance.

You can also configure additional analysis parameters.

Parameters Description Used in dashlet
Normalize SQL Enables SQL normalization Database
Group by Defines grouping value for analysis data. Database
Exceptions
Entry Point
GUI Controls
Tagged Web Requests
Show Defines scope of displayed data. Web Request
Landing User Actions Defines which actions may be considered as landing. User Actions

Content

The Content tab of the Dashlet Properties dialog box allows you to specify one of the following:

Map Rendering

The Map Rendering tab of the Dashlet Properties dialog box allows you to configure the appearance of map in the World Map dashlet.

Property Description
Draw Legend Enables user experience legend.
Border Details Level Configures the border drawing. The lower detail level is, the closer you have to zoom to see the borders.
Source for data points Defines the data for user experience estimation.

Columns

The Columns tab of the Dashlet Properties dialog box allows you to configure data columns displayed in dashlet table. Select the columns you want to display. If dashlet has several tables, select the required one from the Table list. To rearrange the order of columns, drag and drop them in the table itself.

You can save any configuration as the default one by clicking Save as Default. Existing custom defaults will be overwritten, and you won't be able to restore them. To apply saved defaults, click Restore Defaults.
To restore initial configuration, click Restore Factory Defaults. This won't affect saved custom default configuration.

Chart

The Chart tab of the Dashlet Properties dialog box allows you to configure the appearance of the pie charts in dashlets.

Note

In the PurePaths and User Actions PurePaths dashlets this tab is called API distribution.

In the Visits dashlet this tab is called Browser Statistics.

Property Description
Chart type Defines the type of the chart.
Enable tooltip Enables display of Details window on hover over the chart.
Limit the number of displayed items Limits the number of elements in the chart. Only top x records are included, the rest is ignored.
Legend Composition Defines legend parameters. Select Show legend to activate it, then select the measure to be displayed, and position of the legend.
Pie Chart Labels Defines the annotation label parameters. Select Show Pie Chart Labels to activate them. Select the parameter in the list and click + to add it to the annotation. Order is handled automatically.

The Dashboard Links tab of the Dashlet Properties dialog box allows you to add linked dashboards. They will appear as drill down targets.

Reporting

The Reporting tab of the Dashlet Properties dialog box allows you to customize dashlet appearance in reports. See Client reporting for more information about reporting.

Heat field

The Heat field tab of the Dashlet Properties dialog box allows you to enable/disable the Heat field of the Chart dashlet and select incidents to be included in it.

In the Incident Rules pane, select the incidents to be included in the heat field. You can include incidents from any System Profile on the server.

Colors

The Colors tab of the Dashlet Properties dialog box allows you to customize colors of your Chart dashlet. To change the default setting, click it and select the color from the palette.

Series

The Series tab of the Dashlet Properties dialog box allows you to add and configure data series for your chart.

You can add any measure for charting. Properties like units and aggregation are inherited from the measure itself. You can override the default chart-specific settings of each series with the following settings:

Setting Description
Color Set the color for the series representation in chart.
Scale Define a scale from 10-10 to 1010.
Aggregation Define the measurements aggregation.
Unit Defines the measurements units

Axis

The Axis tab of the Dashlet Properties dialog box allows you to configure chart axes.

Property Description
Show X-Axis Displays/hides X-Axis annotation. You can also specify the title for the X-axis here.
Show Y-Axis Displays/hides Y-Axis annotation. You can also specify the title for the Y-axis here.
X-Axis Resolution Defines the timaframe for the X-Axis. The Auto option uses the timeframe set in the timeframe selector.
Logarithmic Y-Axis Enables/disables logarithmic scale on Y-axis.
Share axis bounds for split charts Enables/disables common Y-axis.

If chart is split into several charts, all of them have the same Y-axis scale
Pin bound Freezes Y-axis to the specified bounds, regardless of the actual data span.
Alignment Defines left padding of chart in pixels.
Y-Axis Bounds Defines Y-axes drawing mode for Dual Axis Chart dashlet.
Drawing order Defines Y-axes priority for Dual Axis Chart dashlet.

Legend

The Legend tab of the Dashlet Properties dialog box allows you to configure chart legend.

Select Show Legend to activate it. Select the parameter in the list and click + to add it to the legend. Order is handled automatically. You can also select the position of the legend.

Chart Type

The Chart Type tab of the Dashlet Properties dialog box allows you to configure chart appearance.

See the description of chart types at the Chart dashlet page.

You can also configure additional chart parameters.

Property Description
Orientation
  • Horizontal: Horizontal X-axis and vertical Y-axis.
  • Vertical: Vertical X-axis and horizontal Y-axis.
Enable tooltip Enables display of Details window on hover over the chart.
Limit the number of displayed items Limits the number of elements in the pie charts. Only top x records are included, the rest is ignored.

Split Chart

The Chart Type tab of the Dashlet Properties dialog box allows you to configure chart splitting.

To split chart, select the Enable chart splitting mode and select the splitting entity. You can also select it from the Splitting menu on dashlet's toolbar.

If splitting divide chart into several sub-charts, you can select their alignment, and limit the number of sub-charts.