AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.


    Skip to end of metadata
    Go to start of metadata

    This page provides an overview of Dash Studio widgets in AppDynamics.

    Widgets create a visual representation of your data in the dashboards. 

    Only certain widgets of Beta Dash Studio have been included on this page. The page will be updated as and when new widgets appear in the product.

    Card Component

    Cards are small containers for placing the widgets. Cards have a title, border, and sometimes a footer and/or actions related to the specific context of the Card. These containers have text labels that let you understand information clearly. They can be renamed or deleted as per your requirement at any instant. 

    Global Time Range

    On the top right, the Global Time Range Selector option allows you to set a time range for the dashboard. This can be for the last 5 minutes, hours, weeks, or even months.

    Widget Time Ranges

    Widgets can be compared across different time ranges by setting a time range that is distinct from the global time range. This lets you set the time range for a single widget independent of other widgets. You can do this by following the steps given below:

    1. Select the widget whose time range is to be set.
    2. Go to Widget Properties on the left panel and click Widget Time Range. It displays two options, Global Time Range and Widget Specific Time Range.
    3. Select Widget Specific Time Range and choose from the list below to set a time range distinct from Global Time Range.


      Select the Show Time Range toggle to display the time range on the top of the selected widget:


      Enabling the Show Time Range toggle for a widget allows you to change its time range in View mode.

    Widget Types

    The following widget types are available in the Dash Studio.

    Label widget

    A Label Widget is a simple text string that enables you to add text on the dashboard canvas.

    Time Series Chart

    A Time Series chart is a two-dimensional time-based series of data points connected by a line. There can be multiple lines on one chart. These are similar to a scatter plot except that the measurement points are ordered (typically by their x-axis value) and joined with line segments, which are either straight or curved. 

    Metric Number

    A Metric Number chart highlights a single value/KPI and is typically created by:

    • a single measure which can be specified using the Data Panel.
    • by combining or aggregating multiple metrics.

    The value display shows the following:

    • A single measure or metric value at any instant.
    • A comparison of two values (either two different metrics or a metric at different points of time).
    • An aggregation of metrics across many objects and/or a large interval of time.

    If you are concerned with the trend of a value over time, these charts can be enriched with contextual information that enables you to interpret the present value or the change in value over a time period. These charts can display numbers and text, such as the date and time of an incident.

    You can also display the metric value or a combination of these values in various ways, such as selecting a single metric:

    • By name associated with a particular entity or object that the you want to know more about.

    • Aggregated across all entities of a certain type or a provided sublist of entities.

    • Aggregated for a sublist of entities which is dynamically determined.

    The metric number helps you understand the value of a metric value at the current point in time and also the pattern of the value of the metric over any time interval.

    Metric Number

    Health Widget

    A Health Widget provides different visualizations of the health information of one or more entities for a specified time range. This widget lets you create and view health information of one or more entities at a time for Applications, Business Transactions, Tiers, Nodes, and Health Rules. By default, the Health widget displays health information as a ratio pie. The ratio pie visualization provides an additional option of displaying a metric value at the center of the donut pie.

    Widget Properties

    You can change the visual appearance of the Health widget by selecting options available in the Visualization section under Widget Properties panel on the right.

    The widget can be displayed on the dashboard as a:

    • Ratio Donut: Health widget is by default displayed as a Ratio Donut. 
      • Label Format: This option allows you to change the format of the label by showing either the Count and Type or just the Count.
      • Centre Value Unit: This option lets you set the unit value.
      • Data LabelsIt lets you turn on or off the data labels. 
    • Traffic Light: Displays the health information of critical, warning, and normal status as a traffic light. The health status shown is the overall health status of a list of entities determined by the Aggregation Type.

      "Worst Health" is the only Aggregation Type supported currently for the Health widget. It shows the worst health status in the given list of entities. Additional aggregation types will be included in the future releases.

    • Ratio Bar and List: Displays health status as a ratio bar along with the list of all the entities being monitored (with a health icon next to it). You can modify the size of the bar with Bar Size to small or medium. The Font Weight option lets you change the appearance of the font inside the widget to Light, Medium, and Strong.
    • Ratio Bar: Displays the health status as a ratio bar.
    • List: Displays the health status as a list.

    Data Panel 

    A Data Panel lets you select the data type whose health information is to be displayed on the Health widget. 

    Consider an example where you want to know the health status of the ECommerce application. You can follow the steps below:

    1. Choose a value from the Show me data for drop-down menu based on the data type you wish to display.
      Show Me Data
      We have selected Health Rules in this scenario.
    2. The subsequent input fields displayed in the Data Panel are specific to the data type selected in the previous step. In this case, it is the Health Rules drop-down menu that lets you select the application for which you want to drill down the data. 
      Health Rules Dropdown
    3. The next drop-down menu lets you select a specific Named Health Rule from the pop-up list or select All Health Rules. For example, if you select All Health Rules, the Health widget appears as shown below:
      Named Health Rule
      After you have specified valid inputs for all fields, the widget will be updated on the canvas to display the results. To see the center value click Add Center Query.

    Image Widget

    The Image widget lets you add any images to a new dashboard.

    Image Widget

    You can upload the images using the options shown below:

    Upload Image

    Pie Widget

    Pie charts display single consolidated values for a series of metrics for a given time range as a pie visualization. The Widget Properties panel available on the right of the dashboard editor, provides a list of visualization properties to configure the Pie widget. These properties include options to set the visibility of the data labels, format of the data labels, format of the data values, visibility of the legend, position of the legend, visibility of the center value, format of the center value, and so on.

    Pie Widget

    Widget Properties

    Select any of the following options under Widget Properties panel to modify the visual appearance of the Pie widget:

    • CARD: This list provides a set of options that allows you to set the background color, padding, border, shadow, title properties (name, alignment or color), and subtitle.
    • VISUALIZATION: This option lets you change the following:
      • Data LabelsDefines the individual data points that can be turned on or off.
      • Legend: Describes the value of each pie slice of the widget.
      • Legend Placement: This options lets you place the legend on right side or bottom of the widget.
      • Center ValueThis option lets you set the unit value.
      • Center Value Format: It allows you to set the format of the centre unit value.
      • Center Value Unit: This lets you set the unit for the centre value and is optional.
    • WIDGET TIME RANGE: This options enables you to set the time range options such as global time range and widget specific time range.
    • No labels