Chat now with support
Chat with Support

Foglight 7.3.0 - Web Component Guide

Introducing the Web Component Framework The Web Component Framework Configuring Views and Context Queries Functions Bindings Additional Components

System and User Dashboards

In Foglight®, there are two types of dashboards: system and user. System dashboards are preconfigured and delivered with Foglight. User dashboards are created or modified by users. Depending on your permissions, System dashboards may or may not be displayed in the Dashboards page that you see.

Foglight comes with preconfigured views, queries, renderers, tasks, icons, files, types, and units. Users can view and copy these definitions, and with the proper permissions they can change them as well. Alternatively, you can create and modify your own User modules. Similar to System modules, you can view and copy modules created by another user but you cannot modify those definitions.

As mentioned previously, you can copy and make modifications to an existing view, or you can create an entirely new view. The choice depends upon how similar to an existing one the new page must be. These remarks apply to queries as well. It is better to copy and modify a complex query rather than recreating it if only a few changes are required.

See the Web Component Tutorial for instructions on creating new views.

Dashboard Page Navigation

You can select items in the views that refresh the page (drop-down menus or radio buttons) or click links to display pages with more detail. A list of links to previous pages (breadcrumbs) is located at the top of the page. The current page is highlighted in bold. At any time, you can move back using the breadcrumbs.

You navigate around Foglight® dashboards from summary dashboards down to detailed pages (drill-down) and back up the hierarchy. Navigation is controlled through menus, links, drop-down lists, and option buttons.

 
* 
CAUTION: The pages display dynamic data. Therefore, you should use the links, and not the built-in navigation controls of your browser. Using the links refreshes the data on the page.

You can place views on the navigation panel. The contents of the view should be related in some way to navigation. For instance, you might provide a list of items, and each item would load a corresponding view in the console’s main view area. When a page adds a view to the navigation panel it is persisted. Clicking an item in the list reloads the parent page corresponding to the item.

You can place views on the action panel as well. A customizer can be placed here, as well as other views that provide additional information and a legend for the page in the console’s main view area.

Data and Data Sources Pages

The Data node is only visible to users with administrative privileges in Foglight®. On the left side of the page is a navigation tree. Each node represents a Root Query that has been configured to return a data object hierarchy. You can add nodes by configuring a new query and marking it as a UI Query.

The Data page displays some of the available data objects that have been instantiated on the currently running monitored system for which views have been created and for which root queries have been defined. See Queries for more information about the query mechanism.

The Data Sources tab allows you to add or remove multiple data sources. Using the query mechanism, WCF components look for data in the data source to populate the views.

Definitions Pane

The Definitions pane is your workspace for creating, viewing, and editing items in the Web Component Framework.

 
* 
NOTE: If a user is not granted to the Cartridge Developer role, they cannot see the Data or Definitions dashboards.
To open a definition:
 
* 
NOTE: Views may be opened for editing from the Design tab in the action panel.
1
Open Dashboards > Configuration >Definitions in the navigation panel.
2
You can use the Definitions pane to view or edit these components after you have selected them in the Module Contents pane. In the Definitions menu choice, the Module List pane displays the available modules, while the Module Contents pane displays the contents of the selected module. It contains a set of nine tabs, each listing a particular grouping, such as views, queries, or renderers.
3
In the Module Contents pane, open the item whose definition you want to view by selecting it. Alternatively you can create a new view or query. See Configuring Views for information about creating a new view or see Creating a Query in Foglight for information about creating a new query.
The various configuration options are:
 
Table 9. Configuration options in a definition
Option
Description
Views

Views are the Web Component Framework objects that display data. The components that are shown in the Module List pane are those that have been defined for the node you have selected in the Module Contents pane. See the Web Component Reference online help pages.

Queries

Queries allow you to select a set of data objects of the same type. Pages and views extract and use data from the queries for values and context settings. See Queries .

Functions

Function definitions allow you to return data of a declared output type given an expected input.

Files

Upload files such as images to the module’s public directory. See Files .

Icons

Each icon can be a collection of images of different size. See Type Mappings .

Associations

Associations provide a mechanism to organize references into entities. See Associations .

Renderers

Renderers determine how values is displayed. Various renderer types are available for customization. See Renderers .

Type Mappings

Type mappings associate entities such as renderers, icons and flows to a specific data type or data type property. At run-time, the Web Component Framework will look up the entities mapped to these types and properties to use as defaults if more specific entities have not been specified.

The name of the mapping is a combination of the data source name and the data type name. See Type Mappings .

Unit Mappings

Maps the unit of measurement to a data source and a renderer. The name of the mapping is a combination of the data source name and the unit name. See Theme and Module Resources .

Tasks

Tasks are applications external to the Web Component Framework that can be launched from within a view. See Tasks .

4
When a definition opens for one of the items in the module list, view and reconfigure the settings, as required.
Alternatively, create a new definition and configure it using the definition tabs, as required. For more information see, Definitions Pane Settings Tabs .
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating