ENABLEMONITORING

Valid For

GLOBALS

Description

Use the ENABLEMONITORING parameter to enable the monitoring of Oracle GoldenGate instances from Oracle GoldenGate Monitor and collect trend data for Performance Metrics Server. In Classic Architecture, it directs Manager to publish the monitoring points that provide status and other information to the Oracle GoldenGate Monitor clients.

Performance Metrics Server is used to monitor processes or services and collect statistics. From Oracle GoldenGate 20c (201.0) onward, Unix Domain Sockets (UDS) is used to communicate with the local Performance Metrics Server. UDS is the default mode in Performance Metrics Server. This feature is applicable to both Classic and Microservices architecture and to Oracle and non-Oracle databases.

For operating systems such as Windows and others, which do not support UDS, UDP would continue to be used. If you are working on operating systems that don't support UDS, you need to set the ENABLEMONITORING UDP parameter before starting the server in legacy, to bring up the PMSRVR GLOBALS parameter. For Oracle GoldenGate MA it is done by default. For details, see Using UDS to Communicate with PMServer in Administering Oracle GoldenGate.

Before you enable monitoring on any given platform, see Introduction to Oracle GoldenGate Monitoring in the Administering Oracle GoldenGate Monitor for your database to make certain that the operating system is supported.

Note:

When monitoring is enabled on a UNIX system for a high number of Oracle GoldenGate processes (approximately 400), the system-imposed limit on the maximum amount of allowed shared memory may be exceeded. The message returned by Manager is similar to this:

WARNING OGG-01934  Datastore repair failed" reported during "start... 

If this occurs, increase the kernel parameter kernel.shmall by eight times the default for the operating system.

Default

Disabled

Syntax

ENABLEMONITORING 
    [ UDP ]
    [ UDPPORT portnumber ] 
    [ HTTPPORT portnumber ]

UDPPORT portnumber

Valid with UDP for monitoring with a Performance Metrics Server (PMSRVR) on Windows and other operating systems that don't support UDS.

The UDP listening port. It is optional. If provided, it overrides the existing GLOBALS parameter,REPOUDPPORT. If not provided, it uses the value of REPOUDPPORT as the port number.

You can change the UDP port of a PMSRVR in a secure deployment by adding the repoUDPPORT parameter to the GLOBALS file. For more information on configuring the UDP and TCP ports for PMSRVR, see How to Create Secure or Non-Secure Deployments.

HTTPPORT portnumber

Valid with UDP for monitoring with a Performance Metrics Server. Not valid for the BDB or LMDB monitoring modes.

The HTTP listening port for the service. It is optional. If not provided, 9004 is the default port number.