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, Logical Disk Name.

Metrics used

The dashboard for this use case displays the following metrics from Window OS monitoring agent:
  • % Free
  • Logical Disk Name
  • Server Name
  • Total Size
  • Free Megabytes
  • % Used

Dashboard creation tasks

  1. Access the Dashboard Designer tool.

    For more information, see Accessing the IBM Cloud Application Business Insights web interface.

  2. Configure the connector source for the two widgets that you want to create.
    For example:
    1. Create a connector source, ITM_source.
    Use the following information to create the ITM connector 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.

  3. Select and use the default 1X2 Layout to create dashboards.

    For more information, see Layouts.

  4. Create a dashboard with one Clustered Columns chart for the controller widget and a Grid chart for the listener widget.
  5. 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

    Logical Disk Name (X-axis)
    Server Name (Legend)
    % Free (Y-axis)

    Logical Disk Name
    Server Name
    % Used
    Free Megabytes
    Total Size
    Instance(s) instance_name instance_name

    For more information, see Setting assisted data definitions.

  6. Specify the name of the controller widget as Disk free percent and the name of the listener widget as Disk details.
  7. Specify the name of the dashboard as WindowOS_disk_utilization and save.
  8. Preview the dashboard to make sure that it looks as expected.
  9. Click the Set Relation Set Relation icon icon and complete the following steps:
    Set relations between controller and listener widgets as follows:
    1. Click the Widgets tab and drag the controller widget, Disk free percent widget to the first node.
    2. Right-click the node and select Add a Listener Widget and drag the Disk details widget to this node.
    3. On the Disk free percent widget, click the Set Controller Parameters Set Master Parameters icon.
    4. 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.
    5. On the Disk details widget, click the Map Listener Metrics To Controller Parameters Map Listener Metrics To Controller Parameters icon.
    6. In the Map Listener Metrics to Controller Parameters pane, map the metrics between controller and listener for correlation. For example:
      Logical Disk Name = diskname

      For more information, see Creating a controller-listener relation.

    7. Click Save.
  10. Build a menu and add the dashboards to the menu by using the following tasks:
    1. From the navigation pane, click Menu Access > Create New Menu.
    2. Enter the name for the first menu. For example, ITM_Dashboard.
    3. Right-click ITM_Dashboard and select Add Child.
    4. Click the Dashboard dashboard icon icon and drag WindowOS_disk_utilization dashboard from the list on the Dashboards tab, which is on the right of the window.
    5. Click the User Groups tab and assign user groups who can view the dashboards.
    6. Save and publish the dashboard.

    For more information, see Menu Access.

  11. Access the Engine user interface.
  12. Go to ITM_Dashboard > WindowOS_disk_utilization to view your dashboard.
  13. To view drill-down relation, click any Logical Disk Name. The Disk details widget displays the details of the selected disk.
  14. You can use column-filter Filter icon that is displayed on every column of the grid chart to filter data column-wise.

    For more information, see Viewing widgets and dashboards and performing additional actions.