Creating custom widgets to list all instances

For Telco Network Cloud Manager - Performance data sources, by using a Grid chart, you create a custom widget that lists all the instances for a selected source and resource type. You can add this widget as a master widget in a master-listener or a drill-down relation to drill down to other widgets that display data for the selected instances. You cannot add this widget as a listener widget or a drill-down widget. You must add this widget as a master widget only.

Before you begin

  • Ensure that the data sources for which you want to list the instances are already added.
  • If you want to set a background image for the widget, then ensure that the image is already available on your computer.

About this task

After you log in to the Dashboard Designer, you can create custom widgets by using any of the following options on the landing page:

  • Click CREATE COMPONENTS, then in the Create Components page, click WIDGETS.
  • Click the Expand Expand icon to open the left navigation pane of Dashboard Designer, and click Custom Widgets > Create New Widget.
Note: You cannot change the chart type from Grid to any other chart. Also, you cannot save this widget as a template widget nor can you add multiple data sources to this widget.

Procedure

Complete the following steps to create an instances custom widget:

  1. In the left navigation pane of Dashboard Designer, click Custom Widgets > Create New Widget.

    The New Widget page opens.

  2. Click the Edit Edit icon that is displayed next to the New Widget, Widget Description, and Widget Title fields, and enter a name, title, and description for your widget.
    Note: Only alphanumeric characters, spaces, and underscore are supported.
  3. The Show Gridlines checkbox is selected by default.
    If you do not want the grid-line view, clear the checkbox.
  4. In the left navigation pane, click Charts > Other Charts, and drag a Grid chart to the widget.
  5. Click Set Data Definition icon.
  6. In the Set Data Definition window, click Create a Data Definition, and then click Continue.
  7. From the Connector Type list, select Telco Network Cloud Manager - Performance Connector.
  8. In the Data Definition with pane, click All Instances, and complete the following steps:
    1. From the SOURCE list, select a data source.
    2. From the RESOURCE TYPE list, select a monitoring agent.
  9. Click the Save Save icon.
  10. Optional: To clear the selections, click the Clear Clear icon.
  11. Optional: To modify the selection, click the Edit Edit icon.
  12. Click Set Properties icon to set the widget and chart properties.
    For more information about setting widget and chart properties, see the following topics:
  13. Optional: To add a background image to the widget, complete the following steps:
    1. Click Background Image icon that is displayed on the upper-right of the widget.
    2. In the Background Image pop-up window, click Add Background Image, and then click Select from File.
    3. Browse to the image file location on your computer, select the file, and then click Open.
      Note: You can add PNG, JPEG, JPG, or GIF image files of size less than or equal to 2 MB.

      The selected image is added as a background image to the widget. To replace the image, repeat the steps, and select another image. To delete the image, click No Background Image.

  14. To save the widget as a custom widget, click Save, and complete the following steps in the Save Widget window:
    1. In the Name field, enter a name for the widget.
    2. To save the widget to an existing category, click Existing category, select a category name from the drop-down list, and then click Save.
    3. To save the widget to a new category, click New Category, enter a category name, and then click Save.
  15. To save the widget with another name, click the Save As option, and in the Save As Widget window, enter the required details.

Results

The newly created custom widget is listed under Most Recently Created Widgets in the navigation pane.

What to do next

You can complete any of the following tasks:
  • Publish the custom widgets.

    For more information, see Publishing custom widgets.

  • Use the custom widgets in a dashboard and set master-listener or drill-down relation to view data of individual instances.

    For more information, see Creating a dashboard.