Monitoring Adapter Status
Status information is available between the correlator and an adapter. When developing an IAF adapter, the adapter author can provide the ability to make use of this status information. Basic information, such as whether an adapter is up or down, is available using a standard Apama monitor. Other information, such as the number of connections an adapter has, can be provided by using the getStatus() method in an adapter’s transport and codec. Optionally, adapter authors can also add code to the adapter’s service monitors to send and receive specific status information that application developers can then use when they write Apama applications that connect to the adapters.
Apama provides the following two mechanisms for handling IAF Adapter status information:
IAFStatusManager — The IAFStatusManager manages the connection status and other status information from the adapter to the correlator. In order to retrieve adapter status information, the IAFStatusManager needs to be injected into the correlator and the adapter author needs to add a small amount of code to the adapter. Application authors can then make use of status information available from the IAFStatusManager.
StatusSupport — StatusSupport is a generic interface (or contract) between an Apama application and an adapter’s service monitors. This interface provides a way to provide an application with a similar view of all the status information available from multiple adapters. In order to use the StatusSupport interface, an adapter author writes code in the adapter’s service monitors that send or receive specific StatusSupport events. In turn, the application author writes code to implement the desired behavior for handling the StatusSupport events.
Using the StatusSupport interface is optional. For more information on using this interface, see
StatusSupport.
