1.1 EAA简介

EAA（Embedded Automation Architecture，嵌入式自动化架构）是集成在系统软件中的一系列相关软件模块的总称。

使用EAA功能：

· 用户可以定制一系列监控策略，在策略中定义自己感兴趣的事件以及事件发生时的处理动作。监控策略被启用后，系统会实时监控设备的运行，当用户定制的事件发生时，就触发相应的监控策略并自动执行监控策略中的动作。

· 设备能够智能地监控多种事件，并做出灵活多变的响应，从而大大地提升系统的可维护性。

1.1.1 EAA框架

图1-1 EAA框架示意图

H3C EAA简介及配置

EAA框架如图1-1所示，它包括事件源、EM（Event Monitor，事件监控）模块、RTM（Real-Time Event Manager，实时事件管理）模块和EAA监控策略。

1. 事件源

事件源是系统中的软件或硬件模块，它们会触发事件。例如，CLI事件源能触发命令行事件，Syslog事件源能触发日志事件。

2. EM

EM根据用户配置对事件源中发生的事件进行过滤匹配，匹配成功则通知RTM执行相应监控策略。当用户配置了多个监控策略，系统会创建多个EM模块，每个EM组件监控一个事件。

3. RTM

RTM是EAA的核心部件，负责管理监控策略，包括监控策略的创建、状态变化和执行。

4. EAA监控策略

通过监控策略，用户可以定义自己感兴趣的事件以及事件发生时的处理动作。

监控策略有两种配置方式：一种是通过命令行来配置，一种是通过Tcl脚本来定义。通过命令行配置的监控策略称为基于CLI的监控策略，以下简称CLI监控策略；通过Tcl脚本定义的监控策略称为基于Tcl的监控策略，以下简称Tcl监控策略。

1.1.2 监控策略中的元素

每个监控策略中必须包含以下元素：事件、动作、用户角色、执行时间。

1. 事件

表明用来触发监控策略的事件。目前，EAA能够监控的事件类型如表1-1所示。

表1-1 监控事件类型描述表

事件类型	描述
cli	监控命令行事件配置该事件后，当用户输入指定的命令并对其进行特定操作（执行、协助或者补全）就会触发策略执行
hotplug	监控成员设备加入或离开IRF事件配置该事件后，当成员设备加入或离开IRF，均会触发监控策略执行
interface	监控接口事件接口事件中存在一个触发开关： 1. 配置该事件后，触发开关立即打开 2. 当指定接口上的指定报文的数目达到start-op start-op start-val start-val参数指定的条件时，触发监控策略执行一次（第一次执行），并关闭触发开关，但系统会继续监控接口事件 3. 当满足restart-op restart-op restart-val restart-val参数指定的条件时，才重新开启触发开关 4. 如果指定接口上的指定报文的数目再次达到start-op start-op start-val start-val参数指定的条件时，则再次触发监控策略执行一次（第二次执行），并关闭触发开关，系统继续监控接口事件 5. 如此循环
process	监控进程事件配置该事件后，当指定进程（可以为用户命令行触发的或者系统自动触发的）发生指定状态变化（异常、关闭、启动或重启时），触发监控策略执行
snmp	监控SNMP节点值变化事件 SNMP节点值变化事件中存在一个触发开关： 6. 配置该事件后，触发开关立即打开 7. 系统根据用户配置，定时轮询设备上某个节点的值，当该值达到start-op start-op start-val start-val指定的条件时，触发监控策略执行一次（第一次执行），并关闭触发开关，但系统会继续监控SNMP节点值变化事件 8. 当节点值满足restart-op restart-op restart-val restart-val指定的条件时，才重新开启触发开关 9. 当节点值再次达到start-op start-op start-val start-val指定的条件时，则再次触发监控策略执行一次（第二次执行），并关闭触发开关，系统继续监控SNMP节点值变化事件 10. 如此循环
snmp-notification	监控SNMP告警事件配置该事件后，当系统生成一条告警，告警中携带的MIB对象（由oid参数指定）的值到达oid-val oid-val op op指定的条件时，触发监控策略执行
syslog	监控日志事件配置该事件后，当系统在指定时间段内生成指定规格的日志信息时触发监控策略执行；RTM模块产生的日志不会触发策略执行
track	监控Track事件配置该事件后，当关联的Track项状态由Positive变为Negative或者Negative变为Positive时，触发监控策略执行；如果关联多个Track项，则最后一个处于Positive（Negative）状态的Track项变为Negative（Positive）时，触发监控策略执行如果配置了抑制时间，触发策略的同时开始计时，定时器超时前，收到状态从Positive（Negative）变为Negative（Positive）的消息，直接丢弃，不会处理。直到定时器超后，收到状态从Positive（Negative）变为Negative（Positive）的消息才处理，再一次触发策略执行

2. 动作

表明事件发生时，监控策略将执行的动作。目前设备支持的动作有：

· 执行指定的命令行

· 重启

· 主备倒换

· 生成一条指定内容的日志

3. 用户角色

表明执行监控策略的用户角色。用户角色中定义了允许用户操作哪些系统功能以及资源对象，设备支持的每条命令都有缺省用户角色：

· 如果监控策略中指定的用户角色权限比命令行的缺省用户角色的权限小，则不能执行该命令以及该命令后面的所有动作。

· 如果指定的用户角色不存在，则监控策略不能执行。

· 如果给某个监控策略配置了多个用户角色，则使用这些用户角色权限的并集去执行该策略。例如，给某策略配置了用户角色A和B，如果策略中的动作是角色A或者B允许执行的，则策略可以执行；如果策略中存在角色A和B都不能执行的命令，则该命令以及该命令后面的所有动作都不能执行。

关于用户角色的详细描述请参见“基础配置指导”中的“RBAC”。

4. 运行时间

表明监控策略的运行时间，运行时间达到时即使策略没有执行完毕，也会立即停止执行策略。该元素用来限制策略的运行时间，以免策略长时间运行占用系统资源。

1.1.3 EAA环境变量

EAA环境变量指的是专用于监控策略的环境变量。环境变量由<环境变量名、环境变量值>字对组成。在配置监控策略的动作时，我们可以在应该输入参数的地方输入“$环境变量名”，表明此处需要引用环境变量值。系统在运行监控策略的时候，会自动用环境变量值去替代“$环境变量名”。如果要修改监控参数的值，只需在系统视图下，修改环境变量值即可，而无需进入监控策略视图，修改监控策略下的具体配置。因此，定义和使用环境变量可以简化监控策略的配置，提高监控策略的灵活性和易用性。

目前，EAA支持的环境变量包括内部环境变量和用户自定义环境变量。

1. 内部环境变量

设备缺省支持的环境变量，用户不能创建、删除和修改。内部环境变量名均以“_”开头，内部环境变量的值由系统决定。内部环境变量又包括两类：一类是公共环境变量，另一类是非公共环境变量。

· 公共环境变量可用于所有类型的事件：其中_event_id、_event_type、_event_type_string在系统启动时生成，关联的事件类型不同，其值不同，其值一旦确定不能更改；_event_time、_event_severity在运行时产生。

· 非公共环境变量只能用于对应的事件，其值在事件触发时获得，它标示当前事件的部分信息。例如，HOTPLUG事件对应的内部环境变量为“_slot”，当1号成员设备加入或离开IRF的时候，环境变量“_slot”的值为1；当2号成员设备加入或离开IRF的时候，环境变量“_slot”的值为2。

目前EAA支持内部环境变量如表1-2所示。

表1-2 内部环境变量描述表

事件	内部环境变量的名称	描述
CLI	_cmd	匹配上的命令
HOTPLUG	_slot	加入或离开IRF的成员设备的编号
INTERFACE	_ifname	接口的名称
PROCESS	_process_name	进程的名称
SNMP	_oid	SNMP操作中携带的OID
SNMP	_oid_value	OID对应节点的值
SNMP TRAP	_oid	SNMP告警信息中携带的OID
SYSLOG	_syslog_pattern	匹配的日志信息的内容
公共环境变量	_event_id	事件的ID
	_event_type	事件的类型
	_event_type_string	事件类型的描述
	_event_time	事件发生的时间
	_event_severity	事件的严重级别

2. 用户自定义环境变量

用户定义环境变量名可包含数字、字符或者“_”，但不能以“_”开头。用户自定义环境变量可用于所有类型的事件，其值由用户配置决定。用户定义环境变量可修改、删除。

1.2 配置限制和指导

· 用户可创建多个监控策略，请确保同时启用的策略间动作不能冲突，由于当系统同时执行多个策略，且不同策略间动作有冲突时，执行结果是随机的。

· Tcl监控策略和CLI监控策略的名称可以一样，一样类型的监控策略的名称不能一样。

· 同一个策略下，只能配置一个触发事件和运行时间。

· 同一监控策略下可配置多个用户角色，最多可以配置64个有效用户角色，超过该上限后，新配置的用户角色不会生效。

1.3 配置用户自定义环境变量

1. 功能简介

使用本特性，用户可以自定义EAA环境变量的名称和值，以便定义监控策略时可以引用。

2. 配置步骤

(1) 进入系统视图。

system-view

(2) 配置用户自定义环境变量。

rtm environment var-name var-value

系统中缺省支持的内部环境变量，请参见表1-2。

1.4 配置CLI监控策略

1.4.1 CLI监控策略配置任务简介

CLI监控策略配置任务如下：

(1) 创建CLI监控策略

(2) （可选）配置EAA监控的日志缓冲区的大小

(3) 配置事件

(4) 配置动作

(5) 配置用户角色

(6) 配置运行时间

(7) 启用CLI监控策略

1.4.2 创建CLI监控策略

(1) 进入系统视图。

system-view

(2) 创建CLI监控策略并进入CLI监控策略视图。

rtm cli-policy policy-name

1.4.3 配置EAA监控的日志缓冲区的大小

1. 功能简介

只有CLI监控策略的触发事件为日志事件时，才需要配置本功能。

为EAA策略配置日志事件，并确认执行后，系统会将生成的日志同时复制一份放入EAA监控的日志缓冲区。EAA模块将该缓冲区中的日志取出并和日志事件进行匹配，如果匹配成功，则执行动作；如果匹配失败，则不执行动作。

一般情况下，这个日志缓冲区的大小采用缺省值即可。当某特性功能异常或者用户开启了多个调试开关时，设备会在短时间内产生大量日志，导致一些日志来不及匹配便被丢弃。此时可根据当前设备内存的使用情况，适当增加EAA监控的日志缓冲区的大小。

2. 配置步骤

(1) 进入系统视图。

system-view

(2) 配置EAA监控的日志缓冲区的大小。

rtm event syslog buffer-size buffer-size

缺省情况下，EAA监控的日志缓冲区的大小为50000条。

1.4.4 配置事件

1. 配置限制和指导

为避免触发条件的不确定性，多次执行event命令配置监控事件时，最后一次配置并且commit的事件生效。

2. 配置步骤

(1) 进入系统视图。

system-view

(2) 创建CLI监控策略。

rtm cli-policy policy-name

(3) 配置监控事件。请选择其中一项进行配置。

¡ 配置命令行事件。

event cli { async [ skip ] | sync } mode { execute | help | tab } pattern regular-exp

¡ 配置热插拔事件。

event hotplug [ insert | remove ] slot slot-number

¡ 配置接口事件。

event interface interface-list monitor-obj monitor-obj start-op start-op start-val start-val restart-op restart-op restart-val restart-val [ interval interval ]

¡ 配置进程事件。

event process { exception | restart | shutdown | start } [ name process-name [ instance instance-id ] ] [ slot slot-number ]

¡ 配置SNMP操作事件。

event snmp oid oid monitor-obj { get | next } start-op start-op start-val start-val restart-op restart-op restart-val restart-val [ interval interval ]

¡ 配置SNMP告警事件。

event snmp-notification oid oid oid-val oid-val op op [ drop ]

¡ 配置日志事件。

event syslog priority priority msg msg occurs times period period

¡ 配置Track事件。

event track track-list state { negative | positive } [ suppress-time suppress-time ]

缺省情况下，未配置事件。

1.4.5 配置动作

1. 配置限制和指导

用户可为CLI监控策略配置多个动作，系统会按照动作的编号由小到大顺序执行这些动作。如果新配置的动作的编号和已有动作的编号一样，最后一次配置并且commit的生效。

2. 配置步骤

(1) 进入系统视图。

system-view

(2) 进入CLI监控策略视图。

rtm cli-policy policy-name

(3) 配置动作。请至少选择以下一项进行配置。

¡ 配置事件发生时执行指定的命令行。

action number cli command-line

缺省情况下，监控策略下未配置CLI动作。

¡ 配置事件发生时执行重启操作。

action number reboot [ slot slot-number ]

缺省情况下，监控策略下未配置重启动作。

¡ 配置事件发生时进行主备倒换。

action number switchover

缺省情况下，监控策略下未配置主备倒换动作。

¡ 配置事件发生时发送指定的LOG。

action number syslog priority priority facility local-number msg msg-body

缺省情况下，监控策略下未配置日志动作。

1.4.6 配置用户角色

1. 配置限制和指导

配置本功能时，安全日志管理员角色与其它用户角色互斥：

· 配置安全日志管理员角色后，系统会自动删除已配置的其它用户角色；

· 配置其它用户角色后，系统会自动删除已配置的安全日志管理员角色。

2. 配置步骤

(1) 进入系统视图。

system-view

(2) 进入CLI监控策略视图。

rtm cli-policy policy-name

(3) 配置执行CLI监控策略时使用的用户角色。

user-role role-name

缺省情况下，执行CLI监控策略时使用的用户角色为创建该策略的用户的角色。

1.4.7 配置运行时间

(1) 进入系统视图。

system-view

(2) 进入CLI监控策略视图。

rtm cli-policy policy-name

(3) 配置CLI监控策略执行动作的持续时间。

running-time time

缺省情况下，CLI监控策略执行动作的持续时间为20秒。

多次执行本命令时，最后一次配置并且commit的生效。

1.4.8 启用CLI监控策略

1. 功能简介

配置CLI监控策略后，必须启用CLI监控策略，CLI监控策略下的配置才会生效。

2. 配置步骤

(1) 进入系统视图。

system-view

(2) 进入CLI监控策略视图。

rtm cli-policy policy-name

(3) 启用CLI监控策略。

commit

1.5 配置Tcl监控策略

1. Tcl脚本内容简介

按内容Tcl脚本可以分为两大部分：首行和其它行。

(1) 首行

首行用于定义事件、用户角色和运行时间。用户创建并启用Tcl监控策略后，设备会立即解析Tcl脚本首行，并下发、生效。

Tcl脚本首行的格式为
::platformtools::rtm::event_register event-type arg1 arg2 arg3 … user-role role-name1 | [ user-role role-name2 | [ … ] ] [ running-time running-time ]。其中：

¡ event-type用来指定事件的类型，取值同CLI监控策略支持的事件类型，详情请参见表1-1。

¡ arg用来指定事件参数，具体要求与相应event命令中的参数规格一致，请参考“网络管理和监控命令参考”中的“EAA”。当arg内容中包含空格时，请在arg内容的两端添加英文格式的双引号，形如”a b c”。

¡ user-role用来指定执行脚本的用户角色，参数含义和配置要求同CLI监控策略。

¡ running-time用来指定动作执行的最大时间，参数含义和配置要求同CLI监控策略。未指定该参数时，表明不限制Tcl监控策略的运行时间。

(2) 其它行

从Tcl脚本的第二行开始，定义监控策略触发时将执行的动作。用户可使用多行定义多个动作，系统会按照Tcl脚本中配置的先后顺序执行这些动作。Tcl监控策略支持如下三类动作：

¡ Tcl语言标准命令。

¡ EAA模块的switchover和syslog动作。配置该类动作时，请使用格式
::platformtools::rtm::action switchover或
::platformtools::rtm::action syslog priority priority facility local-number msg msg-body。priority、local-number、msg-body参数的详细描述请参考“网络管理和监控命令参考/EAA”中的action syslog命令。

¡ 设备支持的其它命令行。配置该类动作时，每行为设备可执行的命令行即可。

2. 配置限制和指导

Tcl监控策略启用后，不允许修改Tcl脚本。如需修改，请先停用Tcl监控策略，修改后，再启用Tcl监控策略。否则，Tcl监控策略将不能运行。

3. 配置步骤

(1) 使用FTP或者TFTP功能将Tcl脚本下载到设备上，FTP及TFTP具体配置请参见“基础配置指导”中的“FTP和TFTP”。

(2) 创建并启用Tcl监控策略。

a. 进入系统视图。

system-view

b. 创建并启用Tcl监控策略，并将该策略与Tcl脚本绑定。

rtm tcl-policy policy-name tcl-filename

缺省情况下，不存在Tcl监控策略。

配置Tcl监控策略时，tcl-filename请使用相对路径并确保所有的成员设备上都存在该脚本，以免主备倒换或脚本所在成员设备离开IRF后，策略无法执行。

1.6 暂停监控策略

1. 功能简介

使用本特性可以暂停运行所有的监控策略。如果配置本特性时，某个监控策略正在执行动作，则设备会等待该监控策略的所有动作全部执行完毕后，再暂停运行该监控策略。

2. 配置限制和指导

如果要将暂停运行的所有策略恢复运行，请使用undo rtm scheduler suspend命令。

3. 配置步骤

(1) 进入系统视图。

system-view

(2) 暂停运行所有的监控策略。

rtm scheduler suspend

1.7 EAA显示和维护

在完成上述配置后，在任意视图下执行display命令可以显示配置后EAA的运行情况，通过查看显示信息验证配置的效果。

表1-3 EAA显示和维护

操作	命令
显示CLI监控策略下生效的具体配置	display current-configuration
显示用户自定义的EAA环境变量配置	display rtm environment [ var-name ]
显示监控策略的相关信息	display rtm policy { active \| registered [ verbose ] } [ policy-name ]
显示CLI监控策略下生效的具体配置（请在CLI监控策略视图下执行该命令）	display this