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
Description: