Matrix > Working with Matrix Visualization

Working with Matrix Visualization

Configure Matrix Visualization

In this section, you can add a new Matrix visualization 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 default screen, select Visualization as vuMatrix to create a Matrix visualization.

Step 5: Select Matrix as your QueryType.

Enter the Query Name, and select the Data Model and the Metrics corresponding to that.

Note: You can only select a single Data Model and the Data Models with one Metric and two buckets can be visualized as a Matrix.

Visualization Options

Panel Options

There are multiple options to edit the properties of the panel. The first one is Panel Options. Enter a Name and Description for the Panel that you want to create.

The Description is available in the top left corner and can be viewed by hovering over the  i  button.

The next part of Panel Options is Panel Link where you can point a link to any other website or dashboard of your choice. Enter a title, and URL and select the ‘Open in a new Tab’ option if you want to open the link in a new tab. Click Save.

The URL can be used to open another dashboard, get support, or any other useful information that is required. 

Let’s say you have a default dashboard that you want to compare, you can always click on the link and open that. 


You can configure the matrix settings in the vuMatrix options. There are ways to set how the matrix will appear visually and in what format it will be displayed.

The vuMatrix options allow you to configure the following:

Show serial number: A toggle button to show/hide the serial number on each matrix row.

Show minimal matrix: A toggle button to show the matrix as a simple 2-dimensional table.

Show percentage bar: A toggle button on set will show an input field to set the Percentage bar unit. Based on the unit, each value in the matrix cell will be converted into a percentage and shown as a progress bar.

Standard Options

The Standard Options are used to configure the other standard settings in the graph. It changes the way the graph appears.

The further options include:

  • Unit type: The type of Unit parameters.
  • Min: Minimum value to be considered.
  • Max: Maximum value to be considered.
  • Decimal: Total digits after the decimal point.
  • Display name: Series name to be displayed.
  • Color scheme: choose a color scheme for the graph.
  • No Value: What to show when there is no value.

Data Links

The Data Links option is similar to the Panel Link where you can link a URL and open it in another tab. It is placed on the data instead of the Panel.

You can click on the data anywhere and the link option will appear.

It is used for an instant link you want to appear anytime you click on the data. 

Value Mappings

The Value Mappings option allows you to find a certain value and wherever the value lies, the display text will be displayed. If there is a similar value in the data, it will be highlighted in the form of the color selected.


The Threshold option is used to define the value threshold. You can set certain thresholds and color-code them.

There are two options to show threshold mode:

  • As absolutes
  • As percentages

For example, the threshold value is set as yellow for 20, blue for 30, orange for 40, and red for 50. You can easily see when the output is above the threshold and immediate action can be taken or an error alert can be sent out. 

Add Field Override

The Add field Override option allows you to override an existing field. 

Overrides allow you to change the settings for one or more fields. Field options for overrides are the same as the field options available in a particular panel. The only difference is that you choose which fields to apply them to.

To add a field override, click on the Add Field Override button.

Select the Field type

Select a field type,  based on the following properties:

  • Name: Set properties for a specific field with a name.
  • Matching Regex: Set properties for fields with name matching a regex.
  • Type: Set properties for a field of a specific type (number, string, boolean).
  • Query: Set properties from the field for a specific query.
  1. Select the Field.
  2. Select the override property.
  3. Configure the override property.

You can add multiple fields overrides by repeating the same.


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

Unveiling our all powerful IBMB Observability ExperienceCenter. Click Here