Geneos ["Geneos"]
You are currently viewing an older version of the documentation. End of life for version 5.x.x is scheduled for 30 September 2025.
If you are currently using version 5.x.x, we advise you to upgrade to the latest version before the EOL date. You can find the latest documentation here.
["Geneos > Active Console"]["User Guide"]

Dashboard Charts and Widgets

Overview

This section walks you through on how to create, modify, and use different charts from the Widget group in the Active Dashboard Palette.

Configure chart properties

Note: Beginning Active Console 5.5.x, the Managed Entity display name is used in the user readable path. This also reflects in the charts and widgets legends in the Active Dashboard. For dashboards that are configured in the Active Console 5.4.x and below, the user readable path of the charts and widgets legends retain its original value. However, you can manually update the display names.

The chart properties are applicable to Line Chart, Bar Chart, and Spark Chart.

To configure the properties of the chart:

  1. Select the chart you want to use in the Active Dashboard Palette.
  2. Drag and drop the shape into the Active Dashboard canvass.
  3. Perform any of the following:
    • Right-click the chart and click Properties.
    • Select the shape and press CTRLEnter.
    • Modify the properties using the Object Inspector.

The table shows the list of chart properties depending on the type of widget you have selected:

Chart properties Description
Title

Name of the chart.

Default value: Chart 1, Chart 2

Show Legend

Shows or hides the legend name in the chart.

Default: Enabled

Show Heading

Displays the heading of the chart.

Default: Enabled

Show Grid

Displays the horizontal lines in the chart.

Default: Disabled

Data sets number format

Sets the data sets number format in the chart.

Default value: ##0.00E0

Axis Font Size

Sets the text font size to the X and Y axis labels in the chart.

Default: 10

X-axis Bottom Axis Visible

Displays the value of each data set and time in the X-axis.

Default: Enabled

X-axis Time Format Sets the time format in the X-axis.
X-axis Axis Height Changes the height of the X-axis or the horizontal line.
X-axis Show Scrollbar

Shows or hides the scrollbar to adjust the time range on top of the X-axis.

Default: Enabled

X-axis Comparison Mode

If the chart is in comparison mode, then all datasets that are offset (in time) show with a left or right arrow.

Default: Disabled

Y-axis Axis Width Changes the width of Y-axis of the vertical line. Settings this value to 0 completely hides the axis.
Y-axis Left Axis Visible

Displays the value on the left axis of the chart.

Default: Enabled

Y-axis Right Axis Visible

Displays the value on the right axis of the chart.

Default: Disabled

Y-axis Max labels

Controls the maximum number of labels displayed on the Y-axis.

If this field is set to 0, then there is no maximum.

Y-axis Show Scrollbar

Shows or hides the scrollbar to adjust the time range on top of the Y-axis.

Default: Enabled

Y-axis number format

You can control the format of the numbers displayed on the Y-axis. The pattern used to specify the format is defined for the Java DecimalFormat Class.

Default value: #0.####

The meanings of the characters in this string are:

  • # — shows a digit, or nothing if no digit is present.
  • 0 — shows a digit, or 0 if no digit is present.
  • Point (.) — represents the decimal point.

Upper Y Plot Bound,

Lower Y Plot Bound

If blank, the system automatically calculate the suitable bounds. You can override these fields and enter your desired bounds value.

Define Start Date,

Define End Date

If enabled, the system automatically calculate the suitable start and end dates for the X-axis. You can override these dates to zoom in the data on the X scale.

Constantly Tick If enabled, all the datasets on the chart update every five seconds regardless of whether the items are plotting and updating.
Maximum Displayed Time

Determines the oldest data point that should be displayed on the chart.

If this value is set to one hour, then the chart does not display the data points older than one hour period. You can use this property to create a rolling tick chart that only displays the most up to date data.

Note: The older data points are not lost. You can always access them by setting the maximum displayed data to a longer period or by defining a set start date for the chart, an action which overrides the maximum displayed time setting.

Maximum Time Data is retained

Determines at what point data should be removed from the chart.

For example, a value of one hour in this field means that the dataset removes all data points that occurred more than one hour before the current time. You cannot recover these data points.

This is useful if you are no longer interested in old data and you do not want to suffer the memory overhead of retaining an ever growing dataset. By default, this value is set to 24 hours worth of data.

   

Charts with the same datasets

In Active Dashboard, you can create multiple charts provided that each chart has its own datasets.

However, if you create multiple charts with the same dataset paths, this may result in the disappearance of duplicated datapoints in the new chart.

In the example below, the Bar Chart 1 has the following dataset paths:

  • Dataset path 1: / gw1 / probe1 / me1 / toolkit(type=) / toolkit / data1 / Numbers
  • Dataset path 2: / gw1 / probe1 / me1 / toolkit(type=) / toolkit / data1 / Letters

In the example below, the Bar Chart 2 has the following dataset paths:

  • Dataset path 1: / gw1 / probe1 / me1 / toolkit(type=) / toolkit / data1 / Letters
  • Dataset path 2: / gw1 / probe1 / me1 / toolkit(type=) / toolkit / data1 / No
  • Dataset path 3: / gw1 / probe1 / me1/ toolkit(type=) / toolkit / data2 / No

Both Bar Chart 1 and Bar Chart 2 have the same / gw1 / probe1 / me1 / toolkit1(type=) / toolkit / data1/ Letters dataset path. Since this path has been plotted on Bar Chart 1, it will no longer appear on Bar Chart 2.

Line Chart

Line Chart is a type of widget capable of displaying multiple charts. Each chart can plot multiple datasets from different data items. A chart always plots time on the X-axis, and the value of the data points (that make up the datasets) on the Y-axis.

Create a Line Chart

There are several ways that you can create a Line Chart, depending on the existing dashboard objects and data items you want to plot.

To create a new Line Chart:

  1. Go to View > Active Dashboard > Show Tool Palette
  2. Double-click Widget.
  3. Drag and drop the Line Chartinto the Active Dashboard canvas.
  4. Right-click the Line Chart to populate new or historical data.

If you want to create a Line Chart with multiple data items:

  1. Press CTRL while selecting multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag and drop these data items into the Active Dashboard canvas. This opens the Tools & Modifiers dialog.
  3. Select Line Chart in the Tools & Modifiers dialog.
  4. Click OK.

In this example, three data items are selected from the Metrics dataview:

If you want create a Line Chart with one data item:

  1. Right-click the selected data item from the Metrics dataview.
  2. Click Show Chart > New Chart. This creates an active chart in the Active Dashboard canvas.

Add new data to an existing Line Chart

To add new datasets that can be configured on existing charts:

  1. Right-click the selected data item from the Metrics dataview.
  2. Click Show Chart. This displays the list of all existing charts in your Active Dashboard.
  3. Select the name of the chart where you want to add a new data item. This adds the new data item into the existing Line Chart you have selected.

Alternatively, you can:

  1. Drag and drop the selected or multiple data from the Metrics dataview into the existing Line Chart. This opens the Tools & Modifiers dialog.
  2. Select Line Chart Dataset on the All Tools tab.
  3. Click OK. This adds the new data items into the existing Line Chart.

Note: Selecting Line Chart on this dialog creates a new Line Chart.

View the Line Chart menu

To view the Line Chart menu:

  1. Right-click the Line Chart.
  2. Navigate to Line Chart.

The menu has the following options are:

Field Description
Save Chart and data to file Saves the selected chart in a .dbi format.
Save Chart as a PNG Saves the selected chart as an image in a .png format.
Export to CSV Saves all the chart data in all its datasets to a user-defined comma separated or .csv file.
Launch Table View Launches a separate window that contains details of the actual data that is plotted on the chart. See View chart in a table view.
Interpolate Forces the chart to run an interpolation. See Interpolate Line Chart.
Remove Zoom Locks Disables the zoom functionality in the chart.
Comparison Mode Switches between the chart being in comparison mode or not.
Add Chart Data Set

Adds a new chart dataset to the chart. This is not connected to any data items until you specify them.

All Datasets

Provides access to operations on all datasets on the selected active chart.

This provides the following options:

  • Enable all — enables all datasets on the chart.
  • Disable all — disables all datasets on the chart.
  • Clear data points — clears all data points for all datasets on the chart.
  • Clear all threshold values — clears all threshold values from the chart datasets.
  • Remove data sets — removes all datasets from the chart.

Datasets Shows all datasets for the chart and allows dataset functions to be invoked on the selected dataset.
Repopulate Chart with Historic data Populates the active chart with previous data.
   

View chart in a table view

To launch a tabular view that contains details of the actual data in the chart:

  1. Right-click the selected chart.
  2. Click Line Chart.
  3. Select Launch Table View.

The table view displays the following data from the chart:

  • List of data sets from the chart in the DataSets column.
  • Threshold events, if applicable.
  • Values, such as the X-axis and point values for each data set.

Both these lists can be sorted and their columns reordered. This can be useful for analysing the data for large or unusual values.

Interpolate Line Chart

Line Chart continue to update as long as the Active Console and the connected Netprobe are running. A chart never removes the data from its datasets unless you remove them. Therefore, over time the datasets get bigger, containing days, even weeks, months, or years worth of data.

There are some practical limitations on how many points a chart can display at any given point in time (from both a performance and visibility stand point) and this is the reason for the interpolation function.

To turn on interpolation:

  1. Right-click the selected chart.
  2. Click Line Chart.
  3. Select Interpolate.

How interpolation works

If the number of data points you are asking the chart to plot exceeds a given value (which defaults to 500 per dataset), it interpolates the dataset.

It is reducing the number to its target number for display (which defaults to 250 per dataset), choosing to plot the most significant points from those available. It does this by hiding (not removing) data points that have a similar (or the same) value to the previous point.

Note: You can turn interpolation off any time. In this case, expect the charting routines to become more expensive from a CPU standpoint. If your dataset has over 10,000 data points and you ask it to plot them all, then this could lock the Active Console.

Configure datasets in the chart

Datasets represent each data item that the chart contains. Each chart property of the dataset can be configured in the chart properties.

In this example, there are three datasets that the chart contain:

  • The Dataset 0, Dataset 1, and Dataset 2 represents the properties of each dataset.
  • The All Data Sets tab allows you to configure all datasets simultaneously.

These are the properties that you can configure for each dataset:

Dataset field Description
Display Name Name that appears in the legend and tooltips for the dataset. By default, this becomes the user-defined path.
Path Displays the Geneos path to the data item being plotted. Click Edit to modify the path.
Plotted Attribute Attribute from the data item being plotted. In most cases, this contains the default "Value".
Graph Type

Changes the type of graph.

Options: Line, Bar, Area, Scatter Plot, Step Graph, Target Marker

Line Thickness Width of the line or border in pixels.
Line style

Style of the line.

Option: Solid, Dashed

Display Points on Line charts Defines if the data points (square, triangle, circle) should be plotted in a line chart.
Visible on graph Displays the datasets on the chart.
Enabled

Enables the dataset on the chart.

If the dataset is disabled, then the chart is not updated for this data source. You cannot retrieve any data missed while the dataset is disabled.

Fill Transparency Sets the transparency of the fill, where 0% is completely opaque; 100% is completely transparent.
Line Transparency Sets the transparency of the line/border, where 0% is completely opaque; 100% is completely transparent.
Data Set Colour Defines the colour of the dataset when plotted on the chart.
Interpolate See Interpolate Line Chart.
Target Displayed Data Points Number of data points the dataset should contain after an interpolation.
Maximum Display Data Points If the number of data points exceeds this value, then the dataset interpolates.
Multiplier

A value by which all the data point values are multiplied to.

For example, a value of "2" doubles the plotted data point values.

   

Convert a dataset into a target marker

The Target Marker allows you to visualise threshold markers and values in the Line Chart.

The conversion of the selected dataset into a horizontal line or marker in the Line Chart is based on its cell value from the metrics dataview.

This example, the Line Chart has three cell values used from the metrics dataview:

  • percentKernelTime
  • percentUserTime
  • percentUtilisation

Each dataset has its own colour legend that you can also modify in the Object Attributes properties. In the example, the dataset for percentUtilisation has been converted into a target marker.

To convert a dataset into a target marker:

  1. Go to Active Console > View > Active Dashboards.
  2. Drag and drop the metrics dataview values on the Active Dashboard tab.
  3. Select Line Chart in the Tools & Modifiers screen.
  4. Click OK.
  5. Select the dataset you want to convert in the Line Chart.
  6. Right-click the Line Chart, and click Properties.
  7. Go to the Dataset tab of the selected data item.
  8. Click the Graph Type menu in the Aesthetic Configuration group.
  9. Select the Target Marker option.
  10. Click OK to save the changes.

Note: There is no limit to the number of datasets you can convert into target markers. One dataset conversion becomes one target marker in Line Chart.

Use template data set

The values that you configure in the Template data set are used as defaults when new datasets are subsequently created. To configure this property:

  1. Go to the chart object properties.
  2. Click Template data set.
  3. Set the new configurations.
  4. Click OK.

Use chart comparison mode

Line Chart has a special mode which allows datasets from different time periods to be directly overlaid on the same chart.

To enable chart comparison mode:

  1. Right-click the selected chart
  2. Click Line Chart > Comparison Mode.
  3. Alternatively, enable the Comparison Mode in the Chart Properties.

For example, the data from yesterday between 2:00-4:00PM can be plotted over the top of data from 2:00-4:00PM today. This is called the Comparison Mode.

If you use this, the start date of all datasets revert to the:

  • User-defined start date.
  • Start date of the oldest dataset, if not defined.

The dataset where the Comparison Mode is enabled gets an indicator in the legend to indicate that their time data has been modified:

Pan and zoom the chart data

You can pan and zoom around the data that an a Line Chart contains. To do this, you can either:

  • Right-click the Line Chart and click Zoom.
  • Modify the values of the Line Chart properties dialog.
  • Tick the Show Scrollbar in the X-Axis and Y-Axis Settings.

Note: The start date, end date, lower, and upper Y scale values are automatically configured by Line Chart over time to best display the data contained in the chart's datasets.

Once you start panning and zooming, you essentially override these automatic mechanisms with your own hard coded values. The Line Chart has two scroll bars, a horizontal one (X axis), which allows you to pan and zoom over time, and a vertical scroll bar (Y axis) which allows you to zoom in on specific value ranges:

The start and end pointer change the start and end of the plot range respectively, be it the X axis (time) or the Y values. An orange pointer means you have fixed the relevant start or end point on the X or Y axis.

The locks are also removed if the start or end pointers are moved to their default position (which is generally at the beginning or end of the scroll bar, apart from the start time pointer which can vary). You can pan the available data by scrolling with the scroll bar itself directly (rather than the start and end points).

You can hide the scroll bars in the chart properties.

Create history charts

You can create charts of data that you have previously logged to a data source. To log a data item property, such as the value of a managed variable to the data source, you must have configured the relevant Gateway to connect to a data source, when the selected property changes. For more information, see Import historical events from database in Event Tickers Dockable.

There are a several ways you can create charts from historical data, similar to creating a chart. The only difference is that you select History Chart or the values on the Historical menu from the Tools & Modifiers dialog. See Create a Line Chart.

The dataset displays the Log to database indicator to show that a data source query is running to populate it with data:

The Active Console dispatches the query to the data source to recover the data. The actual query works asynchronously, meaning the Active Console does not wait for a response and you can carry on working. The query is a command that also appears in the Commands dockable:

When you request data for a predefined time period (hour, day, week, or month), the Active Console connects to the same data source of the Gateway where the data item is configured to use. If the data source query is successful, the database legend annotation is removed.

Note: The option to use the historical chart and historical chart dataset tool is available even the data item is currently being logged to the database. This is because the item may previously have been logged to the database, but is no longer being logged.

Configure Time Definitions

Creating or updating a history chart allows you to populate data based on the available time range defined in the Active Console.

Time Definitions contain default values which you can modify:

To configure Time Definitions:

  1. In Active Console, go to Tools > Time Definitions.
  2. Double-click the row you want to modify to open the time details.
  3. In this example, double-click Past Working Day (6am to 6pm).

  4. Click Start or End to configure the Time Definition Editor.
  5. Click OK to apply the changes.

When history chart is not working

These are common reasons why the history chart might not work properly or cannot populate data correctly:

Active Console is not connected to the database

The Active Console connects directly to the database. Check if the database settings are set up correctly and if the Active Console machine (desktop or laptop) has sufficient network access to the database and database server.

Ensure that the settings where the Active Console gets its database connection details are correctly configured:

  • In Gateway Setup Editor, go to Database logging > Database > Client connection. Specific to Oracle database, the Sid, Server name, and Port settings are mandatory.
  • In Active Console, go to Workspace settings > Database.

Duplicate cells where the history chart is executed

To resolve the duplicate cells where the history chart is executed:

  1. Open Active Console > Metrics.
  2. Right-click the cell where the history chart is executed.
  3. Hover Copy from <cell name>, and click Legacy Name.
  4. Paste the Legacy Name on a text file to see the actual variable name. For example, %update100rowcol.row_0.Column_3.
  5. Run a query in the Geneos database to find any possible duplicate varname value.
    1. Use SELECT * FROM var_ref_table to output all the varname value. Check if the variable name has a duplicate from the list.
    2. Use select * from var_ref_table where varname like %update100rowcol.row_0.Column_3 to exactly find a match from the Geneos database.
  6. Delete the duplicate variable names. For more information, see Fix variable name duplicates in Gateway Database Logging.

Incorrect data type for the database logging item value

The cell's value column data type must be set either to REAL or FLOAT.

If the cell's value column data type is correct, but the history chart still does not work, check the Tables setting:

  1. In Gateway Setup Editor, go to the Database logging > Tables.
  2. Check if the Type is set to Double.
  3. Rerun the history chart.

Missing database drivers or client libraries

For Active Console version 4.11 and below, the Active Console connects to all supported databases using JDBC, with the exception of MySQL which means the Active Console does not need any additional libraries or drivers other than those shipped with the Active Console packaged by default. In the case of MySQL, you need to download the MySQL from their website.

For Active Console version 4.12 and above, the Active Console is now packaged with the MariaDB database connector.

The language of the database server and the JVM are different

The Active Console assumes that the decimal delimiter returns the numbers, where these are comma-separated values. Therefore, the conversion of the returned rows might fail. Check the exception log:

Exception no.6
Fri Apr 12 11:56:55 CEST 2013 java.lang.NumberFormatException: For input string: "26,4E0"
sun.misc.FloatingDecimal.readJavaFormatString(Unknown Source)

To resolve this:

  1. Open the Active Console installation directory.
  2. Open the ActiveConsole.gci file.
  3. Add -jvmargs in the file. For example:
  4. -jvmargs
    [....]
    Duser.language=en
  5. Save the file.
  6. Restart the Active Console.

The query from the database should now return a decimal value separated by a dot or decimal point.

Get historical data within specified date range

When populating a historical chart data using User Defined, the User Defined Parameters opens. This returns only the Database Logging connection entries.

To get historical data in the Active Chart for a specific period, go to View > Active Dashboards > Active Dashboard Palette > Line Chart.

  1. Drag and drop the Line Chart widget in the Active Dashboard canvas.
  2. Drag and drop the data you want to use from the Metrics view into the Line Chart.
  3. Click Line Chart in the Tools & Modifiers screen, and then click OK.
  4. Right-click the populated chart and select Re-populate all charts with Historic data.
  5. Click User Defined.
  6. Click Yes in the Re-populate chart dialog. This opens the User Defined Parameters dialog.
  7. Fill out the fields to specify the time period, and click OK.

The User Define Parameters has the following options:

Field Description
Time from Start date and time for the data you want to recover.

Date format: Month, date, year
Time format: Hour, minute, seconds
Time to End date and time for the data you want to recover.

Date format: Month, date, year
Time format: Hour, minute, seconds
Max results (-1 means no limit) Maximum number of data points that must be recovered to get all the matching data.

If more than the maximum number of data points are defined, then the older data points take precedence over the newer data points.

Default: -1
   

Recover data for a disconnected data item

You may want to plot historical data for a data item that is either no longer configured in a Gateway, or a Gateway you are no longer connected to You can do this by following these steps:

  1. Configure the data source connection. If the Gateway is not connected and none of the existing Gateways use the same data source connection, you need to manually define the database settings in the Workspace Settings . You can skip this step if the required data source connection is already known to Active Console. The data source value can be either set to Database Logging or Gateway Hub.
  2. Create a new dataset. If required, you can use the chart tool in the dashboard tools to create a new one.
  3. Setup the path in the dataset. Right-click the chart and select Properties to modify the path. See Geneos URL editor in Path Editor. You need to define the path of the item you want the data for.
  4. Recover the data. Right-click the new dataset in the legend of the chart and select the Supplement with Historical data > User defined. In the resultant dialog, select the relevant database connection, and the time period that you want the data for. If you have correctly defined all the parameters, such as the path, database, time from and to, then the chart retrieves the data.

Note: If no data is available for the selected data item in the database, then this prompts the ActiveChart Error message.

Import saved charts

Charts that are saved in a DBI format can be loaded into another Active Console at any time. The DBI file saves the aesthetic and data properties of the chart.

If an imported chart is loaded with datasets that are enabled and refer to directory components that are active in the Active Console, then these resume ticking from the point the charts are imported.

Area Chart

You can modify the style and properties of an Area Chart by clicking Show Object Inspector.

When you drag the Area Chart to the Active Dashboard, the Dataset > Graph Type automatically sets to Area.

To create an Area Chart:

  1. Select the data item from the Metrics dataview.
  2. Drag the selected data item into the Active Dashboard. This opens the Tools & Modifiers dialog.
  3. Select Area Chart in the Tools & Modifiers dialog.
  4. Click OK.

Alternatively, you can create an Area Chart with multiple data items:

  1. Press CTRL while selecting multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag these data items into the Active Dashboard. This opens the Tools & Modifiers dialog.
  3. Select Area Chart in the Tools & Modifiers dialog.
  4. Click OK.

Add data to existing Area Chart

To add datasets into an existing Area Chart:

  1. Press CTRL while selecting one or multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag these data items into an existing Area Chart. This opens the Tools & Modifiers dialog.
  3. Select Area Chart Dataset in the Tools & Modifiers dialog.
  4. Click OK.

Here is an example of an Area Chart with multiple data items:

Scatter Plot

You can modify the style and properties of a Scatter Plot graph by clicking Show Object Inspector.

When you drag the Scatter Plot to the Active Dashboard, the Dataset > Graph Type automatically sets to Scatter Plot.

To create a Scatter Plot:

  1. Select the data item from the Metrics dataview.
  2. Drag the selected data item into the Active Dashboard. This opens the Tools & Modifiers dialog.
  3. Select Scatter Plot in the Tools & Modifiers dialog.
  4. Click OK.

Alternatively, you can create a Scatter Plot with multiple data items:

  1. Press CTRL while selecting multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag these data items into the Active Dashboard. This opens the Tools & Modifiers dialog.
  3. Select Scatter Plot in the Tools & Modifiers dialog.
  4. Click OK.

Add data to existing Scatter Plot

To add datasets into an existing Scatter Plot:

  1. Press CTRL while selecting one or multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag these data items into the existing Scatter Plot. This opens the Tools & Modifiers dialog.
  3. Select Scatter Plot Dataset in the Tools & Modifiers dialog.
  4. Click OK.

Here is an example of an Scatter Plot with multiple data items:

Step Graph

You can modify the style and properties of a Step Graph by clicking Show Object Inspector.

When you drag the Step Graph to the Active Dashboard, the Dataset > Graph Type automatically sets to Step Graph.

To create a Step Graph:

  1. Select the data item from the Metrics dataview.
  2. Drag the selected data item into the Active Dashboard. This opens the Tools & Modifiers dialog.
  3. Select Step Graph in the Tools & Modifiers dialog.
  4. Click OK.

Alternatively, you can create a Step Graph with multiple data items:

  1. Press CTRL while selecting multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag these data items into the Active Dashboard. This opens the Tools & Modifiers dialog.
  3. Select Step Graph in the Tools & Modifiers dialog.
  4. Click OK.

Add data to existing Step Graph

To add datasets into an existing Step Graph:

  1. Press CTRL while selecting one or multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag these data items into the existing Step Graph. This opens the Tools & Modifiers dialog.
  3. Select Step Graph Dataset in the Tools & Modifiers dialog.
  4. Click OK.

Here is an example of an Step Graph with multiple data items:

Spark Chart

The Spark chart is a small and minimalist chart that is available in the Active Dashboard Palette. Creating a spark chart is the same as creating a Line Chart. See Create a Line Chart

The properties for a Spark chart are the same as those for a standard Active chart. You can also add datasets to a Spark chart by using the Spark Chart Dataset and Historical Chart Dataset tools.

By default, the Spark Chart does not display the legend, heading, and other labels. To modify the chart's properties, see Dashboard Charts and Widgets:

Active Gauge

A dashboard is capable of displaying multiple Active Gauges that can display multiple datasets from different data items.

The value of a dataset is displayed through a pointer. The pointer is constrained by a minimum and a maximum boundary which must be either manually assigned or left to be automatically determined over time by the Active Gauge itself. The number of pointers depend on the number of datasets:

Active Gauges update automatically over time as the attributes of the data items are changing. An update occurs each time the value changes.

Create an active gauge

To create a new Active Gauge:

  1. Select the data item from the Metrics dataview.
  2. Drag and drop the selected data item into the Active Dashboard. This opens the Tools & Modifiers dialog.
  3. Select Active Gauge in the Tools & Modifiers dialog.
  4. Click OK.

If you want to create a new Active Gauge with multiple data items:

  1. Press CTRL while selecting multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag and drop these data items into the Active Dashboard canvas. This opens the Tools & Modifiers dialog.
  3. Select Active Gauge in the Tools & Modifiers dialog.
  4. Click OK.

Add data to existing active gauge

To add datasets into an existing Active Gauge, follow these steps:

  1. Press CTRL while selecting one or multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag and drop these data items into the Active Dashboard canvas. This prompts the Tools & Modifiers dialog.
  3. Select Gauge Dataset in the Tools & Modifiers dialog.
  4. Click OK.

Configure active gauges properties

To configure the properties of an Active Gauge, you can:

  • Right-click the selected chart and click Properties.
  • Click the shape and press CTRLEnter.
  • Modify the properties using the Object Inspector

The table below shows the properties of an Active Gauge:

Settings Description
General Settings

Defines the aesthetic and style of the text present in the widget. This includes the:

  • Title
  • Title Position
  • Title Font
  • Title Font Style
  • Title Font Size
  • Legend
  • Base Size
  • Background Transparency
Scale Settings Modifies the external shape properties and enable labels.
Shape Settings

Changes the orientation of the widget that includes:

  • Circumference — always starts at 0 degrees and its end degree can be set between 45°—360° allowing for a wide range of circular shapes.
  • Rotation — values can bet set to negative (-) 360° to 360°. Setting a positive rotation sets the active gauge in a counter-clockwise, while setting a negative rotation sets it in a clockwise.
  • Start/End Offset — setting an offset amount (spacing) in degrees between the start and end point of the shape.
Boundary Settings

This can be configured by setting it to:

  • Auto-Resize Enabled — Dynamically adjusts the minimum and maximum boundary of the active gauge depending on the value of a dataset
  • Auto-Resize Disabled — minimum and maximum boundaries are explicitly defined and do not adjust regardless of the value of a dataset.
Segment Settings

A segment is defined by a Start From and an End At property. These settings can be modified by entering an explicit value or by percent. If auto-resize is enabled in the boundary settings, then segments can only be defined by percent.

   

Configure segments in active gauge

Defining a segment by value requires a Start From and an End At value which coincides within the gauges minimum and maximum boundary.

For example, if the minimum boundary of the active gauge is 0 and the maximum boundary of the active gauge is 500, the Start From and End At values must be in between these boundaries "0-200", "300-400", "0-500". The Start From value must also be less than the End At value.

Segments do not have to be continuous. If two segments are defined, the second segment does not have to start from where the first finished at.

If a segment is defined by percent, the minimum and maximum values must coincide between 0 and 100%.

ac2-user-guide146

Another important setting for segments is the Start Fill and End Fill property. These properties define the thickness of the segment and are set as a percentage. The Start Fill is the start percentage from the base of the active gauge, while the End Fill is the end percentage from the base of the active gauge.

ac2-user-guide147

Active Pie Charts

Active Pie Charts are available in the Active Dashboard Palette. A dashboard is capable of displaying multiple Active Pie Charts that can display multiple datasets from different data items. The value of a dataset is represented by a slice in the Active Pie Chart:

Active Pie Charts update automatically over time as the attributes of the data items are changing. An update occurs each time the value changes.

Create active pie charts

To create an Active Pie Chart:

  1. Select the data item from the Metrics dataview.
  2. Drag and drop the selected data item into the Active Dashboard. This open the Tools & Modifiers dialog.
  3. Select Active Pie Chart in the Tools & Modifiers dialog.
  4. Click OK.

To create an Active Pie Chart with multiple data items:

  1. Press CTRL while selecting multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag and drop these data items into the Active Dashboard canvas. This opens the Tools & Modifiers dialog.
  3. Select Active Pie Chart in the Tools & Modifiers dialog.
  4. Click OK.

Add data to existing active pie chart

To add datasets into an existing Active Pie Chart, follow these steps:

  1. Press CTRL while selecting one or multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag and drop these data items into the existing pie chart. This opensthe Tools & Modifiers dialog.
  3. Select Active Pie Chart Dataset in the Tools & Modifiers dialog.
  4. Click OK.

Configure active pie charts

To configure the properties of an Active Pie Chart, you can:

  • Right-click the selected chart and click Properties.
  • Click the shape and press CTRLEnter.
  • Modify the properties using the Object Inspector

The table below shows the properties of an Active Pie Chart

Field Description
Title

Name of the pie chart.

Default: Enabled
Options:

  • Enabled — displays the name of the pie chart.
  • Disabled — hides the name of the pie chart.
Labels Path of the data item you selected from the metrics dataview. This displays in the centre of the pie chart.

Default: Enabled
Example: GW / GW ME / Server name / severity / actual value
Legend Path of the data item you selected from the metrics dataview. This displays a panel below the pie chart.

Default: Enabled
Example: GW / GW ME / Server name / severity / actual value
Visual Quality Determines the pie chart's image resolution.

Options: High, Low
Orientation (degrees) Sets the starting angle position of the pie chart in a clockwise manner. This can accommodate values between 0-360 degrees.

When a value is a negative number, it sets the pie chart orientation in a counter-clockwise manner.

Default: 0
   

Bar chart

A dashboard is capable of creating a bar chart that can display a data set using the selected data item.

To create an Bar Chart:

  1. Select the data item from the Metrics dataview.
  2. Drag and drop the selected data item into the Active Dashboard. This opens the Tools & Modifiers dialog.
  3. Select Bar Chart in the Tools & Modifiers dialog.
  4. Click OK.

To create a Bar Chart with multiple data items:

  1. Press CTRL while selecting multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag and drop these data items into the existing bar chart. This opens the Tools & Modifiers dialog.
  3. Select Bar Chart in the Tools & Modifiers dialog.
  4. Click OK.

Add data to existing bar chart

To add datasets into an existing Bar Chart:

  1. Press CTRL while selecting one or multiple data items from the Metrics dataview.
  2. While pressing the CTRL and the selected data items, drag and drop these data items into the existing bar chart. This opens the Tools & Modifiers dialog.
  3. Select Bar Chart Dataset in the Tools & Modifiers dialog.
  4. Click OK.

Note: When you drag and drop data items into the Active Dashboard for the first time, the Bar Chart and Bar Chart Dataset are located on the All Tools tab in the Widget section. In an existing workspace where bar charts are used, these options are accessible on the Recently Used tab.

In this bar chart, multiple datasets are used from the plug-in's metrics dataview:

Each dataset has its own colour legend that you can also modify in the Chart Properties.

Configure picture format

To upload an image in the Active Dashboard canvas:

  1. Go to Active Dashboard Palette > Widget > Picture.
  2. Drag and drop the Picture tool into the dashboard canvas. This opens the Open dialog.
  3. Select the image from your local machine.
  4. Click Open. The image displays in the Active Dashboard canvas.
  5. Right-click the image and click Properties.
  6. Click Picture Format.

The Picture Format tab has the following options:

  • Picture — a thumbnail preview of the image. To change this, double-click the image icon.
  • Remove image on Apply — if you do not want the picture to contain an image, then select this option.
  • Stretch image to fit shape — if disabled, the image stops from scaling. Then, it displays it at its normal size.
  • Transparency — adjusts the transparency of the image.

Note: When pictures are imported into the workspace, the original source images are not required even if you are exporting/importing the dashboard into another workspace.