Foglight 7.3.0 - Web Component Tutorial


	IMPORTANT: You can set a background image for a report as well. For a report, you can set the background to be a watermark that is repeated on each page.

•

For custom dashboard views that you create yourself, you can configure the popup, dwell, and drilldown behavior so that the user is taken to a view that already exists in your system or to another dashboard or view you have created.

•

Optionally, make a view available for inclusion in other custom dashboards or reports.

Many of the Create Dashboard options are now wizard-driven, similar to the options for creating a report.

Also, you can create your own views based on data in the particular object that is selected.

The Web Component Guide describes how Foglight® organizes the data it collects. These objects (and metrics) are displayed using a special-purpose framework.

•

Creating a Custom Dashboard by Drag and Drop

•

Customizing Dashboards

Creating a Custom Dashboard by Drag and Drop

The standard Foglight® dashboards have been designed to satisfy most monitoring needs, however Foglight is also highly extensible and, if your role allows it, it gives you the capability of designing your own custom dashboards. The simplest method for creating a custom dashboard is to use the Create Dashboard link available on the action panel’s General tab.

To build a dashboard from data elements:

On the action panel, on the General tab, under Other Actions, click Create Dashboard.

The Create Dashboard wizard appears with the Build a Dashboard page open.

Figure 1. Create Dashboard

Choose the type of data input for your dashboard.

In the Create Dashboard wizard, on the Build a Dashboard page, select one of the following options.

•

Use All Data: Select this option to build a dashboard from various data elements, and click Next.

•

Start with a Service: Select this option to build a dashboard from service elements. On the Select a Service page that appears, select the service, and click Next.

•

Create a Custom Dashboard based on the current dashboard: Select this option to build a dashboard from the current dashboard. On the Select Objects page that appears, select the data inputs from the current dashboard that you want to include in the new dashboard, and click Next.

In the Create Dashboard wizard, on the View Properties page that appears, edit the dashboard properties, as required.

Figure 2. Create Dashboard

In the Name box, type the dashboard name.

Specify the dashboard’s Auto Refresh Rate to one of the available options:

•

The default number of seconds set in User Preferences

•

A desired number of seconds

•

Never

Select the default roles to control access to this dashboard. By default, if no dashboard roles are selected, the dashboard is available to all roles.

Relevant Roles control which choices appear in wizards, and Allowed Roles determine which user role is required to grant access to this dashboard.


	TIP: Relevant Roles are used to act as filters, showing the views a user is interested in and not showing the others. If some but not all Relevant Roles are set on a view, then in some situations the GUI may not show that view to a user who does not have that role. Even though the view does not show in, say, a list of dashboards, the user can still access the view if there is a page accessible to the user that has a link to the unlisted view.Allowed Roles act as a security mechanism. If some but not all Allowed Roles are set on a view, then only users for whom at least one of their roles is also an Allowed Role on the view can see or in any way interact with that view.

Click

beside Relevant Role(s) and/or Allowed Role(s) and select the appropriate roles.


	TIP: Leaving the default Allowed Role(s) setting to all grants access to all roles to access the new dashboard.

Figure 3. Allowed and Relevant Roles

Optional—Associate the monitored data with a specific domain.

Note

This information is used as your reference.

Click

beside Related Domains and select a domain in the Select related domain dialog box that appears.

Figure 4. Related Domains


	TIP: The type and range of domains that are available for selection reflects the selection of installed cartridges.

Optional—Associate the monitored data with specific monitoring activities.

Note

This information is used as your reference.

Click

beside Related Activities and select one or more activities in the Select related domain dialog box that appears.

Figure 5. Related Activities

Provide a brief description of the dashboard. If specified, this description appears as a popup when hovering over the dashboard name in the navigation panel.

In the Help box, type the dashboard description.

Add a graphic as a background.

Click

beside Background Image and select a graphic file.

Indicate if you want to make this dashboard to have a portlet purpose, making it available for inclusion in other custom dashboards.

Select or clear the check box Share this dashboard and allow it to be included in other custom dashboards.

Click Next.

The Select Dashboard Layout page appears in the Create Dashboard wizard.

Figure 6. Select Dashboard Layout

Select a desired dashboard layout and click Finish.

The Create Dashboard wizard closes, and the Add View dialog box appears with the Add a Dashboard View Element page open.

Figure 7. Add View

Select the data that you want to use as the input and select an available view style.

On the Add a Dashboard View Element page, in the Input Data area, expand the applicable node and select it in the tree.

For example, if you are building a dashboard from various data elements, and want to add a list of current alarms, choose Alarms > Current Alarms.


	TIP: By default, repetitive and complex properties are hidden from the Input Data area to make the selection of meaningful choices simpler. Selecting show all displays all data objects.

The View Styles area refreshes, reflecting your selection. Only those view templates that can accommodate the selected data type are available for selection.

In the View Styles area, select an available view style.

For example, if you selected Alarms > Current Alarms in the Input Data area, you can select Table View or Select a View Template.

Click Next.

The Add View dialog box refreshes, showing the options that are available based on the selections made in the previous step.

Complete the flow for configuring the view. The type and range of available options depends on the selected data type and the view style.

For example, if you want to want to add a tabular view that lists current alarms, you can select the columns that you want to appear in the table, the column headers, alignment, and renderers, then preview the table, and filter the data.

When completed, click Finish.

The view appears on the newly created dashboard in the display area.

Figure 8. List of Alarms


	IMPORTANT: When you have finished adding views to your dashboard, you do not need to save it. It is automatically available under your working module, which is My Dashboards by default.