5 Working with Alerts
About Alerts
Oracle GoldenGate Monitor alerts notify you when a specified condition exists for an Oracle GoldenGate component. For example, you can request notification when a process stops or when a specified lag threshold is reached. You select the information to include in the message. To define alerts go to Alert Management in the user interface.
Using the Alert Management, you can:
-
Define alerts using one or more notification channels.
-
Define alerts and enable or disable them when required.
-
Instance objects associations (available objects) are listed based on user's access to different instances.
-
Enforce alerts with Instance Level Security.
Each user specifies which types of alerts Oracle GoldenGate Monitor should produce for them. To enable alerts for a user, go to the User Profile in the Oracle GoldenGate Monitor user interface and follow the instructions in the online help.
Some examples of alerts:
-
An alert that notifies you when the lag of a Capture or Delivery group reaches a certain threshold.
-
An alert that notifies you when there is a failure within the Oracle GoldenGate instance.
-
An alert that notifies you when Capture has reached the end of the transaction log.
Oracle GoldenGate Monitor supports these notification types:
-
Oracle GoldenGate Monitor console
-
Email
-
SNMP
-
Command-line Interface (CLI)
You determine the content of an alert when you create the alert definition.
This topic contains the following information:
Creating Console Alerts
By default, alerts are sent to the Metrics and Alerts tab of Oracle GoldenGate Monitor. Whenever there is an alert, an animated bell icon appears in the Status Bar, which is visible no matter which tab of the application is active.
Alert Icon | Description |
---|---|
![]() |
Warning-level alert |
![]() |
Error-level alert |
If no other notification protocol is required beyond the built-in alert views, you are ready to create your alert definitions. For instructions, see Managing Alert Definitions.
Creating Email, SNMP, and CLI Alerts
To use these three types of alerts, you must configure a default template for Oracle GoldenGate Monitor to use to send the alert. You must configure a given template before you attempt to create the alert definition.
- email Alerts
-
You can configure Oracle GoldenGate Monitor to send email alerts to one or more Oracle GoldenGate Monitor users. You must create at least a de email no For instructions, see Configuring Email Alerts.
- SNMP Alerts
-
You can configure the Oracle GoldenGate Monitor SNMP interface to send alerts in the form of datagrams to any SNMP server. The datagrams are received by a trap recipient that is listening on a specific port. Versions 1 and 2a of SNMP are supported. For instructions, see Configuring SNMP Alerts.
- CLI Alerts
-
You can configure the Oracle GoldenGate Monitor Command Line Interface (CLI) to execute a script or binary file on the Oracle GoldenGate Monitor Server when an alert is triggered. (Creating CLI alerts does not support authentication.) For instructions, see Configuring CLI Alerts.
Managing Alert Definitions
Use the Alert Definition subtab of the Alert Management tab to create, view, and modify alert definitions. Super Administrators, Administrators, and Power Operators can configure alert definitions.
-
The Manage Alert Definitions table on this tab displays the existing alert definitions, with the following columns:
-
Definition Name: The name of the alert.
-
Object Type: The type of Oracle GoldenGate object for which this alert will be triggered. See About the Objects.
-
Assigned Users Objects: The Oracle GoldenGate Monitor users that can receive the alert for the object. All objects are displayed. The following naming convention is used in displaying the available objects:
Username:fully_qualified_object_name
Example:
superuser:system/abc.host.com/abc.host.com-6890/PUMP12
-
Alert Enabled: Whether or not the alert is enabled or disabled.
-
Date Modified: The date and time that the alert was last modified.
On the Alert Management tab, you can take the following actions:
-
To create an alert definition, click New Alert Definition. See Configuring an Alert Definition.
-
To edit an alert definition, click its name in the list to open the Edit Alert Definition screen. See Configuring an Alert Definition.
-
To delete an alert definition, select the check box next to its name, and then click Remove Definition(s).
-
To create a notification template, click the Notification Template subtab, and then click New Notification Template. See Creating Email, SNMP, and CLI Alerts.
Note:
Alerts for DB and Trails cannot be created.
Related Topics
Configuring an Alert Definition
An Oracle GoldenGate Monitor user with the Administrator, Power Operator, or SuperAdmin role can create or edit an alert definition. You can create as many alert definitions as you like.
Note:
When creating or editing an alert, the following steps are displayed as the New Alert Definition screen. When editing an alert, the steps are displayed as the Edit Alert Definition screen. The functionality for the two are identical, except that default values are shown when creating a new alert, but current values are shown when editing an alert.
To create or edit an alert definition
About the Alert Operators
Oracle GoldenGate Monitor uses the following operators to establish a relationship between an metric and a value for that metric when creating alert criteria.
Operator | Description |
---|---|
< |
Less than. For example: Mapped Total Updates < 10000 |
<= |
Less than or equal to. For example: Start Time <= 06/01/2010 12:00 PM |
> |
Greater than. For example: Lag > 3 sec |
>= |
Greater than or equal to. For example: Last Checkpoint Timestamp >= 06/01/2010 12:00 PM |
!= |
Not equal to. For example: Status != Running |
== |
Equal to. For example: Group Name = ext01 |
contains |
Displays when the metric is Message.text. |
Related Topics