Technology Preview Code - UI Services
Technology Preview Code is included in the Fix Pack 2 package of UI Services in Jazz for Service Management and is subject to the following terms in the License Information regarding Technology Preview Code.
TECHNOLOGY PREVIEW CODE
Technology Preview Code (TPC) may be included or distributed with the Program or updates to it but are not part of the Program. TPC is licensed under the same terms as the Program, except as provided below. TPC will be identified as such in the Notices File (or in an updated Notices File accompanying the updates). Some or all of the TPC may not be made generally available by IBM as or in a product. Licensee is permitted to use TPC only for internal use for evaluation purposes and not for use in a production environment. The Notices File may limit this evaluation use to an evaluation period. If so, at the end of such evaluation period Licensee must cease using and uninstall the TPC. IBM provides the TPC without obligation of support and "AS IS," WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTY OF TITLE, NON-INFRINGEMENT OR NON-INTERFERENCE AND ANY IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
Licensee may not transfer TPC to another party except as a transfer accompanying the Program. TPC may contain a disabling device that will prevent it from being used after the evaluation period ends. Licensee will not tamper with this disabling device or the TPC. Licensee should take precautions to avoid any loss of data that might result when the TPC can no longer be used.
The Data Visualization Charts feature is provided as UI Services Technology Preview Code (TPC). It is for evaluation only and not supported.
Data Visualization Charts
Data Visualization Charts employ a different paradigm from the existing charting implementation in Dashboard Application Services Hub in relation to displaying data visually.
Restriction: The Data Visualization Charts feature is not suitable for versions of Internet Explorer prior to Internet Explorer Version 9.0.
Enabling the Data Visualization feature
As this feature is currently available only as Technology Preview Code, the feature is disabled by fault in the Jazz for Service Management Fix Pack 2 deliverable.
To enable the Data Visualization feature, do the following:
1. Stop the WAS server
2. Change to the Dashboard Application Services Hub bin directory (<JazzSM>/ui/bin)
3. Execute "consolecli.bat|sh TechPreview --enable true --username <user> --password <password>"
4. Start the WAS server
Once enabled, you can add Data Visualization chart widgets (for example, line and bar charts) to console dashboards from the widget palette.
To differentiate the chart technologies in the console, in the widget palette Data Visualization widgets are named in the following format:
Data Visualization: chart_type, for example a Data Visualization: Clustered Column Chart.
Data visualization charts can subscribe to events published by other widgets and update automatically when such events are published.
Data that is compatible with the Data Visualization charting model can be displayed in many different formats. The following chart types can be rendered in the console:
- Column and clustered column
- Bar and clustered bar
Working with Data Visualization Charts
Adding a Data Visualization Chart to a dashboard
Data Visualization Chart widgets are available from the Widget Palette in the Dashboard Widget catalog. You can click and drag a widget from the palette when you are editing or creating a dashboards.
When you add a Data Visualization Chart, it is pre-populated with sample data. For example, the following figure shows a Data Visualization: Column Chart as it is displayed when it is first placed on a dashboard.
Configuring a Data Visualization Chart
After you add a Data Visualization Chart widget, you must configure its settings so that it can displays the data you require. You can configure the widget in Edit mode.
In the widget menu, click Edit. A configuration page is displayed, where you can search for a data provider.
- Enter a search string and click Search to return a list of data sets that include the specified search string in their name. To return a list of all data sets available to the widget, leave the search field empty and click Search.
Select a data set from the list. A Visualization Settings page is displayed, where you associate columns in your selected data set with your chart. For example, the following figure shows associating the data set's Time column to the chart's X-axis.
Optional - Leave the Group by field set to None and all the columns are displayed in one color, that is, the first color in your selected palette. Alternatively, you can select a column from the Group by field drop-down list to display stacked multicolored columns, with each color representing values for the selected column. For example the following column chart maps CPU usage over time, with usage of each system shown in colored stacks.
Optional - For column charts, you can also choose to plot multiple values on the Y-axis. The example images in this step show how to represent data received and sent over time for the system named beagle, based on the following simple data set (not all values are shown):
Time SystemName Data received (MB/sec) Data sent (MB/sec) 11:05 beagle 5 35 11:05 poodle 17 74 11:10 beagle 12 30 11:10 poodle 25 17
Select a column name from the Y-Axis field drop-down list, for example, Data received (MB/sec).
Click the Add button associated with the Y-Axis field and select a different column name from the second Y-Axis drop-down list, for example, Data sent (MB/sec).
Note: When you add a second Y-Axis value, the Group by field is disabled. Data Visualization Chart widgets do not currently supported stacked column charts for the multiple values.
The resulting chart displays as follows: