Service dependencies topology view

To view a topology for Kubernetes services with dependencies, click expand in the Service Dependencies widget. The features of the topology view are described here.

Navigation bar

The navigation bar is on the upper left.

Number of hops

Select a number between one and four to define the number of relationship hops to be visualized.

Type of hops

Choose one of the following hop types:

The Element to Element hop type performs the traversal using all element types in the graph.
The Host to Host hop type uses an aggregate traversal across elements with the entity type 'host'.
The Element to Host hop type provides an aggregated hop view like the 'Host to Host' type, but also includes the elements that are used to connect the hosts.

Visualization toolbar

The Visualization toolbar is available on the left. You can manipulate the topology by using a number of visualization tools.

Select tool menu

When you hover over the Select tool icon, a submenu is displayed from which you can choose the Select, Pan, or Zoom Select tool.

Select tool: Use this icon to select individual resources by using a mouse click, or to select groups of resources by creating a selection area by using click-and-drag.
Pan tool: Use this icon to pan across the topology by using click-and-drag on a blank area of the visualization window.

Zoom Select tool: Use this icon to zoom in on an area of the topology by using click-and-drag.

Zoom In

Use this icon to zoom in on the displayed topology.

Zoom Out

Use this icon to zoom out of the displayed topology.

Zoom Fit

Use this icon to fit the entire topology in the current view window.

Overview

Use this icon to create the overview mini map in the lower right corner.

The mini map provides an overview of the entire topology while you zoom in or out of the main topology. The mini map displays a red rectangle to represent the current topology view.

Layout

Use this icon to recalculate, and then render the topology layout again.

You can choose from a number of layout types and orientations.

Layout 1 - Simple topology

A layout that displays all resources in a topology without applying a specific layout structure.

Layout 2 - Circular topology

Use when you want to arrange a number of entities by type in a circular pattern.

Layout 3 - Grouped topology

Use when you have many linked entities, as it helps you visualize the entities to which a number of other entities are linked. This layout helps to identify groups of interconnected entities and the relationships between them.

Layout 4 - Hierarchical topology

Use for topologies that contain hierarchical structures, as it shows how key vertices relate to others with peers in the topology being aligned.

Layout 5 = Peacock topology

Use when you have many interlinked vertices, which group the other linked vertices.

Layout 6 - system board topology

Use when you want to view how the topology relates to a vertex in terms of its rank, and also how vertices are layered relative to one another.

Layout 7 - Rank topology

Use when you want to see how a selected vertex and the vertices that are immediately related to it rank relative to the remainder of the topology (up to the specified number of hops). The root selection is automatic.

For example, vertices with high degrees of connectivity outrank lower degrees of connectivity. This layout ranks the topology automatically around the specified seed vertex.

Layout 8 -Root Rank topology

Similar to a rank topology but it treats the selected vertex as the root. This layout is useful when you want to treat a selected vertex as the root of the tree, with others being ranked below it.

Ranks the topology by using the selected vertex as the root (root selection: Selection)

Layout orientation

For layouts 4, 6, 7 and 8, you can set the following layout orientations:

Top to bottom
Bottom to top
Left to right
Right to left

Configure auto update Refresh Rate

Choose 10s, 30s, 1 m, 5 m. When you hover over the Refresh Rate icon, a submenu is displayed from which you can configure the auto-update refresh rate.

Click pause auto update to pause topology refresh.

This is unavailable if you are in history mode.

Open Filter toolbar

The Filter window is displayed on the right, with a Simple and Advanced tab. Each tab provides you with access to lists of Resource types and Relationship types. Only types relevant to your topology are displayed, for example host, ipaddress or operatingsystem, although you can use the Show all types toggle to view all of them.

Simple tab: Filter out resource or relationship types, all specified types are removed from view, including the seed resource. By default, all types are On. Use the Off toggle to remove specific types from your view. It removes only the resources that match that type, leaving the resources below, or further out from that type, based on topology traversals.

Advanced tab: The Advanced tab performs a server-side topology-based filter action. It removes the resources that match the type, and all resources below that type. However, the seed resource is not removed from view, even if it is of a type that is selected for removal.

Reset or invert all filters: Click Reset to switch all types back on, or click Invert to invert your selection of types filtered.

Hover to highlight: Hover over one of the filtering type options to highlight them in the topology view.

If a filter is applied to a displayed topology, the text 'Filtering applied' is displayed in the status bar at the bottom of the topology.

Open History toolbar

Use this to open and close the Topology History toolbar. The topology is displayed in history mode by default.

The timeline displays changes to a resource's state, properties, and its relationships with other resources. These changes are displayed through color-coded bars and dash lines, and are elaborated on in a tooltip that is displayed when you hover over the change. You can exclude one or more of these from display.

Resource state changes: The timeline displays the state changes for a resource.

Resource property changes: The timeline displays the number of times that resource properties were changed.; Each time that property changes were made is displayed as one property change event regardless of whether one or more properties were changed at the time.
Resource relationship changes: The number of relationships with neighboring resources are displayed, and whether these were changed.; The timeline displays when relationships with other resources were changed, and also whether these changes were the removal or addition of a relationship, or the modification of an existing relationship.

To view changes made during a specific time period, use the two time sliders to set the time period. Use the + and - buttons on the right to zoom in and out to increase or decrease the granularity, or by double-clicking within a timeframe. The most granular level you can display is an interval of 1 second. The granularity is depicted with time indicators and parallel bars, which form 'buckets' that contain the recorded resource change event details.

You can use the time picker, which opens a calendar and clock, to move to a specific second in time.

The history timeline is displayed above a secondary time bar, which displays a larger time segment and indicates how much of it is depicted in the main timeline. You can use the jump buttons to move back and forth along the timeline, or jump to the current time.

To view the timeline for a different resource, click it, and the heading above the timeline changes to display the name of the selected resource. If you click the heading, the topology centers (and zooms into) the selected resource.

When you first display the history timeline, coach marks (or tooltips) are displayed, which contain helpful information about the timeline functions. You can scroll through these, or switch them off (or on again) as required.

While in delta mode you can move both pins to show a comparison between the earliest pin and the latest pin. The timeline shows the historic changes for a single selected resource, which is indicated in the timeline title. You can lock one of the time pins in place to be a reference point.

You use the time pins to control the topology shown. When you move the pins, the topology updates to show the topology representation for that time.

Context-sensitive view on right-click

A context-sensitive menu is available when you right-click on a resource.

Menu (right-click)

Open the menu by using the right-click function. The menu provides access to the following resource-specific actions.

Resource Details

Displays the current stored properties for the specified resource. Both tabular and raw format are available.

Resource Status

If statuses related to a specific resource are available, the resource is marked with an icon. The Resource Status option appears in the resource menu.

Displays the time-stamped statuses that are related to the specified resource in table format. The Severity, Time, and State columns can be sorted. The reference time that is shown is the time Resource Status was selected.

If any status tools are defined, the status tool selector (three dots) is displayed next to the resource status. Click the status tool selector to display a list of any status tools that are defined, and then click the specific tool to run it. Status tools are only displayed for the states that were specified when the tools were defined.

The state of a status is either 'open', 'clear', or 'closed'.

The severity of a status ranges from 'clear' (white tick on a green square) to 'critical' (white cross on a red circle).

Table 1. Severity levels
Icon	Severity
	Clear
	Indeterminate
	Information
	Warning
	Minor
	Major
	Critical

Comments

Displays any comments that are recorded against the resource.

By default, resource comments are displayed by date in ascending order. You can sort them in the following way:

Oldest first
Newest first
User ID (A to Z)
User ID (Z to A)

Users with the inasm_operator role can view comments, but not add any. Users with inasm_editor or inasm_admin roles can also add new comments.

To add a comment, enter text into the New Comment field, and then click Add Comment to save.

Get Neighbors

Opens a menu that displays the resource types of all the neighboring resources. Each resource type lists the number of resources of that type and the maximum severity that is associated with each type.

To expand the topology in controlled, incremental steps, choose to get all neighbors of the selected resource, or only the neighbors of a specific type.

Selecting Get Neighbors overrides any existing filters.

Click the Undo to return to the previous view.

Follow Relationship

Opens a menu that displays all adjacent relationship types.

Each relationship type lists the number of relationships of that type, and the maximum severity that is associated with each type.

You can choose to follow all relationships, or only the neighbors of a specific type.

Show last change in timeline

Displays the history timeline, and shows the most recent change that is made to the resource.

Show first change in timeline

Displays the history timeline, and shows the first change that is made to the resource.

Recenter View

Updates the displayed topology with the specified resource as seed.

Topology Viewer

The topology is the central section of the Service dependency view where you view the resource topology

Resource display conventions: Deleted: A minus icon shows that a resource was deleted since last rendered.; Displayed when a topology is updated, and in the history views.; Added: A purple plus (+) icon shows that a resource was added since last rendered.; Displayed when a topology is updated, and in the history views.; Added (neighbors): A blue asterisk icon shows that a resource was added using the 'get neighbors' function.