org.lsst.ccs

Class AlertService

java.lang.Object

org.lsst.ccs.AlertService

All Implemented Interfaces:

HasLifecycle, AgentService

Direct Known Subclasses:

AlertService

Deprecated.

Class org.lsst.ccs.services.alert.AlertService should be used instead

@Deprecated
public class AlertService
extends Object
implements HasLifecycle, AgentService

Agent AlertService. It is a Service that is created for all Agents. It offers an interface to manage alerts: raise and clear alerts. Any time alerts are either raised or cleared registered s will be notified via an AlertEvent with the information needed to act upon the change. This Alert management component is activated for all agents. The AlertService also keeps a summary and a history for all the raised alerts that have not been cleared. For Agents of type WORKER or for services (MCM, OCS_BRIDGE, etc) the internal raised alert summary is published on the status bus wrapped in a StatusRaisedAlertSummary object when: - the Agent starts up - when a Console or a Service connects to the buses For all Agents this raised alert summary can be published on request via the #publishRaisedAlertSummary method; this method is meant to be invoked by Agents that do not hold an up-to-date copy of an alert summary object. Raised Alert listening on the buses: the AlertService also provides the ability to start a status bus message listener to intercept Alert related status messages from other subsystems and notify the registered AlertListeners accordingly. To activate the status bus message listener the method #startStatusAlertListening must be invoked before theHasLifecycle#start phase, providing a Predicate<AgentInfo> to select which agents to listen to. By default status bus listening is activated for Consoles and Services with a Predicate selecting either WORKERS or Services.

Author:

LSST CCS Team

Constructor Summary

Constructors

Constructor and Description
AlertService() Deprecated.

Method Summary

Modifier and Type	Method and Description
void	addClearAlertHandler(ClearAlertHandler handler) Deprecated. Add a ClearAlertHandler to this Subsystem.
void	addListener(AlertListener listener) Deprecated.
void	build() Deprecated. First lifecycle hook.
String[]	clearAlerts(String... alertId) Deprecated. Method similar to #clearAlerts(String, String...) with default source equal to the agent name.
String[]	clearAlertsForSource(String source, String... alertId) Deprecated. Clear one or more Alerts for a given source by providing the alert id of the alerts to be cleared.
String[]	clearAllAlerts() Deprecated. Method similar to #clearAllAlerts(String) with default source equal to the agent name.
String[]	clearAllAlertsForSource(String source) Deprecated. Attempt to clear all the outstanding alerts for a given source.
String	getAgentServiceName() Deprecated. Get the name of this service.
Map<String,RaisedAlertSummary>	getAllSummaries() Deprecated.
RaisedAlertSummary	getRaisedAlertSummary() Deprecated. Clients interested in getting the full alert summary should use the publishRaisedAlertSummary method.
RaisedAlertSummary	getSummary(String source) Deprecated.
void	postInit() Deprecated. Population of clear alert handlers.
void	postShutdown() Deprecated. Called from the enclosing Subsystem when HasLifecycle.shutdown() has been called after shtudownNow has been invoked on all the children.
void	publishRaisedAlertSummary() Deprecated. Publish on the status bus the Subsystem's RaisedAlertSummary.
void	raiseAlert(Alert alert, AlertState severity, String cause) Deprecated. Method similar to #raiseAlert(String,Alert,AlertState,String) where the source argument is set to be the agent name.
void	raiseAlert(String source, Alert alert, AlertState severity, String cause) Deprecated. Raise an Alert with a given AlertState for a given source.
void	removeListener(AlertListener listener) Deprecated.
void	shutdown() Deprecated. Called from the enclosing Subsystem when HasLifecycle.shutdown() has been called.
void	start() Deprecated. Called from the enclosing Subsystem when Agent.startAgent() has been called.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.lsst.ccs.framework.HasLifecycle

init, postBuild, postStart

Methods inherited from interface org.lsst.ccs.services.AgentService

startForAgent

Constructor Detail

AlertService

public AlertService()

Deprecated.

Method Detail

getAgentServiceName

public String getAgentServiceName()

Deprecated.

Description copied from interface: AgentService

Get the name of this service. This name will be used to add the given service to the lookup tree.

Specified by:

getAgentServiceName in interface AgentService

Returns:

the AgentService name.

build

public void build()

Deprecated.

Description copied from interface: HasLifecycle

First lifecycle hook. Modification of the component tree is allowed at this stage. After this stage the tree of component cannot be modified anymore. This is where agent periodic tasks should be scheduled.

Specified by:

build in interface HasLifecycle

postInit

public void postInit()

Deprecated.

Population of clear alert handlers. We are also starting listening on the status bus when this agent is either a Console or a Service. We are listening for Alert related status messages as published by workers or services.

Specified by:

postInit in interface HasLifecycle

start

public void start()

Deprecated.

Description copied from interface: HasLifecycle

Called from the enclosing Subsystem when Agent.startAgent() has been called. At the time it is called :

• the PhaseState is INITIALIZING
• connection with the messaging layer is effective, the enclosing subsystem has started StatusHeartBeat publication
• the startup configuration has been loaded (if provided). IMPORTANT NOTE : This statement will not be true in future releases. Code that expect the startup configuration to be loaded should be moved from start to postStart.

It is unnecessary to call super.start()

Specified by:

start in interface HasLifecycle

shutdown

public void shutdown()

Deprecated.

Description copied from interface: HasLifecycle

Called from the enclosing Subsystem when HasLifecycle.shutdown() has been called. At the time it is called :

• PhaseState is CLOSING.
• HardwareController.checkStopped() has been called

It should be overridden to free non hardware related resources.

Specified by:

shutdown in interface HasLifecycle

postShutdown

public void postShutdown()

Deprecated.

Description copied from interface: HasLifecycle

Called from the enclosing Subsystem when HasLifecycle.shutdown() has been called after shtudownNow has been invoked on all the children. At the time it is called :

• PhaseState is CLOSING.
• HardwareController.checkStopped() has been called

It should be overridden to free non hardware related resources.

Specified by:

postShutdown in interface HasLifecycle

addClearAlertHandler

public void addClearAlertHandler(ClearAlertHandler handler)

Deprecated.

Add a ClearAlertHandler to this Subsystem.

Parameters:

handler - The ClearAlertHandler class that will handle the clearing of alerts.

raiseAlert

public void raiseAlert(String source,
                       Alert alert,
                       AlertState severity,
                       String cause)

Deprecated.

Raise an Alert with a given AlertState for a given source. This raises an internal alert and all the registered AlertListeners will be notified with an AlertEvent of type ALERT_RAISED. A special case is when the source is equal to the agent name. In this case we have a listener that will publish a status message on the buses.

Parameters:

alert - The Alert instance to be raised

severity - The AlertState of this Alert.

cause - The reason the Alert was raised.

source - The source for which we raise an alert

raiseAlert

public void raiseAlert(Alert alert,
                       AlertState severity,
                       String cause)

Deprecated.

Method similar to #raiseAlert(String,Alert,AlertState,String) where the source argument is set to be the agent name. This is a convenience method that will trigger a status message publication.

Parameters:

alert -

severity -

cause -

clearAlertsForSource

public String[] clearAlertsForSource(String source,
                                     String... alertId)

Deprecated.

Clear one or more Alerts for a given source by providing the alert id of the alerts to be cleared.

Parameters:

source - The source for which to clear the alerts.

alertId - the Id of the Alerts to be cleared.

Returns:

The String array with the ids of the alerts that have been cleared.

clearAlerts

@Command(description="Clear alerts",
         type=ACTION)
public String[] clearAlerts(String... alertId)

Deprecated.

Method similar to #clearAlerts(String, String...) with default source equal to the agent name. This method is annotated to be invoked over the buses by other consoles.

Parameters:

alertId -

Returns:

clearAllAlertsForSource

public String[] clearAllAlertsForSource(String source)

Deprecated.

Attempt to clear all the outstanding alerts for a given source.

Parameters:

source - the source for which to clear the alerts.

Returns:

The String array with the ids of the alerts that have been cleared.

clearAllAlerts

@Command(description="Clear all alerts",
         type=ACTION)
public String[] clearAllAlerts()

Deprecated.

Method similar to #clearAllAlerts(String) with default source equal to the agent name. This method is annotated to be invoked over the buses by other consoles.

Returns:

getRaisedAlertSummary

@Deprecated
 @Command(description="Get the Raised Alert Summary",
         type=QUERY)
public RaisedAlertSummary getRaisedAlertSummary()

Deprecated. Clients interested in getting the full alert summary should use the publishRaisedAlertSummary method.

Get the Subsystem's RaisedAlertSummary.

Returns:

The RaisedAlertSummary for this subsystem.

publishRaisedAlertSummary

@Command(description="Publish the Raised Alert Summary",
         type=QUERY)
public void publishRaisedAlertSummary()

Deprecated.

Publish on the status bus the Subsystem's RaisedAlertSummary.

addListener

public final void addListener(AlertListener listener)

Deprecated.

removeListener

public final void removeListener(AlertListener listener)

Deprecated.

getSummary

public RaisedAlertSummary getSummary(String source)

Deprecated.

getAllSummaries

public Map<String,RaisedAlertSummary> getAllSummaries()

Deprecated.