org.lsst.ccs.localdb.statusdb.server

Class DataServer

java.lang.Object

org.lsst.ccs.localdb.statusdb.server.DataServer

@Singleton
public class DataServer
extends Object

The DataServer receives requests for trending data analysis. It delivers the requested data as the result of requests to the database.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	DataServer.StatEntry

Constructor Summary

Constructors

Constructor and Description
DataServer()

Method Summary

Modifier and Type	Method and Description
protected Data	exportRawData(String path, long rawId, long t1, long t2)
protected Data	exportStatDataFromRaw(String path, long rawId, long t1, long t2, int nsamples)
protected Data	exportStatDataFromRawNative(String path, long rawId, long t1, long t2, int nsamples)
protected Data	exportStatDataFromStat(String path, StatDesc statDesc, long t1, long t2, int nsamples)
AlertEvent.AlertEventList	getActiveAlerts(List<Long> ids) Returns a list of active alerts.
AlertEvent.AlertEventList	getAlertHistories(List<Long> ids, long t1, long t2) Returns an history of alerts that have been raised within the given time interval.
AlertInfo.AlertInfoList	getAlertInfo()
AlertInfo.AlertInfoList	getAlertInfo(String subsystem)
protected long	getAvailableRawData(long rawId, long t1, long t2)
protected Map<StatDesc,Long>	getAvailableStats(long rawId, long t1, long t2) Counts for each StatDesc entity associated to the given DataDesc id, how many StatData entities span the given time interval [t1,t2[.
DataChannel.DataChannelList	getChannels(long dt)
DataChannel[]	getChannels(String partialPath, int level)
DataChannel.DataChannelList	getChannels(String subsystemName, long dt)
StateChange.StateChangesList	getComponentStateChangeList(String subsystem, String component, List<String> states, long t1, long t2) Gets the state changes events for the given list of states, between the time interval [t1,t2], for a given component of a subsystem.
List<Data>	getData(List<Long> ids, long t1, long t2, String flavor, int nbins)
Data	getData(long id, long t1, long t2, String flavor, int nbins)
List<Data>	getDataByPath(List<String> paths, long t1, long t2, String flavor, int nbins)
TrendingData	getLatestDataByPath(String path)
List<ChannelMetaData>	getMetadataForChannel(int channelId, long t1, long t2)
ChannelMetaData.ChannelMetadataList	getMetadataList(long channelId)
TrendingPlotData.TrendingPlotDataList	getPlotData(long id, long t1, long t2) Returns a list of trended plots for the given data desc id, between the time interval [t1,t2].
List<RawData>	getRawData(long id, long t1, long t2)
org.hibernate.SessionFactory	getSessionFactory()
protected List<StatData>	getStatData(StatDesc statDesc, long t1, long t2) Returns the list of StatData with the given statDesc that overlap the interval [t1,t2[.
StateChange.StateChangesList	getStateChangeList(String subsystem, List<String> states, List<String> components, long t1, long t2) Gets the state changes events for the given list of states, between the time interval [t1,t2], for the given subsystem.
StateInfo.StateInfoList	getStateInfo(String subsystem) Lists all the existing states for a given subsystem.
DataSubsystem.DataSubsystemList	getSubsystems()

Methods inherited from class java.lang.Object

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

Constructor Detail

DataServer

public DataServer()

Method Detail

getSessionFactory

public org.hibernate.SessionFactory getSessionFactory()

getLatestDataByPath

public TrendingData getLatestDataByPath(String path)

getDataByPath

public List<Data> getDataByPath(List<String> paths,
                                long t1,
                                long t2,
                                String flavor,
                                int nbins)

getData

public List<Data> getData(List<Long> ids,
                          long t1,
                          long t2,
                          String flavor,
                          int nbins)

getData

public Data getData(long id,
                    long t1,
                    long t2,
                    String flavor,
                    int nbins)

getMetadataForChannel

public List<ChannelMetaData> getMetadataForChannel(int channelId,
                                                   long t1,
                                                   long t2)

getMetadataList

public ChannelMetaData.ChannelMetadataList getMetadataList(long channelId)

getSubsystems

public DataSubsystem.DataSubsystemList getSubsystems()

getChannels

public DataChannel.DataChannelList getChannels(long dt)

Returns:

the whole channels list for all CCS. optional query parameter maxIdleSeconds with default value 86400: only returns parameters seen since that delay. Negative value: returns all channels.

getChannels

public DataChannel.DataChannelList getChannels(String subsystemName,
                                               long dt)

Parameters:

subsystemName -

Returns:

a channels list for a subsystem optional query parameter maxIdleSeconds with default value 36000: only returns parameters seen since that delay. Negative value: returns all channels.

getChannels

public DataChannel[] getChannels(String partialPath,
                                 int level)

Parameters:

partialPath -

level -

Returns:

the list of channels within a partial path and a level

getAvailableStats

protected Map<StatDesc,Long> getAvailableStats(long rawId,
                                               long t1,
                                               long t2)

Counts for each StatDesc entity associated to the given DataDesc id, how many StatData entities span the given time interval [t1,t2[.

Parameters:

rawId - the DataDesc id

t1 -

t2 -

Returns:

getAvailableRawData

protected long getAvailableRawData(long rawId,
                                   long t1,
                                   long t2)

getRawData

public List<RawData> getRawData(long id,
                                long t1,
                                long t2)

getStatData

protected List<StatData> getStatData(StatDesc statDesc,
                                     long t1,
                                     long t2)

Returns the list of StatData with the given statDesc that overlap the interval [t1,t2[.

Parameters:

statDesc - the statistical description

t1 -

t2 -

Returns:

exportRawData

protected Data exportRawData(String path,
                             long rawId,
                             long t1,
                             long t2)

exportStatDataFromRaw

protected Data exportStatDataFromRaw(String path,
                                     long rawId,
                                     long t1,
                                     long t2,
                                     int nsamples)

exportStatDataFromRawNative

protected Data exportStatDataFromRawNative(String path,
                                           long rawId,
                                           long t1,
                                           long t2,
                                           int nsamples)

exportStatDataFromStat

protected Data exportStatDataFromStat(String path,
                                      StatDesc statDesc,
                                      long t1,
                                      long t2,
                                      int nsamples)

getStateInfo

public StateInfo.StateInfoList getStateInfo(String subsystem)

Lists all the existing states for a given subsystem.

Parameters:

subsystem - the subsystem name.

Returns:

getStateChangeList

public StateChange.StateChangesList getStateChangeList(String subsystem,
                                                       List<String> states,
                                                       List<String> components,
                                                       long t1,
                                                       long t2)

Gets the state changes events for the given list of states, between the time interval [t1,t2], for the given subsystem.

Parameters:

subsystem - the subsystem

states - if empty, returns all state changes for all found states.

components - if empty, return all state changes for all components.

t1 -

t2 -

Returns:

getComponentStateChangeList

public StateChange.StateChangesList getComponentStateChangeList(String subsystem,
                                                                String component,
                                                                List<String> states,
                                                                long t1,
                                                                long t2)

Gets the state changes events for the given list of states, between the time interval [t1,t2], for a given component of a subsystem.

Parameters:

subsystem - the subsystem

component - the component for which to list state changes

states - if empty, returns all state changes for all found states

t1 -

t2 -

Returns:

getAlertInfo

public AlertInfo.AlertInfoList getAlertInfo()

getAlertInfo

public AlertInfo.AlertInfoList getAlertInfo(String subsystem)

getActiveAlerts

public AlertEvent.AlertEventList getActiveAlerts(List<Long> ids)

Returns a list of active alerts. Active alerts are alerts that have been raised during the current subsystem run.

Parameters:

ids - a list of ids.

Returns:

getAlertHistories

public AlertEvent.AlertEventList getAlertHistories(List<Long> ids,
                                                   long t1,
                                                   long t2)

Returns an history of alerts that have been raised within the given time interval.

Parameters:

ids - a list of alertdesc ids.

t1 -

t2 -

Returns:

getPlotData

public TrendingPlotData.TrendingPlotDataList getPlotData(long id,
                                                         long t1,
                                                         long t2)

Returns a list of trended plots for the given data desc id, between the time interval [t1,t2].

Parameters:

id - the datadesc id

t1 -

t2 -

Returns: