12.04 - viewevents - Server Management

Teradata Server Management Web Services User Guide

prodname
Server Management
vrm_release
12.04
created_date
January 2017
category
User Guide
featnum
B035-5350-017K

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.
viewevents -id {175CC646-8CC3-11d3-84FD-00E029103BC7} displays event details for a specific event ID.

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.
viewevents -all displays all events in a 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.
viewevents -start 10/02/2013 -days 2 displays 2 days of events, starting October 2, 2013 00:00:00 and ending 2 days later, on October 3, 2013 23:59:59.
viewevents -end 10/15/2013 -days 4 displays 4 days of events, starting on October 11, 2013 00:00:00 and ending on October 15, 2013 23:59:59.
viewevents -days 4 display events starting 4 days earlier up to 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.
viewevents -all -bycollective lists all events in the system, one collective at a time.
viewevents -all -sys=1 -coll=3-5 -bycollective lists all events from system 1, collectives 3 through 5, one collective at a time.
-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.
viewevents -start 8/19/2013 -days 1 -detail displays event details for all events logged on 8/19/2013.
-format filename
Displays event information according to the format file filename.
viewevents recognizes the following macros in the format file:
{eventGUID}, {TimeStamp}, {TimeReceived}, {Sequence}, {ObjectPath}, {Severity}, {ReporterType}, {SubType}, {Source}, {MessageId}, {Description}, {Details}, {BinaryData}, {Domain}, {ManagedElementAlias}, {SystemName}, {SystemID}, {CollectiveID}, {CabinetID}, {ChassisID}
Surround brackets with single quotes; represent a true single quote with two single quotes.
{‘This is a sample’} is represented as ‘{‘‘‘This is a sample.’’’}’ in the format file.
-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.
If a system, collective, cabinet, or chassis has more than one component, you cannot specify any further granularity.
viewevents -sys=1 -coll=200 -cab=1,2,3 and viewevents -sys=1 -coll=200,300 are valid; however, -sys=1 -coll=200,300 -cab=1 is not valid.
-chassisID=chassisIDNumber[,...]
Selects events associated with the chassis ID numbers.
If a system, collective, cabinet, or chassis has more than one component, you cannot specify any further granularity.
-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.
If a system, collective, cabinet, or chassis has more than one component, you cannot specify any further granularity.
-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.
If the component ID is CMIC_5500J.SystemID=1,CollectiveID=400,CabinetID=1,ID=6 , the class name is CMIC_5500J.
-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
viewevents -rep=MPP_WinLog -dom=node -sev=W,D lists events with a report type of MPP_WinLog, a severity of Warning or Degraded, and domain of Node.
-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.
viewevents -sname=ABC list events where the system name is "ABC."
-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.
If a system, collective, cabinet, or chassis has more than one component, you cannot specify any further granularity.
viewevents -sys=1 -cab=300 -chas=203,204 lists events where systemID=1, cabinetID=300, and chassisID=203 or chassisID=204.
-subType=subTypeName[,...]
Selects events with the specified subType names.
For unassigned or empty string subTypes use the UNASSIGNED keyword.

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.
viewevents -monitor listens for new events.