Data View Types

Chart

This data view can render historic data, as a time series graph, or current values as a 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>

where:

  • <renderer> - mandatory
  • type - mandatory. Must be one of the values described in the "Type of Renderers" section below.
  • <domain> - mandatory. It identifies the resource to be used as a generator for values on the X axis.
  • <range> - mandatory. It identifies the resource to be used as a generator for values on the Y axis. Multiple <range> tags are allowed
  • id - mandatory. It must be a valid identifier of one of the results (Function or Resource) provided by the Query.

Type of Renderers

There are two types of renderers for charts:

  • 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.

Examples of category chart data views: Bar2D, StackedBar2D, Bar3D, StackedBar3D, CategoryLine, CategoryArea, CategoryStackedArea

Examples of XY chart data views: XYLine, XYArea, StackedXYArea

Table

This data view displays the raw results of the query in a tabular format, allowing sorting, filtering and dynamic chart creation with the selected values. It is especially useful for queries based on regular expressions that could potentially have a large number of matches.

A table data view includes by default all results of the Query as columns in the table. However you must also use the following tags:

<category id=""/>

   <column id=""/>
   <column id=""/>
   ...


where:

  • <category> -mandatory. It selects one resource as the category, used when creating bar charts from values in the table. This tag can only have one optional attribute: removeStale that has a boolean value. If the value is true than after every data collection cycle all items that have not been updated will be removed from the table. The default value of this attribute is false.
  • <column> - optional. If no <column> tag is specified, all results of the Query will be included in the table. Otherwise the table will only contain resources specified by the <category> and <column> tags.
  • id - mandatory. It must be a valid identifier of one of the results (Function or Resource) provided by the Query.

The data view colors 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.The type of filter for a column depends on the type of values in that column:String

Filter for string columns:

Check the 'Negative match' box if you want to keep just items that do not match the filter.

Filter for number columns:

Filter for date columns:

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

  • Plot contents as bar charts. This prompts you to select a category class chart renderer. All values shown in the table are displayed as a bar chart. Note that if a filter is applied only the visible items are included.
  • Plot contents as time series. This prompts 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 items.
  • Plot selected as time series. Creates a time series chart, but only includes selected items.

Properties

This data view shows query results as a list of name/value pairs.

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

Log Record Viewer

This is a specialized data view used to visualize application log records.