How to use new WCF components

The Foglight Management Server (hereafter referred to as FMS) 5.9.2 and Foglight for Virtualization (FVE) 8.7.5 introduce three new WCF components to show collected metrics in a variety of ways. For better understanding on these components, we also build up a Community cartridge to include some demonstrations. Please go to https://github.com/Foglight/WCF-Demo/tree/master/Packaged%20Cartridges to download this Community cartridge.

This blog briefly introduces the purpose of these three new components and guides you through the procedure of creating a new dashboard with these components. For more information, see the following topics:

 

 

Downloading and installing this community cartridge

Download this cartridge from GitHub, and then install this cartridge from the Administration > Cartridges > Cartridge Inventory dashboard. Once the cartridge is installed, you may see the following three menus under Homes. When using this cartridge to know how these new components work, you are encouraged to change the topology type, virtual center or metrics, as needed.

 NOTE: All demos included in this cartridges are generated based upon VMware data. Before using this cartridge:

    • Ensure that one or more vCenters have been monitored by the VMware Performance agent at first.
    • Make sure to enable the preview functionality. Refer to Enabling the technical functionality for more information.
  • Map Topology With Circle Style: Click this menu to show the Map Topology With Circle Style dashboard. With this component, the FMS shows the geographical location and usage information of the selected topology objects in a world map.
  • Scatter - View Selection Grid Layout: Click this menu to show the Scatter - View Selection Grid Layout dashboard. Dots on the chart will be refreshed automatically when you change the value for either of the following values: Topology Type, Selected vCenter, X Axis, and Y Axis. Select and dwell on a single dot are supported. Also press the Ctrl key or draw a rectangle to select multiple dots.
  • Tree Map With Datastore Available: Click this menu to show the Tree Map with Datastore Space Data dashboard. Select and dwell on a block are supported.

Enabling the technical functionality

Except for the Map Topology component, both Scatter Chart and Tree Map Chart components are still under the Alpha stage for now. Follow the procedure below to enable the preview functionality:

1. Select Dashboards > Configuration > User Preferences, and then select the Enable preview functionality option under the Advanced section.

2. Click Save.

 

Creating dashboards using new components

After enabling the preview functionality, you can create dashboards using these components from the Dashboards > Configuration > Definitions dashboard.

We strongly recommends that you set up your own working module before creating your dashboards. To set up your working module:

  1. On the Dashboards > Configuration > Definitions dashboard, scroll down to the bottom of the Definitions list, and then click the Add button .
    The New Module dialog box appears.
  2. In the New Module dialog box, specify the Name of your working module, and then click OK.
    The Definitions list refreshes automatically, showing your newly created module.

     

How to create a simple dashboard using the 'Tree Map Chart' component

1. On the Dashboards > Configuration > Definitions dashboard, select your working module from the Definitions list, and then click the Add button next to Types, and then the Add Type dialog box appears.

2. In the Add Type dialog box, specify the Name to be used as an input parameter of the view, and then click OK.

 NOTE: Ensure the Name value does not include spaces and the value of Super Type remains the default Data Object.

3. In the prompted dialog box, click  to add id, name, and count properties.

 

4. Click the Add button  next to Functions, and then the Add Function dialog box appears.

5. In the Add Function dialog box, select Script as the function type, and then click OK.

6. In the prompted dialog box, specify the Name of function, input the function scripts as needed, and then click Save.

7. Click the Add button next to Views. The Add View dialog box appears.

8. In the Add View dialog box, select Tree Map Chart under the Alpha (unstable) list, and then click OK. The New View dialog box appears on the right of the dashboard.

9. In the New View > General dialog box, specify the value for Name and ID, select Home Page from the Purpose(s) drop-down list, select Dashboard User from the Relevant Role(s) drop-down list.

10. Select Configuration in the view that is created in step 9. In the Configuration tab, bind the Object Root to the function that is created in step 6, and then bind the Data Type, ID, Display label, and Display number to the type that is created in step 3, and then click Save.

 

11. Click Save. Then the new view, namely Simple Tree Map Demo, has been added under Homes.

 

 

How to create a simple dashboard using the 'Scatter Chart' component

1. On the Dashboards > Configuration > Definitions dashboard, select your working module from the Definitions list, and then click the Add button next to Types, and then the Add Type dialog box appears.

2. In the Add Type dialog box, specify the Name to be used as an input parameter of the view, and then click OK

 NOTE: Ensure the Name value does not include spaces and the value of Super Type remains the default Data Object

3. In the prompted dialog box, click to add x and y properties.

 

4. Click the Add button next to Functions, and then the Add Function dialog box appears.

5. In the Add Function dialog box, select Script as the function type, and then click OK.

6. In the prompted dialog box, specify the Name of function, input the function scripts as needed, and then click Save. The random number is used as the X and Y value in the scripts below.

7. Click the Add button next to Views. The Add View dialog box appears.

8. In the Add View dialog box, select Scatter Chart under the Alpha (unstable) list, and then click OK. The New View dialog box appears on the right of the dashboard.

9. In the New View > General dialog box, specify the value for Name and ID, select Home Page from the Purpose(s) drop-down list, select Dashboard User from the Relevant Role(s) drop-down list.

 

10. Select Configuration in the view that is created in step 9. In the Configuration tab, bind the Nodes to the function that is created in step 6, and then bind the X Value and Y Value to the type that is created in step 3, and then click Save.

  

11. Click Save. Then the new view, namely Simple Scatter Chart Demo, has been added under Homes.

 

How to create a simple dashboard using the 'Map Topology' component

1. On the Dashboards > Configuration > Definitions dashboard, select your working module from the Definitions list, and then click the Add button next to Types, and then the Add Type dialog box appears.

2. In the Add Type dialog box, specify the Name to be used as an input parameter of the view, and then click OK.

 NOTE: Ensure the Name value does not include spaces. Make sure to change the value of Super Type to GPS Geo Location, as the 'GPS Geo Location' Super Type includes two properties latitude and longitude.

3. In the prompted dialog box, click to add the value property.

 

4. Click the Add button next to Associations, select Map Node in the Add Association dialog box, and then click OK. This association is used to define the location, appearance, and characteristics of nodes in a map topology component.

5. In the Add Association > Context dialog box, click to add the currentNode property, and then bind its Data Type to the type created in step 6.

6. In the Add Association > Configuration dialog box, bind the Location to currentNode created in step 8, bind the Value to the type that is created in step 6, and then click Save.

7. Click the Add button next to Functions, and then the Add Function dialog box appears.

8. In the Add Function dialog box, select Script as the function type, and then click OK.

9. In the prompted dialog box, specify the Name of function, input the function scripts as needed, and then click Save. Random numbers are used to populate latitude, longitude, and value properties in scripts.

   

10. Click the Add button next to Views. The Add View dialog box appears.

11. In the Add View dialog box, select Map Topology under Topology list, and then click OK. The New View dialog box appears on the right of the dashboard.

12. In the New View > General dialog box, specify the value for Name and ID, select Home Page from the Purpose(s) drop-down list, select Dashboard User from the Relevant Role(s) drop-down list.

 

13. Select Configuration in the view that is created in step 12. In the Configuration tab, bind the Nodes to the function that is created in step 9, and then bind the Tags to the Map Node association that is created in step 6, and then click Save.

 

14. Click Save. Then the new view, namely Simple Map Topology Demo, has been added under Homes.

 

Anonymous