org.opennms.web.event
Class Event

java.lang.Object
  org.opennms.web.event.Event

public class Event
extends Object

A JavaBean implementation to hold information about a network event as defined by OpenNMS.

Author:

Lawrence Karnowski , OpenNMS

Field Summary

protected Date	acknowledgeTime The time this event was acknowledged.
protected String	acknowledgeUser The name of the user who acknowledged this event.
protected Integer	alarmId The alarmId if reduced.
protected String	autoAction Automated Action for event.
protected Date	createTime Creation time of event in database, cannot be null
protected String	description Free-form textual description of the event
protected String	dpName The dpName of the Dist Poller which received the event, cannot be null.
protected Boolean	eventDisplay Whether the event is displayable.
protected String	forward The forwarding information.
protected String	host The <host> element from the Event Data Stream DTD
protected int	id Unique identifier for the event, cannot be null
protected String	ipAddr IP Address of node's interface
protected String	logGroup Logical group with which to associate event.
protected String	logMessage Formatted display text to control how the event will appear in the browser.
protected String	mouseOverText Mouse over text.
protected Integer	nodeID Unique integer identifier for node, can be null
protected String	nodeLabel The human-readable name of the node of this event.
protected String	notification Notification string.
protected String	operatorAction Operator Action for event.
protected String	operatorActionMenuText Text of the eventOperAction.
protected String	operatorInstruction Operator instruction for event.
protected String	parms The <parms> element from the Event Data Stream DTD
protected Integer	serviceID Unique integer identifier of service/poller package, can be null
protected String	serviceName Human-readable name of the service
protected OnmsSeverity	severity Severity the of event.
protected String	snmp Contains the eid, eidtext (optionally), specific, and generic identifier for the SNMP Trap.
protected String	snmphost The <snmphost> element from the Event Data Stream DTD
protected Date	time The <time> element from the Event Data Stream DTD, which is the time the event was received by the source process.
protected String	troubleTicket Trouble ticket integration string.
protected Integer	troubleTicketState State of the trouble ticket.
protected String	uei Universal Event Identifer (UEI) for this event, cannot be null

Constructor Summary

Event()
Empty constructor to create an empty Event instance.

Event(int id, String uei, Date time, String dpName, Date createTime, int severityId)
Create an event that represents a real network event with only the required parameters.

Event(int id, String uei, Date time, String dpName, Date createTime, int severityId, String snmp, String host, String snmphost, String parms, Integer nodeID, Integer serviceID, String ipAddr, String description, String logMessage, String logGroup, String operatorInstruction, String autoAction, String operatorAction, String operatorActionMenuText, String notification, String troubleTicket, Integer troubleTicketState, String forward, String mouseOverText, String acknowledgeUser, Date acknowledgeTime)
Create an event that represents a real network event with all the parameters.

Event(int id, String uei, Date time, String dpName, Date createTime, int severityId, String snmp, String host, String snmphost, String parms, Integer nodeID, Integer serviceID, String ipAddr, String description, String logMessage, String logGroup, String operatorInstruction, String autoAction, String operatorAction, String operatorActionMenuText, String notification, String troubleTicket, Integer troubleTicketState, String forward, String mouseOverText, String acknowledgeUser, Date acknowledgeTime, String nodeLabel, String serviceName, Integer alarmId)

Event(int id, String uei, Date time, String dpName, Date createTime, int severityId, String snmp, String host, String snmphost, String parms, Integer nodeID, Integer serviceID, String ipAddr, String description, String logMessage, String logGroup, String operatorInstruction, String autoAction, String operatorAction, String operatorActionMenuText, String notification, String troubleTicket, Integer troubleTicketState, String forward, String mouseOverText, String acknowledgeUser, Date acknowledgeTime, String nodeLabel, String serviceName, Integer alarmId, Boolean eventDisplay)
Create an event that represents a real network event with all the parameters.

Method Summary

Date	getAcknowledgeTime()
String	getAcknowledgeUser()
Integer	getAlarmId()
String	getAutoAction()
Date	getCreateTime()
String	getDescription()
String	getDpName()
Boolean	getEventDisplay()
String	getForward()
String	getHost()
int	getId()
String	getIpAddress()
String	getLogGroup()
String	getLogMessage()
String	getMouseOverText()
int	getNodeId()
String	getNodeLabel()
String	getNotification()
String	getOperatorAction()
String	getOperatorActionMenuText()
String	getOperatorInstruction()
String	getParms()
int	getServiceId()
String	getServiceName()
OnmsSeverity	getSeverity()
String	getSnmp()
String	getSnmpHost()
Date	getTime()
String	getTroubleTicket()
Integer	getTroubleTicketState()
String	getUei()
boolean	isAcknowledged()

Methods inherited from class java.lang.Object

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

Field Detail

id

protected int id

Unique identifier for the event, cannot be null

uei

protected String uei

Universal Event Identifer (UEI) for this event, cannot be null

snmp

protected String snmp

Contains the eid, eidtext (optionally), specific, and generic identifier for the SNMP Trap. This maps directly to the <snmp>element in the Event Data Stream DTD.

time

protected Date time

The <time> element from the Event Data Stream DTD, which is the time the event was received by the source process. Cannot be null.

host

protected String host

The <host> element from the Event Data Stream DTD

snmphost

protected String snmphost

The <snmphost> element from the Event Data Stream DTD

dpName

protected String dpName

The dpName of the Dist Poller which received the event, cannot be null.

parms

protected String parms

The <parms> element from the Event Data Stream DTD

nodeID

protected Integer nodeID

Unique integer identifier for node, can be null

serviceID

protected Integer serviceID

Unique integer identifier of service/poller package, can be null

serviceName

protected String serviceName

Human-readable name of the service

ipAddr

protected String ipAddr

IP Address of node's interface

createTime

protected Date createTime

Creation time of event in database, cannot be null

description

protected String description

Free-form textual description of the event

logMessage

protected String logMessage

Formatted display text to control how the event will appear in the browser. This field may contain variables that are populated by field values of the message.

logGroup

protected String logGroup

Logical group with which to associate event. This field provides a means of logically grouping related events.

severity

protected OnmsSeverity severity

Severity the of event.

 
   1  = Indeterminate
   2 = Cleared (unimplemented at this time)
   3 = Warning
   4 = Minor
   5 = Major
   6 = Critical
  
 

operatorInstruction

protected String operatorInstruction

Operator instruction for event.

autoAction

protected String autoAction

Automated Action for event. Should consist of fully-qualfied pathname to executable command, with possible variables used to reference event-specific data

operatorAction

protected String operatorAction

Operator Action for event. Should consist of fully-qualfied pathname to executable command, with possible variables used to reference event-specific data

operatorActionMenuText

protected String operatorActionMenuText

Text of the eventOperAction. Menu text displayed to Operator, which if selected, will invoke action described in eventOperAction.

notification

protected String notification

Notification string. Should consist of a fully-qualfied pathname to an executable which invokes the notification software, and will likely contain event-specific variables

troubleTicket

protected String troubleTicket

Trouble ticket integration string. Should consist of fully-qualfied pathname to executable command, with possible variables used to reference event-specific data

troubleTicketState

protected Integer troubleTicketState

State of the trouble ticket. Trouble ticket on/off boolean 1=on, 0=off. Can be null.

forward

protected String forward

The forwarding information. Contains a list of triplets: Destination,State,Mechanism;Destination,State,Mechanism; which reflect the following:

• State is a boolean flag as to whether the entry is active or not. 1=on, 0=off.
• Destination is hostname or IP of system to forward the event to
• Method is the means by which it will be forwarded. A keyword, e.g., SNMP

mouseOverText

protected String mouseOverText

Mouse over text. Text to be displayed on MouseOver event, if the event is displayed in the browser and the operator needs additional info.

acknowledgeUser

protected String acknowledgeUser

The name of the user who acknowledged this event.

acknowledgeTime

protected Date acknowledgeTime

The time this event was acknowledged.

nodeLabel

protected String nodeLabel

The human-readable name of the node of this event. Can be null.

alarmId

protected Integer alarmId

The alarmId if reduced. Can be null.

eventDisplay

protected Boolean eventDisplay

Whether the event is displayable.

Constructor Detail

Event

public Event()

Empty constructor to create an empty Event instance. All fields will hold the default values.

Event

public Event(int id,
             String uei,
             Date time,
             String dpName,
             Date createTime,
             int severityId)

Create an event that represents a real network event with only the required parameters.

Event

public Event(int id,
             String uei,
             Date time,
             String dpName,
             Date createTime,
             int severityId,
             String snmp,
             String host,
             String snmphost,
             String parms,
             Integer nodeID,
             Integer serviceID,
             String ipAddr,
             String description,
             String logMessage,
             String logGroup,
             String operatorInstruction,
             String autoAction,
             String operatorAction,
             String operatorActionMenuText,
             String notification,
             String troubleTicket,
             Integer troubleTicketState,
             String forward,
             String mouseOverText,
             String acknowledgeUser,
             Date acknowledgeTime)

Create an event that represents a real network event with all the parameters.

Event

public Event(int id,
             String uei,
             Date time,
             String dpName,
             Date createTime,
             int severityId,
             String snmp,
             String host,
             String snmphost,
             String parms,
             Integer nodeID,
             Integer serviceID,
             String ipAddr,
             String description,
             String logMessage,
             String logGroup,
             String operatorInstruction,
             String autoAction,
             String operatorAction,
             String operatorActionMenuText,
             String notification,
             String troubleTicket,
             Integer troubleTicketState,
             String forward,
             String mouseOverText,
             String acknowledgeUser,
             Date acknowledgeTime,
             String nodeLabel,
             String serviceName,
             Integer alarmId)

Event

public Event(int id,
             String uei,
             Date time,
             String dpName,
             Date createTime,
             int severityId,
             String snmp,
             String host,
             String snmphost,
             String parms,
             Integer nodeID,
             Integer serviceID,
             String ipAddr,
             String description,
             String logMessage,
             String logGroup,
             String operatorInstruction,
             String autoAction,
             String operatorAction,
             String operatorActionMenuText,
             String notification,
             String troubleTicket,
             Integer troubleTicketState,
             String forward,
             String mouseOverText,
             String acknowledgeUser,
             Date acknowledgeTime,
             String nodeLabel,
             String serviceName,
             Integer alarmId,
             Boolean eventDisplay)

Create an event that represents a real network event with all the parameters.

Method Detail

getId

public int getId()

getUei

public String getUei()

getTime

public Date getTime()

getDpName

public String getDpName()

getCreateTime

public Date getCreateTime()

getSeverity

public OnmsSeverity getSeverity()

getSnmp

public String getSnmp()

getHost

public String getHost()

getSnmpHost

public String getSnmpHost()

getParms

public String getParms()

getNodeId

public int getNodeId()

getNodeLabel

public String getNodeLabel()

getServiceId

public int getServiceId()

getServiceName

public String getServiceName()

getIpAddress

public String getIpAddress()

getDescription

public String getDescription()

getLogMessage

public String getLogMessage()

getLogGroup

public String getLogGroup()

getOperatorInstruction

public String getOperatorInstruction()

getAutoAction

public String getAutoAction()

getOperatorAction

public String getOperatorAction()

getOperatorActionMenuText

public String getOperatorActionMenuText()

getNotification

public String getNotification()

getTroubleTicket

public String getTroubleTicket()

getTroubleTicketState

public Integer getTroubleTicketState()

getForward

public String getForward()

getMouseOverText

public String getMouseOverText()

getAcknowledgeUser

public String getAcknowledgeUser()

getAcknowledgeTime

public Date getAcknowledgeTime()

isAcknowledged

public boolean isAcknowledged()

getAlarmId

public Integer getAlarmId()

getEventDisplay

public Boolean getEventDisplay()