9.5.5 Monitoring Service Registration Operations

The SHOW STATS -REG command enables you to monitor database service registration operations that the listener handles, analyze the traffic or overhead of these operations, and diagnose registration-related issues.

An Oracle Database instance registers or updates its services and related information with the listener through service registration operations, such as REGISTER, UPDATE, RE-REGISTER, or UN-REGISTER. The listener keeps a record (count) of all these registration operations. You can query statistics about this data either periodically or for a particular period. Monitoring these statistics is especially helpful in Oracle Autonomous Database environments, where the listener continuously receives registration and update information from multiple instances.

To display statistics about database service registration operations, run the following command at the Listener Control (LSNRCTL) utility prompt:

LSNRCTL SHOW STATS -REG

You can also run this command from the Oracle Connection Manager Control (CMCTL) utility for the Oracle Connection Manager listener.

For a list of all the arguments that you can use with SHOW STATS, see Oracle AI Database Net Services Reference.

The SHOW STATS command generates an output that typically includes these sections:

Output Section	Description
Instance Name, Service Name, and Global Level statistics	The output fields display statistics at these levels, depending on the arguments that you enter with SHOW STATS: Instance Name: Statistics for the specified instance name or for all instances associated with the service Service Name: Statistics for the specified service name or for all services registered with the listener Global Level: Statistics for all instances, registered services, handlers allocated to these services, listening endpoints, and access control lists (ACLs)
Command summary	Registration operations through which an instance registers or updates its services and related information (such as handlers, endpoints, or ACLs) with the listener: REGISTER UPDATE RE-REGISTER UN-REGISTER Counters showing the number of commands received by the listener: Instance: Number of instance registration, instance update, instance re-registration, and instance un-registration commands received. Service: Number of service registration, service update, service re-registration, and service un-registration commands received. ENDP (listening endpoint): Number of endpoints registration, endpoints update, endpoints re-registration, and endpoints un-registration commands received. Handler: Number of handlers registration, handlers update, handlers re-registration, and handlers un-registration commands received. INF (related ACL information): Number of ACL registration, ACL update, ACL re-registration, and ACL un-registration commands received.
Recent count	Periodic count of all commands received by the listener from the last reset, that is, from the time you cleared the Recent section using -clear. If you have not used -clear till now, then this field displays a cumulative count of all registration commands received since the listener started. The Recent Duration field specifies a cumulative time (in days, hours, minutes, and seconds) from the last reset (if used -clear) or since the listener started (if not used -clear).
Cumulative count	Total number of commands received by the listener, collected since the listener started.
Flags, Goodness, and Delta summary	Summary of service update metrics for all services registered with the listener. These fields appear only for service-level queries.

Example 9-7 Sample SHOW STATS Command Output

LSNRCTL:lsnr1> show stats -reg
------------------------
Global Level:
                     Recent
Recent Duration: 5 days 17 hr. 15 min. 25 sec
Command    Instance Service ENDP  Handler  INF
Registration       2        2        2        4        0
Updates            3        0        0       12        0
Re-Register        1        3        0        0        0
Un-Register        0        0        0        0        0
                     Cumulative
Registration       3        3        3        6        0
Updates            4        0        0       12        0
Re-Register        1        3        0        0        0
Un-Register        0        0        0        0        0
The command completed successfully