Table of Contents Previous Next


4 Performance Monitoring and Management : 4.5 Alerting : 4.5.2 Using the Manage Alerts Tab

Use the PEM Client's Manage Alerts tab to define, copy, or manage alerts. To open the Manage Alerts tab (shown in Figure 4.33), select Manage Alerts from the Management menu.
C:\Users\susan\Desktop\Screen Shot 2018-01-30 at 3.10.57 PM.png
Use the Quick Links toolbar to open dialogs and tabs that will assist you when managing alerts:
Click Copy Alerts to open the Copy Alert Configuration dialog and copy an alert definition.
Click Alert Templates to open the Alert Template tab, and modify or create an alert template.
Click Email Groups to open the Email Groups tab, and modify or create an email group.
Click Server Configurations to open the Server configuration dialog and review or modify server configuration settings.
Use the table in the Alerts section of the Manage Alerts tab to create new alerts or manage existing alerts.
You can use the Alert Templates tab (shown in Figure 4.34) to define a custom alert template or view the definitions of existing alert templates. To open the Alert Templates tab, select the Manage Alerts... menu option from the Management menu. When the Manage Alerts tab opens, select Alert Templates from the Quick Links toolbar.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\2c52262f\Screen Shot 2018-01-30 at 3.44.31 PM.png
Use the Show System Template drop-down listbox to filter the alert templates that are displayed in the Alert Templates table. Use the listbox to select a level of the PEM hierarchy to view all of the templates for the selected level.
To define a new alert template, use the Show System Template drop-down listbox to select None, and click the Add icon (+) located in the upper-right corner of the alert template table. The alert template editor opens as shown in Figure 4.35.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\2e582894\Screen Shot 2018-01-30 at 3.45.58 PM.png
Use fields on the General tab to specify general information about the template:
Use the Template name field to specify a name for the new alert template.
Use the Description field to provide a description of the alert template.
Use the Target type drop-down listbox to select the type of object that will be the focus of the alert.
Use the Applies to server drop-down listbox to specify the server type (EDB Postgres Advanced Server or PostgreSQL) to which the alert will be applied; you can specify a single server type, or ALL.
Use the History retention field to specify the number of days that the result of the alert execution will be stored on the PEM server.
Use the Threshold unit field to specify the unit type of the threshold value.
Use fields in the Auto create box to indicate if PEM should use the template to generate an automatic alert. If enabled, PEM will automatically create an alert when a new server or agent (as specified by the Target type drop-down listbox) is added, and delete that alert when the target object is dropped.
o
Move the Auto create? slider to Yes to indicate that PEM should automatically create alerts based on the template. If you modify an existing alert template, changing the Auto create? slider from No to Yes, PEM will create alerts on the existing agents and servers. Please note that if you change the slider from Yes to No, the default threshold values in existing alerts will be erased, and cannot be recovered.
o
Use the Operator drop-down listbox to select the operator that PEM will use when evaluating the current system values.
Use the Check frequency field to specify the default number of minutes between alert executions. This value specifies how often the server will invoke the SQL code specified in the definition and compare the result to the threshold value specified in the template.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\6912e39d\pem_alert_templates_pdtab.png
Use the fields on the Probe Dependency tab (see Figure 4.36) to specify the names of probes referred to in the SQL query specified on the SQL tab:
Use the Probes drop-down listbox to select from a list of the available probes; highlight a probe name, and click the Add button to add the probe to the list of probes used by the alert template. To remove a probe from the selected probes list, highlight the probe name, and click the Delete icon.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\639bfc1f\pem_alert_templates_paramtab.png
Use fields on the Parameters tab (see Figure 4.37) to define the parameters that will be used in the SQL code specified on the SQL tab. Click the Add icon (+) and:
Use the Name field to specify the parameter name.
Use the Data type drop-down listbox to specify the type of parameter.
Use the Unit field to specify the type of unit specified by the parameter.
Use the Code field on the SQL tab (shown in Figure 4.38) to provide the text of the SQL query that the server will invoke when executing the alert. The SQL query will provide the result against which the threshold value is compared; if the alert result deviates from the specified threshold value, an alert will be raised.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\a964aa88\pem_alert_templates_sqltab.png
Within the query, parameters defined on the Parameters tab should be referenced sequentially by the variable param_x, where x indicates the position of the parameter definition within the parameter list. For example, param_1 refers to the first parameter in the parameter list, param_2 refers to the second parameter in the parameter list, and so on.
Use the Detailed Information SQL field to provide a SQL query that will be invoked if the alert is triggered. The result set of the query may be displayed as part of the detailed alert information on the Alerts dashboard or Global Overview dashboard.
Click the Save icon to save the alert template definition and add the template name to the Alert Templates list. After saving a custom alert template, you can use the Alerting dialog to define an alert based on the template.
To view the definition of an existing template (including PEM pre-defined alert templates), use the Show System Template drop-down listbox to select the type of object monitored. When you select the object type, the Alert Templates table will display the currently defined alert templates that correspond with that object type.
Highlight a Template Name in the list, and click the Edit icon (at the left end of the row) to review the template definition.
Use the tabs on the Alert Templates dialog to view detailed information about the alert template:
To delete an alert template, highlight the template name in the alert templates table, and click the Delete icon. The alert history will persist for the length of time specified in the History Retention field in the template definition.
The Manage Alerts tab displays a table of alerts that are defined on the object currently selected in the PEM client tree control. You can use the Alerts table to modify an existing alert, or to create a new alert (see Figure 4.39).
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\e69a794c\Screen Shot 2018-01-31 at 2.17.20 PM.png
To open the alert editor and create a new alert, click the Add icon (+) in the upper-right corner of the table. The editor opens as shown in Figure 4.40.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\fd095749\alert_definition_general.png
Use the fields on the General tab to provide information about the alert:
Use the drop-down listbox in the Template field to select a template for the alert. An alert template is a function that uses one (or more) metrics or parameters to generate a value to which PEM compares user-specified alert boundaries. If the value returned by the template function evaluates to a value that is within the boundary of a user-defined alert (as specified by the Operator and Threshold values fields), PEM raises an alert, adds a notice to the Alerts overview display, and performs any actions specified on the template.
Use the Enable? switch to specify if the alert is enabled (Yes) or disabled (No).
Use the controls in the Interval box to specify how often the alert should confirm if the alert conditions are satisfied. Use the Minutes selector to specify an interval value. Use the Default switch to set or reset the Minutes value to the default (recommended) value for the selected template.
Use controls in the History retention box to specify the number of days that PEM will store data collected by the alert. Use the Days selector to specify the number of days that the data will be stored. Use the Default switch to set or reset the Days value to the default value (30 days).
Use controls in the Threshold values box to define the triggering criteria for the alert. When the value specified in the Threshold Values fields evaluates to greater-than or less-than the system value (as specified with the Operator), PEM will raise a Low, Medium or High level alert:
Use the Operator drop-down listbox to select the operator that PEM will use when evaluating the current system values:
The Parameter Options table contains a list of parameters that are required by the selected template; the table displays both pre-defined parameters, and parameters for which you must specify a value. Please note that you must specify a value for any parameter that displays a prompt in the Value column.
PEM can send a notification or execute a script if an alert is triggered, or if an alert is cleared. Use the Notification tab (see Figure 4.41) to specify how PEM will behave if an alert is raised.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\b6ecc2a3\alerting_define_notification.png
Use the fields in the Email notification box to specify the email group that will receive an email notification if the alert is triggered at the specified level. Use the Email Groups tab to create an email group that contains the address of the user or users that will be notified when an alert is triggered. To access the Email Groups tab, click the Email Groups icon located in the Quick Links menu of the Manage Alerts tab.
To instruct PEM to send an email when a specific alert level is reached, set the slider next to an alert level to Yes, and use the drop-down listbox to select the pre-defined user or group that will be notified.
Use the Trap notification options to configure trap notifications for this alert:
Set the Send trap slider to Yes to send SNMP trap notifications when the state of this alert changes.
Set the SNMP Ver slider to v1 or v2 to identify the SNMP version.
Use the Low alert, Med alert and High alert sliders to select the level(s) of alert that will trigger the trap. For example, if you set the slider next to High alert to Yes, PEM will send a notification when an alert with a high severity level is triggered.
Use the field in the Nagios notification* box to instruct the PEM server to notify Nagios network-alerting software when the alert is triggered or cleared. For detailed information about configuring and using Nagios with PEM, please see Section 0.
Set the Submit passive service check result to Nagios switch to Yes to instruct the PEM server to notify Nagios when the alert is triggered or cleared.
Use the fields in the Script execution box to (optionally) define a script that will be executed if an alert is triggered, and to specify details about the script execution.
Set the Execute script slider to Yes to instruct PEM to execute the provided script if an alert is triggered.
Set the Execute on alert cleared slider to Yes to instruct PEM to execute the provided script when the situation that triggered the alert has been resolved.
Use the radio buttons next to Execute script on to indicate that the script should execute on the PEM Server or the Monitored Server.
Provide the script that PEM should execute in the Code field. You can provide a batch/shell script, or SQL code. Within the script, you can use placeholders for the following:
%AlertName% - this placeholder will be replaced with the name of the triggered alert.
%ObjectName% - this placeholder will be replaced with the name of the server or agent on which the alert was triggered.
%ThresholdValue% - this placeholder will be replaced with the threshold value reached by the metric when the alert triggered.
%CurrentValue% - this placeholder will be replaced with the current value of the metric that triggered the alert.
%CurrentState% - this placeholder will be replaced with the current state of the alert.
%OldState% - this placeholder will be replaced with the previous state of the alert.
%AlertRaisedTime% - this placeholder will be replaced with the time that the alert was raised, or the most recent time that the alert state was changed.
When you have defined the alert attributes, click the edit icon to close the alert definition editor, and then the save icon (in the upper-right corner of the Alerts table). To discard your changes, click the refresh icon; a popup will ask you to confirm that you wish to discard the changes.
Use the Alerts table to manage an existing alert or create a new alert. Highlight an object in the PEM client tree control to view the alerts that monitor that object.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\a0f6f2eb\alerting_manage_alerts_table.png
The Alert name column displays the name of the alert; to change the alert name, simply replace the name in the table, and click the save icon.
The Alert template column displays the name of the alert template that specifies properties used by the alert. You can use the drop-down listbox to change the alert template associated with an alert.
Use the Alert enable? switch to specify if an alert is enabled (Yes) or disabled (No).
Use the Interval column to specify how often PEM should check to see if the alert conditions are satisfied. Set the Default switch to No and specify an alternate value (in Minutes), or return the Default switch to Yes to reset the value to its default setting. By default, PEM will check the status of each alert once every minute.
Use the History retention field to specify the number of days that PEM will store data collected by the alert. Set the Default* switch to No and specify an alternate value (in Days), or return the Default switch to Yes to reset the value to its default setting. By default, PEM will recommend storing historical data for 30 days.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\fd005f5f\modifying_an_alert_pdf.png
Use fields on the Alert details dialog (see Figure 4.43) to modify the definition of the selected alert. When you've finished modifying the alert definition, click Save to preserve your changes, or Cancel to exit the dialog without saving any changes.
To mark an alert for deletion, highlight the alert name in the Alerts table and click the delete icon to the left of the name; the alert will remain in the list, but in red strike-through font (see Figure 4.44).
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\ff8958cd\alerting_manage_alerts_delete.png
To copy alerts from an object, highlight the object in the PEM client tree control on the main PEM window, and select the Copy Alerts... option from the Management menu. When the Manage Alerts tab opens, click the Copy Alerts icon (located in the Quick Links toolbar) to open the Copy Alert Configuration dialog (see Figure 4.45).
C:\Users\susan\Desktop\alert_copy.png
The Copy Alert Configuration dialog copies all alerts from the object highlighted in the PEM client tree control to the object or objects selected on the dialog. Expand the tree control to select a node or nodes to specify the target object(s). The tree control displays a red warning indicator next to the source object.
Check the Ignore duplicates radio button to prevent PEM from updating any existing alerts on the target objects with the same name as those being copied. Use the Replace duplicates option to replace existing alerts with alerts of the same name from the source object.
Click the Configure Alerts button to proceed to copy the alerts from the source object to all objects of the same type in, or under those objects selected on the Copy Alert Configuration dialog.
PEM provides alert templates that allow you to use the Alerting dialog to create an alert that will trigger when an ERROR or WARNING statement is written to a log file for a specific server or agent. To open the Alerting dialog, highlight the name of the server or agent in the PEM client Object browser tree control, and select Alerting... from the Management menu.
To create an alert that will notify you of ERROR or WARNING messages in the log file for a specific server, create an alert that uses one of the following alert templates:
To create an alert that will notify you of ERROR or WARNING messages for a specific agent, create an alert that uses one of the following alert templates:
Use the Email Groups tab to configure groups of SMTP email recipients. To access the Email Groups tab, select Manage Alerts... from the PEM client's Management menu; when the Manage Alerts tab opens, select Email Groups from the Quick Links toolbar.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\a07dae2b\email_groups_tab.png
The Email Groups tab displays a list of the currently defined email groups (see Figure 4.46). Highlight a group name and click the Edit icon (at the far left end of the row) to modify an existing group.
To define a new email group, click the Add icon (+) in the upper-right corner of the Email Groups table. The Email Group definition dialog opens, as shown in Figure 4.47.
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\3e645ba9\email_group_add.png
Use the Email Group dialog to define an email group and its members:
Click the Add icon (+) in the group members table to open the Options tab, and add the member addresses that will receive notifications for the time period specified:
Use the Subject prefix field to provide a message that will be added to the start of each subject line when a notification is sent.
Use the From Time and To Time time selectors to specify the time range for notifications to the group member(s) that are identified on this row. Provide the From Time and To Time values in the locale of the PEM client host, and the PEM server will translate the time into other time zones as required.
When you've identified the member or members that will receive an email during a specific time period, click the Add icon to add a row to the table, and specify another time period and the email addresses that will be notified during those hours. When you've finished defining the email group, click the Save icon.
To delete an email group, highlight the name of the group in the Email Group table and click the Delete icon (located to the left of the group name).
C:\Users\susan\AppData\Local\Temp\vmware-susan\VMwareDnD\9c1cb73e\email_group_delete.png
The group name will be displayed in the Email Group table in red; click the Save icon to make the change persistent and remove the group from the table (see Figure 4.48).
After creating the email group, you can use the Manage Alerts tab to set up the Notification details for an alert that will direct notifications to the group.

4 Performance Monitoring and Management : 4.5 Alerting : 4.5.2 Using the Manage Alerts Tab

Table of Contents Previous Next