Controls

Chart Control

This control can render historic data, as a time series graph, or current values as a comparative bar chart. Various display styles are available.

When creating a custom chart view use the <renderer> tag to specify display options:

    <renderer type="">
        <domain id=""/>
        <range id=""/>
        <range id=""/>
        ...
    </renderer>
		
  • XY class renderers: display continuous information along the X axis, most common example is a time series chart.
    • XYLine: shows a horizontal continuous line for each of the ranges.
    • XYArea: same as XYLine, but the area below the line is filled. Multiple ranges will be shown overlapped, and will be better visible by setting opacity level to less than 100%.
    • StackedXYArea: same as XYArea, but multiple ranges will be shown stacked one on top of the other.
  • Category class renderers: display information grouped by discrete values on the X axis, for example bar charts.
    • Bar2D: shows 2D vertical bars of different colors for each range. Multiple ranges are shown as bars close together.
    • StackedBar2D: same as Bar2D, but multiple ranges are shown as bars stacked one on top of the other.
    • Bar3D: same as Bar2D, but with a depth effect which makes it easier to identify zero values.
    • StackedBar3D: same as StackedBar2D but with a depth effect.
    • CategoryLine: the discrete values of the domain axis are joined by a continuous line.
    • CategoryArea: same as CategoryLine, but the area under the line is filled. Multiple ranges will be shown overlapped, and will be better visible by setting opacity level to less than 100%.
    • CategoryStackedArea: same as CategoryArea, but multiple ranges will be shown stacked one on top of the other.
  • <renderer>(mandatory): multiple renderers can be specified, as long as all of them belong to the same class (either Category or XY), as detailed below.
  • type(mandatory): one of the following values:
  • <domain>(mandatory): identifies the resource to be used as a generator for values on the X axis.
  • <range>(mandatory): identifies the resource to be used as a generator for values on the Y axis. Multiple <range> tags are allowed
  • id: must be a valid identifier of one of the results (Function or Resource) provided by the Query.
Category Chart Controls: Bar2D, StackedBar2D, Bar3D, StackedBar3D, CategoryLine, CategoryArea, CategoryStackedArea

Figure 10. Category Chart Controls: Bar2D, StackedBar2D, Bar3D, StackedBar3D, CategoryLine, CategoryArea, CategoryStackedArea

XY Chart Controls: XYLine, XYArea, StackedXYArea

Figure 11. XY Chart Controls: XYLine, XYArea, StackedXYArea

When plotting numeric raw counters LivePerf will create a chart of type XYLine, with the timestamp as the domain and the counters as ranges.

Table Control

This control displays the raw results of the query in a tabular format, allowing sorting, filtering and dynamic chart creation with selected values. It is especially useful for queries based on regular expressions.

When creating custom views, a table control will by default include all results of the Query as columns in the table. However you must also use the following tags.

   <category id=""/>
   <range id=""/>
   <range id=""/>
   ...
		
  • <category>(mandatory): selects one resource as the category, used when creating bar charts from values in the table.
  • <range>(optional): if no <range> tag is specified, all results of the Query will be included in the table. Otherwise the table will only contain resources specified by <category> and <range> tags.
  • id: must be a valid identifier of one of the results (Function or Resource) provided by the Query.
Table Control

Figure 12. Table Control

The control will color table cells with shades of red or green, to show that the values have been increasing or decreasing, respectively.

The filter option allows you to quickly reduce the volume of information to only a relevant subset.

Dynamic charts can be created, having table's category as domain, and selected columns as ranges. See "Chart Control" for a list of chart styles. The control will prompt you to select the renderer type, and which columns to show.

  • Plot contents as bar charts. This will prompt you to select a Category class chart renderer. All values shown in the table will be displayed as a bar chart. Note that if a filter is applied only the visible items are included.
  • Plot contents as time series. This will prompt you to select a XY class chart renderer. All values except the category will be shown in a time series (history) chart. Note that if a filter is applied only the visible items are included.
  • Plot selected as bar charts. Creates a bar chart, but only includes selected lines.
  • Plot selected as time series. Creates a time series chart, but only includes selected lines.

Properties Control

Simple control which shows query results as a list of name / value pairs.

When creating custom views there are no additional tags required for this control. All query results will be included in the output.

Properties Control

Figure 13. Properties Control