Working with Dashboards. Dell Vizioncore

Add to My manuals
235 Pages

advertisement

Working with Dashboards. Dell Vizioncore | Manualzz

3

Working with Dashboards

This section describes how to work with vFoglight dashboards, and provides a description of the common elements that are found on most dashboards.

Note For information about the options in the Administration module, see the Administration and

Configuration Guide .

For information about the Definitions dashboard, see the Web Component Guide .

For information about cartridge dashboards, such as the dashboards for the Cartridge for

Operating Systems, see the User Guides for those cartridges.

This chapter contains the following sections:

Introduction to Dashboards .........................................................................................................50

Common Views ...........................................................................................................................58

Creating a Custom Dashboard ....................................................................................................76

Viewing Dashboard Properties ....................................................................................................89

Working With Tables ....................................................................................................................91

Printing Views ..............................................................................................................................92

50 vFoglight

User Guide

Introduction to Dashboards

vFoglight displays monitoring data in views that group, format, and display it.

Dashboards are top-level views that do not need to receive data from other views.

Dashboards usually contain a number of lower-level views. The dashboards supplied with vFoglight, as well as those created by users, are available in the navigation panel.

Lower-level views in vFoglight can be added to dashboards or can be accessed by drilling down from a dashboard. They receive and display data directly from the vFoglight Management Server or from other views. Some views filter or select data that appears in other views in the same dashboard. Some are tree views with expandable nodes for selecting servers, applications, or data.

Display Functions

vFoglight provides various ways in which you can modify a view or display the data in a different format. For example, you can select metrics, select a data object to update a view, or change the time range. These functions are available as drop-down lists or table filters, in dialogs, or through menus.

This section describes the following functions that you can use to modify a view:

“ Tooltips, Dwells, and Popups ” on page 50

“ Time Range ” on page 51

“ Splitter ” on page 56

“ Columns ” on page 56

“ Drop-Down Lists and Trees ” on page 56

Tooltips, Dwells, and Popups

Different types of smaller views provide additional detail about an element in a view.

Examples of these views are:

• A tooltip element describes what it represents when you hold the cursor over a status icon. Tooltips also appear when you hold the cursor over a line in a chart.

• A dwell displays additional information about the item when you hold your cursor over a line in a table.

• A popup displays additional information and options if you click a line in a table.

Working with Dashboards

Introduction to Dashboards

51

Tooltips and dwells disappear when you move the mouse, but a popup remains open until you close it by clicking outside it or clicking the close icon in the corner. You can also maximize some popups by clicking the maximize icon in the upper right corner.

Figure 1

Time Range

The time range at the top of a dashboard indicates the current time range for all the views on the page. If some of the views have independent time ranges, the time range is not displayed.

By default, the time range in a dashboard is displayed in real time. You can “freeze” the time range so that the views are fixed at a certain range. This is helpful for diagnostic purposes when you do not want to receive new data. For further details, refer to

“ Freezing a time range ” on page 52.

Changing the time range in a dashboard affects all the views in the dashboard. If an individual view in a dashboard has a different time range, that takes precedence over the time range for the dashboard.

Clicking the time range opens a menu where you can select another time range or select

Custom to specify a range.

Standard Time Ranges

The time range menu lists the standard ranges. When you select one of these options, all the views in the dashboard are automatically updated, unless they were created with a time range other than the global one.

Custom Time Ranges

To set a specific time range, you select Custom from the time range menu to open the

Custom Time Range dialog. Initially, only the Zonar is displayed. Clicking the down-

52 vFoglight

User Guide arrow beside Precision Control expands the dialog to display the Precision Control options. Clicking the browse button to the right of the date fields displays the calendars.

Figure 2

The Precision Control section contains the following settings:

From and To date and time fields (see page 55

)

• Earliest Available and Current Date check boxes (see

page 55 )

Calendars (see page 55

)

Granularity options (see page 55 )

Except for granularity, changing any of these settings automatically updates the views.

The time range for a summary view is likely to be different from the time range for a detail view. Therefore, the time range that you select affects only the current view and drill-downs from it; it does not affect higher-level views.

Freezing a time range

By default, the time range on a dashboard is displayed in real time. You can tell this ata-glance if the word Now is shown in the time range display.

Image 3

Working with Dashboards

Introduction to Dashboards

53

You can disconnect from real time and “freeze” a dashboard at a specified time range.

When this occurs, the views on the dashboard will not receive any new data.

To freeze a time range:

1

2

Select the dashboard for which you want to freeze the time range.

Click the icon to the left of the displayed time range at the top right of the dashboard.

Tip When you hover over the icon a popup indicates if the time range is real time or frozen:

The time range is set and the icon changes to .

Hover over the icon to display the message: Time range is in the past, click to switch to real time .

3 If you later refresh a dashboard, you may notice that the time range remains fixed even though the time that is displayed in the Zonar changes. For example, in the screen shot below, the time range ends at 9:50 while the current time is 10:12.

To unfreeze a time range:

• Click the icon.

The time range changes to end at the last monitoring time range that you used (for example, the last four hours).

Diagnostic Time Range

In vFoglight versions 3.0, if you drilled down the path for an old alarm, all of the drilldowns applied to the current time, not the time that the alarm occurred. In versions

3.0.1 (or later), the time-sync function called the diagnostic time range was added to drill-downs.

The diagnostic time range shows a 4 hour window, where the alarm time range is placed

3 hours into the window (e.g. 3 hours prior and one hour past the alarm). The diagnostic time range stays frozen until you unfreeze (toggle) the time range.

54 vFoglight

User Guide

The diagnostic time range function works as follows:

• For any alarm that is not in the current time range, if you click on a drill down, places you into a diagnostic time range.

• Some drill-downs indicate that you are in diagnostic time range as shown in the dialog box below.

Note The diagnostic time range function is not available for all drill-downs.

Zonar

At the top of the dialog is a sliding bar called the Zonar. When you place your mouse over the bar, a popup displays the current date, time, and time range.

Figure 4

Click in the middle of the range to drag the Zonar to the left or the right. The start and end times of the range changes, but keeps the same time period. You can increase or decrease the time period by dragging the sides of the range. As you drag, the popup displays the new range.

As you drag the edges of the range, the Zonar scale automatically adjusts, increasing or decreasing the units of time. For example, in the above screen shot, the time range is four hours. If you drag the left edge of the range as far as you can, the range increases by about eight hours. When you stop dragging, the scale automatically adjusts and you can then drag the edge further.

If you drag the right edge of the range when the time range is in real time (the word Now is shown in the time range display), the range will persist for the duration (for example,

4.5 hours) and not to the specific date/time to which it was set.

Working with Dashboards

Introduction to Dashboards

55

Precision Control

The Precision Control section is collapsed when the dialog opens. To display it, click the down arrow to the right of Precision Control .

Date and Time Fields

Type specific dates and times for the range. If you enter an incorrect date or time, a red exclamation mark is displayed at the right of the field and you cannot apply the changes.

You can also use the Earliest Available or Current Date check box to set the time range.

Calendars

If you prefer to use a calendar to select dates, click the browse button to the right of the date and time fields to display start-date and end-date calendars.

Granularity

Granularity controls the size of the metric intervals. The default option is Raw, which displays the actual collected data points. The Auto option uses intervals that are sized according to the time range. For example, a one-hour range has five-minute intervals, while a one-week range has one-hour intervals. If you choose an option other than the default, click Apply to update the views.

Caution If you set too large an interval, there may not be enough points to plot on a chart. For example, if you only have one day of data, an interval of six months will result in a single point. If an interval is too small, there may be too many data points to display if the chart is small.

The maximum and minimum values of a metric are actual numbers, while data points inside an interval are averaged. Agents may report their data at uneven intervals. vFoglight sets the data to be plotted in evenly-spaced intervals using data collected from any number of agents.

To do this, the data points inside the interval are averaged. This has the effect of evening out the maximum and minimum values if an interval contains more than one real data point. The maximum and minimum values of a metric are based on real data and not an averaged value. These values are often plotted as markers on the chart. Therefore the averaged values on the plotted curve or bar may not match the real values of the markers.

56 vFoglight

User Guide

Splitter

Composite views may have a moveable bar, or splitter, between the two views. It can be either horizontal or vertical. You can move it back and forth to resize the views on either side.

Figure 5

The splitter has two arrows facing in opposite directions. When you click an arrow, the view it is facing collapses, the splitter moves to the edge of the remaining view, and only the other arrow is visible. You can restore the hidden view by clicking the other arrow.

Columns

When you are creating a custom dashboard or report, you can choose one of the options under Columns under the General tab in the action panel to divide the display area into one, two, or three columns.

Figure 6

Drop-Down Lists and Trees

Drop-down lists are views that change the context of other views, such as those in the same container view. When you select an item from a drop-down list, the view is refreshed with new data. For example, a view may contain a drop-down list of metrics, a chart, and a table. Selecting a different metric changes the context of the page, and the chart and table are updated accordingly.

A drop-down list displays a list of single options. A tree expands to display a hierarchy of options. They have the same effect on the context.

Working with Dashboards

Introduction to Dashboards

57

Customizer

The Customizer icon is available for charts and tables.

Note To access the customizer it needs to be enabled. Customizers are not enabled by default.

If the Customizer icon is enabled you can:

Change the chart type dynamically. See “ Changing the Chart Type ” on page 81.

• Export charts and tables to PDF or CSV format. See

Exporting Data from Charts and Tables .

Exporting Data from Charts and Tables

The option to export data to CSV and PDF format is available for charts and tables.

For example, you can create new graphs using drag and drop metrics onto a dashboard, and then export the data to CSV output. Therefore, you can create multiple metrics, set a time range, export to CSV, and then open the data in Excel.

To export charts to CSV or PDF format:

1

2

1 Navigate to the chart or table you want to export.

Click the Customizer icon in the top right hand corner of the table or chart.

Choose either Export as CSV or Export as PDF .

3 If you chose Export as CSV , choose if you want to open or save the file.

58 vFoglight

User Guide

Common Views

vFoglight makes use of common views in most of the standard dashboards. Using common views in pre-declared dashboards is an effective way to enable and create easy workflows. Examples of views used in most of the dashboards include the Alarm list display and the Host summary display.

Alarm List

When a list of alarms is shown, the same alarm list view appears as a popup or fixed path depending on the navigation path.

Figure 7

The Alarm list view displays a summary of alarms by severity level at the top. The counts in the title are for outstanding alarms. The Outstanding Alarms view shows

Ack’ed and Cleared columns containing a Y (Yes) or N (No) to indicate the

Acknowledgement status. While the Alarms list also shows cleared alarms, the cleared alarms are not included in the count for outstanding alarms. Cleared alarms appears dimmed out. Cleared alarms can be filtered out. You can also apply a filter to the alarm

list using other criteria, as described in “ Filtering the Alarms View ” on page 62.

Managing Alarms

You can select an individual alarm and once selected, choose to take action on the alarm that has been fired such as Acknowledge or Clear . For further information, refer to

either “ Acknowledging an Alarm

” on page 63 or “ Clearing an Alarm ” on page 65.

The Alarm list view allows you to choose from four different perspectives on alarms:

Current Alarm(s)

Error Instance(s)

Related Host(s)

Working with Dashboards

Common Views

59

Related Agent(s)

Current Alarm(s)

By default, you see the list of alarms with the ability to sort the alarms by different elements (Severity, Time, Ack’ed, Cleared, Host, Instance, Message, Origin, Agent,

Agent Type).

Error Instance(s)

The Error Instances option lists the agents containing data that triggered an alarm in the

Outstanding Alarms table. For each error instance triggered, it indicates its state of health, number of each type of alarm, and its health history.

In the example shown below, the alarms are grouped according to their source (Long

Name).

Figure 8

Drilldowns

The following drilldowns are available from the Alarm Source(s) table.

Select

Long Name

Health icon

Alarms

To

see the “ Instance ” on page 66.

If you select an agent, you also are notified if the agent is running and the overall health state of the agent (Broken or

OK ). see links to:

• health of all alarm sources

• health of current alarm source

• all outstanding alarms for that alarm source see a list of alarms for that alarm source

60 vFoglight

User Guide

Select

Health History

To

Hover over the Health History bar to see the percentage and duration of time that the alarm source was at a certain severity level.

Related Host(s)

A convenient way to isolate issues related to systems is to show the alarms organized by the originating host. You can expand each host to see the source of the alarm. In the example below, all alarms are coming from a single host instance.

Figure 9

Drilldowns

The following drilldowns are available from the Related Host(s) table.

Select

Long Name

Health icon

Alarms

To

see the “ Instance ” on page 66.

If you select a host, the

Host Summary

as described on

page 74 is displayed.

If you select an agent, you also see if the agent is running and the overall health state of the agent (Broken or OK). see links to:

• health of all alarm sources

• health of current alarm source

• all outstanding alarms for that alarm source see a list of alarms for that alarm source

Hover over the Health History bar to see the percentage and duration of time that the alarm source was at a certain severity level.

Working with Dashboards

Common Views

61

Related Agent(s)

A useful way to understand which agent is causing an alarm to fire is to show alarms organized by the agent that collected the data. You can expand each agent node to see where the agent is gathering data.

The example below shows that the Application Monitor agent is firing fatal alarms and critical alarms are coming from the Windows System agent.

Figure 10

Drilldowns

The following drilldowns are available from the Related Agent(s) table.

Select

Long Name

Health icon

Alarms

To

see the “ Instance ” on page 66.

If you select an agent, you also are notified if the agent is running and the overall health state of the agent (Broken or

OK). see links to:

• health of all alarm sources

• health of current alarm source

• all outstanding alarms for that alarm source see a list of alarms for that alarm source

Hover over the Health History bar to see the percentage and duration of time that the alarm source was at a certain severity level.

62 vFoglight

User Guide

Filtering the Alarms View

You can filter the list in the Outstanding Alarms view using one or more of the following criteria:

• Severity (Undefined, Normal, Fire, Warning, Critical, Fatal)

• Time (range, earliest available, current date)

• Is Acknowledged (true or false)

• Is Cleared (true or false)

• Host name

• Instance

• Message

• Origin (source of an alarm)

• Whether or not the alarm has been acknowledged (True or False)

• Agent name

• Agent type

To filter the alarm list:

1 Click Alarm Filter Not Set in the title bar of the view. (If a filter has already been set, the link will say Alarm Filter Applied .). The Alarm Filter Not Set/

Applied dialog opens.

Working with Dashboards

Common Views

63

2 Select or enter your filter criteria. If you want to use a calendar to choose a date or date range, click the browse button to display two calendars. The dates that you choose in the calendars appear above in the From and To fields.

3

4

If applicable, select the Use Regex checkbox to search for a regular expression

(regex). Regex is a special text string that describes a search pattern using wildcards. For example: .*\.txt$

Click Find .

The table refreshes to display the filtered alarm data.

Hiding Columns in the Alarms View

You can hide any of the columns in the Outstanding Alarms view.

To hide columns:

1 Click the edit icon ( ) above the table.

A popup displays a list of the columns in the table.

2 De-select the columns that you want to hide and click Apply .

The de-selected columns are removed from the table.

Acknowledging an Alarm

The Ack’ed and Cleared columns in the Outstanding Alarms view indicates if an alarm has been acknowledged. If an alarm has not yet been acknowledged, the column displays N. When you acknowledge an alarm, the column appears with a Y. The name of the person who acknowledged it is also indicated. This information is also stored in

an audit report. You also have the option of adding a note (see “ Alarm Notes ” on page 70) to indicate an alarm has been acknowledged.

To acknowledge an alarm:

1

2

In the Alarms view, select the alarm(s) in the alarm table that you want to acknowledge.

To acknowledge the alarm from the Outstanding Alarms list, click Acknowledge at the top of the table:

64 vFoglight

User Guide

The Alarm status in the Ack’ed column changes to Y to indicate the alarm has been acknowledged. If you hover over the Y, your user name appears in the By user column for that alarm.

Note Alternatively, you can acknowledge an alarm using the Alarm Details dialog box.

a In the Outstanding alarms view, click N beside the alarm that you want to acknowledge.

The Alarm Details dialog box appears.

Working with Dashboards

Common Views

65 b Click Acknowledge .

Your user name appears in the Ack’ed column for that alarm. The Alarm status in the Ack’ed column changes to Y to indicate the alarm has been acknowledged.

If you want to acknowledges the current alarm and all consecutive alarms fired by the same rule on the same instance, click Acknowledge Until Normal . This option is available to an outstanding (not-yet-cleared) alarm only.

You can also apply a note to alarm. See “ Alarm Notes ” on page 70.

Clearing an Alarm

The Alarms table list all alarms including cleared alarms in a given time range. Cleared alarms are shown by default. You can filter out cleared alarms using the alarm filter. See

“ Filtering the Alarms View ” on page 62.

As a visual cue, cleared alarms appear dimmed out. This applies to all alarms that are

cleared regardless of the time range. You can add a new note (see “ Alarm Notes ” on

page 70) or acknowledge an alarm (see “ Acknowledging an Alarm ” on page 63), even

though it is cleared. The Cleared column in the Outstanding Alarms view indicates the status on whether a cleared alarm was not acknowledged (N) or the cleared alarm has been acknowledged (Y).

If the same condition that caused the alarm to fire occurs again in the next sampling interval, the alarm will reappear in this table.

To clear an alarm:

1 In the Outstanding Alarms view, click the check box beside the alarm that you want to clear.

66 vFoglight

User Guide

2 Click Clear above the table.

The Alarm Status in the Cleared column changes to indicate the alarm has been cleared and the cleared alarm is dimmed out. The alarm is removed from the count for outstanding alarms.

Alternatively, you can clear an alarm from the Alarms Details dialog box.

Instance

When you select the instance of the alarm (e.g. in the Alarm list when looking at a list of

Outstanding alarms, or when looking at alarms grouped by Alarm source), a common health summary for the data that triggered the alarm appears:

Working with Dashboards

Common Views

67

Figure 11

The health summary:

• shows the number of alarms by severity and the overall health of the selected alarm source.

• provides links to the agents and host for the alarm source.

• provides a list of related views that show quick drilldowns to help identify the root cause. This list is based on the views that match the type of the alarm source.

The related views are often provided by cartridges. If no related views are available, then the default views (e.g. Data Browser, Summary) are provided.

Alarm Details

The Alarm Details summary is shown when an alarm message, severity icon, alarm time, or agent type is selected.

You can check alarm details to view more information about an alarm in the alarms table. For example, if you are concerned about a particular alarm, click the alarm severity in the alarms table to view the alarm details. On the alarm details dialog box you can view the table that illustrates how the alarm has changed state in the current time range.

The Alarm Details dialog box shows alarms related to the current alarm in the given time range, acknowledgement information of these alarms (such as whether an alarm has been acknowledged or is not acknowledged), clearing information of these alarms, and any alarm notes added to these alarms.

68 vFoglight

User Guide

The alarm details view also shows the full alarm history. This includes all consecutive alarms fired by the same rule on the same instance regardless of the time range. The default for 'consecutive' is 5 seconds.

Figure 12

Figure 13

Drilldowns

The following drilldowns are available from the Alarm Details with Actions popup.

Select

Instance

Host

Agent

Agent Type

To

The data that triggers an alarm. See “

see the

Host Summary

Instance

status and state of the agent (Broken or OK).

” on page 66.

as described on page 74.

see the “ Instance ” on page 66, as well as an indication as to the see the “ Instance ” on page 66, as well as an indication as to the

status and state of the agent (Broken or OK).

Working with Dashboards

Common Views

Select

Origin (by rule)

To displays the origin of the alarm. You can access links to:

• Rule Details— to view a short synopsis about the rule

• Edit Rule— to edit the rule definition

• Rule Help— to display online help about the rule

To edit a rule, select the rule name and then select Edit Rule

Definition . The Rule Editor appears. For further information on editing rules, refer to the vFoglight Administration and

Configuration Guide .

Default Drilldown see the view associated with the rule that is listed in the by

Rule field. From the view, you can then drill down to see additional details.

If a view is not available for a rule, N/A is displayed.

Severity and

Message at show the date and time when the alarm severity occurred along with a description.

History tab view a history of alarms for the:

• Created Time (time when the alarm occurred)

• Sev (alarm severity when the alarm occurred)

• Dur: duration of length of time that the alarm was in the associated state.

• Acknowledgment Info (indicating the status if the alarm was acknowledged or not, and by whom). For further

information, refer to “ Acknowledging an Alarm ” on page 63.

• Clearing Info (indicating the status if the alarm has been cleared or not, and message). For further information,

refer to “ Clearing an Alarm ” on page 65.

• Notes. Click the Notes icon to display the notes that were added to the alarm. Clicking the Notes icon takes you to the Alarm Notes tab described below. For more

information on notes, see “ Alarm Notes ” on page 70.

69

70 vFoglight

User Guide

Select

Notes tab

To

Displays a list of all alarm notes added to the alarm. Alarm notes allow you to record information about an alarm for yourself and for others. For example, after acknowledging an alarm you can include a note and details as to the alarm. All users can view and create a note but only the author of the note can edit or delete an existing note. Notes can be added to any alarm at any time even after the alarm has cleared. Alarm notes display:

• Created Time (time when the note was created)

• Description of the note

• User who created the note

• An Edit icon to enable the creator of the note to change the note description.

For more information, see “ Alarm Notes ” on page 70.

Alarm Notes

Alarm notes provide you with a handy way to record information about an alarm for all other users to view. For example, if you are managing alarms during an installation of vFoglight and if an urgent alarm comes up, you can add a note to the alarm that you are checking if the back-up process may be causing the problem. The note, along with a username stamp and a timestamp, are attached to the alarm.

There are two ways you can add notes from the Alarm Details dialog box by using either the:

• History tab. The Notes icon in the Alarm History table is for maintaining notes attached to a particular alarm in the history table. Clicking the Notes icon, takes you to the Alarm Notes dialog box.

Working with Dashboards

Common Views

• Notes tab. In the Notes tab, new notes are automatically attached to the most recent alarm in the alarm history.

71

You can also search for a note by using the Find button or Advanced button. See

“ Filtering Notes ” on page 73.

Creating an Alarm Note

Alarm notes consist of freeform non-localizable text, a user name and a timestamp.

To create an alarm note:

1

2

From the Alarm Details view you can either:

• In the History tab, click on the Alarm note icon and then click Add .

• In the Notes tab click New .

In the Add Note dialog box, type a description of the note.

3 Click Add .

The description is added to the Alarm Notes dialog box.

You also have the option to:

72 vFoglight

User Guide

• Acknowledge

the current alarm. See “ Acknowledging an Alarm ” on page 63.

• Acknowledge Until Normal . Selecting this option acknowledges the current alarm and all consecutive alarms fired by the same rule on the same instance.

This option is available to an outstanding (not-yet-cleared) alarm only.

• Clear

the selected alarm. See “ Clearing an Alarm ” on page 65.

Editing an Alarm Note

Only the creator of the note can edit the note.

To edit an alarm note:

1 From the Alarm Details view, you can either:

2

3

• From the History tab click the Notes icon.

• From the Notes tab, go to step 2.

Click the Edit icon.

In the Edit Note dialog, change the description of the note.

4 Click Submit .

The description of the note changes to the modified text.

Deleting an Alarm Note

Only the creator of the note can delete the note.

To delete an alarm note:

1

2

From the Alarm Details view you can either:

• Click the History tab, and then click on the Alarm note icon.

• Click the Notes tab.

In the Alarm Notes dialog box, select the checkbox of the note(s) you want to delete.

3 Click Delete .

Working with Dashboards

Common Views

73

The selected notes are removed.

Filtering Notes

You can filter notes by clicking the Find button or the Advanced button in the Notes tab of the Alarm Details dialog box. Using the Regular Expressions option when filtering notes enables you to search substrings.

To filter a note using the Find button:

1

2

In the Alarm Details view, click the Notes tab for a particular alarm.

Click in the textbox and type a string. If desired, click the Regular Expressions checkbox to filter notes on substrings.

3 Click Find .

To filter a note using the Advanced button:

1 In the Alarm Details view, click the Notes tab for a particular alarm.

2 You can filter notes by using one or more of the following criteria:

• Created Time (range, earliest available, current date)

• Severity (Undefined, Normal, Fire, Warning, Critical, Fatal)

• Note . Click the Use Regex checkbox to select the Regular Expressions option to filter notes on substrings.

• User name . Click the Use Regex checkbox to select the Regular Expressions option to filter a user name on substrings.

74 vFoglight

User Guide

3 Click Find .

Host Summary

When a host summary or Host object is shown in the browser interface, you can view a host summary popup or dwell.

Figure 14

A diagnostic time range is displayed at the top of the popup summary. This time range indicates the period during which the alarm was fired. It is usually in the past and is sometimes different from the time range that appears on a dashboard. For example, the following alarm occurred on Thursday October 23rd at a particular time range, while the date displayed on the dashboard is Friday October 24th.

Working with Dashboards

Common Views

75

Figure 15

Drilling down from here retains the time range during which the alarm occurred. To go back to the monitoring time range you last used, "unfreeze" the range by following the

procedures in “ Freezing a time range ” on page 52.

Drilldowns

The following drilldowns are available from the Host Summary popup.

Select

Health icon

To see links to:

• health of all alarm sources

• health of current alarm source

• all outstanding alarms for that alarm source

76 vFoglight

User Guide

Select

Alarms

To see a list of alarms according to alarm severity. Click on a particular alarm severity to view:

• number of alarms for the particular severity

• the alarm error instance on a particular agent or host

• summary table of the time, instance, rule name and ack’d by details.

CPU, memory, disk, and network see a detailed drilldown of that part of the host’s performance.

Host Monitor

Host Browser see a real-time monitoring view of the host.

Creating a Custom Dashboard

In addition to using the dashboards that are supplied with vFoglight or created by dashboard developers in your organization, you can create custom dashboards for your specific needs. These dashboards can contain any combination of tables and charts that you find useful. You can use the Columns options in the action panel to choose the number of columns for the dashboard.

The custom dashboards that you create are located under My Dashboards in the navigation panel.

To create a dashboard:

1 Click Create Dashboard in the action panel.

The Create Dashboard dialog box opens.

Working with Dashboards

Creating a Custom Dashboard

77

2 Type a unique name for the dashboard in the Name field. This is the only information required to create a new dashboard.

3

4

By default, a dashboard you create is not available to any vFoglight roles. You can select the default roles to control how people gain access to different parts of the browser interface. To do this, click the edit icon beside Relevant Role(s) and/or Allowed Role(s) and select the appropriate roles.

• Relevant Role —Select the roles for allowing existing dashboard users to view a dashboard. The option to choose a relevant role is only valid for super users such as a Java administrator who also has an operator role. Selecting the

Cartridge Developer role enables a filter to restrict certain user roles (e.g.

Operator role) from accessing the dashboard. Selecting the Operator role allows anyone with this role to access the new dashboard.

• Allowed Role —determines if a user role is allowed to see the dashboard.

Selecting the Operator role allows anyone with this role to access the new dashboard.

If you want the views in your dashboard to be refreshed at regular intervals, click the Automatically refresh page every check box and choose one of the options.

If you choose the second option, you need to enter a number of seconds in the text box to indicate the length of the refresh interval.

5

6

You can enter a description of the dashboard in the Context Help text box. This text will appear in a tooltip when you hover over the dashboard name in the navigation panel.

Click OK to save your dashboard.

7

8

Two additional tabs (Views and Data) appear at the top of the action panel.

In the action panel, select the Views or Data tab and locate the views or portlets that you want to add to your dashboard. You can add both types of information to

the same dashboard. For information on editing charts, see “ Metrics Chart Editor ” on page 83.

Note When you have finished adding views to your dashboard, you do not need to save it.

It is automatically available under My Dashboards in the navigation panel.

To divide the display area into one, two, or three columns, choose the number of columns in the action panel, under the General tab > Columns.

78 vFoglight

User Guide

Deleting a Custom Dashboard

You can delete any custom dashboard that you have created. You may also be able to delete dashboards created by other users, although this is not recommended. You cannot delete any default dashboards or dashboards created by dashboard developers in your organization.

To delete a custom dashboard:

1

2

Select the dashboard that you want to delete from the list under My Dashboards .

Click Delete this page in the action panel.

3

A confirmation dialog appears.

Click Delete to confirm the deletion.

The dashboard is removed from the My Dashboards view.

Working with Charts

Data charting enables you to create pre-defined and customizable charts that let you access and analyze collected data.

This section describes the options available when you are adding charts to a dashboard or report that you have created.

Creating a Metrics Chart

To create a metrics chart:

1 Drag each metric from the Data tab in the action panel into its own chart, as shown below.

Working with Dashboards

Working with Charts

79

2 You can also add one or more metrics to an existing chart.

Figure 16

Figure 17

• The metrics in the chart are indicated by different-colored lines at the left side of the chart under count and percentage (%).

• The line for the currently displayed metric (by default, the first one chosen) is bold. To highlight other metrics in the chart, click on the lines in the legend.

The legend below the chart changes to indicate the name of the highlighted metric.

• When you hover over a line in the chart, a dwell indicates the name of the metric, as well as the count or percentage and the specific date and time when it was collected.

80 vFoglight

User Guide

The Y axis shows the units for the metric. If there is more than one metric in the chart, the Y axis shows the units for the first metric that was charted, unless you have

unchecked the Layout check box in the Metric Chart Default dialog (see “ Setting Metric

Chart Labels ” on page 88 for details).

By using the Customizer function you have the option to export metric data for charts to

CSV format. See “ Exporting Data from Charts and Tables ” on page 57.

Zooming Into Charts

For plot or bar charts, you can zoom into an area to view data at different levels of detail by using CTRL + drag. You can also drag on an axis to specify the region you would like to zoom into (a zoom region).

To zoom into a chart:

1 In a line graph, zoom in to the area of the chart. Select one of the following methods to specify a zoom region:

• press CTRL + drag on the area

• drag on the axes of the chart

Working with Dashboards

Working with Charts

81

2 The chart will zoom into the range selected and will locally change the time range so vFoglight displays all data points. Now you can view the data for the selected metric at a more granular level.

3 To zoom out and return the line chart to its original view, click the Reset Zoom icon in the top right corner.

Changing the Chart Type

If the Customizer icon is enabled for charts, you have the option to dynamically change the chart to a different chart type (bar, plot, area, stacking area). For example, choose the chart type to Area to emphasize the magnitude of change over time and illustrate the metric parts in relation to the whole graph.

Note To access the customizer it needs to be enabled. By default, chart customizers are not enabled.

To change the chart type:

1

2

Click the Customizer icon in the top right hand corner of the chart.

In the Chart Type dialog box, click the chart type to change.

The chart dynamically changes to the selected chart type.

82 vFoglight

User Guide

To export the chart to CSV or PDF format, see Exporting Data from Charts and Tables

.

Chart Options

You can edit, save, maximize, restore, or close a chart by clicking the icons in the title

bar. The editing options are described under “ Metrics Chart Editor ” on page 83.

Note All other charts are hidden when you maximize a chart.

To save a chart:

1 Click the save icon in the title bar of the chart that you want to save.

The Save Individual View dialog box appears.

2

You can accept the default name, edit, or type another name for the chart.

Select the format in which you want to save the chart.

• Portlet —this option appears in the Views tab when creating a dashboard. If you choose Portlet , the view will be available on the Views tab (under My

Views) to be added to a dashboard that you create from the action panel.

• Pagelet —this option appears as a view that is designed to be added to a page or dashboard.

• Reportlet —the main purpose of reportlets is to appear in the Views tab when creating a report. If you choose Reportlet , the view will be available on the

Views tab (under My Views) from where it can be added to a report that you create from the action panel.

Working with Dashboards

Working with Charts

83

Pagelets and Reportlets are listed under Configuration > Definitions in the navigation panel. If you have access to the Definitions area, you can use them when building a dashboard. For information about building dashboards, see the

Web Component Tutorial .

3 Click OK .

Metrics Chart Editor

There are two editors that control how metrics are displayed in charts: one controls the settings for all the charts that you create; the other controls the settings for the current chart.

Editing a Chart

To edit a chart:

1 To apply changes to any new metrics chart that you created, click Set metric chart defaults in the action panel. The Metric Chart Defaults dialog opens.

2

Figure 18

Click the edit icon in the title bar of a chart to display an edit dialog where you can make changes that affect only that chart.

84 vFoglight

User Guide

Figure 19

The settings you can change are described in the following table. Note that not all the options are available in both dialogs.

Setting

Title

Metric Label

Parent Label

Description

Allows you to rename the chart.

No specific limits, but keep

Allows you to choose another label for the metric.

Options/Limits display space in mind.

Only available when editing a single chart.

Allows you to choose another label for the parent metric. This label appears in the title of a chart that contains metrics from a single parent.

The parent label appears in the legend when the chart contains metrics from more than one parent. (For example, see

“ Grouping Metrics with Many

Parent Hosts ” on page 87.)

Only available when editing a single chart.

Working with Dashboards

Working with Charts

Setting

Chart

Height

Layout

Line Thickness

Description

Lists the available types of chart.

Options/Limits

• Plot (default)

• Area

• Stacking area

• Bar

Sets the height for all charts or this chart.

The default chart height is

300 pixels.

Select “ Only show metric of selected chart ” to show only one axis is used in the chart, regardless of how many metrics are displayed. (For examples,

see “ Setting Metric Chart

Labels ” on page 88.)

Clear the check box to display the label for all metrics in the legend.

Check box.

Specifies the thickness of lines in all charts or this chart.

• Automatic

• Small

• Medium

• Large

85

86 vFoglight

User Guide

Setting

Metric Value

Description

Controls the type of value that is displayed for one metric or all metrics in a chart.

Options/Limits

• None

• Average: The chart displays the average value for the metric per interval.

• Minimum: The chart displays the actual lowest value for the metric per interval.

• Maximum: The chart displays the actual highest value for the metric per interval.

• Minimum/Maximum:

The chart displays the maximum and minimum value for the metric per interval.

• Sum

Check box

Show data at both start and end of intervals

Applies only to plot and area charts.

Show Overall Displays the overall value for the set time range as a dashed line.

Show Min/Max

As

Displays the minimum and maximum per interval.

• Average displays the overall average.

• Min displays the overall minimum.

• Max displays the overall maximum.

• Envelope (a filled-in area between the minimum and maximum)

• Marks

• Lines

Working with Dashboards

Working with Charts

87

Setting

Show Baseline

Min/Max As

Description Options/Limits

Displays the baseline minimum and maximum.

• Envelope (a filled-in area between the minimum and maximum)

• Marks

• Lines

Show Standard

Deviation As

Similar to the Min/Max setting; lets you highlight a range per interval. You determine the high and low values by setting the deviation from the average.

The default value is 1, but the unit of deviation depends on the metric.

• Envelope (a filled-in area between the minimum and maximum)

• Marks

• Lines

Show Thresholds If a metric has a threshold, it is displayed.

You can choose to show thresholds only for the selected metric.

Grouping Metrics with Many Parent Hosts

When you have many metrics on a chart from different parent hosts, the parent label will appear in the legend when metrics are grouped. For example, in the chart on the left below, if you drag metrics from a Windows_Host and from a Windows_CPU, the parent label shows up in the metric labels themselves since the metrics are mixed. In the chart on the right below, if you drag metrics from the Windows_CPU host only, the legend does not refer to the parent.

88 vFoglight

User Guide

Setting Metric Chart Labels

The Layout option enables you to choose the layout of the metric chart axes.

Figure 20

Figure 21

• Select the Layout check box for a chart to indicate only one axis is used in the chart, regardless of how many metrics are displayed, as shown below.

Working with Dashboards

Viewing Dashboard Properties

89

Figure 22

• Clear the Layout check box to display all the axes in the chart, as shown below.

Figure 23

Viewing Dashboard Properties

When you are viewing a dashboard, you can edit some or all of its properties and definition if you have the appropriate role(s).

You can also use this procedure to publish a dashboard that you have created.

To view the properties of a dashboard:

1

2

Select the dashboard whose properties you want to view or change.

Click Properties in the action panel.

A popup appears.

90 vFoglight

User Guide

3 Click Edit basic Properties .

The Edit View Properties dialog appears.

Depending on your role(s), you may be able to change some or all of the properties.

To make available a dashboard that you have created, it is recommended that you choose Operator for both the Relevant Role and Allowed Role.

Click OK to close the dialog and save any changes.

4

If you have access to the Definitions area (under Configuration in the navigation panel), you can view (and possibly make changes) to the definition of a dashboard. For details about creating dashboards, see the Web Component Tutorial and the Web Component

Guide .

To view or change the definition of a dashboard:

2

3

1 Select the dashboard whose definition you want to view or change.

Click Properties in the action panel.

Click Go to full definition in the popup.

The definition page for this dashboard appears.

4

5

If you can make changes to the definition, click Edit .

If you have made changes to the definition, click Save .

Working with Dashboards

Working With Tables

91

Working With Tables

You can sort and filter data in a table, if these functions are enabled on the table.

Sorting Tables

If a table is sortable, you can sort it by clicking the column-header text. A down ( ) or up ( ) icon in the table header indicates the current sort order.

Filtering Tables

Some tables have a filter option in the title bar. When you click it, a dialog opens in which you select filtering criteria. You then click Apply to refresh the table and display only those rows in which the data meets the specified criteria. For an example of table

filtering, see “ Filtering the Alarms View ” on page 62.

Hiding Columns

Another way you can filter tables is to hide some of the columns. If this option is available, there is an edit icon ( ) at the top of the table. Clicking the edit icon opens a popup list of all the columns, where you can de-select the columns you want to hide and click Apply . To display a hidden column, select it and click Apply . For an example, see

“ Hiding Columns in the Alarms View ” on page 63.

Paging Icons

By default, most tables display only a set number of rows. If there are more rows, you can display the additional rows by using the paging buttons:

Button Name

First page

Previous page

Next page

Last page

Note Active buttons are blue. Disabled buttons are gray.

92 vFoglight

User Guide

Printing Views

You can print vFoglight views using the Print option in the actions panel. The view is displayed in a separate browser with a standard print dialog.

Note To generate a PDF file for a table that exceeds the number of rows to fit on a single page, the table should be specified as either a top level view with the Purpose = report in

Configuration > Definitions, or it should be included in the Report Layout container.

The output is formatted using the Print theme specified in the User Preferences page.

(see “ User Preferences ” on page 36 for details). You can override this setting by

choosing a different option in the action panel under Themes.

advertisement

Related manuals

Download PDF

advertisement

Table of contents