This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

Widgets display the data in custom dashboards and war rooms. You configure what data to display and how to display it.

Widget Overview

Most of the widgets are common and self-explanatory. This section provides information for certain widget features that may require additional explanation.

Analytics is a separate product from AppDynamics APM. If you have purchased Analytics, you can use the the Analytics widgets to display the results of Analytics searches on a custom dashboard. See Using Widgets to Visualize Analytics Data.

Time Series Graph for displaying data over time

The standard time series graph displays one or more values over time in various formats: line, area, column, scatter diagram.

If you are configuring a widget for a war room that examines metrics on a Java node, consider also the streaming graph widget described in Virtual War Room. The streaming widget updates more frequently (every 5 seconds) than the standard time series widget (every 60 seconds) for collaborative real-time troubleshooting.

Pie Chart for displaying numerical proportion of a whole

These are actually doughnut charts, in which multiple values are displayed as proportional slices of a whole. The data series should meaningfully total 100% of some series; for example CPU Busy + CPU Idle + CPU Stolen on a single node or tier.

Gauge Widget for displaying magnitude

The gauge widget displays the magnitude of a metric value with respect to its minimum and maximum values, both by the extent to which the gauge is filled and by the color of the fill.

You can optionally set the minimum and maximum values displayed by the widget. Set the maximum to the highest acceptable maximum or some value close to it so that the gauge is useful for informing you whether the metrics are within acceptable values for your site.  If you do not set them, defaults are used.

Interpret the color coding of the gauge as follows:

  •    0-10%   green - OK
  •  10-50%   gradient from green to yellow - OK trending to WARNING
  •  50-90%   gradient from yellow to red - WARNING trending to CRITICAL
  •  90-100% red - CRITICAL

For example, the following gauge displays the calls per minute metric without any special configuration for minimum and maximum in the widget. The current value is 74 cpm, which is midway between the observed minimum (0) and maximum (148) for the time period, in the WARNING range.

Here is the same gauge but with the maximum configured to be 1000. With this configuration the current value of 74 cpm looks OK.

Metric Value for displaying a single metric value

You can specify a title, as well as format string to add the name of the selected metric, the time range, the name of the function. Or alternately use a separate label widget to explain the metric value.

Health Status for summarizing the status of a single health rule

This is a circle which is green for normal, yellow for warning, and red for critical status. See Configure Health Rule Conditions in Configure Health Rules for information on how the metrics that define warning and critical health status are set.

Event List for displaying events

This is a filtered table of events that occurred within the specified time range.

IFrame for displaying external data

You may want to include a shared custom dashboard in another custom dashboard when you have different operators who focus on particular dashboards and you want to roll them all up into a master dashboard for management.

To display information from another dashboard or from another website inside this custom dashboard, you need the URL.  You can get the URL for a screen by clicking Settings > Copy a link to this screen to the clipboard or Copy a link to this screen to the clipboard (fixed time range).

Iframe widgets can be sandboxed when you create or edit them.  If you sandbox an iframe widget, features such as forms and Javascript will no longer work with the widget.

Label and Image

You can use labels and images to clarify or decorate what is displayed in the dashboard.

Widget Data

Some widgets, such as a time series graph, can display a single value or multiple values. Some, such as a doughnut, must display multiple values to make sense. Others, such as a gauge or a metric value, display only a single value.

Specifying a function of a metric value for a single entity

When you specify the data to be displayed in the widget, in the Add Series window you use a pulldown menu to select which function of the value to display:

  • Minimum: Minimum value, only available for averaged metrics
  • Maximum: Maximum value, only available for averaged metrics
  • Value: Contains the average or the sum across the time range depending on the metric
  • Sum: Aggregated value of the metric over the time range
  • Count: Count of the observed values over the time range
  • Current: Sum of the most recent minute's metric data values across all the included nodes

Specifying metrics in multiple entities using a wild card

You can use a wildcard to specify a metric that evaluates across several similar entities for metrics in the following branches in the metric hierarchy:

  • Hardware Resource
  • JVM
  • CLR
  • Custom Metrics

See Specify Metrics in Multiple Entities Using a Wildcard for instructions on how to do this.

Empty Data Series

It is possible that for a particular metric, no data is available for the specified time range, while for other time ranges valid data is reported. When this occurs, the label for the empty data series appears in the legend but no data is displayed; for example, no line in a time series graph or no slice in a pie chart.

Widget Properties

Widget properties vary to some extent based on the type of the widget.

Most of the widget properties in the configuration forms are self-explanatory. This section describes the details of some of the less obvious properties.

  • Metric Display Name:  You can choose the display name for the metrics in a widget. Use one or more of the following substitution variables to determine the metric display name:
    • ${#}:  Number the displayed metrics based on sorting with the rollup value.
    • ${m}:  Metric name.
    • ${e}:  Entity name.
      For example, if you specify ${m}, the widget uses only the full metric name for the metric display name.   
  • Static Thresholds:  You can create static threshold with a specific value for graph widgets.  The threshold appears as a line on the graph.  
  • Double click action: Some widgets have an option to define the result of double-clicking the widget. You can configure the double click action to open the Metric Browser or a URL specified by the Drilldown URL value.
  • Drilldown URL: The Drilldown URL specifies the URL of an AppDynamics window you want the widget to open when you double-click the widget. For example, if you see an increase in slow requests and want to investigate the cause, you may want to jump to the App Servers List of all tiers from your dashboard by double-clicking a widget. To get the URL for a specific screen, click Settings > Copy a link to this screen to the clipboard.
  • Time Range: Widgets can use the global or dashboard time range or a time range that is specific to the widget. If you choose a widget-specific time range, select the widget time range from the pulldown menu.
  • Events Overlay: You can configure specific events to overlay on the graph widget to show how specific events may correlate with performance. Check the Show Events check box and create the query to define which events should be overlayed.

Configuring Widgets

To access the widget palette and to set up or modify widgets, you must be in edit mode.

Click the pencil button at the top of the dashboard or war room if you are not in edit mode.

Then click the Add Widget button.

The widget palette appears:

If you are configuring widgets for a war room, you will see an additional category for Streaming Data widgets. For information about the Streaming Data widgets, see Widgets in Virtual War Room.

To configure a new widget:
  1. Click the widget in the palette. 
    The configuration form appears in the left side of the configuration window.
  2. Use the form to configure both the widget data and the widget properties.
    After you configure the data, a preview of the widget appears.  The preview updates as you set more properties.
  3. Click Save when you are done.
To modify an existing widget:
  1. Make sure you are in edit mode.
  2. Click the widget in the dashboard.
  3. Click the settings icon in the upper right corner of the widget.
  4. Use the form to modify the widget.
  5. Click Save when you are done.
  • No labels