System events are produced by Agent and are used to inform the client of a change in the system operations. Such events as a Container status change, configuration change, and resource allocation alerts are currently supported. Other event types may be added in the future.
Agent monitors the system at all times and triggers an event as soon as it detects the corresponding change. In order to be automatically notified of an event, the client must subscribe to the event notification services first. This is accomplished by executing the subscribe
or subscribe_alert
calls.
The client subscribes to a particular event type by specifying the event subscription name, which is defined for every event type individually. The Elements section describes the event types and their corresponding subscription names. The subscription name is used when you subscribe to an event. The same name is then used as the value of the target
element of the event notification message, so that you can recognize the event message among other messages that you might be receiving from the Agent server side.
The following subsections describe currently supported event types and provide examples.