Purpose
The viewevents command captures a particular time frame of events, retrieves them from the Consolidated Event Log, and displays them to the screen or outputs them to a file.
System problem events can be captured and then forwarded to Customer Services for further analysis.
Syntax
viewevents [components] [TimeParameters] [DisplayParameters] [FilterParameters]
viewevents -monitor [components] [MonitorParameters] [FilterParameters]
viewevents -id {eventGUID} [-sequence sequenceNumber]
Parameters
- components
- Unique ID of the component or components whose events you want to display. The unique ID can be a Component ID, default alias, or user-defined alias. If no Component IDs or aliases are specified, events for the first system display.
- {eventGUID}
- Unique ID that identifies an event.
- -id
- Displays details for the event specified by {eventGUID}; use -sequence to speed up event retrieval.
Time Parameters
- -all
- Displays all events in the system. If -all or -max is not specified, the default is 1000 records.Operation could be lengthy depending on the size of the system.
- -desc | asc
- Specifies sort order based on create time.
- Descending displays newest record first (default)
- Ascending displays oldest record first
- -end [mm/dd/yyyy ] [hh:mm:ss]
- Selects the end date or time. Default is current date or time 23:59:59.
- -max x
- Specifies the maximum number of events to retrieve. If -all or -max is not specified, the default is 1000 records.
- -sec | -min | -hrs | -days x
- Selects events by the specified seconds, minutes, hours, or days since the start time or before the end time; if -start or -end is not specified, the default is since current time.
- -sequence sequenceNumber
- Adds the time sequence to speed up event retrieval.
- -start [mm/dd/yyyy ] [hh:mm:ss]
- Selects the start date and time. Default is current date and time 0.
Display Parameters
- -byalias
- Displays output using the component alias instead of the ObjectPath. If a user-defined alias has been configured, it displays.
- -bycollective
- Displays event information one collective at a time. You cannot use -bycollective if you designate specific components.
- -csv
- Displays the information in CSV (comma-separated value) format on the screen. To redirect the command output to a .csv or .txt file, type one of the following:
- -csv > myfilename.csv
- -csv > myfilename.txt
- -detail
- Displays detailed event data.
- -format filename
- Displays event information according to the format file filename.
- -formNameValue
- Displays in AttributeName=Value format.
- -nohdr
- Suppresses display of format header.
- -perform
- Displays statistics such as elapsed time and number of records.
- -xml
- Displays alert information in xml format.
Filter Parameters
- -cabinetID=cabinetIDNumber[,...]
- Selects events associated with the cabinet ID numbers. If you identify multiple cabinet ID numbers, you cannot specify chassis IDs.
- -chassisID=chassisIDNumber[,...]
- Selects events associated with the chassis ID numbers.
- -collectiveID=collectiveIDNumber[,...]
- Selects events associated with the collective ID numbers. If you identify multiple collective ID numbers, you cannot specify cabinet IDs or chassis IDs.
- -domain=domainName[,...]
- Selects events with the specified domain names.
- -msgID=msgID[,...]
- Selects one or more events with matching MessageIDs.
- -objectClass=objectClassName[,...]
- Selects one or more events associated with object class names. To determine the class name, see the first part of the component ID.
- -reporterType=reporterType[,...]
- Selects event reporter types.
- MPP_StatusEvent
- MPP_ConfigChangeEvent
- MPP_CommandEvent
- MPP_SnmpTrap
- MPP_BynetDPEvent
- MPP_UNIXLog
- MPP_SiteActivity
- MPP_Alert
- MPP_DeviceLog
- PSR_SummaryAlert
- -severity=severity[,...]
- Selects the first letter of one or more severity names or a range x-y, between 0 and 6.
- Unknown or 0
- OK or 1
- Info or 2
- Warning or 3
- Degraded or 4
- Critical or 5
- Fatal or 6
- -sName=systemName[,...]
- Selects events associated with system names.
- -systemID=systemIDNumber[,...]
- Selects events associated with the system ID numbers. If you identify multiple system ID numbers, you cannot specify collective IDs, cabinet IDs, or chassis IDs.
- -subType=subTypeName[,...]
- Selects events with the specified subType names.
Monitor Parameters
- -monitor
- Monitors the database for new events and displays them. The following parameters are not supported: -start , -end , -sec , -min , -hrs , -days , -active , -desc , -asc , -seq , -detail , -perform , and -id.Tip: Press CTRL + C to quit.