Home > Class Reference > %SYS namespace > %SYSTEM.Monitor


abstract class %SYSTEM.Monitor extends %SYSTEM.Help

The %SYSTEM.Monitor class provides an interface for accessing the System Monitor. You can Get/Set/Clear the system 'State' and 'Alerts' counter.

You can use it via the special $SYSTEM object.

You can call help to get a list of all entrypoints:

Do $SYSTEM.Monitor.Help()

Method Inventory (Including Private)

Methods (Including Private)

classmethod Alerts() as %Integer [ Language = objectscript ]
Returns the number of alerts posted to messages.log.
classmethod Clear() as %Integer [ Language = objectscript ]
Clears the alerts counter and sets the system state = 0 (OK).
classmethod ClearAlerts() as %Integer [ Language = objectscript ]
Clears the alerts counter.
classmethod GetAlerts(Alerts As %Integer, Messages As %String, LastAlert As %String = "") as %Status [ Language = objectscript ]
Read messages from the alerts.log file. Returns the number of messages in 'Alerts' and an array of those messages in 'Messages'. 'LastAlert' contains the last message added to the alerts.log file.

This may be called periodically to get only recently added alerts. The first time GetAlerts is called, the caller should set LastAlert="". The caller may then retain the returned value and pass that LastAlert back in subsequent calls, to only retrieve messages added since then.
classmethod SetState(State As %Integer) as %Integer [ Language = objectscript ]
Set the system state. See State() for allowed integer values.
classmethod State() as %Integer [ Language = objectscript ]
Returns the system state as an integer.

-1: System is hung
0: System state is OK
1: System state is Warning
2: System state is Alert

Inherited Members

Inherited Methods (Including Private)