Caché Monitoring Guide - InterSystems Documentation

Monitoring Caché Using Web Services
SAMPLES>zn "%sys"
%SYS>Set client=##class(SYS.WSMon.Client).%New()
%SYS>Set client.Location="http://localhost:57799/csp/sys/SYS.WSMon.Service.cls"
%SYS>Set myroutinestats=client.GetRoutine()
%SYS>Write myroutinestats.RtnCallsLocal
19411581
%SYS>Write myroutinestats.RtnCallsRemote
0
%SYS>Write myroutinestats.RtnCommands
432764817
%SYS>
More typically, you create and use the client programmatically, perhaps to retrieve data for display in a user interface.
Note:
Remember that the SYS.WSMon package is available only in %SYS namespace, which means that you must be
in that namespace to perform the steps described here.
D.6 Processing Events
Caché provides a sample web service (SYS.WSMon.EventSink) that can receive and process events sent by any Caché
Monitoring Web Service. You can use this web service or create and use your own.
D.6.1 Using the Sample Event Sink Web Service
SYS.WSMon.EventSink is a sample Caché web service that can receive and process events.
For a given Caché instance, the Caché Monitoring Web Service is available at the following URL:
http://server:port/csp/sys/SYS.WSMon.EventSink.cls
Where server is the server on which Caché is running and port is the port that the Caché web server uses.
This web service has one method:
CacheEventSink()
Method CacheEventSink(event As SYS.WSMon.wsEvent) As %Integer
On Windows platforms, this sample method displays a popup window when an event occurs; for other platforms,
it adds an entry to ^SYS("MONITOR","WSMON","EVENT_RECEIVED",$h).
This method always returns 1.
To subscribe this sample service so that it will receive events from the Monitoring Web Service, do the following in the
Terminal:
SER>zn "%sys"
%SYS>Set client=##class(SYS.WSMon.Client).%New()
%SYS>Set eventsinklocation="http://localhost:57772/csp/sys/SYS.WSMon.EventSink.cls"
%SYS>Set subscriptionid=client.EventSubscribe(eventsinklocation)
%SYS>Write subscriptionid
CacheEventSubscription_2
Here eventsinklocation is the URL for the event sink web service that will process events.
128 Caché Monitoring Guide