Metrics dockable

Overview Copied

The Metrics dockable contains a number of metrics dataviews that are represented by a name and a tab. Each tab displays the contents of the selected metrics view.

This dockable also shows the following:

The content of the primary metrics view always follow the selection in other Active Console components. It creates one metrics table for each dataview within the relevant directory component and insert it into the primary view. While, the custom metric views are manually populated. The list of dataviews do not change unless you add or remove these metrics tables from them.

There are no restrictions on the source of the dataviews that can be placed into a single metrics view. These can come from independent Gateways, and can connect to any plug-in type.

Example of a Metrics dataview:

View selector Copied

The View selector is a tree structure that consist of groups and metric tables as leaf nodes. It appears on the left panel of the Metrics view:

View selector in the Metrics dataview

The metric tables can be grouped by a primary and secondary attribute. The attributes that can be used are:

In cases where the dataviews connected to a metric table do not share a common value for a selected attribute, these belong into a group labelled Multiple. If the specified attribute cannot be located, these belong into Unknown group.

These are the available options to choose from when you right-click a managed entity from the View Selector:

Adjust the navigation pane Copied

Beginning Geneos 5.6.x, you can adjust the width of the navigation pane in the View > Metrics by dragging the line border to the left or right. This is useful to easily view the samplers or groups with long names.

Metric tables Copied

The view selector contains a list of metric tables. A metric table contains zero to many dataviews that are published from the plug-ins connected to the Gateways. These have two main properties:

Beginning Active Console 5.5.x, the Managed Entity display name is used in the user readable path. A metric table has a single path which points at a single dataview. However, it is possible not only to include several paths, but to configure one or more of them to match multiple dataviews.

In these cases, the metric table may contain more than one dataview. When the metric table is selected and its contents displayed in the viewer, it shows single merged table that contains the contents of all the dataviews. This is referred to as Metric Overview Tables.

The set of dataviews connected to a metric table update as Gateways and probes come up and down.

For example, the content of metric tables is dynamic and reflects the current state at all times.

Refresh the metric table data Copied

This feature allows you force restart the data sampling in the dataview.

The sample rate or time is also shown that can be configured in Gateway Setup Editor:

  1. Go to the Metrics dockable.
  2. Click Sample now .

Metric tables update automatically when the dataviews contain resampling of data.

You can also stop these updates by clicking Pause from the metric table in the viewer.

Add and remove metric tables Copied

There are many ways on how to add or remove metric tables.

Using the options from State Tree:

  1. Right-click any Managed entity or sampler.
  2. Click Create Metrics View.
  3. Select from the available settings you want to apply to your metric table.

Using options from View selector in Metrics dockable:

  1. Right-click any Managed entity or sampler.
  2. Click Create Metrics View.
  3. Select from the available settings you want to apply to your metric table.

Create Metrics View has the following options:

Another option is to drag and drop the Managed entity or sample into the Metrics dockable. This added to the currently opened metrics tab in your Metrics dockable.

Note

You can only add new metric tables to custom metrics views through drag and drop. You cannot modify the primary view.

To remove the metrics dataview:

  1. Right-click the metrics dataview from the Metrics dockable.
  2. Select Remove Metrics Table.

Note

This cannot be done within the primary metrics view.

Metric table viewer Copied

If the metric table is displaying a single dataview, then the headlines for that dataview are displayed above the table in a series of horizontally ordered boxes.

If the metric table has more than one dataview, then the headlines are displayed in another table. This includes columns detailing the Gateway and managed entity the headline is applicable to, so that you can tie specific headlines to specific dataview instances that make up the metric table.

Configure the column headings Copied

The columns in metric tables allows you to:

These settings are save for as long as the metric table exists in the view selector.

Note

The first column of a metric table is treated as a special column that cannot be hidden. Once resized, it does not occupy more than a third of the viewable screen. If any value of a first column cell is longer than this limit, use a tooltip to view the full value.

You can choose to save the settings as the default for all metrics tables of the same name.

To save this setting, go to the metric table:

  1. Right-click any column header.
  2. Click Column settings.
  3. Select Save as data view defaults.

Alternatively, you can save the column settings selectively by using the Table Column Settings Editor. This dialog is accessible on the same menu when you right-click any column header, or go to Tools > Table Column Settings Editor. See Table column settings editor.

Whenever a metric table with a dataview of the same name is created, the default column settings are applied. However, any existing metric tables are not affected.

Warning

The primary metric view constantly refreshes its content based on user selection. Do not spend too much time setting up table layouts here, as these will be lost as soon as there is a new user selection in another Active Console component. You can define the dataview default settings that can be saved.

To revert the changes made to dataview default setting, go to the metric table:

  1. Right-click any column header.
  2. Click Column settings.
  3. Select Revert to data view defaults.

The other option is to revert any modified settings to factory defaults by clicking to Column settings > Revert to Factory Settings.

This setting loses any modified settings in favour of factory defaults, but no changes are applicable to the workspace. Therefore, when the dataview is loaded next time, the workspace default is automatically applied.

Column header naming convention Copied

Using curly brackets { } as characters in the table column headers can cause Active Console to crash or result in infinite loop issues.

Beginning Geneos 5.10.x, the Active Console will automatically replace the curly brackets { } with parentheses ( ) in its rendering of the column header names. Active Console will display logs to indicate that the curly bracket characters are replaced.

Example log: [INFO] The column header "Tableheader {1}" has been changed to "Tableheader (1)"

Note

This only applies to column headers. Headlines, row names, and row cells in the table can still render the curly brackets with no issues.

Sampling information label Copied

This label is available on the Metrics dataview next to the Pause . This sampling information label contains comma separated literal values for rows, sampling interval, manual sampling time stamp, last sample time stamp, and list of hidden columns.

The Last sample value displayed in the dataview is the Sample Time value of the Netprobe:

4 rows, Sampling every 20 seconds, User requested sample completed at <local AC time>, Last sample <Netprobe Last Sample Time>

Sampling information label

The Last sample value updates during the following events:

Note

If the sampling information label does not display the sample time, then Active Console is not receiving an event to trigger an update for the current metrics table.

Sub-rows or indented rows Copied

Geneos UIs will by convention display rows containing a # character indented from the other rows in a dataview. Such rows are sometimes referred to as “sub-rows”, and are typically used for displaying additional details for the row they are displayed under. Example usage by other Geneos plug-ins include the “summary+details” view of the PROCESSES plug-in, or physical/logical rows of the CPU plug-in.

To use sub-rows in your own plug-in, simply name the row in the form topRow#detail. Metrics for the sub row should typically display detailed information, while the top (or summary) row displays a summary or aggregate of the sub rows. For example, a “total” or “average” column would display the total or average of the figures displayed beneath it.

-- Sub-rows are displayed 'indented' in Geneos UI
-- This convention is typically used to display "summary" and "detail" data in the same view.
-- The top-level row shows the summary or aggregate data.
subrowsView.row["top"]      = { 8, 7, 4 }
subrowsView.row["top#sub1"] = { 2, 7, 3 }
subrowsView.row["top#sub2"] = { 6, 0, 1 }
subrowsView.row["head"]      = { 1, 0, 0 }
subrowsView.row["head#sub1"] = { 1, 0, 0 }
assert(subrowsView:publish())

The code above produces the following dataview:

Dataviews SubRows

Status of hidden columns Copied

The status bar displays a list of column names that are currently hidden from the table. This hidden column information is independent of any persisted table settings. If there are hidden columns, these are listed here.

Note

The exception to this rule are columns whose name starts with a ‘/’. These are hidden by default, and therefore their hidden status is not reported on the status bar.

Active and inactive metric tables Copied

You can make metric tables active and inactive. This is useful if you have large scale metric overview tables that you only need by the time you query them.

Caution

Metric tables still consume memory and CPU usage when active. You may consider making them inactive when not in use.

To do this:

  1. Right-click the selected metric table or the selected Managed entity/sampler in the View Selector.
  2. Select Active.

Inactive dataview metric tables contain no dataviews. Once activated, the dataviews return in metrics table.

Save metric tables as CSV Copied

You can make an output of metric tables that saves the table to a comma separated (.csv) file:

  1. Right-click the selected metric table.
  2. Select Save As CSV.
  3. Type the filename in the File name field.
  4. Click Save.

You can also use the Copy Dataview option that places the non-filtered table contents into the system clipboard.

Query the metrics table Copied

You can perform a simple query function that can be performed on metric tables.

Count Unique is used to count the number of unique names or values in a given column.

To use this method, follow these instructions:

  1. Right-click the selected metric table.
  2. Click Query Table.
  3. Select Count Unique.
  4. Click OK to close the dialog box.

Success

The results of the selected parameter with unique values show in a dialog box.

Configure metrics filters Copied

You can add filters to any metric table to restrict the rows that are displayed based on criteria.

To configure metrics filters:

  1. Right-click the selected metric table.
  2. Click Filter Table.
  3. Click Add to specify the metric filters.
  4. Click OK to save the changes.

Configure Metrics Filters

A row is only displayed if it passes all the filter conditions. Each filter has the following attributes:

If a metric table has an active filter, then the sampling information labels indicates the number rows and filters applied:

Sampling information label with filters

Filters persist for the life time of the metric table and between Active Console sessions. Therefore, it is possible to add two metric tables to a metrics view which have the same path attributes (and therefore contain the same data views) because you can set up different filters on these tables.

To remove the filters, follow these instructions:

  1. Right-click the selected metric table.
  2. Click Clear filters.
Field Description
Column

The column whose row value must pass the filter.

There are also special cases for ANY COLUMN, where 1 or more cell values in a row must match the criteria.

Or ALL COLUMNS, where all row values must match the criteria.

Not A Boolean flag check box that inverts the criteria.
Value Value to match against.
Operator

A series of logical operators that determines the relationship between a successful match and the value specified in the value column.

  • Contains — matches if the value of the specified column contains (case sensitive) the value defined.
  • Contains No Case — matches if the specified column contains (non-case sensitive) the value defined.
  • Equal — matches if the specified column is the same with the specified value. This is a literal string equality (case sensitive).
  • Equal No Case — matches if the specified column is the same with the specified value. This is a literal string equality (non-case sensitive).
  • Less than — matches if the specified column is less than the specified value.
  • Greater than — matches if the specified column is greater than the specified value.
  • Numeric Equals — matches if the specified column is the same with the specified value. as a mathematical equality.

Create a metrics overview Copied

To create a Metrics Overview, do one of the following:

This allows you to specify a dataview name, a target metrics view, and whether to filter the dataviews on the current state tree selection.

The Metrics Overview is created with the relevant metrics view that contains all dataviews of the specified type currently connected to the Active Console, in the specified section of the State Tree.

The Metrics Overview screen has the following options:

Metrics Overview

Select the persistent overview option Copied

This changes the default behaviour to close the Metrics Overview dockable when the window is closed.

In addition, this adds the Persistent overview check box in the overview metrics wizard which was initially turned off.

  1. Select the Dataview Attribute and the field you want to view.
  2. Tick the Persistent overview check box.
  3. Click OK.

Success

The New Overview Dockable displays on the screen.
Field Description
Dataview attribute Defines which attribute of dataviews is used to populate the list and subsequently used to populate the overview.
Dataview name

A list of all the unique names of the dataviews you are currently connected to through the Gateways.

You have to select one or more of these before clicking OK (Hold down the CTRL key to make a multiple selection).

Also, you can double-click an item from the list to save than having to click OK. However, this limits the selection of one dataview type.

Metrics view The target metrics view that you want to insert the new metrics overview into.
Limit on the current state tree selection

Limits the dataviews that are selected to go into your new metrics overview based on the current selection in the State Tree.

For example, only dataviews that are children of the currently selected state tree node are selected to go into your metrics overview.

If you turn this off, then the state tree selection is ignored and all dataviews with the specified name are inserted into the State Tree.

Default: On

Export and import metric views Copied

You can export a metrics view (one of the tabs) to a file that can then be imported into another workspace:

  1. To export, right click in the view selector and select the export function.
  2. To import, go to File > Import.

Table column settings editor Copied

The Table Column Settings Editor configures the table settings in the Metrics view.

To open this editor:

  1. Right-click any data item in the Metrics view.
  2. Select Column Settings.
  3. Click Table Column Settings Editor.

Note

If you open this editor through Tools > Table Column Settings Editor, the Active Console leads you to an empty view. Check that a cell or data item is selected from the Metrics view before you use this.

Configure the table column settings Copied

For each column in the table, the following column settings can be saved:

You can also review, change, or remove any previously saved settings for all tables. If you remove saved settings for a table, then the system automatically resets itself to factory settings for that table. Different operations are associated with each type of settings that can be saved, such as:

The Remove Persisted Settings, which is located at the bottom of the editor, can be used to remove all modified column settings for the selected dataview entry.

Table Column Settings Editor

Edit columns properties Copied

You can manipulate the column headers to change their properties. Right-click the specific row in the table for more options:

The Table Column Settings Editor can only be configured properly when you right-click a cell in the Metrics dockable.

["Geneos"] ["Geneos > Active Console"] ["User Guide"]

Was this topic helpful?