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:
- Object type and name
- Current time
- Reporting period, including the years, days, hours, minutes, and seconds covered by the report
- Period begin and end dates
- Log format version
- Times of first and last event in the report
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: