1. Parameters and Functions Reference Guide
  2. Oracle GoldenGate Parameters
  3. ENABLEMONITORING

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 Service.

Performance Metrics Server is used to monitor processes or services and collect statistics. Starting with Oracle GoldenGate 21c, Unix Domain Sockets (UDS) is used to communicate with the local Performance Metrics Service.
UDS is the default mode in Performance Metrics Service. This feature is applicable for Oracle GoldenGate Microservices Architecture for 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 Protocols for Performance Monitoring for Different Operating Systems in Oracle GoldenGate Microservices Architecture.

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 Add a Deployment.

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.