Viewing SAM Events Reports

The Events screen of the SAM Viewer displays the SAM Events report, which contains detailed information about the up and down time of a single object. You can specify a time period for the statistics and an object about which to obtain the statistics. Additionally, you can update the statistics by clicking the Update View button.
To Specify a Time Period
Enter the starting date in the To: field and the ending date in the From: field. The date format is mm/dd/yy. When you re-specify a time period, press the Update View button to see the new report.
To Specify an Object
Click the down arrow on the left side of the Select Object: field. Holding down the mouse button, slide your cursor to the item you want to select. When you select a different object, a report for that object is displayed.
To Update the Reported Information
Click the Update View button at the top right of the screen.

Information Displayed

The Events view displays the following identifying information: The body of the Events report displays the following information about the selected object for the time period specified:
event id
A unique identifier for the event. You can use the event id of the down event to specify an event record to alter with samlog command.
related object
The name of the object associated with the failure. The name has the format of object type.name. The object type is one of CLUS, NODE, TIME, or APPL. This name can be that of the selected object for which the Events report was generated, or it can be the name of the supporting object that actually failed and caused the selected object's down event. You may need to view a separate report of the supporting object to determine its last logged state. The supporting object may be operational again despite having caused the selected object's down event. In such a case, this report shows only that the supporting object caused the selected object's down event, not the last logged state of the selected object.
new state
The state of the related object after the event occurred. The state can be UP, DOWN, or GONE. For monitored objects, SAM places the UP and DOWN states in the event log file. The GONE state must be added with the samlog command, and stops SAM from accumulating down time for an object. For example, if you remove a node from the cluster, SAM considers it down. When you mark its state as GONE, SAM stops accumulating down time for it.
occurred when YYYY.MM.DD_HH:MM:SS
The time of the event in year, month, day, hour, minute, second format.
planned?
A YES- or NO-populated field that indicates whether the down event was planned or not. By default, all down time is logged in the event log as unplanned. You can annotate the event log file to specify that down time is planned using the samlog -i evid -p PLANNED command.
msg description
The short descriptive text associated with the event. SAM notes a basic reason for the event in the log file if possible. You can annotate the event log file to specify more descriptive text for an event using the samlog -i evid msg command.


Additional SAM Viewer help: