Purpose
The alertutil command displays alert records retrieved from Server Management.
Syntax
alertutil [components] [TimeParameters] [DisplayParameters] [FilterParameters]
alertutil -guids {alertGUID[,...]} [DisplayParameters]
alertutil -detail -timeStamp mm/dd/yyyy hh:mm:ss -sequence sequenceNumber
alertutil -monitor [MonitorParameters] [DisplayParameters] [FilterParameters]
alertutil -clear -start mm/dd/yyyy hh:mm:ss -end mm/dd/yyyy hh:mm:ss
alertutil -clear -guids {alertGUID[,...]}
alertutil -clear -timeStamp mm/dd/yyyy hh:mm:ss -sequence sequenceNumber
alertutil -summary [components] [TimeParameters] [DisplayParameters] [FilterParameters] [SummaryParameters]
alertutil -summary -guids {summaryalertGUID[,...]} [DisplayParameters]
alertutil -summary -monitor [MonitorParameters][DisplayParameters] [FilterParameters] [SummaryParameters]
alertutil -summary -clear -guids {summaryalertGUID[,...]}
Parameters
- -clear
- Clears all alert and summary alert records between the specified times. When combined with -summary and -guids {alertGUID}, clears the summary alert for the specified {alertGUID} and all alerts associated with the summary. You can also clear multiple alerts or summary alerts with the matching IDs.
- components
- Unique ID of the components whose alerts 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, alerts for the first system display.
- -detail
- Displays details for the specified alert.
- -guids {alertGUID[,...]}
- Displays alerts for specified GUIDs.
- -monitor
- Monitors and displays new alert records coming from Server Management. Tip: Press CTRL + C to quit.
- -summary
- Displays summary alert information.
Time Parameters
- -all
- Displays all alerts 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 alerts to retrieve. If -all or -max is not specified, the default is 1000 records.
- -sec | -min | -hrs | -days x
- Selects alerts 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 alert 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 alert information grouped by 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
- -format filename
- Displays alert information according to the format file filename. alertutil recognizes the following macros 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.
- -raw
- Displays alert information retrieved from Server Management without translation to a more readable format.
- -verbose
- Displays all alert data.
- -xml
- Displays alert information in xml format.
Filter Parameters
- -cabinetID=cabinetIDNumber[,...]
- Selects alerts associated with the cabinet ID numbers. If you identify multiple cabinet ID numbers, you cannot specify chassis IDs.
- -chassisID=chassisIDNumber[,...]
- Selects alerts associated with the chassis ID numbers.
- -collectiveID=collectiveIDNumber[,...]
- Selects alerts associated with the collective ID numbers. If you identify multiple collective ID numbers, you cannot specify cabinet IDs or chassis IDs.
- -domain=domainName[,...]
- Selects alerts with the specified domain names.
- -msgID=msgID[,...]
- Selects alerts with matching MessageIDs.
- -objectClass=objectClassName[,...]
- Selects alerts associated with object class names. To determine the class name, see the first part of the component ID.
- -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 alerts associated with system names.
- -status=Status[,...]
- Selects alerts with associated statuses.
- Active
- Autosolved
- Cleared
- Expired
- -subSystem=subSystem[,...]
- Selects alerts with associated subsystems.
- Storage
- Power
- Node
- OS
- Database
- Network
- ServerMgmt
- Client
- Other
- -subType=subTypeName[,...]
- Selects alerts with the specified subType names.
- ProbableCause
- AlertGroup
- Null
- UNASSIGNED
- -systemID=systemIDNumber[,...]
- Selects alerts associated with the system ID numbers. If you identify multiple system ID numbers, you cannot specify collective IDs, cabinet IDs, or chassis IDs.
- -TVI_Disposition=disposition[,...]
- Selects alerts associated with TVI dispositions.
- Abeyed
- Escalate_Requested
- Escalated
- Ignore_Maintenance
- Ignore_Heartbeat
- Ignored
- None
Monitor Parameters
- -modification
- Displays alert modifications in addition to new alerts. Use this with -monitor parameter to view status and TVI disposition changes.
Summary Parameters
- -impact=impact[,...]
- Displays summary alerts with matching impacts.
- -maintenance=settingType
- Displays summary alerts with specified maintenance settings.
- On
- Off
- -notify=settingType
- Displays summary alerts with specified notify settings.
- On
- Off
- -scope=scope[,...]
- Displays summary alerts with matching scopes.
- -synopsis=synopsis[,...]
- Displays summary alerts with matching synopsis.