ListenerServiceStatus

Shows live data about the Listener Service, such as health and version number.

{
    "health": "ok",
    "instances": {
        "0C-C4-7A-A9-09-28": {
            "hostedBy": "other",
            "hostname": "listenerservice-vm-01",
            "ipAddress": "192.168.1.100",
            "javaVersion": "Oracle Corporation 1.8.0_241",
            "operatingSystemVersion": "Windows 7 6.1 amd64",
            "timestamp": 1688420305840,
            "version": "2.27.0 (100)"
        },
        "0C-C4-7A-A9-09-29": {
            "hostedBy": "other",
            "hostname": "listenerservice-vm-02",
            "ipAddress": "192.168.1.101",
            "javaVersion": "Oracle Corporation 1.8.0_241",
            "operatingSystemVersion": "Windows 7 6.1 amd64",
            "timestamp": 1688420310840,
            "version": "2.27.0 (100)"
        }
    },
    "listenerServiceId": "4fb329c03a8ce62480d87e24",
    "version": "2.27.0 (100)"
}

Properties

health

Whether the Listener Service is ok, hosed, or unknown.

instances

Details about the member instances of the Listener Service HA cluster, which all share the same Listener Service ID. The key of this map is the MAC address of the instance (in uppercase dashed hex notation), and the value is an object containing the IP address, hostname, Listener Service version, Java runtime version, and operating system version of the instance, along with the timestamp of the last successful health check from this instance.

Instances will remain in this map for a long time, even if they have been failing all health checks, so you should compare this timestamp to the current time if you plan to derive a list of recently healthy Listener Service instances.

If this Listener Service is not clustered, this map will contain only one entry. If this map is empty, the Listener Services may have been offline for a long time, or they may be older than 2.27.0.

listenerServiceId

The ID of the Listener Service.

version

The version and build of the Listener Service that's running, for example, 1.9.0 (32).