Scenario: Creating an IBM Tivoli Monitoring Dashboard
Create a dashboard for Linux® OS monitoring agent to view the disk utilization on a single VM instance and drill-down to the details of a specific disk.
Use case description
As a dashboard designer, by using IBM® Tivoli® Monitoring Data Source, I want to create a dashboard that displays the summary level information of percentage of free disk space available in an instance. By using the Logical Disk Name, I want to drill-down to the details of the logical disk.
Create a dashboard with two widgets, a controller widget that shows disk free percent and logical
disk name, and another listener widget that shows the details of logical disks within the selected
instance. Both the widgets are related by a common metric value,
Metrics usedThe dashboard for this use case displays the following metrics from Window OS monitoring agent:
Logical Disk Name
Dashboard creation tasks
- Access the Dashboard Designer tool.
For more information, see Accessing the IBM Cloud Application Business Insights web interface.
- Configure the connector source for the two widgets that you want to create. For example:
- Create a connector source, ITM_source.
Field Value Connector Type ITM Connector Source Name ITM_source URL http://server_IP_or_HOSTNAME:15200 Managed System Name <managed_system_name>
For more information, see Getting the Managed System Name for ITM Connectors.
Username User name to access the server where IBM Tivoli Monitoring is installed. Password Password to access the server where IBM Tivoli Monitoring is installed.
For more information, see Configuring IBM Tivoli Monitoring Connector Sources.
- Select and use the default 1X2 Layout to create dashboards.
For more information, see Layouts.
- Create a dashboard with one Clustered Columns chart for the controller widget and a Grid chart for the listener widget.
- Set the data definitions in both the widgets by using the following information:
Field Value for Controller widget Value for Listener widget Source ITM_source ITM_source Resource Type Window OS Window OS Metric Group Logical Disk Logical Disk Metric(s)
Logical Disk Name (X-axis)
Server Name (Legend)
% Free (Y-axis)
Logical Disk Name
Instance(s) instance_name instance_name
For more information, see Setting assisted data definitions.
- Specify the name of the controller widget as Disk free percent and the name of the listener widget as Disk details.
- Specify the name of the dashboard as WindowOS_disk_utilization and save.
- Preview the dashboard to make sure that it looks as expected.
- Click the Set Relation
complete the following steps:Set relations between controller and listener widgets as follows:
- Click the Widgets tab and drag the controller widget, Disk free percent widget to the first node.
- Right-click the node and select Add a Listener Widget and drag the Disk details widget to this node.
- On the Disk free percent widget, click the Set Controller Parameters icon.
- In the Default Parameter to be Published pane, specify a parameter name for the Value field. It is the first metric in the widget, which is Logical Disk Name. For example, diskname.
- On the Disk details widget, click the Map Listener Metrics To Controller Parameters icon.
- In the Map Listener Metrics to Controller Parameters pane, map the
metrics between controller and listener for correlation. For
Logical Disk Name = diskname
For more information, see Creating a controller-listener relation.
- Click Save.
- Build a menu and add the dashboards to the menu by using the following tasks:
- From the navigation pane, click .
- Enter the name for the first menu. For example, ITM_Dashboard.
- Right-click ITM_Dashboard and select Add Child.
- Click the Dashboard icon and drag WindowOS_disk_utilization dashboard from the list on the Dashboards tab, which is on the right of the window.
- Click the User Groups tab and assign user groups who can view the dashboards.
- Save and publish the dashboard.
For more information, see Menu Access.
- Access the Engine user interface.
- Go to to view your dashboard.
- To view drill-down relation, click any Logical Disk Name. The Disk details widget displays the details of the selected disk.
- You can use column-filter that is displayed on every column of the grid chart to filter data
For more information, see Viewing widgets and dashboards and performing additional actions.