Foglight for DB2 (Cartridge) 5.9.5.10

Foglight for DB2 LUW attempts to connect to the OS. If the credentials are valid, the Save changes button is enabled. Otherwise, correct the credentials. See Creating or Editing OS Credentials.

When the credentials are valid, click Save changes.

Creating or Editing OS Credentials

To create or edit credentials used to access the OS:

Select a database instance or host from the list.

Click Set credentials.

The Edit Credentials dialog box opens.

Click Edit Host Connection Details.

The Edit Credentials dialog box expands to show the connection detail boxes.

If you want Foglight for DB2 LUW to monitor the instance’s OS, ensure that the Enable OS Monitoring check box is selected.

If credentials exist in this lockbox or another lockbox, select the credentials.

Click Select from stored credentials.

The Use Credentials dialog box opens.

Select a lockbox from the list.

Select a set of credentials from the list.

Click Apply.

The Edit Credential boxes display values for the selected credential. The password is masked.

Otherwise, create credentials by filling in the form.

Choose an authentication type from the list. The remainder of this example assumes a UNIX (log in cred.) authentication type.

Type a user name.

Type a password.

Type a port number.

If necessary, select the Use Sudo check box.

Click Apply.

Foglight for DB2 LUW attempts to connect to the OS. If the credentials are valid, the Save changes button is enabled. Otherwise, correct the credentials.

When the credentials are valid, click Save changes.

If an IC (Infrastructure Cartridge) agent currently exists, its credentials are updated. Otherwise, a new IC agent is created with the credentials.

Defining Data Collection Options

The Foglight for DB2 agent always collects and stores data, even when the browser window that displays the data is not active. Use the Collections page to specify:

•

Which collections are sampled and stored.

•

The data collection values when sampling is carried out in offline, online, and real-time frequency modes.

•

The collection frequency.

When a user is focusing on a page, the sampling frequency for all the collections associated with this page automatically switches to Real-Time. The collection frequency setting determines the sampling frequencies of the other collections (collections that are not running in Real-Time mode).

The available collection frequencies can be selected from the The selected agent's current collection frequency is (frequency) field located in the middle of the panel.

To change the selected agent's current collection frequency:

Click agent’s current frequency status.

The frequency settings dialog displays.

Select the required frequency.

The following settings are provided:

•

Low — all collections are running in Offline mode, regardless of whether a Client is connected

•

Normal — the collections running mode (Online/Offline/Real-time) adjusts dynamically to the Client's connection status (disconnected/connected/focusing on a page).

•

High — all collections are running in Online mode, regardless of whether a Client is connected.

Select the required setting.

Click Set.

The Query timeout for on-demand collections setting defines the number of seconds that a query for on-demand collections runs before it times out.

On-demand collections are collections who retrieve data not by predefined time intervals but upon entering a page or clicking a button. The default setting of this parameter is 60 seconds. It can be modified by clicking the number that indicates the parameter’s value in the field Query timeout for on-demand collections.


	IMPORTANT: In the Normal collection frequency, when the browser window that displays Foglight for DB2 is active, the collection frequency mode in the active page (for example: the Current Sessions panel in the Activity drilldown) switches to the fastest frequency possible, once every 20 seconds.

The Collections table contains the following columns:

Table 1. Collections table
Column	Description
Collection Enabled	Defines whether the selected collections are sampled and stored.
Collection Name	The name of the collection. This list is sorted in alphabetical order.
Offline Frequency (Sec)	Allows defining the collection interval, in seconds, in offline mode (for example: 300). Offline frequency is defined as the longest interval possible for sampling the monitored instance.
Online Frequency (Sec)	Allows defining the collection interval, in seconds, in online mode (for example: 60).
Real-time Frequency (Sec)	Allows defining the collection interval, in seconds, in real-time mode (for example: 20). Only one collection can be sampled for a real-time frequency at any given moment.
Query Timeout (Sec)	The amount of time, in seconds, that elapses before the query times out.

To modify the values of a specific collection:

Select the collection’s row in the table.

Click Edit.

The Edit the Collection dialog box appears.

Select whether to enable the collection and storage of the selected collection.

Set the collection interval, in seconds, in offline frequency mode (if available).

Set the collection interval, in seconds, in online frequency mode (if available).

Set the collection interval, in seconds, in real-time frequency mode.

Set the query timeout, in seconds.

Click Set to apply these settings or Cancel to reject them.

Customizing Alarms for Foglight for DB2 LUW Rules

Many Foglight for DB2 LUW multiple-severity rules trigger alarms. To improve your monitoring experience, you can customize when alarms are triggered and whether they are reported. You can also set up email notifications.

This section covers the following topics:

•

Introducing the Alarms View

•

Setting and Modifying Alarm Sensitivity Levels

•

Modifying Alarm Settings

•

Configuring Email Notifications

•

Cloning Agent Settings

•