Defining widget properties

Define different properties for the widgets such as metrics and charts to view real-time data in the widgets.

To define the properties for a widget, complete these steps:

1. In a widget, click to select a chart type to display data.
   • Line
   • Area
   • Bar
   • Grid
   Important: For line, area, bar charts, if there are more than nine legends then the color of graph repeats after ninth legend. The color of the graph is same for 1st and 10th legend, 2nd and 11th legend, and so on.

   A green indicator is displayed on the to indicate that chart type is selected.

2. Specify the following chart properties for line, area, and bar charts:
   • X Axis Label
   • Y Axis Label
   • Show Legend
   • Show Interpolation: The data that is collected to be plotted on the chart, it might include some Null values. Therefore, when the chart is plotted, the chart line is disconnected where it encounters a Null value and multiple disconnected lines appear in the chart. If you select interpolation, the line on the chart does not look disconnected where it encounters a Null value, instead it connects to the next available valid value. Therefore, you get a single connected chart line when you select interpolation.
     Note: For APM V8.1.4.0 IF0005 and later versions, the line and area charts no longer display disconnected lines for null values. Therefore, Show Interpolation feature is not required anymore and hence, it is not supported.
   Important: Grid has no properties.
3. Click to select the metric content.

   Option	Description
   Resource Type	From the Resource Type list, select a resource. The available resources are associated with the application. If a resource that is a part of the application is not available in the list, its resource definition was not found. Either the resource definition was not published or the managed system is not connected to the Cloud APM server.
   Metric Type	From the Metric Type list, select a data set that you want to include in the widget.
   Metric	From the Metric list, select an attribute to include in the view. The available attributes are from the selected data set. To select metrics, complete the following steps: Click the Metric list. A pop-up window opens where the metrics are listed alphabetically sorted in ascending order. Click the attributes that are listed under Metrics (select one or more) or click Select All. Note: When you click Select All, all the metrics in the list get selected. Click to add the metrics under Selected Metrics list. If you want to delete a metric under Selected Metrics, click . Click the Resource Instance list to close the pop-up window. Important: For line, bar, and area charts, metric containing numeric value needs to be selected. Metrics containing string values cannot be displayed in these charts. Tip: For grid, limit your selection on metrics according to the output that suits your visibility on the UI.
   Resource Instance	Initially, the selection is *, which retrieves metrics from all the instances in the list. Retain the default selection or select the instance from the list. Important: If you select an instance, then this widget cannot be used to display data for any other agent or instance. But it is good to specify the instance to avoid processing of huge data.
   Set Condition for Metric Group	If the selected Metric Type has multiple elements, such as CPUs or disks, then Set Condition for Metric Group displays other elements for you to select from the WHERE field. Important: Specify values for elements in the WHERE field. Avoid specifying * to reduce processing of huge data. By default WHERE condition displays last 4 hours of data. This time interval can be changed between 1 to 24 hours by the system administrator, see Changing time interval for WHERE condition data.
   Actions	Click Save to save a metric. Click Edit to edit a metric. Click Delete to delete a metric.

4. To add another metric, click + Add Another Metric.
   Important: Not applicable for grid.
5. Close the Select Metrics window after all the metrics are added.
   All the metrics are saved automatically after you close the Select Metrics window.

   The following changes may occur on the dashboard or message may be displayed:

   • If * is selected in the Resource Instance list in any of the metrics, then the following message is displayed:

     You selected * in Resource Instance or in Set Conditions, which will result in a large number of data series (such as lines on a graph). The large number of data series can make the page readability or performance unusable. The advisable limit for this chart is 50 data series. Adding specific values helps to narrow the data within recommended limits and results in a better user experience.

   • A green indicator is displayed on the to indicate that metrics are selected correctly to narrow the data within recommended limits.
   • A orange indicator is displayed on the to indicate that metrics are not selected correctly to narrow the data within recommended limits. Either * is selected in Resource Instance or in Set Conditions.
6. Click to enter the widget title.
   If widget title is not added, then the first metric name is assigned as the widget title automatically.