Download PDF
Download page Dash Studio Widgets.
Dash Studio Widgets
This page provides an overview of existing Dash Studio widgets in AppDynamics. Widgets create a visual representation of your data in the dashboards.
Card Component
Cards are small containers for placing the widgets. Cards have a title, border, and sometimes a footer and actions related to the specific context of the Card. These containers have text labels to clearly describe the information. You can rename or delete them.
Grouped Widgets
The widget grouping functionality enables you to organize two or more widgets on a card component or on their respective cards. You can apply widget properties to the entire group of widgets instead of a single widget.
- Each widget is created on a card by default.
- A card component, for a widget or group of widgets, has a title and a background.
Create a Widget Group
To create a group:
- Select two or more widgets.
- Click the group icon
in the top panel.
Select one of these options:- Group - Groups the widgets on their respective cards.
- Group In Card - Groups the widgets on a card component.
To separate the widgets in a group, click the ungroup icon in the top panel.
Group Properties
You can apply these properties to modify the appearance of grouped widgets:
Property | Description |
---|---|
Group In Card | Group all the selected widgets on a card. |
Background Color | Set the background color of the widget. You can either set the default option or customize it. |
Padding | Add extra spaces between the top and bottom of the text within the widget. The default value is 1. |
Border | Set the border around the widget. |
Shadow | Set a shadow around the widget. |
Title | Define a title for the widget. |
Title Alignment | Align the title of the widget. |
Title Color | Set the color of the widget title. |
Subtitle | Define a subtitle for the widget. |
Time Ranges
Global Time Range
The Global Time Range Selector option on the top right enables you to set a time range for the dashboard. This can be for the last five minutes, hours, weeks, or even months.
Widget Time Range
You can compare widgets across different time ranges by setting a time range that is distinct from the global time range.
To set the time range for a single widget independent of other widgets:
- Select the widget to set its time range.
- Go to Widget Properties on the left panel and click Widget Time Range. Two options display: 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:
You can enable the Show Time Range toggle for a widget 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 option under Group Properties panel. It provides these 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. You can also click Custom to create a customized 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 Navigations
Simple navigation actions in Dash Studio enable you to quickly 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. Use this capability to troubleshoot processes and determine root cause analysis.
Navigate with a Single Click
To navigate with a single click in view mode, click the widget for which you want to set this action:
- Click Single Click Action option available under the Widget Properties panel. These options display:
- Destination Type - Specify the type of the destination (URL or Metric Browser).
- Link - Provide the details based on the destination type.
- Show In - Select the current page or new page.
- After entering valid details, click the View icon at the top right. In the view mode, click the widget to navigate to the appropriate destination.
Widget Types
These 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.
Widget Properties
You can select these options in the Widget Properties panel to modify the appearance of the Label widget:
Property | Description |
---|---|
Background Color | Set the background color of the widget. You can either leave the default option as it is or customize it. |
Padding | Add extra spaces between the top and bottom of the text within the widget. The default value is 1. |
Border | Set the border around the widget. |
Shadow | Set a shadow around the widget. |
Property | Description |
---|---|
Font Color | Specify the color of the text inside the widget. |
Font Size | Specify the size of the text within the widget. |
Horizontal Alignment | Defines the horizontal alignment of the text in the widget. |
Vertical Alignment | Defines the vertical alignment of the text in the widget. |
See single click action.
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.
- Combining or aggregating multiple metrics.
The value display shows:
- 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 or a large interval of time.
If the trend of a value over time is concerning, you can enrich these charts with contextual information to better interpret the present value, or the change in value over a time period. These charts can display numbers and text, for example, 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 you want to learn more about.
Aggregated across all entities of a certain type, or a provided sub-list of entities.
Aggregated for a sub-list of entities which is dynamically determined.
The metric number helps you understand the metric value at the current point in time, and also the pattern of the metric value over a time interval.
Health Widget
A Health Widget provides different visualizations of the health information of one or more entities for a specified time range. Use this widget to 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.
You can display the widget on the dashboard as a:
- Ratio Donut: By default, the Health Widget displays as a Ratio Donut.
- Label Format: Use to change the format of the label by showing either the Count and Type or just the Count.
- Center Value Unit: Use to set the unit value.
- Data Labels: Use to turn data labels on or off.
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 based on the Aggregation Type.
"Worst Health" is the only Aggregation Type currently supported for the Health widget. It shows the worst health status in the given list of entities. Additional aggregation types will be included in future releases.
- Ratio Bar and List: Displays health status as a ratio bar 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 from small to medium. You can use the Font Weight option to 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
From a Data Panel, you can select the data type whose health information is to display on the Health widget.
For example, supposed you want to know the health status of the ECommerce application.
- Choose a value from the Show me data for dropdown based on the data type you want to display.
For this example, select Health Rules. - 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 select the application for which you want to drill down the data.
- From the next dropdown, select a specific Named Health Rule from the popover list or select All Health Rules. For example, if you select All Health Rules, the Health widget displays as:
After you specify valid inputs for all fields, the widget will update on the canvas and display the results. To view the center value, click Add Center Query.
Image Widget
You can use the Image Widget to add images to a new dashboard.
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.
Widget Properties
You can select these options under the Widget Properties panel to modify the visual appearance of the Pie widget:
- CARD: Provides a set of options enabling you to set the background color, padding, border, shadow, title properties (name, alignment or color), and subtitle.
- VISUALIZATION: Enables you to change these options:
- Data Labels: Defines the individual data points that you can turn on or off.
- Legend: Describes the value of each pie slice of the widget.
- Legend Placement: Enables you to place the legend on right side or bottom of the widget.
- Center Value: Enables you to set the unit value.
- Center Value Format: Enables you to set the format of the center unit value.
- Center Value Unit: Enables you to set the unit for the center value and is optional.
- WIDGET TIME RANGE: Enables you to set the time range options, such as: global time range and widget specific time range.
Datagrid Widget
The Datagrid widget provides a quick view of the list of entities associated with all the events on the Dash Studio. You can use this widget to present a collection of data in a tabular format. It improves the troubleshooting capabilities by reducing the number of drill-downs required to perform and navigate to other panels.
Widget Properties
The Datagrid widget has these properties:
Feature | Description |
---|---|
Column sorting | Sorts items in the widget columns. |
Column resizing | Adjusts or resizes the width of the widget columns based on the content contained 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:
- Under Data panel, click Show me data for and select Events.
Click the subsequent dropdown and select the data source for which you want to see the list of events. Applications is selected in this example.
The subsequent inputs shown in the Data panel are specific to the data type selected from the previous step.
Click Application and select one from the list of options. You can also enter the name of the application manually.
Once you specify valid inputs for all the required fields, the widget is updated on the canvas and displays these results:
Click the Filter Panelicon on the top-right corner of the Datagrid widget to see the available filters to apply.
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.