org.lsst.ccs.monitor

Class Monitor

java.lang.Object

org.lsst.ccs.monitor.Monitor

All Implemented Interfaces:

HasLifecycle, AgentService, HasDataProviderInfos

public class Monitor
extends Object
implements HasLifecycle, HasDataProviderInfos, AgentService

Author:

emarin

Field Summary

Fields

Modifier and Type	Field and Description
protected Logger	log
static String	MONITOR_CHECK_TASK
static String	MONITOR_PUBLISH_TASK
static String	MONITOR_UPDATE_TASK

Constructor Summary

Constructors

Constructor and Description
Monitor()

Method Summary

Modifier and Type	Method and Description
void	build() First lifecycle hook.
String	getAgentServiceName() Get the name of this service.
Alarm	getAlarm(String name) Gets the alarm with the given name.
Channel	getChannel(int id) Gets the channel with the given ID.
Channel	getChannel(String name) Gets the channel with the given name.
int	getChannelId(String name) Gets the ID of the channel with the given name.
List<String>	getChannelNames() Gets the list of channel names.
Double	getChannelValue(String name) Gets a monitored channel value.
List<DataProviderInfo>	getDataProviderInfos() Get the list of available DataProviderInfos.
Device	getDevice(String name) Gets the device with the given name.
List<String>	getDeviceNames() Gets the list of all device names.
String	getMonitorPublishTaskName(MonitorUpdateTask task)
List<MonitorUpdateTask>	getMonitorTasksList()
String	getMonitorUpdateTaskName(MonitorUpdateTask task)
List<MonitorUpdateTask>	getMonitorUpdateTasksForDevice(Device dev)
int	getNumChans() Gets the number of channels.
void	init() Called from the enclosing Subsystem at initialization phase.
void	postInit() Called from the enclosing Subsystem at construction phase.
String	printMonitoringThreads() Gets a printout of the monitoring threads.
void	publishDataProviderCurrentData(AgentInfo... agents) Publish the current data of all the DataProviderInfos managed by this object for the provided list of Agents.
Double	readChannelValue(String name) Reads a monitored channel value.
void	start() Called from the enclosing Subsystem.
boolean	startForAgent(AgentInfo agentInfo) This method is invoked after an agent service is created to see if this service is to be started for the tiven Agent.

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

postBuild, postShutdown, postStart, shutdown

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

finalizeDictionary

Field Detail

log

protected Logger log

MONITOR_CHECK_TASK

public static final String MONITOR_CHECK_TASK

See Also:

Constant Field Values

MONITOR_UPDATE_TASK

public static final String MONITOR_UPDATE_TASK

See Also:

Constant Field Values

MONITOR_PUBLISH_TASK

public static final String MONITOR_PUBLISH_TASK

See Also:

Constant Field Values

Constructor Detail

Monitor

public Monitor()

Method Detail

getAgentServiceName

public String getAgentServiceName()

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.

startForAgent

public boolean startForAgent(AgentInfo agentInfo)

Description copied from interface: AgentService

This method is invoked after an agent service is created to see if this service is to be started for the tiven Agent.

Specified by:

startForAgent in interface AgentService

Returns:

true if the service is to be added to the given agent.

start

public void start()

Description copied from interface: HasLifecycle

Called from the enclosing Subsystem. 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

build

public void build()

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

getMonitorTasksList

public List<MonitorUpdateTask> getMonitorTasksList()

getMonitorUpdateTasksForDevice

public List<MonitorUpdateTask> getMonitorUpdateTasksForDevice(Device dev)

postInit

public void postInit()

Description copied from interface: HasLifecycle

Called from the enclosing Subsystem at construction phase. This method is called after init and postInit have been called on this component's children.

Specified by:

postInit in interface HasLifecycle

init

public void init()

Description copied from interface: HasLifecycle

Called from the enclosing Subsystem at initialization phase.

This method is called before the children components of this object have their init method called.

At the time it is called, connection to the messaging layer is not yet done, so there should be no attempt to send messages in the body of this method. Configuration for message listening can nevertheless be done here, such as adding MessageListener objects.

It is unnecessary to call super.init()

Specified by:

init in interface HasLifecycle

getDevice

public Device getDevice(String name)

Gets the device with the given name.

Parameters:

name - The device name

Returns:

The matching device, or null if not found

printMonitoringThreads

@Command(type=QUERY,
         description="Show the monitoring threads",
         category=SYSTEM)
public String printMonitoringThreads()

Gets a printout of the monitoring threads.

Returns:

A printout of the monitoring threads

getDeviceNames

@Command(type=QUERY,
         description="Get the list of all devices",
         category=CORE)
public List<String> getDeviceNames()

Gets the list of all device names.

Returns:

The list of device names

getAlarm

public Alarm getAlarm(String name)

Gets the alarm with the given name.

Parameters:

name - The alarm name

Returns:

The matching alarm, or null if not found

getChannel

public Channel getChannel(String name)

Gets the channel with the given name.

Parameters:

name - The channel name

Returns:

The matching channel, or null if not found

getChannel

public Channel getChannel(int id)

Gets the channel with the given ID.

Parameters:

id - The channel ID

Returns:

The matching channel

getChannelId

public int getChannelId(String name)

Gets the ID of the channel with the given name.

Parameters:

name - The channel name

Returns:

The ID of the matching channel, or -1 if not found

getNumChans

public int getNumChans()

Gets the number of channels.

Returns:

The number of channels

getChannelNames

@Command(type=QUERY,
         description="Get the list of channel names",
         category=CORE)
public List<String> getChannelNames()

Gets the list of channel names.

Returns:

The list of channel names

getChannelValue

@Command(type=QUERY,
         description="Get a channel value",
         category=CORE)
public Double getChannelValue(String name)

Gets a monitored channel value.

Parameters:

name - The channel name

Returns:

The last-read channel value, or null if the name is unknown

readChannelValue

@Command(type=QUERY,
         description="Read a channel value",
         category=CORE,
         level=1)
public Double readChannelValue(String name)

Reads a monitored channel value.

Parameters:

name - The channel name

Returns:

The read channel value, NaN if the data isn't available, or null if the name is unknown

getDataProviderInfos

public List<DataProviderInfo> getDataProviderInfos()

Description copied from interface: HasDataProviderInfos

Get the list of available DataProviderInfos.

Specified by:

getDataProviderInfos in interface HasDataProviderInfos

Returns:

a List of DataProviderInfos

publishDataProviderCurrentData

public void publishDataProviderCurrentData(AgentInfo... agents)

Description copied from interface: HasDataProviderInfos

Publish the current data of all the DataProviderInfos managed by this object for the provided list of Agents.

Specified by:

publishDataProviderCurrentData in interface HasDataProviderInfos

Parameters:

agents - The array of AgentInfo for which we are requesting to publish the data.

getMonitorUpdateTaskName

public String getMonitorUpdateTaskName(MonitorUpdateTask task)

getMonitorPublishTaskName

public String getMonitorPublishTaskName(MonitorUpdateTask task)