Package org.opennms.features.alarms.history.rest.api

Interface AlarmHistoryRestService

All Known Implementing Classes:

AlarmHistoryRestServiceImpl

public interface AlarmHistoryRestService

Query the alarm history and state changes stored in the AlarmHistoryRepository.

Method Summary

Modifier and Type	Method	Description
Collection<AlarmState>	getActiveAlarmsAt(Long timestampInMillis)	Retrieve the last known state of all alarms which were active at the given time.
AlarmState	getAlarm(String alarmId, String matchType, Long timestampInMillis)	Retrieve the last known state of an alarm at the given time.
Collection<AlarmState>	getStatesForAlarm(String alarmId, String matchType)	Retrieve the complete set of state changes for the given alarm.

Method Detail

getStatesForAlarm

Collection<AlarmState> getStatesForAlarm(String alarmId,
                                         String matchType)

Retrieve the complete set of state changes for the given alarm.

Parameters:

alarmId - alarm id to query

matchType - when set the 'reduction-key', lookup by reduction key instead of alarm id

Returns:

state changes

getAlarm

AlarmState getAlarm(String alarmId,
                    String matchType,
                    Long timestampInMillis)

Retrieve the last known state of an alarm at the given time.

Parameters:

alarmId - alarm id to query

matchType - when set the 'reduction-key', lookup by reduction key instead of alarm id

timestampInMillis - timestamp in milliseconds - defaults to "now" when null

Returns:

last known state

getActiveAlarmsAt

Collection<AlarmState> getActiveAlarmsAt(Long timestampInMillis)

Retrieve the last known state of all alarms which were active at the given time.

Parameters:

timestampInMillis - timestamp in milliseconds

Returns:

last known state of all alarms which were active at the given time - defaults to "now" when null