Working with UTM

Creating UTM

Follow the steps ahead to create UTM Configuration.

Step 1: Log in to the vuSmartMaps.

Step 2: vuSmartMaps UTM can be accessed by navigating from the left navigation menu (Configure Observability > UTM).

Step 3: On the UTMs List Page, click the + icon in the table header to go to the UTM Configuration Page.

The UTM Configuration page will look like this.

Step 4: Make the necessary configurations on the left side and click Preview to apply the changes.

Configuring Graphs

You can visualize the UTM by configuring Data Models. Follow these steps:

Click on + Add Graph under Graphs, enter the graph name, and select the Data Model. You can add multiple Data Models using the + Add Data Model button.

Note: You can create multiple graphs by clicking the + Add Graph button at the bottom of the Graphs section.

If the selected Data Models have supporting data, then UTM will be visualized.

Configuring Nodes and Links

To visualize the UTM, create nodes and links with these steps:

Step 1: Click + Add Node under Nodes, and enter the node name.

Step 2: Choose the Node Type from the dropdown to assign icons to the nodes. The “customnode” type has the default icon.

Step 3: Select the Data Model and metric from the dropdown. Add multiple Data Models with the + Add Data Model button.

Note: You can create multiple nodes by clicking the + Add Node button at the bottom of the Nodes section.

Click Preview at the top to visualize the data.

Next, create Links:

Step 4: Click + Add Link under Links, and enter the link name.

Step 5: Select the From Node and To Node from the dropdown (nodes created earlier). All the nodes which were created in the previous section will be listed in the drop-down here.

Step 6: Choose the Data Model and metric from the dropdown. Add multiple Data Models with the + Add Data Model button.

Note: Multiple links can be created by clicking + Add Link at the bottom of the Links section.

Step 7: Click Save on the top right and provide a unique name for the UTM dashboard (maximum 50 characters).

To change the time range and refresh the data, use the Date Time selector and Refresh button in the top right corner.

Drag and Drop can reposition nodes. Save the updated visualization by clicking Save.

UTM Actions

You can easily perform actions on your UTM configurations on the main page. There are three main actions:

  • View
  • Edit 
  • Delete

View UTM

Click the Name of UTM to view the configurations. All the names are clickable as shown below


Edit UTM

  • Click the Edit button to make changes to your UTM.
  • After making your edits, click Preview to see the new UTM setup.
  • To finalize your changes, click Save.


Now, You can click on Permissions to manage Object Level Permissions in the UTM.

  • Click Permissions to manage who can access and modify the UTM.
  • You can assign three types of permissions for each role:
    • None: No permissions.
    • View: Allows viewing only.
    • Modify: Grants the ability to make changes to the UTM.

Delete UTM

  • Click Delete to remove a selected UTM.
  • Confirm by clicking Yes to proceed with the deletion.

Once your UTM configuration is complete, the next step is to Configure the UTM Visualization panel on the Panel creation page.

Configure UTM Visualization

In this section, you can add a new UTM and configure it. It consists of the following steps.


Before configuring, set the Data Source as “Vunet (provisioned) ”, as Insights can be accessed only through this.

Step 1: Create a Dashboard.


On the Toggle menu, click on the Dashboards tab and Click on New Dashboard.

Step 2: Click on + Add Visualization

Step 3: Select Data Source as Vunet (Provisioned)

Step 4: On the right side of the screen, pick Unified Transaction Map for your UTM panel.

Step 5: Choose Unified Transaction Map as your QueryType.

Now, simply select one of the pre-configured UTM configurations.

Visualization Options 

Panel Options

You have several ways to tweak your panel. Let’s start with Panel Options:

  1. Name and Description: Give your panel a Name and Description. I have taken CPU storage as an example here. The Description appears in the top left corner and can be seen by hovering over the i button.

  2. Panel Link: Create a link to another website or dashboard. Provide a title, and URL, and choose to open it in a new tab if needed. Click Save.

    The URL can lead to another dashboard, offer support, or provide helpful information. If you want to compare with a default dashboard, just click the link to open it.

Unified Transaction Map

In the Unified Transaction Map settings, you can configure how your UTM looks and behaves:

  • Show Link Directions: Toggle to display or hide link directions. Turning it off makes UTM non-directional.
  • Show Node Metrics: Toggle to show or hide the metrics list under the nodes.
  • Show Link Metrics: Toggle to show or hide the metrics list on the links.
  • Show Node Names: Toggle to show or hide the names of the nodes.
  • Node Size: Use the number input field to specify the pixel node size. The default is 30, with a minimum of 15 and a maximum of 100.

Standard Options

In the Standard Options, you can change how the panel looks. Here are the details:

  • Unit Type: Select the type of unit parameters.
  • Minimum Value: Set the minimum value to be considered.
  • Maximum Value: Define the maximum value to be considered.
  • Decimal Places: Specify the total number of digits after the decimal point.
  • Display Name: Choose the name to display for the series.
  • Color Scheme: Pick a color scheme for the graph.
  • No Value Display: Decide what to show when there is no value available.

Data Links

Data Links are like Panel Links, but they’re attached to specific data, not the entire panel.

  • Adding a Data Link: Click anywhere on the data, and the link option will pop up.
  • Instant Access: It’s perfect for quick access links that you want to see whenever you click on the data.

Value Mappings

Value Mappings help you find a specific value in your data and replace it with custom display text. If there are similar values, they’ll stand out with the chosen color.


The Threshold option lets you establish value thresholds and assign colors to them. You have two ways to show thresholds:

  • As Absolutes: Define specific values and their corresponding colors.
  • As Percentages: Assign colors based on percentages. For instance, you can set CPU usage to be green at 0%, blue at 10%, yellow at 20%, red at 30%, and so on. This helps you quickly spot when values exceed thresholds, allowing for immediate action or error alerts.

Add Field Override

The “Add Field Override” option allows you to modify an existing field. Overrides let you tweak settings for specific fields. 

The field options for overrides are just like those for a regular panel, but you choose which fields they apply to. Here’s how:

  • Click Add Field Override.

  • Choose the Field Type based on:
    • Name: Modify properties for a field with a specific name.
    • Matching Regex: Modify properties for fields with names matching a regex pattern.
    • Type: Modify properties for a specific type field (number, string, boolean).
    • Query: Modify properties from the field for a specific query.

  • Select the Field you want to modify.
  • Choose the Override Property you want to adjust.
  • Configure the Override Property according to your needs.

You can add multiple field overrides by repeating these steps.

Dashboard Filters for UTM

You’ve already learned how to create filters for your Dashboard. Now, you can apply these filters to your UTM visualizations. Here’s how:

  1. Open the Dashboard where you’ve created a filter. The filters appear at the top and show the default value you chose earlier.

  2. To use a different variable, simply select it from the list.

    Notice that the filter values are applied, and the Dashboard now shows panels only for those selected values.

  3. You can create additional filters for other values and repeat these steps.


Browse through our resources to learn how you can accelerate digital transformation within your organisation.

Unveiling our all powerful IBMB Observability ExperienceCenter. Click Here