Alarm Management and Logging Correlation Commands

76 Pages·2014·1.68 MB·English

Alarm Management and Logging Correlation
Commands
Thismoduledescribesthecommandsusedtomanagealarmsandconfigureloggingcorrelationrulesfor
systemmonitoringontherouter.
Fordetailedinformationaboutalarmmanagementandloggingcorrelationconcepts,configurationtasks,
andexamples,seetheImplementingandMonitoringAlarmsandLoggingCorrelationmoduleinthe
CiscoASR9000SeriesAggregationServicesRouterSystemMonitoringConfigurationGuide.
Forsystemloggingcommands,seetheLoggingServicesCommandsmodule.
Forsystemloggingconcepts,seetheImplementingLoggingServices moduleinthe CiscoASR9000Series
AggregationServicesRouterSystemMonitoringConfigurationGuide.
• alarm, page 3
• all-alarms, page 4
• all-of-router, page 5
• clearloggingcorrelatordelete, page 6
• clearloggingeventsdelete, page 7
• clearloggingeventsreset, page 11
• context-correlation, page 13
• loggingcorrelatorapplyrule, page 15
• loggingcorrelatorapplyruleset, page 18
• loggingcorrelatorbuffer-size, page 20
• loggingcorrelatorrule, page 22
• loggingcorrelatorruleset, page 25
• loggingeventsbuffer-size, page 27
• loggingeventsdisplay-location, page 29
• loggingeventslevel, page 31
• loggingeventsthreshold, page 33
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
OL-24733-01 1
Alarm Management and Logging Correlation Commands
• loggingsuppressapplyrule, page 35
• loggingsuppressrule, page 37
• nonrootcause, page 39
• reissue-nonbistate, page 41
• reparent, page 43
• rootcause, page 45
• showloggingcorrelatorbuffer, page 47
• showloggingcorrelatorinfo, page 50
• showloggingcorrelatorrule, page 52
• showloggingcorrelatorruleset, page 55
• showloggingeventsbuffer, page 57
• showloggingeventsinfo, page 62
• showloggingsuppressrule, page 64
• showsnmpcorrelatorbuffer, page 66
• showsnmpcorrelatorinfo, page 68
• showsnmpcorrelatorrule, page 69
• showsnmpcorrelatorruleset, page 70
• source, page 71
• timeout, page 72
• timeout-rootcause, page 74
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
2 OL-24733-01
Alarm Management and Logging Correlation Commands
alarm
alarm
Tospecifyatypeofalarmtobesuppressedbyaloggingsuppressionrule,usethealarmcommandinlogging
suppressionruleconfigurationmode.
alarmmsg-categorygroup-namemsg-code
Syntax Description
msg-category Messagecategoryoftherootmessage.
group-name Groupnameoftherootmessage.
msg-code Messagecodeoftherootmessage.
Command Default Noalarmtypesareconfiguredbydefault.
Command Modes Loggingsuppressionruleconfiguration
Command History
Release Modification
Release3.9.0 Thiscommandwasintroduced.
Usage Guidelines
Task ID
Task ID Operations
logging read,write
Examples Thisexampleshowshowtoconfiguretheloggingsuppressionrule“commit”tosuppressalarmswhoseroot
messageare“MBGL”,withgroupname“commit”andmessagecode“succeeded”:
RP/0/RSP0/CPU0:router(config)# logging suppress rule commit
RP/0/RSP0/CPU0:router(config-suppr-rule)# alarm MBGL COMMIT SUCCEEDED
Related Commands
Command Description
loggingsuppressrule, onpage37 Createsaloggingsuppressionrule.
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
OL-24733-01 3
Alarm Management and Logging Correlation Commands
all-alarms
all-alarms
Toconfigurealoggingsuppressionruletosuppressalltypesofalarms,usetheall-alarmscommandinlogging
suppressionruleconfigurationmode.
all-alarms
Syntax Description Thiscommandhasnokeywordsorarguments.
Command Default Noalarmtypesareconfiguredbydefault.
Command Modes Loggingsuppressionruleconfiguration
Command History
Release Modification
Release3.9.0 Thiscommandwasintroduced.
Usage Guidelines
Task ID
Task ID Operations
logging read,write
Examples Thisexampleshowshowtoconfiguretheloggingsuppressionrulecommittosuppressallalarms:
RP/0/RSP0/CPU0:router(config)# logging suppress rule commit
RP/0/RSP0/CPU0:router(config-suppr-rule)# all-alarms
Related Commands
Command Description
loggingsuppressrule, onpage37 Createsaloggingsuppressionrule.
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
4 OL-24733-01
Alarm Management and Logging Correlation Commands
all-of-router
all-of-router
Toapplyaloggingsuppressionruletoalarmsoriginatingfromalllocationsontherouter,usetheall-of-router
commandinloggingsuppressionapplyruleconfigurationmode.
all-of-router
Syntax Description Thiscommandhasnokeywordsorarguments.
Command Default Noscopeisconfiguredbydefault.
Command Modes Loggingsuppressionapplyruleconfiguration
Command History
Release Modification
Release3.9.0 Thiscommandwasintroduced.
Usage Guidelines
Task ID
Task ID Operations
logging execute
Examples Thisexampleshowshowtoapplytheloggingsuppressionrule“commit”toalllocationsontherouter:
RP/0/RSP0/CPU0:router(config)# logging suppress apply rule commit
RP/0/RSP0/CPU0:router(config-suppr-apply-rule)# all-of-router
Related Commands
Command Description
loggingsuppressapplyrule, onpage35 Appliesandactivatesaloggingsuppressionrule.
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
OL-24733-01 5
Alarm Management and Logging Correlation Commands
clear logging correlator delete
clear logging correlator delete
TodeleteallmessagesormessagesspecifiedbyacorrelationIDfromtheloggingcorrelatorbuffer,usethe
clearloggingcorrelatordeletecommandinEXECmode.
clearloggingcorrelatordelete{all-in-buffer|correlation-id}
Syntax Description
all-in-buffer Clearsallmessagesintheloggingcorrelatorbuffer.
correlation-id CorrelationeventrecordID.Upto14correlationIDscanbespecified,
separatedbyaspace.Rangeis0to4294967294.
Command Default Nomessagesareautomaticallydeletedunlessbuffercapacityisreached.
Command Modes EXEC
Command History
Release Modification
Release3.7.2 Thiscommandwasintroduced.
Usage Guidelines Usetheshowloggingcorrelatorbuffer, onpage47commandtoconfirmthatrecordshavebeencleared.
Usetheloggingcorrelatorbuffer-size, onpage20commandtoconfigurethecapacityoftheloggingcorrelator
buffer.
Task ID
Task ID Operations
logging execute
Examples Thisexampleshowshowtoclearallrecordsfromtheloggingcorrelatorbuffer:
RP/0/RSP0/CPU0:router# clear logging correlator delete all-in-buffer
Related Commands
Command Description
showloggingcorrelatorbuffer, onpage47 Displaysmessagesintheloggingcorrelatorbuffer.
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
6 OL-24733-01
Alarm Management and Logging Correlation Commands
clear logging events delete
clear logging events delete
Todeletemessagesfromtheloggingeventsbuffer,usetheclearloggingeventsdeletecommandinEXEC
mode.
clearloggingeventsdelete
Syntax Description
admin-level-only Deletesonlyeventsattheadministrativelevel.
all-in-buffer DeletesalleventIDsfromtheloggingeventsbuffer.
bistate-alarms-set Deletesbi-statealarmsintheSETstate.
categoryname Deleteseventsfromaspecifiedcategory.
contextname Deleteseventsfromaspecifiedcontext.
event-hi-limitevent-id DeleteseventswithaneventIDequaltoorlowerthantheeventIDspecified
withtheevent-idargument.Rangeis0to4294967294.
event-lo-limitevent-id DeleteseventswithaneventIDequaltoorhigherthantheeventIDspecified
withtheevent-idargument.Rangeis0to4294967294.
firstevent-count Deletesevents,beginningwiththefirsteventintheloggingeventsbuffer.For
theevent-countargument,enterthenumberofeventstobedeleted.
group message-group Deleteseventsfromaspecifiedmessagegroup.
lastevent-count Deletesevents,beginningwiththelasteventintheloggingeventsbuffer.For
theevent-countargument,enterthenumberofeventstobedeleted.
location node-id Deletesmessagesfromtheloggingeventsbufferforthespecifiedlocation.
Thenode-idargumentisenteredintherack/slot/modulenotation.
message message-code Deleteseventswiththespecifiedmessagecode.
severity-hi-limit Deleteseventswithaseveritylevelequaltoorlowerthantheseveritylevel
specifiedwiththeseverityargument.
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
OL-24733-01 7
Alarm Management and Logging Correlation Commands
clear logging events delete
severity Severitylevel.Validvaluesare:
•alerts
•critical
•emergencies
•errors
•informational
•notifications
•warnings
Note Settingsfortheseveritylevelsandtheirrespectivesystemconditions
arelistedunderthe“UsageGuidelines”sectionfortheloggingevents
levelcommand.Eventsoflowerseveritylevelrepresenteventsof
higherimportance.
severity-lo-limit Deleteseventswithaseveritylevelequaltoorhigherthantheseveritylevel
specifiedwiththeseverityargument.
timestamp-hi-limit Deleteseventswithatimestampequaltoorlowerthanthespecifiedtime
stamp.
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
8 OL-24733-01
Alarm Management and Logging Correlation Commands
clear logging events delete
hh:mm:ss[month][day] Timestampforthetimestamp-hi-limitortimestamp-lo-limitkeyword.The
[year] month,day,andyearargumentsdefaulttothecurrentmonth,day,andyear,
ifnotspecified.
Rangesforthehh:mm:ssmonthdayyearargumentsareasfollows:
•hh:—Hours.Rangeis00to23.Youmustinsertacolonafterthehh
argument.
•mm:—Minutes.Rangeis00to59.Youmustinsertacolonafterthemm
argument.
•ss—Seconds.Rangeis00to59.
•month—(Optional)Themonthoftheyear.Thevaluesforthemonth
argumentare:
◦january
◦february
◦march
◦april
◦may
◦june
◦july
◦august
◦september
◦october
◦november
◦december
•day—(Optional)Dayofthemonth.Rangeis01to31.
◦year—(Optional)Year.Enterthelasttwodigitsoftheyear(for
example,04for2004).Rangeis01to37.
timestamp-lo-limit Deleteseventswithatimestampequaltoorhigherthanthespecifiedtime
stamp.
Command Default Nomessagesareautomaticallydeletedunlessbuffercapacityisreached.
Command Modes EXEC
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
OL-24733-01 9
Alarm Management and Logging Correlation Commands
clear logging events delete
Command History
Release Modification
Release3.7.2 Thiscommandwasintroduced.
Usage Guidelines Thiscommandisusedtodeletemessagesfromtheloggingeventsbufferthatmatchthekeywordsandarguments
thatyouspecify.Thedescriptionismatchedifalloftheconditionsaremet.
Usetheshowloggingeventsbuffer, onpage57 commandtoverifythateventshavebeenclearedfromthe
loggingeventsbuffer.
Usetheloggingeventsbuffer-size, onpage27 commandtoconfigurethecapacityoftheloggingevents
buffer.
Task ID
Task ID Operations
logging execute
Examples Thisexampleshowshowtodeleteallmessagesfromtheloggingeventsbuffer:
RP/0/RSP0/CPU0:router# clear logging events delete all-in-buffer
Related Commands
Command Description
clearloggingeventsreset, onpage11 Resetsbi-statealarms.
showloggingeventsbuffer, onpage57 Displaysmessagesintheloggingeventsbuffer.
Cisco ASR 9000 Series Aggregation Services Router System Monitoring Command Reference, Release 4.1
10 OL-24733-01