Chat now with support
Chat with Support

Foglight for Azure SQL Database (Cartridge) 5.9.7.20 - User Guide

Installing and Configuring Agents Using Foglight for Azure SQL Database Administering Foglight for Azure SQL Database Reporting Reference
Overview of Collections SQL Performance Investigator Metrics
Active Connections Active Time Active Time per Execution Active Time Rate Always On Average CPU Percent Average DTU Percent Average Memory Usage Percent Average SQL Response Time Average XTP Storage Percent Average Data IO Percent Average Log Write Percent Backup Recovery Blocked Sessions Connections CPU Limit CLR Wait CLR Wait per Execution CLR Wait Rate CPU Time CPU Time per Execution CPU Time Rate CPU Wait CPU Wait per Execution CPU Wait Rate Cursor Synchronization Database Replication Deferred Task Worker Distributed Transaction DTU Limit Elapsed Time Executions External Procedure Full Text Search Governor Wait Governor Wait per Execution Governor Wait Rate Granted Memory Hosted Component Inactive User Connections I/O Bulk Load I/O Completion I/O Data Page I/O Wait I/O Wait per Execution I/O Wait Rate Idle Time Internal Cache Latch Latch Buffer Latch Savepoint Latch Wait Latch Wait per Execution Latch Wait Rate Lead Blockers Lock Bulk Update Lock Exclusive Lock Intent Lock Schema Lock Shared Lock Update Lock Wait Lock Wait Rate Lock Wait per Execution Log Buffer Log Other Log Synchronization Log Wait Log Wait per Execution Log Wait Rate Log Write Logical Reads Logical Reads per Execution Max Degree of parallelism Max DTU Percent Max Session Percent Max Workers Percent Memory Wait Memory Wait per Execution Memory Wait Rate Network HTTP Network I/O Network IPC Network Mirror Network Wait Network Wait per Execution Network Wait Rate OLEDB Provider Full Text Other Miscellaneous Other Wait Other Wait per Execution Other Wait Rate Parallelism Wait Percent of Total Plan Recompilations Physical Reads Physical reads per Execution Preemptive Wait Preemptive wait per Execution Preemptive Wait Rate Remote Provider Wait Remote Provider wait per Execution Remote Provider Wait Rate Row count Service Broker Synchronous Task Wait Time Percent Writes Writes per Execution XTP Log write Wait XTP Miscellaneous Wait XTP Procedure Wait XTP Transaction Wait XTP Wait XTP Wait per Execution XTP Wait Rate
Glossary

Reviewing the Administration Settings

Use the Databases Administration dashboard to set options for collecting, storing, and displaying data, which apply to all of the currently selected agents. Click a category of settings on the left (for example: Connection Details) to open a view containing related settings on the right.

The metrics defined on the Databases Administration dashboard apply to all of the agents that were selected before opening the Administration dashboard. As a result, the same unit of measure and aggregation value for display are enforced for all currently selected agents.

To view the full list of selected agents, click Selected Agents button at the upper right corner of the screen. To change the list of agents to which the metrics apply, exit the Databases Administration dashboard, select the required agents, and re-open the dashboard.

If the settings vary between the selected agents (for example: one agent uses the measurement unit kilobyte, while another uses megabyte), the fields that contain non-identical values are displayed as empty and marked with an Inconsistent Values () icon.

Changes made to settings should be saved before selecting another category of settings.

To save changes made in an Administration dashboard view:
1
In the Database Administration dashboard, select a category of settings from the left-hand panel.
2
Make changes to settings as necessary.
3
Click Save changes at the bottom of the view.
If you attempt to exit the view without saving changes, a Warning dialog box prompts you to confirm your action.

Customizing Alarms for Foglight for Azure SQL Database Rules

Customizing Alarms for Foglight for Azure SQL Database Rules

Many Foglight for Azure SQL Database 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
•
Modifying Alarm Settings
•
Configuring Email Notifications
•
Cloning Agent Settings
•
Reviewing Rule Definitions

Introducing the Alarms View

The Alarms view enables you to modify global settings and agent-specific settings for alarms.

To open the Alarms view:
1
Open the Administration dashboard as described in Opening the Databases Administration Dashboard .
2
Click Alarms.
The list of agents that you selected on the Databases dashboard is shown in the upper right corner of the view.
3
From the Alarms view, you can complete the following tasks:
•
Modifying Alarm Settings
•
Configuring Email Notifications
•
Cloning Agent Settings

Modifying Alarm Settings

You can customize how the alarms generated by the default Foglight for Azure SQL Database rules are triggered and displayed in the Alarm Settings tab. All changes to alarm settings apply to the selected agents, with the exception of thresholds, which can be customized by agent.

* 
TIP: If you want to copy alarm settings to another agent that was not in the selected list— for example, you add a new agent — you can copy the alarm customizations to that agent. For instructions, see Cloning Agent Settings .
* 
IMPORTANT: Avoid editing Foglight for Azure SQL Database rules in the Administration > Rules & Notifications > Rule Management dashboard. Default rules may be modified during regular software updates and your edits will be lost. Always use the Alarms view.

The Alarms list controls the contents displayed to the right and the tasks that are available.

•
All Alarms – Displays all rules with configured alarms and indicates whether alarms are enabled. In this view, you can enable or disable alarms for all the rules at once. You can also set email notifications and define mail server settings.
•
Category of rules – Displays a set of related rules with configured alarms. In this view, you can enable or disable alarms and also set email notifications for the category of rules.
•
Rule name – Displays the alarm status for the selected rule. If the rule has multiple severity levels, displays the threshold configured for each severity level. In this view, you can enable or disable the alarm, edit the alarm text, and edit severity levels and their thresholds. You can also set email notifications for the alarm.

You can complete the following tasks:

•
Enabling or disabling alarms for selected agents
•
Modifying alarm threshold values
•
Editing the text of the alarm message

Your changes are saved separately and applied over the default rules. This protects you from software upgrades that may change the underlying default rules.

Enabling or disabling alarms for selected agents

You can override the global alarm sensitivity level setting for the selected agents. You can enable or disable alarms for all rules, a category of rules, or an individual rule.

* 
TIP: If you want to see descriptions of the rules, follow the steps described in Reviewing Rule Definitions .
To enable or disable alarms:
1
In the Alarms view, click the Settings tab.
2
Decide on the scope for the change: all alarms, a category of rules, or a selected rule.
3
Complete the steps for the selected scope:
 
 
Table 4. Alarm scope
Scope
Procedure

All alarms

Click All Alarms. In the Alarms Settings tab, click either Enable all or Disable all.

Category of rules

Click a category. Click either Enable all or Disable all.

Selected rule

Click the rule. In the Alarms Settings tab, click the link that displays the alarm status. Select Enabled or Disabled from the list and click Set.

4
Click Save changes.
Modifying alarm threshold values

You can and should modify the thresholds associated with alarms to better suit your environment. If you find that alarms are firing for conditions that you consider to be acceptable, you can change the threshold values that trigger the alarm. You can also enable or disable severity levels to better suit your environment.

When a rule has severity levels, a Threshold section appears in the Alarm Settings tab showing the severity levels and bounds by agent. Many rules, such as Baseline rules, do not have severity levels and thresholds.

When editing thresholds, ensure that the new values make sense in context with the other threshold values. For most metrics, threshold values are set so that Warning < Critical < Fatal.

* 
TIP: If you want to review the thresholds for all Foglight for Azure SQL Database rules in a single view, use the Rule Management dashboard. In the navigation panel, click Homes > Administration, then click Rules. Type Azure in the Search field to see the list of predefined rules for Azure SQL Database. For rules with severity levels, you can see the threshold values set for each level. If you want to edit threshold values, return to the Alarms view. Edits made directly to the default rules may be overwritten during software upgrades.
To change severity levels and thresholds:
1
In the Alarms view, click the Settings tab.
2
Click the rule with multiple severity levels that you want to edit.
3
Click the Alarms Settings tab.
4
In the Threshold section, review the defined severity levels and existing threshold bounds for all target agents. The colored bar across the bottom of the view indicates the percentage of collections that fall within each threshold.
5
From this view, you can perform the following tasks:
 
Table 5. Tasks
Task
Procedure

Edit severity levels and set threshold (lower bound) values for all agents.

Click Enhance alarm. Select the check boxes for the severity levels you want enabled and set the threshold values. Click Set.

Change the threshold (lower bound) values for one agent.

Click Edit beside the agent name. Set the new threshold values and click Set.

Copy the changes made to one agent’s threshold values to all other agents.

Click Edit beside the agent name that has the values you want to copy. Select Set for all agents in table and click Set.

6
Click Save changes.
Editing the text of the alarm message

For individual rules, you can change the message displayed when an alarm fires. You cannot add or remove the variables used in the message. This is a global setting that affects all agents.

To change the alarm message:
1
In the Alarms view, click the Settings tab.
2
Select a rule.
3
Click the Alarm Settings tab.
4
Click Enhance alarm.
A Customize <rule> dialog box opens.
5
In the Message box, edit the message text.
If desired, you can restore the default message by clicking Reset message.
6
Click Set.
7
Click Save changes.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating