Foglight for SQL Server (Cartridge) 5.9.5.20


	IMPORTANT: Agents must be enabled for user-defined collections. If one or more of the selected agents is not enabled for such collections, this view allows enabling them. To disable or modify the credentials of a currently enabled agent, go to the Connection Details view and click the agent to edit it. For details, see Step 10 on page 146.

After collections are added, this view displays all of the user-defined collections for all of the agents; for example, if a collection was added to 12 agents during its addition, the view will display 12 rows, showing the collection for each agent.

This view can also be used for configuring the sampling frequency for each collection.

The available sampling frequencies are as follows:

•

Real-Time - When a user is currently focusing on a screen, the sampling frequency for all of the collections associated with this screen switches to Real-Time.

•

Online - When at least one user is connected, the sampling frequency for all of the collections that are not currently running at Real-Time frequency switches to Online.

•

Offline - when no user is currently connected to the application

To add user-defined collections:

Click Add.

The User-defined Collections screen appears.


	IMPORTANT: If one or more of the selected agents is not enabled for user-defined collections, a dialog box appears to notify this issue, displaying a table of the currently disabled collections. Use this dialog box to enable all agents for user-defined collections. To enable only part of these agents, exit the Databases Administration dashboard and select only these agents that are currently enabled or need to be enabled for user-defined collections before entering again the Databases Administration dashboard.

Type a name in the Collection Name field.

Enter a brief description of the collection in the Collection description field (optional).

Paste the query’s SQL text in the Query Text field.

Type a value, in seconds, in the Query Timeout field.

Click Verify.

The collection is verified by running the query on each of the currently selected agents.

After the verification process is complete, the Verification Results pop-up appears, indicating whether the collection was verified successfully. In case the collection verification failed, the error message is displayed.

Table 72. If the verification succeeded on at least one agent, the collection details are displayed as below.

The name of the column

Column Type

The field type, as retrieved by the query (String, Integer and so on)

Data Storage

Display Name

The column’s display name

Type

The topology type for storage purposes. This type can be one of the following:

•

•

•

•

•

NOTE: When the Frequently modified check box is selected (the default state), the field’s change history is kept, including use of optional functionality such as use of the IntelliProfile mechanism and aggregation type selection. Clearing this check box is recommended only for fields whose values change infrequently, such as IP address of a specific host, as storing the change history of such fields is highly CPU-intensive and may degrade the FMS performance.

Unit of Measurement/Indicator

The metric’s Unit of Measurement/Indicator.

The possible measurement unit values are: Percent, Count, Millisecond, Second, Minute, Hour, Day, Byte, Kilobyte, Megabyte and Gigabyte.

Aggregation

Allows defining the value that is displayed in this metric, out of several values that were returned in the relevant time range.

The available aggregation values are:

•

As is — value of the last sample taken during the selected time range

•

Sum — summarized value of all samples taken during the selected time range

•

Average — average value of all samples taken during the selected time range

Is Key

Indicates whether the field is the query’s key for retrieval.

NOTE: Fields that are indicated as keys should correspond with the database result set unique values. Selecting a field which has frequently changing and repeating results as key is allowed, but may result in unexpected behavior from the defined collection.

Except for the Column Name and Column Type fields, whose values are retrieved by the query and cannot be changed, all other fields can be edited by clicking any of them.

The Edit Collection Properties dialog box appears, allowing you to edit the values of the following parameters:

•

Display name

•

Type

•

Unit of Measurement/Indicator

•

Aggregation

In addition, the collection’s sampling frequencies are displayed on the table at the bottom of the view, and can be edited by clicking any of them.

Ensure that all settings are appropriate, and click OK to finish the collection creation process.

The newly created collection now appears on the table.


	IMPORTANT: After adding the requested user-defined collections, they can only be deleted or cloned to other agents. If one or more queries need to be modified, delete them and create new ones.

Administering SQL Performance Investigator

The SQL Performance Investigator view in the Administration dashboard allows you to enable and disable SQL PI monitoring for selected agents. In addition, you can start and stop the collection of change tracking data.

In the SQL PI view, select one or more agents to enable or disable or for which to modify the change tracking status.

Configuring the On-demand Data Settings

The On-demand Data Settings view in the Databases Administration dashboard allows you to define a port for each Foglight Agent Manager (FglAM) to be used for retrieving data and integrating with SQL Performance Investigator.

To configure a port for the collection of on-demand data:

Select the check box near the names of the requested Foglight Agent Managers.

Click Set port.

The Set On-demand Data Port dialog box appears.

Type the name of the requested port.

Click Set.

Click Validate connectivity.

The Validate connectivity progress bar appears. At the end of the validation process, the connection status appears on the Status column.

If the connection failed, take the requested correction measures and try again.


	IMPORTANT: Changes to the On-demand Data Settings view take effect immediately and do not need to be saved.

Configuring the Database to be Excluded

Monitoring all of the databases within all of the agents can unnecessarily load the system, as not all databases require such monitoring, due to being either non-mission critical or less significant. The Exclude Databases from Monitoring view allows excluding such databases from monitoring. Use this view to select the agents from which databases are to be excluded from monitoring, and then specify, either manually or by selecting from a list, which databases to exclude.

The On-demand Data Settings view in the Databases Administration dashboard allows defining a port for each Foglight Agent Manager (FglAM) to be used for retrieving data and integrating with Foglight SQL PI.

To exclude databases from monitoring:

Click Exclude databases.


	NOTE: Selecting a specific agent from which databases are to be excluded is done using the dialog box that opens upon clicking this button.

The dialog box Specify Databases for Exclusion appears.

Use the list Select specific agent or all agents to select an agent from which databases are to be excluded. Alternatively, select the option All selected agents.

Specify which databases to exclude from monitoring, either by adding their names manually or by selecting them from the list and clicking

to move them to the list of excluded agents.