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.
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.
To group two or more widgets, select them and click the group icon in the top panel. To ungroup the widgets, click the ungroup icon in the top panel.
Global Time Range
The Global Time Range Selector option on the top right, 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 Range
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:
- Select the widget whose time range is to be set.
- 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.
Select Widget Specific Time Range and 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.
Group Time Range
You can set the time range for a set of grouped widgets using the Group Time Range feature under Group Properties panel. It provides the following options:
- Inherit Time Range - Set the same time range as the global time range for each widget of the group.
- Group Specific Time Range - Set the time range for each widget of the group by selecting an option from the dropdown list. You can also click Custom to create a customised time range.
Toggling the Show Time Range option hides or displays the time range in the upper-right corner of each widget in the group.
Simple navigation actions in Dash Studio enables basic user interactions and helps you to seamlessly navigate to any specific part of the product. The navigation actions allow you to drill down into complex and detailed information about a selected entity. You can utilize this capability as part of the troubleshooting processes and for root cause analysis.
Navigate with a Single Click
To perform navigation actions with just a click in the view mode, click the widget for which you want to set this action:
- Click Single Click Action option available under the Widget Properties panel.
It displays the following options:
- Destination Type - Specify the type of the destination (URL or Metric Browser)
- Link - Provide the details depending on the type of destination
- Show In - Select the current page or new window
- Click the View icon at the top right after entering valid details.
In the view mode, click the widget to navigate to the appropriate destination.
The following widget types are available in the Dash Studio.
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.
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.
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.
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 Labels: It 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.
View Health Information
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:
- Choose a value from the Show me data for drop-down menu based on the data type you wish to display.
We have selected Health Rules in this scenario.
- The subsequent input fields displayed in the Data Panel are specific to the data type selected in the previous step. Click the Application dropdown and choose the application for which you want to drill down the data.
- The next dropdown 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:
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.
The Image widget lets you add any images to a new dashboard.
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.
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 Labels: Defines 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 Value: This 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.
The Datagrid widget provides a quick view of the list of entities associated with all the events on the Dash Studio. This widget lets you present a collection of data in a tabular format. It improves the troubleshooting capabilities by reducing the number of drill-downs you need to perform and navigations to other screens.
The Datagrid widget has the following properties:
|Column sorting||Sorts items in the widget columns|
Adjusts or resizes the width of the widget columns based on the content to be made fit in the viewport of the DataGrid
|Search||Queries or searches for objects in the widget|
|Grid footer||Hides or displays the footer content|
|Row height||Adjusts the height of the rows|
|Filter panel||Displays a list of filters|
View List of Events
To view a list of events for a given data source, select the Datagrid widget icon from the widget palette, and follow the steps given below:
- Under Data panel, click Show me data for and select Events.
Click the subsequent drop-down menu and choose the data source for which you want to see the list of events. Here Applications is selected from the list of options.
The subsequent inputs shown in the Data panel are specific to the data type selected in the previous step.
Click Application and select one from the list of options.
You can also enter the name of the application in the input field manually.
Once you specify valid inputs for all the required fields, the widget gets updated on the canvas to display the results as follows:
Click the Filter Panel icon on the top-right corner of the Datagrid widget to see the filters that can be applied.
To view information such as summary, details, actions executed, and comments about the selected event, double-click the specific row of the widget. Based on your analysis of the event information you can start a war room, delete the event, archive it, or test the action.
You can also resize the widget in vertical and horizontal directions by dragging the edges.