List view

Overview Copied

The List View is a dockable that can be configured to display a set of related data items. It can be configured to display:

• All critical managed entities of all connected Gateways.
• All data items that are snoozed.
• All data items that are assigned to a user.

Beginning Geneos 5.8.x, the undo and redo key functions, CTRL + Z and CTRL + Y, are supported in Active Console and Gateway Setup Editor for the following: text fields, multiline texts, and editable drop-down fields.

By default, a new workspace contains the following list views:

• Managed Entities — displays all managed entities relative to the selected data item in the State Tree dockable. See Entities dockable.
• Status Overview — contains the Critical and Warning (Under Selection), Netprobe Issues, and Sampling Errors tab. See Status overview.

All list views provide the following options on their status bar:

List view settings Copied

A list view setting can be defined on a list view dockable and at the workspace level. To open the List View settings, click Configure the view .

These functions are referred to as the list view settings hierarchy:

• Application level — settings that are hard-coded in the application. This cannot be changed.
• Workspace level — all list views inherit the settings provided within the workspace, unless you modify the settings at the dockable level. For more information, see Workspace level list view.
• Dockable level — all list views within the dockable level inherit the settings.
• List view level — settings configured directly in a list view. This ignores all parent settings.

These are the properties that you can modify in the List View settings:

• Content Paths — defines the paths that populates the list view.
• Filters — sets temporary filters on the list view which restrict the data items that displayed.
• Drag and Drop — defines what should happen when data items and other paths are dropped into the list view.
• General Visual — defines some general aesthetic properties of the list view.
• Details View — specifies other visual aspects of the details (table) mode of the list view.
• Properties — selects which data item properties are listed in the view.

Content paths settings Copied

This setting allows you to add, remove, and edit the paths that populate a list view.

These are the fields that you can modify:

Populate list views Copied

To create a path, follow these instructions:

1. Click Add in the Local settings group.
2. Enter the name of the path in the Name field.
3. Click the row in the Type column and select the appropriate type of path.
4. Click the row in the Path field to edit the path properties.
5. Click OK to save the changes.

Here are some example paths and data items:

• //managedentity (severity = critical) — creates a list view with all critical managed entities.
• //managedentity (snoozed = false)//cell (severity > 1) — all cells that have a severity of warning or critical that are in a managed entity which is not snoozed.
• //* (snoozed = true) — a list view configured with a single path matches all snoozed items in the system. If you snooze an item, it appears in the list view. If it is unsnoozed, then the system removes it.

Note

Paths are shown in a user readable form. You cannot enter these directly in the field.

Types of path Copied

There are three main types of path that can be configured within a list view:

Filters settings Copied

Filters can be defined in a list view by applying the configured filter on all the data items that are present in the list view.

Note

Filters can only be defined on a list view. These cannot be defined at a dockable level.

By default, the first logic value of the filter is “None”. These are the settings that you can modify:

To add a filter, follow these steps:

1. Click Add in the Filters group. This adds a new row.
2. Click the new row and select the logic value (the Logic displays None if you only have one filter).
3. Select a property on the Property menu.
4. Select or clear the Not check box.
5. Select the appropriate operator on the Operator menu.
6. Enter the value in the Value field.
7. Click OK to save the changes.

You may add more filters as needed.

Drag and drop settings Copied

When you drag and drop a data from the State Tree, Gateways, or Metrics dockable into a list view, the list view’s configured drag and drop rules are applied to it.

The path of the dropped data item is added as a new row on the Content paths settings.

These are the fields that you can modify:

droppeditem()/append(//*[(state("severity")="3")])

sgeneos/gateway[(@name="<data item’s Gateway>")]/directory/probe[(@name="<data item’s
Netprobe>")]//*[(state("severity")="3")]

Apply drag and drop rules Copied

To apply or edit your drag and drop rules:

1. Go to List View settings > Drag and Drop.
2. Select Define Locally on the Inheritance menu. Otherwise, the rules inherit the Dockable level settings.
3. Click Add in the Local settings.
4. Fill out the ID and Display name.
5. Click Edit in the Modifier field to modify the path. To know more about editing a path, see Path editor.
6. Click OK to save the changes.

General visual settings Copied

The General Visual settings allows you to modify the aesthetic properties of the list view.

It contains the following settings:

Details mode settings Copied

The Details Mode allows you to modify the visual settings of the list view:

In the Details mode, the columns at the top are defined by the properties that are configured in the list view.

These can be changed in the following ways:

• Order — columns can be rearrange by pressing the column name, then dragging them to the desired location.
• Changed in width — allows you to manually adjust the column. Alternatively, right-click the column name to select from these options:
  • Set Column Size
  • Auto Resize This Column
  • Auto Resize All Columns
• Hide/Show all hidden columns — right-click the column name to hide the selected data item. The Show all hidden columns option only appears if there is an existing hidden column in the managed entity.

There are two ways of removing columns from the details mode:

• Right-click on the column heading and select Hide This Column. This temporarily removes the column from the details mode, but in the background the value is still present in the list view.
• Use the properties dialog to remove the property from the list view. This completely removes the property from the list view. Removing a column rather than hiding it lowers the CPU and memory footprint of the list view on the machine where it is running on.

The column settings for a list view are persisted in the workspace, and restored on load.

Properties settings Copied

The Properties settings modify the columns or properties present on the list view. Its inheritance settings default value is Inherit from Dockable level settings.

The main setting is formatted into a table form, also known as a matrix. The rows contain the property names and the columns contain the data item names, such as the Gateway and sampler.

The check marks that intersect the row and column, also known as the delta, mean that the property is available to the data item. Blank cells denote the inverse which is the property is not available on that data item. For example:

The following row values represent the following:

• A grey check mark indicates that the property is available, but not selected. Therefore, property does not appear in the view.
• A green check mark indicates that it is available and is selected. Therefore, the property appears in the list view if there is at least one suitable data item type.

The search field on the properties settings window can be used to search a given property or a data item. The table changes depending on the keyword used.

Workspace level list view Copied

The Workspace level list view settings allow the modification of a list view at the dockable level. This means that this is the parent setting that is inherited by all child list views.

To access this setting, go to Tools > Workspace Level List View Settings.

Beginning Active Console 5.5.x, the Managed Entity display name is used in the user readable path.

List view template editor Copied

The Template Editor allows you to create a new icon view mode and modify the Netprobe view mode.

To create a new mode, follow these steps:

1. Go to Tools > Workspace Level List View Settings > Templates.
2. Click Add in the Template Table group.
3. Double-click the new icon in the Preview column. The List View Template Editor appears.
4. Change the size and content of the icon depending on your preference.
5. Drag and drop variables from the toolbar into the container. Only variables within the container appears in the list view.
6. Click OK to save the changes.

There is a default outline in the List View Template Editor that represents a single instance of a data item in a list view configured with your selected mode. This contains the number of data item properties to be displayed for all data items represented by the mode.

The size and shape of each data item the template is used to represent is defined by the boundary. You can also add new properties in the editor.

To add or edit the properties of the data item, follow these steps:

1. Drag and drag any data items in the container.
2. Right-click the selected data item.
3. Click Properties.
4. Go to Layout Variable Settings to modify the properties.

The Layout Variable Settings allows you to modify the following properties:

• Display Label
• Layout Properties
• Text Properties
• Text Alignment

Import and export list views and list view dockables Copied

Individual list views and entire list view dockables can be exported. This can be useful for sharing list view configurations or for creating a backup for each list view.

To export a list view, follow these steps:

1. Right-click the list view.
2. Click Export > Configuration.
3. Enter the file name.
4. Click Save. This gives you an .ltv extension name.

To export a list view dockable, follow these steps:

1. Go to View > Dockable Manager or press CTRL + D.
2. Right-click the list view dockable you want to export.
3. Click Export.
4. Enter the file name.
5. Click Save. This gives you an .ado extension name. Exporting an entire list view dockable includes all the settings at a dockable level and all existing list views (tab) created within the dockable.

To import a list view and list view dockable into your workspace, go to File > Import.

Entities dockable Copied

The Entities dockable is an instance of a list view. It is configured as default in a new workspace.

When following user selection, it displays all the entities relevant to the selected item:

• if a Gateway is selected, it display all the entities connected to that Gateway.
• if a dataview is selected, it displays the entity that is an ancestor to that dataview.

The first tab is also configured to auto-group based on the user selection.

If additional tabs are added, these are configured only to display the entities. When you drag and drop data items into these tabs, the following occur:

• Drop global state, a Gateway, Netprobe, or view path folder — the entities within these items appear in the view. The contents automatically update as these entities change, including the creation of new entities or removal of existing ones.
• Drop an entity — if you drop an entity, you can choose between two outcomes:
  • The entity only appears in the list view if the managed entity is connected to the console (using a Dynamic path).
  • There is always an entry on the tab for the entity, regardless of its connection status (Static).
• Drop a sample, data view or cell — locates the entity that is an ancestor of the selected data item, and add it to the tab.

Status overview Copied

To open the Status Overview, click View > Status Overview. By default, the Status Overview displays these tabs:

• Critical and Warning (Under Selection) — displays all cells with a Warning or Critical severity relative to the selected data item.
• Netprobe Issues — lists all Netprobes that have a connectionState not equal to UP (disconnected Netprobes).
• Sampling Errors — lists all samplers that have a samplingStatus value that is not equal to OK.

Note

Beginning Active Console 5.5.x, the Managed Entity display name is used in the user readable path.

When you click a row in the Critical and Warning (Under Selection), it opens the data item in the Metrics dataview. For example, the first data item on this list, which refers to /data1.percentageUsed:

This displays its managed entity and sampler the Metrics dataview:

Further reading Copied

To know more about paths, user selections, and dropped items, see Path editor.