新的一年

新的征程

新的课程开班

等你来学！

EEM（Embedded Event Manager）作为一个自动化的脚本部署在设备上，可以根据指定的trigger来自动完成提前布置的任务，如信息的收集或特定的操作。一个完整的EEM需要包含Name、Trigger、Action，以下为EEM部署的示例,仅供参考。

注意：Catalyst 9000 需要DNA许可证才能支持EEM。

基本构成：

1. EEM Name
event manager applet MY-SCRIPT authorization bypass <<<<< 创建一个名字叫MY-SCRIPT的EEM脚本。
使用"authorization bypass"命令来规避权限问题，否则可能由于权限问题导致EEM无法生效。

2. EEM Trigger
a. 周期触发：
event timer watchdog time 120 maxrun 100 <<<<< 每 120 秒运行一次，每次最多运行 100 秒。

b. 特定时间或特定周期触发
event timer cron cron-entry “1 2 3 4 5” <<<<< 1=分 2=时 3=日 4=月 5=星期(0表示周日)
Cron Timer Examples:
“15 9 * * *” <<<<< 每天上午的9点15分触发
“00 10 * * 1-5” <<<<< 每周一到周五的上午10点触发

c. 通过SNMP触发
event snmp oid 1.3.6.1.4.1.9.2.1.56 get-type next entry-op ge entry-val 50 poll-interval 1
当CPU超过50%时触发， 1.3.6.1.4.1.9.2.1.56 为 Cat9000 的SNMP CPU OID，其他平台需对应修改。

d. 根据系统日志来触发：
event syslog pattern “NOPOWER_AVAIL: Interface” ratelimit 60
当出现的日志中包含"NOPOWER_AVAIL: Interface"关键字后触发，ratelimit为每60s内只触发一次。

e. 系统自带的参数：
如当接口的total output 增长时触发：
event interface name Te1/0/1 parameter output_packets_dropped entry-op ge entry-val 1000 poll-interval 1 entry-type value

3. EEM Action
a. CLI Action
按顺序执行指令，注意所有序号需保持同样位数，如010和100，而不能写10和100.
action 010 cli command “en”
action 020 cli command “show version | append bootflash:EEM.txt”

b. 生成系统日志：
action 050 syslog msg “Script has completed” priority 1 <<<<<< 将生成1级日志: “%HA_EM-1-LOG: xxx: Script has completed”

c. 交互式CLI：
action 430 cli command “clear log” pattern “confirm”
action 431 cli command “”
当执行clear log后，系统会出现交互式语句，匹配关键字confirm后输入""，相当于确认进行下一步。

d. 匹配SNMP的信息：
action 010 info type snmp oid 1.3.6.1.4.1.9.2.1.56 get-type next
action 020 syslog msg “Current CPU: $_info_snmp_value” <<<<< 系统收集当前OID的结果，并通过变量打印至日志中

e. If / Else / Elseif 语句
如果CPU 大于等于 85，则执行“end”之前的语句，否则执行“end”之后的语句。
action 010 info type snmp oid 1.3.6.1.4.1.9.2.1.56 get-type next
action 020 if $_info_snmp_value ge “85”
action 030 syslog msg “High CPU detected inside script!”
action 040 end
action 050 syslog msg “This line is now outside the –if- statement”

f. 循环语句
一个循环可以一遍又一遍地做同样的事情而不用写很多额外的行，如打印1到10：
action 010 set loop_iteration 1 <<<<< 设置变量"loop_iteration" 为 1.
action 020 while $loop_iteration le 10
action 030 syslog msg “Iteration: $loop_iteration”
action 040 increment loop_iteration 1
action 050 end
action 060 syslog msg “Script Complete”

g. 正则表达式匹配
正则表达式通常可以应用于特定命令的结果。 Regex 还会在调用后创建一些预定义的变量。
action 010 cli command “show ip interface brief | ex unass”
action 020 regexp “[123]” $_cli_result match
action 030 if $_regexp_result eq 1
action 040 syslog msg “The Regex found 1 or 2 or 3 in $match”
action 050 end
在show ip interface brief 中搜索是否存在1或2或3的字段，如果有，则打印匹配结果。

配置示例：

1. 使用SNMP监控来触发high cpu的信息收集：
当CPU无规律瞬间变高时，我们可以使用如下脚本（OID为catalyst 9000的OID，其他平台需要对象修改）。
event manager applet High_CPU authorization bypass
event snmp oid 1.3.6.1.4.1.9.2.1.56 get-type next entry-op ge entry-val 80 poll-interval 1 ratelimit 60
action 010 info type snmp oid 1.3.6.1.4.1.9.2.1.56 get-type next
action 020 syslog msg “CPU Utilization is high, Current CPU: $_info_snmp_value”
action 030 cli command “enable”
action 040 cli command “show clock”
action 041 regex “([0-9]|[0-9][0-9])😦[0-9]|[0-9][0-9])😦[0-9]|[0-9][0-9])” $cli_result match H M S <<<<将匹配表达式中的小时，分钟和秒
action 050 set time $matchaction060clicommand"showclock|appendflash:CP{U}_{i}nfo$time.txt"
action 070 cli command “show process cpu sorted | append flash:CPU_infoKaTeX parse error: Expected group after '_' at position 143: …ation flash:CPU_̲H.$M.$S.pcap” pattern “confirm”
action 201 cli command “”
action 210 cli command “monitor capture A start”
action 220 wait 10
action 230 cli command “monitor capture A stop”
!注意: Cat9200需要monitor capture stop之后
运用"monitor capture A export flash:CPU$H.$M.$S.pcap" pattern "confirm"来将抓包文件保存到机器里面

当CPU超过80%时，将生成以下日志：
%HA_EM-6-LOG: test: CPU Utilization is high, Current CPU: 80

同时将生成基于时间的文件，例如以下：
switch#dir flash: | i CPU
409606 -rw- 296 Apr 24 2022 12:08:54 +00:00 CPU_12.08.51.pcap <<<抓包文件
262188 -rw- 49487 Apr 24 2022 12:02:38 +00:00 CPU_info12:02:38.txt <<<show 信息

2. 应用正则表达式来监控设备上的变量:
当需要监控非系统自定义的参数时，可以使用正则表达式来监控，如以下方式监控TCAM的使用情况：
event manager applet TCAM authorization bypass
event timer watchdog time 3600
action 10 cli command “enable”
action 20 cli command “show platform hardware fed active fwd-asic resource tcam utilization”
action 30 regex “[(6-9)][(0-9)].[(0-9)][(0-9)]” $_cli_result
action 40 if ${}_{r}egex{p}_{r}esultge"1"action50syslogmsg"\ast \ast \ast TCAMabnormaldetected\ast \ast \ast "priority1action60syslogmsg"$_cli_result"
action 70 else
action 80 syslog msg “*** TCAM normal ***”
action 90 end

当TCAM的利用率超过60%时，将出现告警，同时会将TCAM的具体值通过log打印：
%HA_EM-1-LOG: TCAM: TCAM abnormal detected
Cat9500#$ ac fwd-asic resource tcam utilization
Table Subtype Dir Max Used %Used V4 V6 MPLS Other

---

Mac Address Table EM I 65536 31 60.05% 0 0 0 31

3. 使用循环语句和自定义变量来配置EEM
当我们需要配置大量的重复参数时可以使用以下方法来配置：
event manager applet Port authorization bypass
event timer watchdog time 300 maxrun 200
action 100 cli command “en”
action 200 set PORT “1” <<<<< 设置一个变量名为PORT，同时将变量值置为1
action 201 while $PORTle24<<<<<设置循环语句，使得变量小于等于24action202clicommand"showinterfaceG1/0/$PORT"
action 204 regexp “err-disabled” “$cli_result"
action 205 if KaTeX parse error: Expected group after '_' at position 72: …etected at PORT_̲PORT is err-disabled ***"
action 208 cli command “configure terminal”
action 209 cli command "interface G1/0/KaTeX parse error: Expected group after '_' at position 139: … msg " *** PORT_̲PORT is Recovery "
action 242 else
action 253 syslog msg " No issue detected! PORT$PORT ***”
action 300 increment PORT
action 301 wait 1
action 403 end
action 404 end

设备每300s自动检测接口1-24接口的状态，如果出现err-disabled, 则自动执行shutdown/no shutdown的操作。

4. 交互式EEM
当执行一些需要交互的操作时，可能使用到以下方法：
event manager applet Reload authorization bypass
event timer cron cron-entry “1 0 * * " <<<<< 每天的0:01分自动执行
action 010 cli command “enable”
action 020 cli command “show switch | i aaaa.bbbb.cccc”
action 030 regexp “Active” $_cli_result
action 040 if $_regexp_result eq “1”
action 050 syslog msg "** Switch 1 is Active ***”
action 070 else
action 080 cli command “wr”
action 090 wait 10
action 100 cli command “redundancy force-switchover” pattern “confirm”
action 110 cli command “”
action 120 end

每天的0:01分自动检测aaaa.bbbb.cccc是否为active设备，如果不是，则主备切换。