STUDY · NETWORK GUIDE

7-5 Embedded Event Manager(EEM)— イベントで動くポリシー

csr1000v 17.03.08a の EEM で、アプレットと Tcl・Python のポリシーを登録し、syslog・timer・CLI の event と event manager run で動かして、action と vty・suspend の表示を撮ります。

1. 前節の振り返りと本節の内容

前節 7-4 Python on Box / Guest Shell は、csr1000v 17.03.08a で IOx と Guest Shell を有効にし、Guest Shell の中の Python の cli モジュールで show と設定を扱いました。7-4 のプログラムは、IOS の CLI で打った guestshell run で起動しています。

前節までの記事の記述を並べると、7-1〜7-3 のプログラムはどれも機器の外で動き、NETCONF・RESTCONF・gNMI のクライアントが機器の外から機器の管理アドレスへ接続を張りました。7-3 の CLI で設定した購読(dial-out)では、機器が機器の外の受信器へ接続を張っています(7-4 §11 の記述)。7-4 のプログラムは機器の上の Guest Shell で動き、起動は IOS の CLI で打った guestshell run でした(7-4 §15 の記述。7-4 §11 の表では、WSL の取得スクリプトが SSH で入った CSR1 の CLI で打っています)。

本節の EEM(Embedded Event Manager)は、機器の中で起きた出来事(syslog の行・timer・CLI のコマンド)か、CLI で打った event manager run を契機に、登録したポリシーを動かす仕組みです。資料はポリシーの中の event の指定に従って EEM がポリシーを走らせると書いており(§2)、本節はその表示を機器の上で撮ります。

7-4 の末尾(§15)は、次の予告を置いています。本節はこの予告を同じ順で次の場所で受けます。

7-4 §15 の予告本節での受け方場所
① 本節のプログラムは、IOS の CLI で打った guestshell run で起動した本節のポリシーは、event の指定で動きます。syslog・timer・cli の event は機器の中の出来事が契機で、none の event は CLI で打った event manager run が契機です。applet A75-PYSTD は、7-4 と同じ guestshell run python3 を applet の action から打ちます§5・§7〜§9・§12
② 次節 7-5 は、EEM を扱い、アプレットと TCL のスクリプトを見るアプレット(§5〜§10)と TCL のポリシー(§11)を撮ります§5〜§11
③ EEM Python Module 章の 2 つの引用(Python のスクリプトを EEM のポリシーとして登録できる・設定した EEM のポリシーは Guest Shell の中で動く)2 つの段落を §12.1 に引き直し、本ラボ(csr1000v 17.03.08a・RAM 4096 MB)で撮れた形(登録・発火の記録・ポリシーが書いたファイル・印のファイル)で受けます。「Guest Shell の中で動く」は資料の文のまま残します§12
④ Guest Shell の site-packages に eem のディレクトリがあったこと(7-4 §6.3)までを確かめ、EEM のポリシーは撮っていない・次節はイベントを契機に動く仕組みを見る仕組みの用語は §2(資料)にまとめ、本ラボで撮ったものは §3〜§13 に置きます。7-4 §6.3 が import できるかを撮っていないとした eem は、Guest Shell の中の標準のスクリプトで import eem を走らせた記録で受けます§2・§3〜§13(import eem は §12.11)

本節は資料に基づく部分と、本ラボの実測に基づく部分を分けて書きます。§2 は資料だけで、本ラボの値を入れません。§3〜§13 は、各節の中で資料の段落(引用を含む)と本ラボの段落を分けます。§14 は撮っていないことと撮れなかったこと、§15 は資料と実機が割れた所と罠です。割れた所は両方を並べ、どちらが正しいとも、何が原因とも書きません。

層どこ何を根拠にしているか
出典層§2 と、§3〜§13・§15 の資料の段落と引用Cisco の System Management Configuration Guide, Cisco IOS XE 17.x の EEM の 7 章と、Programmability Configuration Guide, Cisco IOS XE Amsterdam 17.3.x の EEM Python Module 章(§18)
本ラボの run§3〜§13・§15CML 上の csr1000v 17.03.08a(CSR1)。CML の設定の RAM を 4096 MB にして撮った 1 回の run。7-1〜7-4 と同じ機種と版
ツール側の観測〔ツール側〕を付けた記述と出力CML の API の読み返し・取得スクリプトの判定メモ・WSL の経過秒・md5 の手元の値。機器の出力そのものではない
確かめていないこと§14—

以下に貼る実機出力は改変していません。1 つのコードブロックは 1 つの取得の記録から取り、長い出力から一部を抜き出した箇所には …(省略) を置きました。取得の記録の中の、取得スクリプトが書いた〔ツール側〕の行も …(省略) で外しています。文の後ろの(数えた)は、保存した出力や原典の行を数えた値であることを示します。地の文のインラインコードは、機器の出力の空白の連続を 1 つに詰めて書きます(空白の数に意味がある所は文で断ります)。

プロンプトとコマンドを 1 行にまとめた表記(CSR1# …・? のヘルプの 1 行目の CSR1(config)# …・CSR1(config-applet)# …)は本節の組み立てで、取得の記録ではコマンドが見出しの行として別に残っています。Guest Shell の bash のコードブロックの 1 行目の [guestshell@guestshell ~]$ … も同じ組み立てで、2 行目からは取得の記録の行のままです。設定の投入と tclsh は、エコーからそのまま載せます。

コードブロックの直前の文には、機器と版と RAM(csr1000v 17.03.08a・RAM 4096 MB)を書きます。RAM の値は CML の設定値(〔ツール側〕CML の API の読み返し)で、機器の側の値は show version の物理メモリの行です(§3.1)。

時刻は機器の時計(UTC)で、show clock と syslog の行頭の値をそのまま書きます。show clock の日付は Mon Oct 26 2026 です。history の Time of Event は、月と日の間に空白の無い形(Mon Oct26 16:19:04 2026)で表示されます。パスワードは撮影ごとの使い捨てで、本文には載せていません。本ラボの実測は 1 回の run の観測で、同じ手順を繰り返した時に同じ値になるかは確かめていません(§14)。


2. EEM とは(資料が書く用語と仕組み)

資料の 8 章は、以下の短い名前で呼びます。

短い名前資料と章
Overview 章System Management Configuration Guide, Cisco IOS XE 17.x — Embedded Event Manager Overview
CLI 章同 — Writing Embedded Event Manager Policies Using the Cisco IOS CLI
Tcl 章同 — Writing Embedded Event Manager Policies Using Tcl
Event Registration 章同 — EEM Event Registration Tcl Command Extensions
Action 章同 — EEM Action Tcl Command Extension
CLI Library 章同 — EEM CLI Library Command Extensions
Debug 章同 — EEM Library Debug Command Extensions
Python 章Programmability Configuration Guide, Cisco IOS XE Amsterdam 17.3.x — EEM Python Module

2.1 EEM の定義

Overview 章は、EEM を、Cisco IOS の機器の中で直接行うイベントの検出と回復の仕組みとしています。同じ段落は、EEM のポリシーを、イベントと、そのイベントが起きた時に取る action を定めるものとしています。

Embedded Event Manager (EEM) is a distributed and customized approach to event detection and recovery offered directly in a Cisco IOS device. EEM offers the ability to monitor events and take informational, corrective, or any desired EEM action when the monitored events occur or when a threshold is reached. An EEM policy is an entity that defines an event and the actions to be taken when that event occurs.

(Overview 章の冒頭)

同じ章は、EEM を機器の中に置く理由として、機器と外の管理装置の間の通信が壊れる障害があることを挙げています。

Event tracking and management has traditionally been performed by devices external to the networking device. Embedded Event Manager (EEM) has been designed to offer event management capability directly in Cisco IOS devices. The on-device, proactive event management capabilities of EEM are useful because not all event management can be done off device because some problems compromise communication between the device and the external network management device.

(Overview 章「Embedded Event Manager」)

2.2 event detector・EEM server・ポリシー

Overview 章は、EEM を、event detector と呼ぶ software agent が機器の中を監視する、ポリシー駆動の枠組みとしています。

EEM is a flexible, policy-driven framework that supports in-box monitoring of different components of the system with the help of software agents known as event detectors.

(Overview 章「Embedded Event Manager」)

同じ節は、EEM server と、event を publish する event detector(publisher)と、subscribe するポリシー(subscriber)の関係を書いています。publisher は、subscriber が出した event の指定に一致した時に event を publish します。引用の中の figure below は資料の中の図を指し、その図は転載していません。

The figure below shows the relationship between the EEM server, core event publishers (event detectors), and the event subscribers (policies). Basically, event publishers screen events and publish them when there is a match on an event specification that is provided by the event subscriber.

(Overview 章「Embedded Event Manager」)

流れの後半について、同じ節は、event detector が EEM server に通知し、ポリシーがその時の機器の状態とポリシーに書いた action で回復すると書いています。

Event detectors notify the EEM server when an event of interest occurs. The EEM policies that are configured using the Cisco command-line interface (CLI) then implement recovery on the basis of the current state of the system and the actions specified in the policy for the given event.

(Overview 章「Embedded Event Manager」)

Event Detectors の節は、event detector を、監視される対象(例は SNMP)と action を実行するポリシーの間をつなぐ、別の仕組みとしています。

Embedded Event Manager (EEM) uses software programs known as event detectors to determine when an EEM event occurs. Event detectors are separate systems that provide an interface between the agent being monitored, for example Simple Network Management Protocol (SNMP), and the EEM policies where an action can be implemented.

(Overview 章「Event Detectors」)

2.3 ポリシーの種類と 2 冊の資料の違い

17.x の Overview 章は、ポリシーを applet と script の 2 種類とし、applet は CLI の設定の中に書く形、script は Tcl(Tool Command Language)で書く形としています。

There are two types of EEM policies: an applet or a script. An applet is a simple form of policy that is defined within the CLI configuration. A script is a form of policy that is written in Tool Command Language (Tcl).

(Overview 章「Embedded Event Manager」)

同じ章の Embedded Event Manager Policy Creation の節も、ポリシーの作り方を、CLI のコマンドで applet を書く方法と、Tcl のスクリプトを書く方法の 2 つとしています。

There are two ways to create an EEM policy. The first method is to write applets using CLI commands, and the second method is to write Tcl scripts.

(Overview 章「Embedded Event Manager Policy Creation」)

17.x の Tcl 章は、EEM のスクリプトはすべて Tcl で書くとし、ポリシーを作るのに Cisco が対応するスクリプトの言語を、今のところ Tcl だけとしています。

All Embedded Event Manager scripts are written in Tcl.

(Tcl 章「EEM Script」)

Tcl is currently the only Cisco-supported scripting language for policy creation.

(Tcl 章「Sample EEM Policies」)

17.3 の Python 章は、これと違い、Python のスクリプトを EEM のポリシーとして登録できると書いています(§12.1 に引きます)。取得した 17.x の 7 章に Python の語は 0 回でした(数えた)。2 冊の版は、17.x の 7 章が Updated: August 21, 2023、17.3 の Python 章が Updated: July 31, 2020 です(§18)。

2.4 登録・登録の解除・suspend

Overview 章は、ポリシーを登録すると、ソフトウェアがポリシーを調べて、指定の event が起きた時に走るよう登録すると書いています。登録は外すことも、一時停止(suspend)することもできます。

When a policy is registered with the Embedded Event Manager, the software examines the policy and registers it to be run when the specified event occurs. Policies can be unregistered or suspended. Both types of policies can be used to implement EEM in your network.

(Overview 章「Embedded Event Manager Policy Creation」)

CLI 章は、EEM がポリシーの中の event の指定に従ってポリシーを走らせ、applet の設定モードを抜けた時に event と action を調べて登録すると書いています(§5.1)。Python 章にも、event manager policy を打った時に EEM がポリシーを調べて登録するという同じ形の文があります(§12.1)。

2.5 版

Overview 章は、EEM の版ごとに入った機能を並べ、上位の版はそれより前の版の内容を含むと書いています。

If your network has a higher version of EEM, that version would include the previous releases of EEM version as well.

(Overview 章「Embedded Event Manager」)

EEM 1.0 は、applet の作成と、SNMP と syslog の event detector を入れました。

EEM 1.0 introduced Embedded Event Manager applet creation with the SNMP and syslog event detectors. EEM 1.0 also introduced the following actions: generating prioritized syslog messages, generating a CNS event for upstream processing by Cisco CNS devices, reloading the Cisco IOS software, and switching to a secondary processor in a fully redundant hardware configuration.

(Overview 章「Embedded Event Manager 1.0」)

timer の event detector は EEM 2.0 の欄にあり、ポリシーを手で走らせる機能は EEM 2.1 の欄にあります。

EEM 2.0 introduced the application-specific event detector, the counter event detector, the interface counter event detector, the timer event detector, and the watchdog event detector.

(Overview 章「Embedded Event Manager 2.0」)

EEM 2.1 introduced some new event detectors and actions with new functionality to allow EEM policies to be run manually and the ability to run multiple concurrent policies. Support for Simple Network Management Protocol (SNMP) event detector rate-based events was provided as was the ability to create policies using Tool Command Language (Tcl).

(Overview 章「Embedded Event Manager 2.1」)

CLI 章の機能表は、EEM 4.0 を 15.2(2)T 以降で対応する版としています。

EEM 4.0 is supported in 15.2(2)T and later releases, and introduced several new features.

(CLI 章「Embedded Event Manager 4.0」)

Overview 章の event detector の版の表(Table 1)の列は、Cisco IOS の版で、最右の列が 15 E / XE 3E です。IOS XE 16.x・17.x の列はありません。

Table 1. Availability of Event Detectors by Cisco IOS Release Event Detector 12.2(25)S 12.3(14)T 12.2(18)SXF5 12.2(28)SB 12.2(33)SRA 12.4(2)T 12.2(31)SB3 12.2(33)SRB 12.2(18)SXF4 Cisco IOS Software Modularity 12.2(33)SXH 12.4(20)T 12.2(33)SXI 12.4(22)T 12.2(33)SRE 15.0(1)M 15.1(3)T 15.1(2)SY 15 E XE 3E

(Overview 章「EEM Event Detectors Available by Cisco IOS Release」)

機能表は、各 release train で機能が入った最初の版だけを載せ、断りが無ければ同じ train の後の版も対応すると書いています。表の版から、IOS XE 17.3 での対応をそのまま読むことはできません。

This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

(Overview 章「Feature Information for Embedded Event Manager 4.0 Overview」)

2.6 用語のまとめ

用語は以下のとおりです(出典層)。

用語資料での意味記述のある節
event detector機器の中の監視を担う software agent。event が起きると EEM server に通知する(publisher)§4・§7〜§9
EEM serverevent detector から通知を受け、ポリシーとの間に立つもの§2.2・§13.2
ポリシーevent と action を定めるもの(subscriber)。17.x の章は applet と script(Tcl)の 2 種類と書き、17.3 の Python 章は Python のスクリプトもポリシーとして登録できると書く§5〜§12
appletCLI の設定の中に書くポリシー§5〜§10
actionevent が起きた時に取る動作§5〜§10
none の event手で走らせるポリシーの event。event manager run で走らせる§5
環境変数event manager environment で定義し、ポリシーの中で使う変数§6.4
Safe-Tcl信頼しない Tcl のスクリプトを safe mode のインタプリタで動かす仕組み§11.7
suspend全ポリシーの実行を一時停止する操作§13

3. 本ラボの構成

この図を大きく開く ↗

EEM の部品(event detector・EEM server・ポリシー・action)を、紫の破線=資料が書く関係と、緑=本ラボで撮った表示に分けて並べた図です。

本ラボは CML 上の 3 ノード(CSR1・mgmt-sw・ext)で組みました。ノードとリンクの形は取得スクリプトの設計で、show の出力には出ません(〔ツール側〕取得スクリプトは起動の前にリンク 2 本を確かめています)。WSL の取得スクリプトは CSR1 に SSH で入り、設定の投入・event manager run・show を打ちました。7-4 と違い、COL・Gi2・NAT はありません。

ノード機種・版IFアドレス役割
CSR1csr1000v 17.03.08aGi1(vrf Mgmt-vrf)172.16.1.241/24WSL からの SSH(CLI)の入口。day0 の設定〔ツール側〕
CSR1〃Loopback010.7.5.1/32day0 の設定〔ツール側〕
CSR1〃Loopback75〜7810.7.5.75〜10.7.5.78/32event の引き金と、applet が設定を変える先。本ラボの中で投入(§7・§10・§11・§12)
CSR1〃VirtualPortGroup0192.168.35.1/24Guest Shell の通信路。§12 で投入(NAT は入れていない)
Guest Shell—guest-interface 0(app-vnic の指定)192.168.35.2/24app-hosting の guest-ipaddress(§12)
mgmt-sw / extunmanaged_switch / external_connector(System Bridge)——管理の L2 とラボの外への出口〔ツール側〕

Gi1 の vrf Mgmt-vrf・172.16.1.241/24 と Loopback0 のアドレスは、取得スクリプトが起動時に入れた設定(day0)の値で、本ラボの show の出力にはありません(〔ツール側〕)。機器の出力で見えるのは、show tcp brief all の Local Address の 172.16.1.241.22 の行までです(§3.3)。図の Gi1 の箱が灰色の破線なのは、この区別のためです。

EEM の action が設定を変える IF は、Loopback75(§7)と Loopback76(§10)だけにしました。Loopback77 と Loopback78 は、取得スクリプトが shutdown して Tcl と Python のポリシーの引き金にした IF です(§11・§12)。

3.1 版と RAM

CSR1 の RAM は、CML の csr1000v の node definition の値(〔ツール側〕取得スクリプトの判定メモでは 3072 MB)を、起動の前に 4096 MB に上書きしました。〔ツール側〕CML の API で読み返した CSR1(csr1000v 17.03.08a・RAM 4096 MB)の ram の値は以下のとおりです(単位の MB は判定メモの側にあり、この表示には付きません)。

snippet
4096

機器の側では、show version の物理メモリの行が 3978408K でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の show version の抜粋は以下のとおりです。

snippet
CSR1# show version
Cisco IOS XE Software, Version 17.03.08a
Cisco IOS Software [Amsterdam], Virtual XE Software (X86_64_LINUX_IOSD-UNIVERSALK9-M), Version 17.3.8a, RELEASE SOFTWARE (fc3)
…(省略)
cisco CSR1000V (VXE) processor (revision VXE) with 2071576K/3075K bytes of memory.
Processor board ID 9MISPUM0V9C
Router operating mode: Autonomous
1 Gigabit Ethernet interface
32768K bytes of non-volatile configuration memory.
3978408K bytes of physical memory.
6188032K bytes of virtual hard disk at bootflash:.
…(省略)

CML の設定値 4096 と、物理メモリの行 3978408K の対応(差の内訳)は確かめていません。IF の数の行は 1 Gigabit Ethernet interface です。

3.2 day0 の logging と時刻の窓

day0 の設定には、〔ツール側〕取得スクリプトの設計で logging buffered 512000 debugging・service timestamps debug datetime msec・service timestamps log datetime msec を入れました。本ラボの running-config の buffered の行には水準の語がありませんでした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の running-config の表示は以下のとおりです。

snippet
CSR1# show running-config | include ^logging buffered|^service timestamps
service timestamps debug datetime msec
service timestamps log datetime msec
logging buffered 512000

logging の見出しは Buffer logging: level debugging でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の logging の見出しの表示は以下のとおりです。

snippet
CSR1# show logging | include Syslog logging|Buffer logging|Log Buffer
Syslog logging: enabled (0 messages dropped, 3 messages rate-limited, 0 flushes, 0 overruns, xml disabled, filtering disabled)
    Buffer logging:  level debugging, 40 messages logged, xml disabled,
Log Buffer (512000 bytes):
*Oct 26 16:14:21.341: %SYS-5-LOG_CONFIG_CHANGE: Buffer logging: level debugging, xml disabled, filtering disabled, size (512000)

本ラボは、run の途中で logging buffered を投入し直していません(最後の 1 回を除く。§15.1)。Log Buffer には起動からの行が積み上がっていて(PZ の全体の logging の最初の行は、P0 の show clock より前の 16:14:15.077)、| include で絞った表示には前の段の行も入ります。

本ラボの logging の事実は、時刻の窓で切りました。窓は、始めの show clock → 手順 → 終わりの show clock → include を掛けない show logging(全体)の順に撮り、全体の行のうち時刻が始めと終わりの間にある行を、その窓の行とします。窓の外の行を並べる時は「窓の外」と書きます。

窓の前後には logging の見出しも撮りました。見出しの dropped・rate-limited・overruns が増えた窓と、messages logged が減った窓では、「窓の中に〜の行は無い」を書きません。本ラボでこれに当たったのは、§9.5 の debug の窓の 1 つ(overruns が 0 → 1)です。

3.3 管理面の関門(MG)

各段の後には、管理面の関門(以下 MG)を置きました。MG は、(a) 取得スクリプトの永続の SSH のセッションで打つ show clock、(b) 〔ツール側〕WSL から 172.16.1.241:22 への TCP の接続、(c) 新しい SSH を 1 本張って打つ show users、(d) §12 の最初の Guest Shell の操作の直後からの外向きの確認です。(d) は、show running-config | section pnp に Mgmt-vrf と GigabitEthernet1 の行が無いことと、show tcp brief all で Local Address が 172.16.1.241 の行が port 22 だけであることを見ます。

外れたら残りの段を飛ばして撤去する設計で、MG0〜MG8 の 9 回はすべて通りました(〔ツール側〕取得スクリプトの判定メモ)。EEM の action で設定を変えた段(§7・§10)と、CLI の event を入れた段(§9)の後の MG も、通った回に数えています。

(d) の陽性対照として、最初の段(P0)に show tcp brief all を撮りました。Local Address が 172.16.1.241 の行は port 22 の 1 行で、Foreign Address の IP は 192.168.1.65 です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show tcp brief all
TCB       Local Address               Foreign Address             (state)
7F8F463FABE0  172.16.1.241.22            192.168.1.65.54301          ESTAB
7F8F4B6FF910  ::.21111                   *.*                         LISTEN
7F8F4B6FED08  0.0.0.0.21111              *.*                         LISTEN
7F8F49AE3000  ::.443                     *.*                         LISTEN
7F8F4B015000  0.0.0.0.443                *.*                         LISTEN

本ラボの設計では、この ESTAB の行は WSL の取得スクリプトの接続ですが、192.168.1.65 が何のアドレスか(WSL か、その手前で変換されたアドレスか)は出力からは言えません。show tcp brief all は run の中で 7 回撮り、7 回とも同じ表でした。show running-config | section pnp は 6 回とも出力の行が 0 行でした(数えた)。

(c) の新しい SSH の show users は、9 回とも同じ 2 行(vty 1 と vty 2 の netops)でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の P0 の後の (c) は以下のとおりです。

snippet
CSR1# show users
    Line       User       Host(s)              Idle       Location
   2 vty 1     netops     idle                 00:00:05 192.168.1.65
*  3 vty 2     netops     idle                 00:00:00 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

2 行のどちらが新しい SSH の行かは、この出力の列だけからは確かめていません。

(d) の show pnp profile は 6 回撮り、6 回とも同じ表示でした(数えた)。表示には pnp_python という名前の profile が 1 つあり、作られた時刻の表示は 16:38:40 でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の最初の show pnp profile の抜粋は以下のとおりです。

snippet
CSR1# show pnp profile
PnP Profiles: Active:1, Created:1, Deleted:0, Hidden:1

first-profile-created-name=[pnp_python] by:[pid=293, pname=SSH Process, time=16:38:40 UTC Mon Oct 26 2026])
last-profile-created-name=[pnp_python] by:[pid=293, pname=SSH Process, time=16:38:40 UTC Mon Oct 26 2026]
last-profile-deleted-name=[-] by:[-]

Name            CBType Node     Primary-Path           Primary-Trans  Backup-Trans  
pnp_python      User   hidden   /pnp_python            HTTP           none          
…(省略)

syslog には、同じ秒の %PNP-6-PNP_PROFILE_CREATED の行(16:38:40.696)がありました。この行は窓の外の行で、時刻は PF の Guest Shell の有効化の窓(16:35:59.254〜16:37:40.313)の終わりと、§12.3 の run の窓の始め(16:39:12.855)の間です。〔ツール側〕取得スクリプトが撮った順では、§12 の最初の Guest Shell の操作(bash で 2 本のファイルを書いた操作。§12.10・§12.11)も、この 2 つの窓の間です。この profile が何のためのものかと、最初の Guest Shell の操作の前に在ったかは撮っていません(§14)。

3.4 撮影の段階

撮影は段階に分け、1 本の取得スクリプトで続けて撮りました。記事の § の並びは撮影の順と違い、CLI の event(§9)は §10〜§12 の段の後に撮っています。

段内容本文機器の時刻の拠り所(show clock)
P0版・メモリ・logging・EEM の一覧・? のヘルプ・何も入れない applet§3・§4・§5.216:14:54.498、窓 16:15:55.354〜16:16:49.779
PAapplet の基本・action の順と変数・run の引数§5・§6窓 16:19:01.871〜16:19:37.213・16:20:16.641〜16:20:23.418
PBsyslog の event§7窓 16:21:33.748〜16:22:04.728・16:22:13.770〜16:22:23.415
PCtimer の event§8窓 16:23:29.629〜16:25:52.475
PDaction cli の vty・設定変更の記録・空いている vty の本数§10窓 16:27:49.355〜16:29:04.315 の間の 4 つ
PETcl のポリシー・2 本目の cli_open§10.8・§11窓 16:30:49.990〜16:34:17.480 の間の 6 つ
PFPython のポリシー・applet からの guestshell run python3§12窓 16:34:48.475〜16:51:55.161 の間の 11 個
PGCLI の event§9窓 16:54:15.076〜16:54:49.598・16:55:00.946〜16:55:10.009
PHGuest Shell を止めた後・suspend§12.12・§13窓 16:56:16.260〜16:56:23.000・16:56:39.887〜16:56:56.678
PZ後始末の確認・logging buffered の投入し直し§13・§15.116:57:50.879

MG の (a) の show clock は、P0 の後の 16:17:01.147 から PH の後の 16:57:20.578 まで、段の順に 9 回撮りました。show clock を撮っていない操作の前後は、取得スクリプトが撮った順(〔ツール側〕)と syslog・history の時刻で書きます。


4. この機器の EEM(版・detector・event と action)

4.1 版と event detector

資料の版の表は、Cisco IOS の版の列が 15 E / XE 3E までで、IOS XE 17 の列はありません(§2.5)。

本ラボの show event manager version の 1 行目は Embedded Event Manager Version 4.00 で、Event Detectors の表は 28 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager version
Embedded Event Manager Version 4.00
Component Versions:
eem: (dev10)1.1.5
eem-gold: (rel1)1.0.2
eem-call-home: (rel2)1.0.5
Event Detectors:
Name                Version   Node        Type    
application         01.00     node0/0     RP      
rf                  01.00     node0/0     RP      
syslog              01.00     node0/0     RP      
mat                 01.00     node0/0     RP      
neighbor-discovery  01.00     node0/0     RP      
generic             01.00     node0/0     RP      
nhrp                01.00     node0/0     RP      
track               01.00     node0/0     RP      
routing             03.00     node0/0     RP      
resource            01.00     node0/0     RP      
cli                 01.00     node0/0     RP      
counter             01.00     node0/0     RP      
interface           01.00     node0/0     RP      
ioswdsysmon         01.00     node0/0     RP      
none                01.00     node0/0     RP      
oir                 01.00     node0/0     RP      
snmp                01.00     node0/0     RP      
snmp-object         01.00     node0/0     RP      
snmp-notification   01.00     node0/0     RP      
timer               01.00     node0/0     RP      
test                01.00     node0/0     RP      
config              01.00     node0/0     RP      
env                 01.00     node0/0     RP      
ds                  01.00     node0/0     RP      
crash               01.00     node0/0     RP      
gold                01.00     node0/0     RP      
rpc                 01.00     node0/0     RP      
ipsla               01.00     node0/0     RP      

28 行とも Node は node0/0、Type は RP で、Version は routing の行だけが 03.00、ほかの 27 行が 01.00 でした(数えた)。show event manager detector all も同じ 28 の名前を、番号の列を付けて表示しました(番号の列を除いて上の表と同じ)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager detector all
No.  Name                Version   Node        Type    
1    application         01.00     node0/0     RP      
2    rf                  01.00     node0/0     RP      
3    syslog              01.00     node0/0     RP      
…(省略)
28   ipsla               01.00     node0/0     RP      

資料(Overview 章)は、detector の多くは特定の版で入ったと書いています(版の表は §2.5)。

Some event detectors are available on every Cisco IOS release, but most event detectors have been introduced in a specific release.

(Overview 章「EEM Event Detectors Available by Cisco IOS Release」)

本ラボの 28 の detector と資料の版の表を並べても、この機器の detector が表のどの列に当たるかは、表からは言えません。

4.2 applet の中の event と action の一覧

applet の設定モードで撮った event ? の項目は 24 行で、そのうち tag を除く 23 行が event の種類の名前でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1(config-applet)# event ?
  application         Application specific event
  cli                 CLI event
  config              Configuration policy event
  counter             Counter event
  env                 Environmental event
  gold                GOLD event
  interface           Interface event
  ioswdsysmon         IOS WDSysMon event
  ipsla               IPSLA Event
  mat                 MAC address table event
  neighbor-discovery  Neighbor Discovery event
  none                Manually run policy event
  oir                 OIR event
  resource            Resource event
  rf                  Redundancy Facility event
  routing             Routing event
  rpc                 Remote Procedure Call event
  snmp                SNMP event
  snmp-notification   SNMP Notification Event
  snmp-object         SNMP object event
  syslog              Syslog event
  tag                 event tag identifier
  timer               Timer event
  track               Tracking object event

CSR1(config-applet)#event 
…(省略)

項目の後の CSR1(config-applet)#event の行は、機器のプロンプトと入力途中の文字列で、その後の …(省略) で外したのは取得スクリプトが書いた〔ツール側〕の行です(以下のヘルプも同じ形)。

event ? の 24 の名前と 28 の detector の名前を突き合わせると、detector の側にだけ在る名前は crash・ds・generic・nhrp・test の 5 つ、event ? の側にだけ在る名前は tag の 1 つでした(数えた)。名前の突き合わせだけで、意味は書きません。

action 1.0 ? の項目は 41 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1(config-applet)# action 1.0 ?
  add                  Add
  append               Append to a variable
  break                Break out of a conditional loop
  cli                  Execute a CLI command
  cns-event            Send a CNS event
  comment              add comment
  context              Save or retrieve context information
  continue             Continue to next loop iteration
  counter              Modify a counter value
  decrement            Decrement a variable
  divide               Divide
  else                 else conditional
  elseif               elseif conditional
  end                  end conditional block
  exit                 Exit from applet run
  export-to-telemetry  Export EEM variables to Telemetry
  file                 file operations
  force-switchover     Force a software switchover
  foreach              foreach loop
  gets                 get line of input from active tty
  handle-error         On error action
  help                 Read/Set parser help buffer
  if                   if conditional
  increment            Increment a variable
  info                 Obtain system specific information
  mail                 Send an e-mail
  multiply             Multiply
  policy               Run a pre-registered policy
  publish-event        Publish an application specific event
  puts                 print data to active tty
  regexp               regular expression match
  reload               Reload system
  set                  Set a variable
  snmp-object-value    Specify value for the SNMP get request
  snmp-trap            Send an SNMP trap
  string               string commands
  subtract             Subtract
  syslog               Log a syslog message
  track                Read/Set a tracking object
  wait                 Wait for a specified amount of time
  while                while loop

CSR1(config-applet)#action 1.0 
…(省略)

一覧に載っていることは、その event や action がこの機器で動くことの証拠にしません。本ラボで発火させた event は none・syslog・timer・cli の 4 種で、使った action は puts・syslog・cli・regexp・set・if と end です。

4.3 設定を入れる前の EEM の表示

CLI 章は、show event manager policy registered を、今登録されている EEM のポリシーを表示するコマンドとしています。

(Optional) Displays the EEM policies that are currently registered.

(CLI 章「Unregistering Embedded Event Manager Policies」)

本ラボの設定を入れる前の show event manager policy registered には、Client Policies の見出しの下に、Class が CH・Type が user・Name が CiscoTAC-1 の行が 8 行ありました(数えた)。8 行のうち Event Type が syslog の行は 2 行で、pattern は Traceback と .* です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager policy registered
No.  Class     Type    Event Type          Trap  Time Registered           Name

Client Policies
No.  Class     Type    Event Type          Trap  Time Registered           Name
1    CH        user    timer cron          Off   Mon Oct 26 16:14:52 2026  CiscoTAC-1
…(省略)
3    CH        user    syslog              Off   Mon Oct 26 16:14:52 2026  CiscoTAC-1

 severity-debugging severity-normal severity-notification severity-warning severity-minor severity-major severity-critical severity-fatal severity-disaster severity-catastrophic pattern {Traceback}
 queue-priority normal maxrun 0.000
…(省略)
7    CH        user    syslog              Off   Mon Oct 26 16:14:52 2026  CiscoTAC-1

 severity-major severity-critical severity-fatal severity-disaster severity-catastrophic pattern {.*}
 queue-priority normal maxrun 0.000
…(省略)

8 行の Time Registered はどれも Mon Oct 26 16:14:52 2026 で、applet の行は 0 行でした(数えた)。この 8 行が何をするものかは撮っていません。本ラボの applet と script の行は、この表の上の側(Client Policies の見出しの前)に足されていきます(§5.3)。

show event manager policy available system は、system のサンプルのポリシー 7 本を表示しました。中身は撮っていません。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager policy available system

No.  Type    Time Created              Name
1    system  Thu Feb 7  06:28:15 2036  ap_perf_test_base_cpu.tcl
2    system  Thu Feb 7  06:28:15 2036  cl_show_eem_tech.tcl
3    system  Thu Feb 7  06:28:15 2036  no_perf_test_init.tcl
4    system  Thu Feb 7  06:28:15 2036  sl_intf_down.tcl
5    system  Thu Feb 7  06:28:15 2036  tm_cli_cmd.tcl
6    system  Thu Feb 7  06:28:15 2036  tm_crash_reporter.tcl
7    system  Thu Feb 7  06:28:15 2036  tm_fsys_usage.tcl

user policy の directory と、AAA の下で使う session cli username は、どちらも not configured でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の directory の表示は以下のとおりです。

snippet
CSR1# show event manager directory user policy
not configured

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の session cli username の表示は以下のとおりです。

snippet
CSR1# show event manager session cli username
not configured

同じ時点の show event manager environment all と show event manager history events は、出力の行が空行 1 行だけで、show event manager statistics policy は見出しの下に行が 0 行でした(数えた)。

CLI 章は、show event manager scheduler thread を、スケジューラから見た EEM の実行スレッドと、走っているポリシーの詳細を表示するコマンドとしています。

This command displays all the EEM execution threads from the scheduler perspective and the details of the running policies.

(CLI 章「Verifying Class-Based Scheduled Activities of EEM Policies」)

本ラボでは、Applet threads が total 5、Script threads が total 1 と表示されました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager scheduler thread

1 Script threads service class default 
  total: 1 running: 0 idle: 1

2 Applet threads service class default 
  total: 5 running: 0 idle: 5

3 Callhome threads service class default 
  total: 32 running: 0 idle: 32

4 Shell threads service class default 
  total: 1 running: 0 idle: 1

5 Shell threads service class Z 
  total: 1 running: 0 idle: 1

6 ONE-P threads service class default 
  total: 5 running: 0 idle: 5

5. アプレットの基本

5.1 資料の applet

CLI 章は、applet を、event の条件と、その event が起きた時に取る action を簡潔に定める方法としています。applet の設定モードで書ける文は 3 種類です。

An EEM applet is a concise method for defining event screening criteria and the actions to be taken when that event occurs. In applet configuration mode, three types of configuration statements are supported.

(CLI 章「EEM Applet」)

3 種類の文の役割は、event が applet を走らせる条件、action が走った時の動作、set が applet の変数の値です。set で値を入れられる変数は、今のところ _exit_status だけと書かれています(§9)。

The event commands are used to specify the event criteria to trigger the applet to run, the action commands are used to specify an action to perform when the EEM applet is triggered, and the set command is used to set the value of an EEM applet variable. Currently only the _exit_status variable is supported for the set command.

(CLI 章「EEM Applet」)

同じ節は、applet の中に置ける event の設定の文は 1 つだけと書いています。続く文は、event が無いまま applet の設定モードを抜けると警告が出て、その applet は登録されたとみなされないと書いています。

Only one event configuration command is allowed within an applet configuration. When applet configuration mode is exited and no event command is present, a warning is displayed stating that no event is associated with this applet. If no event is specified, this applet is not considered registered.

(CLI 章「EEM Applet」)

同じ章の Configuring Multiple Event Support の節は、複数の event を EEM サーバに登録する機能を書いています。

The multiple event support feature adds the ability to register multiple events in the EEM server. The multiple event support involves one or more event occurrences, one or more tracked object states, and a time period for the event to occur.

(CLI 章「Configuring Multiple Event Support」)

その下の手順は、trigger の文が、各 event の文に付けた tag で複数の event の文を結ぶと書いています。

The trigger command enters the trigger applet configuration mode and specifies the multiple event configuration statements for EEM applets. The trigger statement is used to relate multiple event statement using the tag argument specified in each event statement.

(CLI 章「Setting the Event Configuration Parameters」)

event の文を 1 つだけと書く節と、複数の event を登録する節が、同じ章に在ります。ここでは両方を並べるだけです。本ラボの applet の中の event ? のヘルプには tag の項目が在ります(§4.2)。本ラボの running-config と registered の出力に、tag を付けた event の文の行は 0 行でした(数えた)。tag を付けた複数の event の applet は撮っていません(§14.1)。

EEM Applet の節は、applet の設定モードを抜けた時に、EEM が event と action の文を調べて applet を登録するとも書いています。

The Embedded Event Manager schedules and runs policies on the basis of an event specification that is contained within the policy itself. When applet configuration mode is exited, EEM examines the event and action commands that are entered and registers the applet to be run when a specified event occurs.

(CLI 章「EEM Applet」)

applet の設定モードのプロンプトは (config-applet)# で、何も書かずに抜けた applet は消えると書かれています。

Applet configuration mode is entered using the event manager applet command. In applet configuration mode the config prompt changes to (config-applet)#.

(CLI 章「Configuring Variable Logic for EEM Applets」)

If no commands are specified in applet configuration mode, the applet will be removed upon exit. The exit applet config command is used to exit from applet configuration mode.

(CLI 章「Configuring Variable Logic for EEM Applets」)

applet の実行時間の上限(maxrun)について、CLI 章は、maxrun を付けない applet の既定を 20 秒としています。この文は event snmp-object の節にあり、event none ほかの applet にも当たるとは書かれていません。

The maxrun keyword specifies the maximum runtime of the applet. If the maxrun keyword is specified, the maxruntime-number value must be specified. If the maxrun keyword is not specified, the default applet run time is 20 seconds.

(CLI 章「Configuring Event SNMP Object」)

action puts は文字列を active console に書きます。同期の applet の puts は system logger を通らずに console へ直接出て、非同期の applet の puts は system logger に行くと書かれています。

The action puts command will write the string to the active console. A new line will be displayed unless the nonewline keyword is specified.

(CLI 章「Writing Input to the Active Console」)

The output from the action puts command for a synchronous applet is displayed directly to the console, bypassing the system logger. The output of the action puts command for an asynchronous applet is directed to the system logger.

(CLI 章「Writing Input to the Active Console」)

none の event について、Overview 章は、event manager run がポリシーを走らせた時に none の event detector が event を publish し、手で走らせるポリシーも先に登録が要ると書いています。

The none event detector publishes an event when the Cisco IOS event manager run CLI command executes an EEM policy. EEM schedules and runs policies on the basis of an event specification that is contained within the policy itself. An EEM policy must be identified and registered to be permitted to run manually before the event manager run command will execute.

(Overview 章「None Event Detector」)

5.2 何も入れずに applet を抜けた時

資料は、event の無い applet を抜けると警告が出ると書き、何も書かずに抜けた applet は消えると書いています(§5.1)。

本ラボの P0 では、global config で event manager applet A75-HELP を打って applet の設定モードに入りました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の端末の逐語は以下のとおりです。

snippet
event manager applet A75-HELP
CSR1(config-applet)#

applet の設定モードで ? のヘルプ(§4.2)を撮った後、何も入れずに exit と end を打ちました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の端末の逐語は以下のとおりです。

snippet
exit
CSR1(config)#end
CSR1#

exit と end の間に % を含む行は 0 行で、警告の文言は端末の逐語にありませんでした(数えた)。この操作を含む窓(16:15:55.354〜16:16:49.779)の中の syslog の行は、%SYS-5-CONFIG_I の 1 行だけでした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:16:47.500: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)

その後の running-config に A75-HELP の行は 0 行で、| section event manager の出力も空でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の | include A75-HELP の表示は以下のとおりです。

snippet
CSR1# show running-config | include A75-HELP

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の | section event manager の表示は以下のとおりです。

snippet
CSR1# show running-config | section event manager

資料の「警告が出る」と、本ラボの端末に警告の行が無かったことを並べます。端末に警告の行が無かった理由と、警告が vty の端末以外に出るかは撮っていません。

5.3 applet の登録と registered の表示

本ラボの PA では、環境変数 1 つと applet 5 本を 1 回の configure terminal で入れました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーの抜粋(環境変数と A75-NONE)は以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager environment p75_greeting hello-from-env
CSR1(config)#event manager applet A75-NONE
CSR1(config-applet)# event none
CSR1(config-applet)# action 1.0 puts "A75-NONE puts: event_type=$_event_type_string"
CSR1(config-applet)# action 2.0 syslog msg "A75-NONE syslog line"
CSR1(config-applet)# action 3.0 cli command "enable"
CSR1(config-applet)# action 4.0 cli command "show clock"
CSR1(config-applet)# action 5.0 puts "A75-NONE cli_result begin"
CSR1(config-applet)# action 6.0 puts "$_cli_result"
CSR1(config-applet)# action 7.0 puts "A75-NONE cli_result end"
…(省略)
CSR1(config-applet)#end
CSR1#

A75-NONE は、puts(1.0・5.0・6.0・7.0)・syslog(2.0)・cli(3.0・4.0)の action を持つ applet です。投入のエコーの中に % を含む行は 0 行でした(数えた)。

6.0 の $_cli_result と同じ名前の変数は、CLI 章の見本の action にも出ます(§10.1)。

投入の後の show event manager policy registered は、A75-NONE を Class applet・Type user・Event Type none と表示し、次の行に policyname {A75-NONE} sync {yes}、その次に maxrun 20.000 を表示しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager policy registered
No.  Class     Type    Event Type          Trap  Time Registered           Name
1    applet    user    none                Off   Mon Oct 26 16:17:43 2026  A75-NONE
 policyname {A75-NONE} sync {yes}
 maxrun 20.000
 action 1.0 puts "A75-NONE puts: event_type=$_event_type_string"
 action 2.0 syslog msg "A75-NONE syslog line"
 action 3.0 cli command "enable"
 action 4.0 cli command "show clock"
 action 5.0 puts "A75-NONE cli_result begin"
 action 6.0 puts "$_cli_result"
 action 7.0 puts "A75-NONE cli_result end"
…(省略)

投入した applet の行に sync と maxrun は書いていません(投入のエコーで 0 行。数えた)。PA の 5 本の applet は、どれも sync {yes} と maxrun 20.000 の行を持っていました(数えた)。

§5.1 の資料の maxrun の既定の文は 20 秒で、表示の 20.000 と同じ数です。2 つを並べるだけで、20.000 が event none の applet の既定の値だとは書きません。

CLI 章の show event manager policy registered の見本は、applet の行の Type を system と表示しています。

Device# show event manager policy registered No. Class Type Event Type Trap Time Registered Name 1 applet system snmp Off Fri Aug 12 17:42:52 2005 IPSLAping1

(CLI 章「Unregistering Embedded Event Manager Policies」)

本ラボの applet の行の Type は、上の registered の表示で user でした。

資料の見本の system と本ラボの user を並べ、どちらが正しいとは書きません。

show event manager policy registered detailed に applet の名前を渡すと、%EEM: で始まる 1 行を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager policy registered detailed A75-NONE

%EEM: A75-NONE does not have valid policy extension

5.4 event manager run と出力の行き先

本ラボの PA の窓(16:19:01.871〜16:19:37.213)では、5 本の applet を event manager run で 1 本ずつ走らせました。A75-NONE の run の逐語には、1.0 の puts の行と 5.0・7.0 の puts の行が出て、5.0 と 7.0 の行の間に、空行・show clock の形の行・CSR1# の 3 行が出ました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-NONE
A75-NONE puts: event_type=none
A75-NONE cli_result begin

*16:19:04.455 UTC Mon Oct 26 2026
CSR1#
A75-NONE cli_result end

1 行目の event_type=none は、$_event_type_string の位置に none が入った形です。2.0 の syslog の action の文字列(A75-NONE syslog line)を含む行は、run の逐語に 0 行で、窓の中の syslog に 1 行ありました(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:19:04.331: %HA_EM-6-LOG: A75-NONE: A75-NONE syslog line
*Oct 26 16:19:32.649: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)

窓の中の syslog の行は、この 2 行(%HA_EM-6-LOG の 1 行と %SYS-5-CONFIG_I の 1 行)だけでした。run の中の show clock(16:19:04.455)は、%HA_EM-6-LOG の行(16:19:04.331)の 0.124 秒後です。%SYS-5-CONFIG_I の行と、同じ窓の中で撮った global config の操作(§5.5)が同じ操作かは、行の逐語からは言えません。

本ラボの registered の表示は sync {yes} で、puts の行は event manager run を打った端末の逐語に出ました。非同期の applet の puts の行き先は撮っていません。

資料は、同期の applet の puts は console に直接出ると書いています(§5.1)。資料の文と本ラボの端末の逐語を並べるだけで、端末が資料の console に当たるかは書きません。

窓の後の show event manager history events は、5 本の run を 5 行で表示しました。5 行とも Status は success、Event Type は none です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager history events
No.  Job Id Proc Status   Time of Event            Event Type        Name
1    1      Actv success  Mon Oct26 16:19:04 2026  none              applet: A75-NONE 
2    2      Actv success  Mon Oct26 16:19:09 2026  none              applet: A75-ORDER 
3    3      Actv success  Mon Oct26 16:19:13 2026  none              applet: A75-REGEXP 
4    4      Actv success  Mon Oct26 16:19:18 2026  none              applet: A75-IF 
5    5      Actv success  Mon Oct26 16:19:22 2026  none              applet: A75-ENV 

run が戻った後の show event manager policy active は、7 回とも表の行が 0 行でした(数えた)。この表示からは、ポリシーが走り終えた後か、まだ始まっていないかを分けられません。

5.5 event manager run を打つモード

CLI 章は、手で走らせるポリシーを、applet の設定モードの action policy か、特権 EXEC の event manager run で走らせると書いています。同じ手順の Step 7 の例も Device# のプロンプトから打っています。

To run the policy, use either the action policy command in applet configuration mode or the event manager run command in privileged EXEC mode.

(CLI 章「Registering and Defining an Embedded Event Manager Policy to Run Manually」)

Step 7 event manager run applet-name Example: Device# event manager run manual-policy Manually runs a registered EEM policy.

(CLI 章「Registering and Defining an Embedded Event Manager Policy to Run Manually」)

同じ章の Using the event manager run Command の例の説明は、global configuration mode から event manager run で走らせると書いています。その例の設定は、applet を書いて end で抜けた後に event manager run を打つ形です。

This example shows how to run a policy manually using the event manager run command. The policy is registered using the event none command under applet configuration mode and then run from global configuration mode using the event manager run command.

(CLI 章「Using the event manager run Command」)

event manager applet manual-policy event none action 1.0 syslog msg “Manual-policy triggered” end ! event manager run manual-policy

(CLI 章「Using the event manager run Command」)

Tcl 章の例は、event manager run を Device(config)# のプロンプトで打っています(§11.4)。資料の中で、run を打つモードの書き方が割れています。

本ラボでは、exec の event manager ? の項目に run が在り、config の event manager ? の項目に run で始まる行は 0 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の exec のヘルプは以下のとおりです。

snippet
CSR1# event manager ?
  auto-deploy  Run Embedded Event Manager Auto-deploy instantly
  run          Run a registered Embedded Event Manager policy
  scheduler    Embedded Event Manager scheduler
  update       Update Embedded Event Manager files

CSR1#event manager 
…(省略)

config のヘルプは別の取得の記録で、項目の後のプロンプトは CSR1(config)# です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の config のヘルプは以下のとおりです。

snippet
CSR1(config)# event manager ?
  applet       Register an Event Manager applet
  auto-deploy  Configure Embedded Event Manager Auto-deploy profile
  detector     Set Embedded Event Manager detector information
  directory    Set Embedded Event Manager directory information
  environment  Set an Embedded Event Manager global environment variable
  history      Set Embedded Event Manager history information
  policy       Register an Embedded Event Manager policy
  scheduler    Set Event Manager scheduler options
  session      Set Embedded Event Manager session attributes

CSR1(config)#event manager 
…(省略)

global config で event manager run A75-NONE を打つと、run の頭の位置に ^ が付き、% Invalid input で始まる行が返りました。A75-NONE の puts の行は 0 行です(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager run A75-NONE
                           ^
% Invalid input detected at '^' marker.

CSR1(config)#end
CSR1#

^ の行は 28 文字(空白 27 個と ^)で、エコーの行の 28 文字目は event manager run の run の頭の r です(数えた)。PA の history(§5.4)に、この global config の操作に当たる行はありません(A75-NONE の行は 1 回目の run の 1 行だけ)。

資料の「特権 EXEC」と「global configuration mode」を並べ、本ラボの受理と拒否の逐語を置くまでにとどめます。

5.6 event manager run の引数

Overview 章の EEM 2.4 の節は、event manager run に parameter の引数が足され、最大 15 個まで使えると書いています。どの変数に入るかは、この文は書いていません。

Support for parameters—The parameter argument has been added to the event manager run command. A maximum of 15 parameters can be used.

(Overview 章「Embedded Event Manager 2.4」)

CLI 章の None Event Detector の表は、_none_argc と _none_arg1〜_none_arg15 の説明を、XML SOAP のコマンドからスクリプトへ渡す引数としています。資料は、この表の変数と event manager run の引数を結び付けて書いていません。

The parameters that are passed from the XML SOAP command to the script.

(CLI 章「None Event Detector」)

本ラボでは、$_none_argc・$_none_arg1・$_none_arg2 を puts で出す applet A75-ARGS を入れました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager applet A75-ARGS
CSR1(config-applet)# event none
CSR1(config-applet)# action 1.0 puts "A75-ARGS begin"
CSR1(config-applet)# action 2.0 puts "A75-ARGS argc=$_none_argc"
CSR1(config-applet)# action 3.0 puts "A75-ARGS arg1=$_none_arg1"
CSR1(config-applet)# action 4.0 puts "A75-ARGS arg2=$_none_arg2"
CSR1(config-applet)# action 5.0 puts "A75-ARGS end"
CSR1(config-applet)#end
CSR1#

run の引数のヘルプは LINE と <cr> の 2 項目でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)のヘルプは以下のとおりです。

snippet
CSR1# event manager run A75-ARGS ?
  LINE  The list of arguments for the policy
  <cr>  <cr>

CSR1#event manager run A75-ARGS 
…(省略)

引数を 2 つ付けた run は、argc=2・arg1=p75one・arg2=p75two の puts の行を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-ARGS p75one p75two
A75-ARGS begin
A75-ARGS argc=2
A75-ARGS arg1=p75one
A75-ARGS arg2=p75two
A75-ARGS end

run の後の show event manager history events detailed は、各行の下に argc の行を付けて表示しました。引数なしで走らせた 5 本は argc 0、A75-ARGS は arg1 p75one arg2 p75two argc 2 です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager history events detailed
No.  Job Id Proc Status   Time of Event            Event Type        Name
1    1      Actv success  Mon Oct26 16:19:04 2026  none              applet: A75-NONE 
   argc 0
2    2      Actv success  Mon Oct26 16:19:09 2026  none              applet: A75-ORDER 
   argc 0
3    3      Actv success  Mon Oct26 16:19:13 2026  none              applet: A75-REGEXP 
   argc 0
4    4      Actv success  Mon Oct26 16:19:18 2026  none              applet: A75-IF 
   argc 0
5    5      Actv success  Mon Oct26 16:19:22 2026  none              applet: A75-ENV 
   argc 0
6    6      Actv success  Mon Oct26 16:20:18 2026  none              applet: A75-ARGS 
   arg1 p75one arg2 p75two argc 2

本ラボでは、run の引数が puts の行と history detailed の行の 2 か所に出ました。引数の数の上限・空白や引用符を含む引数・引数なしの時の $_none_arg1 の値は撮っていません(§14)。


6. action の順と変数

6.1 action の実行順

CLI 章は、action のラベルを任意の文字列の識別子とし、action をラベルの辞書順(英数字の昇順)に並べて走らせると書いています。数字のラベルでは 10.0 が 1.0 の後・2.0 の前に来るので、01.0・02.0 の形か、先頭に英字を付ける形を勧めています。

An EEM action label is a unique identifier that can be any string value. Actions are sorted and run in ascending alphanumeric (lexicographical) key sequence using the label as the sort key. If you are using numbers as labels be aware that alphanumerical sorting will sort 10.0 after 1.0, but before 2.0, and in this situation we recommend that you use numbers such as 01.0, 02.0, and so on, or use an initial letter followed by numbers.

(CLI 章「Alphabetical Order of EEM Action Labels」)

同じ趣旨の文は、CLI 章の EEM Applet の節・Overview 章の Embedded Event Manager Actions の節・Tcl 章の EEM Applet の節にもあり、取得した資料の中で辞書順と書く所は 4 か所です。

The action configuration commands are uniquely identified using the label argument, which can be any string value. Actions are sorted in ascending alphanumeric key sequence using the label argument as the sort key, and they are run using this sequence.

(CLI 章「EEM Applet」)

一方で CLI 章の Variable Logic の節は、変数の論理が入る前の applet は、event が起きた時に action を設定した順に実行する直線の構造だったと書いています。この文は「変数の論理が入る前」という条件の付いた文です。

The Variable Logic for EEM Applets feature adds the ability to apply conditional logic within EEM applets. Before variable logic is introduced, applets have a linear structure where each action is executed in the order in which they are configured when the event is triggered. Conditional logic introduces a control structure that can change the flow of actions within applets depending on conditional expressions.

(CLI 章「Configuring Variable Logic for EEM Applets」)

本ラボの A75-ORDER は、ラベル 1.0・2.0・10.0 の puts をこの順に投入しました(§5.3 と同じ 1 回の投入)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーの抜粋は以下のとおりです。

snippet
…(省略)
CSR1(config-applet)#event manager applet A75-ORDER
CSR1(config-applet)# event none
CSR1(config-applet)# action 1.0 puts "A75-ORDER label 1.0"
CSR1(config-applet)# action 2.0 puts "A75-ORDER label 2.0"
CSR1(config-applet)# action 10.0 puts "A75-ORDER label 10.0"
…(省略)
CSR1(config-applet)#end
CSR1#

running-config は、同じ 3 行を 1.0 → 10.0 → 2.0 の順に表示しました(registered も同じ順)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の running-config の抜粋は以下のとおりです。

snippet
CSR1# show running-config | section event manager
…(省略)
event manager applet A75-ORDER
 event none
 action 1.0  puts "A75-ORDER label 1.0"
 action 10.0 puts "A75-ORDER label 10.0"
 action 2.0  puts "A75-ORDER label 2.0"
…(省略)

表示の puts の前の空白は、1.0 と 2.0 の行が 2 つ、10.0 の行が 1 つです。event manager run A75-ORDER の出力の順も 1.0 → 10.0 → 2.0 でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-ORDER
A75-ORDER label 1.0
A75-ORDER label 10.0
A75-ORDER label 2.0

投入の順・表示の順・出力の順を並べると、表示の順と出力の順が同じで、投入の順だけが違いました。どの規則によるかは書きません。ほかのラベルの組で、順を入れ替えた投入は撮っていません。

6.2 regexp と変数

CLI 章の action regexp の構文は、string-pattern・string-input の後に、一致した全体と部分一致を入れる変数を任意で続ける形です。

action label regexp string-pattern string-input [string-match [string-submatch1 ] [string-submatch2 ] [string-submatch3 ]]

(CLI 章「Writing Input to the Active Console」)

同じ章の puts の節には、event none の applet で regexp の結果を puts で出す見本と、その出力(match is one two three・submatch 1 is one)があります。

Device(config-applet)# event manager applet puts Device(config-applet)# event none Device(config-applet)# action 1 regexp “(.*) (.*) (.*)” “one two three” _match _sub1 Device(config-applet)# action 2 puts “match is $_match” Device(config-applet)# action 3 puts “submatch 1 is $_sub1” Device# event manager run puts match is one two three submatch 1 is one

(CLI 章「Writing Input to the Active Console」)

本ラボの A75-REGEXP は、この見本の action の 3 行と同じ行を入れました(§5.3 と同じ 1 回の投入)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーの抜粋は以下のとおりです。

snippet
…(省略)
CSR1(config-applet)#event manager applet A75-REGEXP
CSR1(config-applet)# event none
CSR1(config-applet)# action 1 regexp "(.*) (.*) (.*)" "one two three" _match _sub1
CSR1(config-applet)# action 2 puts "match is $_match"
CSR1(config-applet)# action 3 puts "submatch 1 is $_sub1"
…(省略)
CSR1(config-applet)#end
CSR1#

run の出力は 2 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-REGEXP
match is one two three
submatch 1 is one

run の出力は、見本の出力の 2 行と同じ文字列でした。

6.3 if と set

CLI 章の if / else の手順は、action の set で変数に値を入れ、action の if で比べる形です。比較の演算子は eq・gt・ge・lt・le・ne で、手順の例は画面に 5 is less than 10 が出ると書いています。

action label if [stringop1 ] {eq | gt | ge | lt | le | ne } [stringop2 ]

(CLI 章「Specifying if else Conditional Blocks」)

Step 4 action label set variable-name variable-value Example: Device(config-applet)# action 1.0 set x 5 Sets an action for the event. In this example, the value of the variable x is set to 5.

(CLI 章「Specifying if else Conditional Blocks」)

In this example, the message ‘5 is less than 10’ is displayed on the screen.

(CLI 章「Specifying if else Conditional Blocks」)

本ラボの A75-IF は、action 1.0 set x 5 と action 2.0 if $x lt 10 を投入しました(§5.3 と同じ 1 回の投入)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーの抜粋は以下のとおりです。

snippet
…(省略)
CSR1(config-applet)#event manager applet A75-IF
CSR1(config-applet)# event none
CSR1(config-applet)# action 1.0 set x 5
CSR1(config-applet)# action 2.0 if $x lt 10
CSR1(config-applet)# action 3.0 puts "$x is less than 10"
CSR1(config-applet)# action 4.0 end
…(省略)
CSR1(config-applet)#end
CSR1#

running-config は、この 2 行を set x "5" と if $x lt "10" の形(数字を " で囲んだ形)で表示し、3.0 の行は puts の前の空白が 2 つでした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の running-config の抜粋は以下のとおりです。

snippet
CSR1# show running-config | section event manager
…(省略)
event manager applet A75-IF
 event none
 action 1.0 set x "5"
 action 2.0 if $x lt "10"
 action 3.0  puts "$x is less than 10"
 action 4.0 end
…(省略)

run の出力は、$x の位置に 5 が入った 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-IF
5 is less than 10

6.4 環境変数

Overview 章は、環境変数を event manager environment のコマンドで定義してポリシーの中で使うとし、環境変数を 3 種類としています。

EEM allows environment variables to be defined using a CLI command, the event manager environment command, for use within an EEM policy. All EEM environment variables are automatically assigned to Tcl global variables before a Tcl script is run. There are three different types of environment variables associated with Embedded Event Manager:

(Overview 章「Embedded Event Manager Environment Variables」)

CLI 章は、設定した環境変数を特権 EXEC の show event manager environment で見ると書いています。

You can display the EEM environment variables set on your system by using the show event manager environment privileged EXEC command.

(CLI 章「EEM Environment Variables」)

本ラボは、event manager environment p75_greeting hello-from-env を投入し(§5.3 の投入のエコーの 1 行目)、show event manager environment all と A75-ENV の run を撮りました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の environment all の表示は以下のとおりです。

snippet
CSR1# show event manager environment all
No.  Name                          Value                         
1    p75_greeting                  hello-from-env

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の A75-ENV の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-ENV
A75-ENV p75_greeting=hello-from-env

run の出力の $p75_greeting の位置には、環境変数の表の値 hello-from-env が入っていました。投入の前(P0)の同じ表示は空でした(§4.3)。


7. syslog の event

7.1 資料の syslog の event

Overview 章は、syslog の event detector を、syslog のメッセージを正規表現のパターンで照合して選び出すものとしています。指定した時間の中の回数でさらに絞ることができ、一致すると、設定したポリシーの action が動くと書かれています。

The syslog event detector allows for screening syslog messages for a regular expression pattern match. The selected messages can be further qualified, requiring that a specific number of occurrences be logged within a specified time. A match on a specified event criteria triggers a configured policy action.

(Overview 章「Syslog Event Detector」)

Event Registration 章は、Tcl の event_register_syslog の pattern を、syslog のメッセージを照合する正規表現の必須の引数としています。

(Mandatory) A regular expression used to perform syslog message pattern match. This argument is what the policy uses to identify the logged syslog message.

(Event Registration 章「event_register_syslog」)

Python 章の applet の手順(Step 4)には、Loopback55 の administratively down の syslog の文を pattern に書く例があります。

event [tag event-tag] syslog pattern regular-expression Example: Device(config-applet)# event syslog pattern “Interface Loopback55, changed state to administratively down” Specifies a regular expression to perform the syslog message pattern match.

(Python 章「Adding a Python Script in an EEM Applet」)

同じ見本の出力の行は、%LINK-5-CHANGED に Line protocol の本文を、%LINK-3-UPDOWN に administratively down の本文を付けています。

Mar 13 10:53:24.156 EDT: %LINK-5-CHANGED: Line protocol on Interface Loopback55, changed state to down

(Python 章「Adding a Python Script in an EEM Applet」)

Mar 13 10:53:27.319 EDT: %LINK-3-UPDOWN: Interface Loopback55, changed state to administratively down

(Python 章「Adding a Python Script in an EEM Applet」)

7.2 Loopback75 の shutdown と applet A75-SYSLOG-LO

本ラボの PB では、Loopback75 と、2 本の syslog の event の applet を入れました。A75-SYSLOG-LO は、pattern に Loopback75 の administratively down の文を書き、action 1.0 で syslog を出し、2.0〜6.0 の action cli で enable・configure terminal・interface Loopback75・no shutdown・end を打つ applet です。pattern の形(IF の名前と状態の文)は、§7.1 の Python 章の例に合わせました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#interface Loopback75
CSR1(config-if)# ip address 10.7.5.75 255.255.255.255
CSR1(config-if)#event manager applet A75-SYSLOG-LO
CSR1(config-applet)# event syslog pattern "Interface Loopback75, changed state to administratively down"
CSR1(config-applet)# action 1.0 syslog msg "A75-SYSLOG-LO fired"
CSR1(config-applet)# action 2.0 cli command "enable"
CSR1(config-applet)# action 3.0 cli command "configure terminal"
CSR1(config-applet)# action 4.0 cli command "interface Loopback75"
CSR1(config-applet)# action 5.0 cli command "no shutdown"
CSR1(config-applet)# action 6.0 cli command "end"
CSR1(config-applet)#event manager applet A75-SYSLOG-SEND
CSR1(config-applet)# event syslog pattern "P75SENDLOG"
CSR1(config-applet)# action 1.0 syslog msg "A75-SYSLOG-SEND fired"
CSR1(config-applet)#end
CSR1#

registered は、2 本を Event Type syslog で表示し、pattern を { } で囲んだ行を付けました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager policy registered
…(省略)
7    applet    user    syslog              Off   Mon Oct 26 16:21:17 2026  A75-SYSLOG-LO
 pattern {Interface Loopback75, changed state to administratively down}
 maxrun 20.000
 action 1.0 syslog msg "A75-SYSLOG-LO fired"
 action 2.0 cli command "enable"
 action 3.0 cli command "configure terminal"
 action 4.0 cli command "interface Loopback75"
 action 5.0 cli command "no shutdown"
 action 6.0 cli command "end"

8    applet    user    syslog              Off   Mon Oct 26 16:21:26 2026  A75-SYSLOG-SEND
 pattern {P75SENDLOG}
 maxrun 20.000
 action 1.0 syslog msg "A75-SYSLOG-SEND fired"
…(省略)

2 本の行に severity・occurs・period・priority を含む行は 0 行でした(数えた)。

この図を大きく開く ↗

applet A75-SYSLOG-LO の流れです。Loopback75 の shutdown から up の行まで、窓の中の syslog の 7 行をこの run の時刻の順に並べます。

取得スクリプトは、窓の始めの show clock(16:21:33.748)の後に、interface Loopback75 と shutdown を打ちました。この投入に no shutdown の行は 0 行です(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#interface Loopback75
CSR1(config-if)#shutdown
CSR1(config-if)#end
CSR1#

窓(16:21:33.748〜16:22:04.728)の中の syslog の行は 7 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:21:43.553: %LINEPROTO-5-UPDOWN: Line protocol on Interface Loopback75, changed state to down
*Oct 26 16:21:43.553: %LINK-5-CHANGED: Interface Loopback75, changed state to administratively down
*Oct 26 16:21:43.558: %HA_EM-6-LOG: A75-SYSLOG-LO: A75-SYSLOG-LO fired
*Oct 26 16:21:44.003: %SYS-5-CONFIG_I: Configured from console by  on vty0 (EEM:A75-SYSLOG-LO)
*Oct 26 16:21:44.833: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)
*Oct 26 16:21:45.902: %LINEPROTO-5-UPDOWN: Line protocol on Interface Loopback75, changed state to up
*Oct 26 16:21:45.902: %LINK-3-UPDOWN: Interface Loopback75, changed state to up

7 行の時刻を並べると、administratively down の行(16:21:43.553)から A75-SYSLOG-LO の %HA_EM-6-LOG の行(16:21:43.558)までが 0.005 秒、そこから (EEM:A75-SYSLOG-LO) の %SYS-5-CONFIG_I の行(16:21:44.003)までが 0.445 秒でした。down の行から、Loopback75 の up の 2 行(16:21:45.902)までは 2.349 秒です。

(EEM:A75-SYSLOG-LO) の行は、by と on の間が空白 2 つで(netops の行で利用者名が入る位置に文字が無い形)、line は vty0 です。その次の 16:21:44.833 の %SYS-5-CONFIG_I の行は、netops・vty1 の行です。7 行の中で pattern の文字列を含む行は、%LINK-5-CHANGED の 1 行でした(数えた)。7 行のうち shutdown の時刻(16:21:43.553)の 2 行は、%LINEPROTO-5-UPDOWN に Line protocol の本文、%LINK-5-CHANGED に administratively down の本文が付く組でした。

§7.1 の Python 章の見本の行の組(%LINK-5-CHANGED に Line protocol の本文、%LINK-3-UPDOWN に administratively down の本文)と、本ラボの行の組を並べるだけで、どちらが正しいとは書きません。

窓の中に見えるのは、EEM の CONFIG_I の行と netops の CONFIG_I の行の後に up の行が出る、という並びまでです。applet の action の各 cli の返事と、no shutdown が効いた時刻を直接示す行は撮っていません。窓の後の history は、7 番目の行を Event Type syslog・Status success で表示しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events
No.  Job Id Proc Status   Time of Event            Event Type        Name
…(省略)
7    7      Actv success  Mon Oct26 16:21:43 2026  syslog            applet: A75-SYSLOG-LO 

shutdown の前と後に撮った show ip interface brief は、どちらも Loopback75 を up / up と表示しました。後の 1 本は投入のエコーの次に撮ったもので、機器の時刻は付いていません。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の shutdown の前の 1 本は以下のとおりです。

snippet
CSR1# show ip interface brief | include Loopback75
Loopback75             10.7.5.75       YES manual up                    up      

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の shutdown の後の 1 本は以下のとおりです。

snippet
CSR1# show ip interface brief | include Loopback75
Loopback75             10.7.5.75       YES manual up                    up      

7.3 send log と applet A75-SYSLOG-SEND

A75-SYSLOG-SEND は、pattern P75SENDLOG に一致すると syslog の行を 1 本出す applet です。2 つ目の窓(16:22:13.770〜16:22:23.415)で、取得スクリプトは send log 6 を打ちました。send log の出力は空行 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の send log の逐語は以下のとおりです。

snippet
CSR1# send log 6 P75SENDLOG from probe

窓の中の syslog の行は 2 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:22:16.056: %SYS-6-USERLOG_INFO: Message from tty2(user id: netops): P75SENDLOG from probe
*Oct 26 16:22:16.058: %HA_EM-6-LOG: A75-SYSLOG-SEND: A75-SYSLOG-SEND fired

send log の行は %SYS-6-USERLOG_INFO で、0.002 秒後に A75-SYSLOG-SEND の %HA_EM-6-LOG の行が出ました。2 つの窓とも、見出しの dropped・rate-limited・overruns は前の見出しから増えていません。

7.4 後片付けと Client Policies の syslog の行

取得スクリプトは、PB の最後に、2 本の applet を外しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#no event manager applet A75-SYSLOG-LO
CSR1(config)#no event manager applet A75-SYSLOG-SEND
CSR1(config)#end
CSR1#

その後の registered に A75-SYSLOG を含む行は 0 行で、Class が applet で Event Type が syslog の行も 0 行でした(数えた)。Client Policies の CH の 8 行は残り、その中の Event Type が syslog の 2 行もそのまま表示されています。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の registered の抜粋は以下のとおりです。

snippet
CSR1# show event manager policy registered
No.  Class     Type    Event Type          Trap  Time Registered           Name
1    applet    user    none                Off   Mon Oct 26 16:17:43 2026  A75-NONE
…(省略)
6    applet    user    none                Off   Mon Oct 26 16:20:11 2026  A75-ARGS
…(省略)
Client Policies
No.  Class     Type    Event Type          Trap  Time Registered           Name
…(省略)
3    CH        user    syslog              Off   Mon Oct 26 16:14:52 2026  CiscoTAC-1
…(省略)
7    CH        user    syslog              Off   Mon Oct 26 16:14:52 2026  CiscoTAC-1
…(省略)

registered の CH の行に Event Type が syslog の 2 行が在る状態は、ラボの設定を入れる前(§4.3)から、PH-a で guestshell disable の前に撮った registered(§12.12)まで同じでした(show event manager policy registered を撮った 18 回とも、CH の Event Type が syslog の行は 2 行。数えた)。PH の後と PZ では registered を撮っていません。CH の行が何をするかは撮っていません。


8. timer の event

8.1 資料の timer の event

Overview 章は、timer の event detector の timer を、absolute-time-of-day・countdown・watchdog・CRON の 4 種類としています。

Timer—The timer event detector publishes events for the following four different types of timers: absolute-time-of-day, countdown, watchdog, and CRON.

(Overview 章「Embedded Event Manager 2.0」)

同じ章の Timer Event Detector の節は、4 種類を次のように書いています。countdown は 0 まで数え下ろした時に event を出し、watchdog は 0 で event を出した後に初期値に戻って数え下ろし直し、CRON は UNIX の CRON の指定で event を出して 1 分に 1 回より多くは出しません。

An absolute-time-of-day timer publishes an event when a specified absolute date and time occurs.

(Overview 章「Timer Event Detector」)

A countdown timer publishes an event when a timer counts down to zero.

(Overview 章「Timer Event Detector」)

A watchdog timer publishes an event when a timer counts down to zero and then the timer automatically resets itself to its initial value and starts to count down again.

(Overview 章「Timer Event Detector」)

A CRON timer publishes an event using a UNIX standard CRON specification to indicate when the event is to be published. A CRON timer never publishes events more than once per minute.

(Overview 章「Timer Event Detector」)

Event Registration 章は、Tcl の event_register_timer の cron_entry を、空白で区切った 5 つの欄の文字列とし、欄の * は first-last を表すと書いています。

A cron_entry specification consists of a text string with five fields. The fields are separated by spaces. The fields represent the time and date when CRON timer events will be triggered.

(Event Registration 章「event_register_timer」)

A field may be an asterisk (*), which always stands for “first-last.”

(Event Registration 章「event_register_timer」)

CLI 章の applet の timer の見本の設定は 3 つで、どれも watchdog の形でした(Application-Specific Event Detector の節の EventPublish_A の time 20.0、下の EventCounter_A の time 60.0、Configuring Variable Logic for EEM Applets Examples の節の略記の ev timer watchdog name rx_timer time 30。数えた)。countdown と cron の applet の見本は、取得した章にありません。

event manager applet EventCounter_A event timer watchdog time 60.0

(CLI 章「Counter Event Detector and Timer Event Detector」)

この見本の次の action の行は、文字列を全角の引用符で囲んでいます(§15.9)。

8.2 本ラボの countdown・watchdog・cron

本ラボは、applet の countdown と cron の書き方を、機器の ? のヘルプの語と、投入の受理(% を含む行が 0 行)で選びました。発火は %HA_EM-6-LOG の行で確かめています。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の applet の設定モードの event timer の ? のヘルプは以下のとおりです。

snippet
CSR1(config-applet)# event timer ?
  absolute   Absolute timer event
  countdown  Countdown timer event
  cron       Cron timer event
  watchdog   Watchdog timer event

CSR1(config-applet)#event timer 
…(省略)

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の event timer countdown の ? のヘルプは以下のとおりです。

snippet
CSR1(config-applet)# event timer countdown ?
  maxrun     Maximum runtime of applet
  name       Name of the timer
  ratelimit  Limit trigger to once per given time period
  time       Time period for watchdog / countdown / absolute timer

CSR1(config-applet)#event timer countdown 
…(省略)

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の event timer cron の ? のヘルプは以下のとおりです。

snippet
CSR1(config-applet)# event timer cron ?
  cron-entry  Cron entry for cron timer
  maxrun      Maximum runtime of applet
  name        Name of the timer
  ratelimit   Limit trigger to once per given time period

CSR1(config-applet)#event timer cron 
…(省略)

PC では、countdown 20・watchdog 30・cron * * * * * の 3 本を入れました。投入のエコーに % を含む行は 0 行です(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager applet A75-COUNTDOWN
CSR1(config-applet)# event timer countdown time 20
CSR1(config-applet)# action 1.0 syslog msg "A75-COUNTDOWN fired"
CSR1(config-applet)#event manager applet A75-WATCHDOG
CSR1(config-applet)# event timer watchdog time 30
CSR1(config-applet)# action 1.0 syslog msg "A75-WATCHDOG fired"
CSR1(config-applet)#event manager applet A75-CRON
CSR1(config-applet)# event timer cron cron-entry "* * * * *"
CSR1(config-applet)# action 1.0 syslog msg "A75-CRON fired"
CSR1(config-applet)#end
CSR1#

registered は、Event Type を timer countdown・timer watchdog・timer cron と表示し、countdown と watchdog に time 20.000・time 30.000、cron に cron entry {* * * * *} の行を付けました。Time Registered は 16:23:07・16:23:17・16:23:27(秒まで)です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager policy registered
…(省略)
7    applet    user    timer countdown     Off   Mon Oct 26 16:23:07 2026  A75-COUNTDOWN
 time 20.000
 maxrun 20.000
 action 1.0 syslog msg "A75-COUNTDOWN fired"

8    applet    user    timer watchdog      Off   Mon Oct 26 16:23:17 2026  A75-WATCHDOG
 time 30.000
 maxrun 20.000
 action 1.0 syslog msg "A75-WATCHDOG fired"

9    applet    user    timer cron          Off   Mon Oct 26 16:23:27 2026  A75-CRON
 cron entry {* * * * *}
 maxrun 20.000
 action 1.0 syslog msg "A75-CRON fired"
…(省略)

窓は、投入の後の show clock(16:23:29.629)から 16:25:52.475 までの 142.846 秒です。窓の中の syslog の行は 7 行で、A75-WATCHDOG の行が 5 行、A75-CRON の行が 2 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋(最初の 2 行は窓の始めより前の時刻で、窓の外)は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:23:27.358: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)
*Oct 26 16:23:27.684: %HA_EM-6-LOG: A75-COUNTDOWN: A75-COUNTDOWN fired
*Oct 26 16:23:47.539: %HA_EM-6-LOG: A75-WATCHDOG: A75-WATCHDOG fired
*Oct 26 16:24:00.001: %HA_EM-6-LOG: A75-CRON: A75-CRON fired
*Oct 26 16:24:17.541: %HA_EM-6-LOG: A75-WATCHDOG: A75-WATCHDOG fired
*Oct 26 16:24:47.540: %HA_EM-6-LOG: A75-WATCHDOG: A75-WATCHDOG fired
*Oct 26 16:25:00.001: %HA_EM-6-LOG: A75-CRON: A75-CRON fired
*Oct 26 16:25:17.541: %HA_EM-6-LOG: A75-WATCHDOG: A75-WATCHDOG fired
*Oct 26 16:25:47.541: %HA_EM-6-LOG: A75-WATCHDOG: A75-WATCHDOG fired

A75-COUNTDOWN の fired の行は 16:23:27.684 で、窓の始めの 1.945 秒前の時刻です。窓の中に A75-COUNTDOWN の行は 0 行で、この行は時刻つきの行として全体の logging に在ったものです。Time Registered(16:23:07・秒まで)から、この行までは 20.684 秒でした。

watchdog の 5 行の間隔は 30.002 秒・29.999 秒・30.001 秒・30.000 秒で、cron の 2 行は 60.000 秒の間隔で、秒の部分がどちらも 00.001 でした。watchdog の Time Registered(16:23:17)から最初の行(16:23:47.539)までは 30.539 秒です(Time Registered は秒までの表示)。

窓の後の history は、3 番目の行に countdown、4〜10 番目の 7 行に watchdog と cron を表示しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager history events
No.  Job Id Proc Status   Time of Event            Event Type        Name
1    7      Actv success  Mon Oct26 16:21:43 2026  syslog            applet: A75-SYSLOG-LO 
2    8      Actv success  Mon Oct26 16:22:16 2026  syslog            applet: A75-SYSLOG-SEND 
3    9      Actv success  Mon Oct26 16:23:27 2026  timer countdown   applet: A75-COUNTDOWN 
4    10     Actv success  Mon Oct26 16:23:47 2026  timer watchdog    applet: A75-WATCHDOG 
5    11     Actv success  Mon Oct26 16:24:00 2026  timer cron        applet: A75-CRON 
6    12     Actv success  Mon Oct26 16:24:17 2026  timer watchdog    applet: A75-WATCHDOG 
7    13     Actv success  Mon Oct26 16:24:47 2026  timer watchdog    applet: A75-WATCHDOG 
8    14     Actv success  Mon Oct26 16:25:00 2026  timer cron        applet: A75-CRON 
9    15     Actv success  Mon Oct26 16:25:17 2026  timer watchdog    applet: A75-WATCHDOG 
10   16     Actv success  Mon Oct26 16:25:47 2026  timer watchdog    applet: A75-WATCHDOG 

取得スクリプトは、PC の最後に、3 本を外しました。外した後の registered と running-config に、A75-COUNTDOWN・A75-WATCHDOG・A75-CRON を含む行は 0 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#no event manager applet A75-WATCHDOG
CSR1(config)#no event manager applet A75-CRON
CSR1(config)#no event manager applet A75-COUNTDOWN
CSR1(config)#end
CSR1#

窓の終わりの後には、3 回目の A75-CRON の行(16:26:00.001)が後の logging に在りました。後片付けの投入の時刻は撮っておらず、この行と後片付けの前後は言えません。


9. CLI の event

9.1 資料の CLI の event

Overview 章は、CLI の event detector を、打たれた CLI のコマンドを正規表現で照合し、一致すると event を公開(publish)するものとしています。照合は、パースに成功した後・実行の前に、完全に展開したコマンドに対して行うと書かれています。

The CLI event detector screens command-line interface (CLI) commands for a regular expression match. When a match is found, an event is published.

(Overview 章「CLI Event Detector」)

The match logic is performed on the fully expanded CLI command after the command is successfully parsed and before it is executed. The CLI event detector supports three publish modes:

(Overview 章「CLI Event Detector」)

publish の形は 3 つです。同期の publish では、ポリシーが終わるまで CLI コマンドを実行せず、_exit_status が 0 ならコマンドを飛ばし、1 なら実行すると書かれています。非同期の publish は「event を公開してから CLI コマンドを実行する」形で、非同期で skip する publish は「event を公開するが CLI コマンドは実行しない」形と書かれています。

Synchronous publishing of CLI events–The CLI command is not executed until the EEM policy exits, and the EEM policy can control whether the command is executed. The read/write variable, _exit_status, allows you to set the exit status at policy exit for policies triggered from synchronous events. If _exit_status is 0, the command is skipped, if _exit_status is 1, the command is run.

(Overview 章「CLI Event Detector」)

Asynchronous publishing of CLI events–The CLI event is published, and then the CLI command is executed.

(Overview 章「CLI Event Detector」)

Asynchronous publishing of CLI events with command skipping–The CLI event is published, but the CLI command is not executed.

(Overview 章「CLI Event Detector」)

applet の event cli の構文は、sync の yes と no を選び、no の時だけ skip の yes と no を続ける形です。

event [tag event-tag ] cli pattern regular-expression sync {yes | no skip {yes | no }} [occurs num-occurrences ] [period period-value ] [maxrun maxruntime-number ]

(CLI 章「Setting the Event Configuration Parameters」)

Event Registration 章の Tcl の event_register_cli の説明は、ポリシーの終了ステータスが 0 ならコマンドを実行せず、それ以外なら実行すると書き、省略したコマンドはパーサが展開してから照合すると書いています。

The exit status of the policy indicates whether or not the CLI command should be executed: if the exit status is zero, which means that the policy is executed successfully, the CLI command will not be executed; otherwise, the CLI command will be executed.

(Event Registration 章「event_register_cli」)

The user can enter an abbreviated CLI command, such as sh mem summary , and the parser will expand the command to show memory summary to perform the matching.

(Event Registration 章「event_register_cli」)

CLI 章は、CLI の event detector が照合するのは正しい IOS のコマンドそのものだけで、パイプ(|)の後ろの文字は含まないと書いています。同じ章の applet の set は、版によって action の set に置き換わると書かれています。

The functionality provided in the CLI event detector only allows a regular expression pattern match on a valid IOS CLI command itself. This does not include text after a pipe (|) character when redirection is used.

(CLI 章「CLI Event Detector」)

Depending on your release, the set (EEM) command is replaced by the action set command. See the action label set command for more information. If the set (EEM) command is entered in certain releases, the IOS parser translates the set command to the action label set command.

(CLI 章「Specifying a Loop of Conditional Blocks」)

sync no の時の CLI コマンドの実行とポリシーの前後について、Overview 章は event を公開してから CLI コマンドを実行すると書き(上の非同期の publish の文)、Event Registration 章の event_register_cli の注は、ポリシーはコマンドの実行の前に走ると書いています。2 つの章の書き方が違います。

This policy runs before the CLI command is executed.

(Event Registration 章「event_register_cli」)

9.2 登録前の出力

本ラボは、PG の段(PD・PE・PF の後。段の順は §3.4)で、CLI の event の引き金にするコマンドを、applet を入れる前に打って正の出力を撮りました(以下、この出力を登録前の出力と呼びます)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の登録前の show inventory は以下のとおりです。

snippet
CSR1# show inventory
NAME: "Chassis", DESCR: "Cisco CSR1000V Chassis"
PID: CSR1000V          , VID: V00  , SN: 9MISPUM0V9C

NAME: "module R0", DESCR: "Cisco CSR1000V Route Processor"
PID: CSR1000V          , VID: V00  , SN: JAB1303001C

NAME: "module F0", DESCR: "Cisco CSR1000V Embedded Services Processor"
PID: CSR1000V          , VID:      , SN:            

show privilege は Current privilege level is 15 を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の登録前の show privilege は以下のとおりです。

snippet
CSR1# show privilege
Current privilege level is 15

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の登録前の show hosts は以下のとおりです。

snippet
CSR1# show hosts
Default domain is lab.local
Name servers are 255.255.255.255
NAME  TTL  CLASS   TYPE      DATA/ADDRESS
-----------------------------------------

show history は、このセッションで打ったコマンドの 10 行を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の登録前の show history は以下のとおりです。

snippet
CSR1# show history
  configure terminal
  show running-config | section event manager
  show clock
  show running-config | section pnp
  show tcp brief all
  show pnp profile
  show inventory
  show privilege
  show hosts
  show history

show clock | include P75PIPE の出力は空行 1 行で、この空行が機器の出した改行か、取得の記録の改行かは区別できません。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の登録前の表示は以下のとおりです。

snippet
CSR1# show clock | include P75PIPE

9.3 投入と表示

PG では、event cli の applet を 5 本入れました。A75-CLI-ASYNC(^show inventory・sync no skip no)・A75-CLI-SYNC1(^show hosts・sync yes・_exit_status 1)・A75-CLI-SYNC0(^show history・sync yes・_exit_status 0)・A75-CLI-PIPE(P75PIPE・sync no skip no)の 4 本を 1 回目の投入で、A75-CLI-SKIP(^show privilege・sync no skip yes)を 2 回目の投入で入れています。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の 1 回目の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager applet A75-CLI-ASYNC
CSR1(config-applet)# event cli pattern "^show inventory" sync no skip no
CSR1(config-applet)# action 1.0 syslog msg "A75-CLI-ASYNC saw: $_cli_msg"
CSR1(config-applet)#event manager applet A75-CLI-SYNC1
CSR1(config-applet)# event cli pattern "^show hosts" sync yes
CSR1(config-applet)# action 1.0 syslog msg "A75-CLI-SYNC1 saw: $_cli_msg"
CSR1(config-applet)# set 2.0 _exit_status 1
CSR1(config-applet)#event manager applet A75-CLI-SYNC0
CSR1(config-applet)# event cli pattern "^show history" sync yes
CSR1(config-applet)# action 1.0 syslog msg "A75-CLI-SYNC0 saw: $_cli_msg"
CSR1(config-applet)# set 2.0 _exit_status 0
CSR1(config-applet)#event manager applet A75-CLI-PIPE
CSR1(config-applet)# event cli pattern "P75PIPE" sync no skip no
CSR1(config-applet)# action 1.0 syslog msg "A75-CLI-PIPE saw: $_cli_msg"
CSR1(config-applet)#end
CSR1#

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の 2 回目の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager applet A75-CLI-SKIP
CSR1(config-applet)# event cli pattern "^show privilege" sync no skip yes
CSR1(config-applet)# action 1.0 syslog msg "A75-CLI-SKIP saw: $_cli_msg"
CSR1(config-applet)#end
CSR1#

資料は、版によっては set(EEM)を action の set に直すと書いています(§9.1)。

本ラボの投入の set 2.0 _exit_status 1 は、running-config と registered では action 2.0 set _exit_status "1" の形で表示されました(0 の行も同じ形)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の running-config の抜粋は以下のとおりです。

snippet
CSR1# show running-config | section event manager
…(省略)
event manager applet A75-CLI-ASYNC
 event cli pattern "^show inventory" sync no skip no
 action 1.0 syslog msg "A75-CLI-ASYNC saw: $_cli_msg"
event manager applet A75-CLI-SYNC1
 event cli pattern "^show hosts" sync yes
 action 1.0 syslog msg "A75-CLI-SYNC1 saw: $_cli_msg"
 action 2.0 set _exit_status "1"
event manager applet A75-CLI-SYNC0
 event cli pattern "^show history" sync yes
 action 1.0 syslog msg "A75-CLI-SYNC0 saw: $_cli_msg"
 action 2.0 set _exit_status "0"
event manager applet A75-CLI-PIPE
 event cli pattern "P75PIPE" sync no skip no
 action 1.0 syslog msg "A75-CLI-PIPE saw: $_cli_msg"
event manager applet A75-CLI-SKIP
 event cli pattern "^show privilege" sync no skip yes
 action 1.0 syslog msg "A75-CLI-SKIP saw: $_cli_msg"

この表示の形と、資料の「set を action の set に直す」という記述を並べます。

registered は、5 本を Event Type cli で表示しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager policy registered
…(省略)
11   applet    user    cli                 Off   Mon Oct 26 16:53:17 2026  A75-CLI-ASYNC
 pattern {^show inventory} sync no skip no
 maxrun 20.000
 action 1.0 syslog msg "A75-CLI-ASYNC saw: $_cli_msg"

12   applet    user    cli                 Off   Mon Oct 26 16:53:30 2026  A75-CLI-SYNC1
 pattern {^show hosts} sync yes
 maxrun 20.000
 action 1.0 syslog msg "A75-CLI-SYNC1 saw: $_cli_msg"
 action 2.0 set _exit_status "1"

13   applet    user    cli                 Off   Mon Oct 26 16:53:44 2026  A75-CLI-SYNC0
 pattern {^show history} sync yes
 maxrun 20.000
 action 1.0 syslog msg "A75-CLI-SYNC0 saw: $_cli_msg"
 action 2.0 set _exit_status "0"

14   applet    user    cli                 Off   Mon Oct 26 16:53:53 2026  A75-CLI-PIPE
 pattern {P75PIPE} sync no skip no
 maxrun 20.000
 action 1.0 syslog msg "A75-CLI-PIPE saw: $_cli_msg"

15   applet    user    cli                 Off   Mon Oct 26 16:54:08 2026  A75-CLI-SKIP
 pattern {^show privilege} sync no skip yes
…(省略)

Log Buffer には、投入の時刻に当たる %PARSER-5-HIDDEN の行が 2 行ありました(窓の外の行)。set 2.0 _exit_status の 2 行を hidden command と書く行です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:53:27.636: %PARSER-5-HIDDEN: Warning!!! ' set 2.0 _exit_status 1' is a hidden command. Use of this command is not recommended/supported and will be removed in future.
*Oct 26 16:53:40.779: %PARSER-5-HIDDEN: Warning!!! ' set 2.0 _exit_status 0' is a hidden command. Use of this command is not recommended/supported and will be removed in future.
*Oct 26 16:53:53.905: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)
*Oct 26 16:54:08.281: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)
…(省略)

2 つの %SYS-5-CONFIG_I の行の時刻(16:53:53・16:54:08)は、registered の A75-CLI-PIPE と A75-CLI-SKIP の Time Registered と、秒まで同じでした。

9.4 引き金の 6 本

この図を大きく開く ↗

CLI で打ったコマンドと、パイプ以外の 4 本の applet の結果の表です。原典の CLI event detector の説明と、本ラボの出力の形・syslog の行・時刻を並べます。

窓(16:54:15.076〜16:54:49.598)の中で、取得スクリプトは 6 本のコマンドを 1 本ずつ打ち、各コマンドの直後に show event manager history events detailed を撮りました。

1 本目の show inventory は、登録前と同じ出力を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の show inventory は以下のとおりです。

snippet
CSR1# show inventory
NAME: "Chassis", DESCR: "Cisco CSR1000V Chassis"
PID: CSR1000V          , VID: V00  , SN: 9MISPUM0V9C

NAME: "module R0", DESCR: "Cisco CSR1000V Route Processor"
PID: CSR1000V          , VID: V00  , SN: JAB1303001C

NAME: "module F0", DESCR: "Cisco CSR1000V Embedded Services Processor"
PID: CSR1000V          , VID:      , SN:            

直後の history に、A75-CLI-ASYNC の count 1 msg show inventory の行が増えました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history detailed の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events detailed
…(省略)
10   38     Actv success  Mon Oct26 16:54:17 2026  cli               applet: A75-CLI-ASYNC 
   count 1 msg show inventory 

2 本目は短縮形の sh inventory です。出力は登録前と同じでした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の sh inventory は以下のとおりです。

snippet
CSR1# sh inventory
NAME: "Chassis", DESCR: "Cisco CSR1000V Chassis"
PID: CSR1000V          , VID: V00  , SN: 9MISPUM0V9C

NAME: "module R0", DESCR: "Cisco CSR1000V Route Processor"
PID: CSR1000V          , VID: V00  , SN: JAB1303001C

NAME: "module F0", DESCR: "Cisco CSR1000V Embedded Services Processor"
PID: CSR1000V          , VID:      , SN:            

history の新しい行の msg は、打った sh inventory ではなく show inventory でした。count は 2 です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history detailed の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events detailed
…(省略)
10   39     Actv success  Mon Oct26 16:54:21 2026  cli               applet: A75-CLI-ASYNC 
   count 2 msg show inventory 

3 本目の show privilege(A75-CLI-SKIP・sync no skip yes)の出力は空行 1 行で、登録前の Current privilege level is 15 の行は出ませんでした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の show privilege は以下のとおりです。

snippet
CSR1# show privilege

history には A75-CLI-SKIP の行が増えました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history detailed の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events detailed
…(省略)
10   40     Actv success  Mon Oct26 16:54:26 2026  cli               applet: A75-CLI-SKIP 
   count 1 msg show privilege 

4 本目の show hosts(A75-CLI-SYNC1・sync yes・_exit_status 1)は、登録前と同じ出力を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の show hosts は以下のとおりです。

snippet
CSR1# show hosts
Default domain is lab.local
Name servers are 255.255.255.255
NAME  TTL  CLASS   TYPE      DATA/ADDRESS
-----------------------------------------

history には A75-CLI-SYNC1 の行が増えました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history detailed の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events detailed
…(省略)
10   41     Actv success  Mon Oct26 16:54:30 2026  cli               applet: A75-CLI-SYNC1 
   count 1 msg show hosts 

5 本目の show history(A75-CLI-SYNC0・sync yes・_exit_status 0)の出力は空行 1 行で、登録前の 10 行は出ませんでした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の show history は以下のとおりです。

snippet
CSR1# show history

history には A75-CLI-SYNC0 の行が増えました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history detailed の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events detailed
…(省略)
10   42     Actv success  Mon Oct26 16:54:35 2026  cli               applet: A75-CLI-SYNC0 
   count 1 msg show history 

6 本目の show clock | include P75PIPE(A75-CLI-PIPE の pattern はパイプの後ろの語)は、登録前と同じ空行 1 行を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show clock | include P75PIPE

直後の history の表示は、5 本目の直後の表示とファイル全体で同じでした(違う行は 0 行。数えた)。この後の show clock(16:54:49.598)が窓の終わりです。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history detailed の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events detailed
…(省略)
10   42     Actv success  Mon Oct26 16:54:35 2026  cli               applet: A75-CLI-SYNC0 
   count 1 msg show history 

窓の中の syslog の行は 5 行で、5 行とも %HA_EM-6-LOG の行でした。A75-CLI-ASYNC が 2 行、A75-CLI-SKIP・A75-CLI-SYNC1・A75-CLI-SYNC0 が 1 行ずつで、A75-CLI-PIPE を含む行は 0 行です(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:54:17.353: %HA_EM-6-LOG: A75-CLI-ASYNC: A75-CLI-ASYNC saw: show inventory 
*Oct 26 16:54:21.880: %HA_EM-6-LOG: A75-CLI-ASYNC: A75-CLI-ASYNC saw: show inventory 
*Oct 26 16:54:26.400: %HA_EM-6-LOG: A75-CLI-SKIP: A75-CLI-SKIP saw: show privilege 
*Oct 26 16:54:30.926: %HA_EM-6-LOG: A75-CLI-SYNC1: A75-CLI-SYNC1 saw: show hosts 
*Oct 26 16:54:35.461: %HA_EM-6-LOG: A75-CLI-SYNC0: A75-CLI-SYNC0 saw: show history 

5 行は行末に空白が 1 つ付きます。この窓は、見出しの dropped・rate-limited・overruns が前の見出しから増えていない窓です。6 本の観測の形をまとめると以下のとおりです(本ラボのこの run で)。

打ったコマンドapplet と設定出力history の新しい行窓の中の syslog の行
show inventoryA75-CLI-ASYNC・sync no skip no登録前と同じcount 1 msg show inventory16:54:17.353
sh inventory同上登録前と同じcount 2 msg show inventory16:54:21.880
show privilegeA75-CLI-SKIP・sync no skip yes空行 1 行(登録前は 1 行の表示)count 1 msg show privilege16:54:26.400
show hostsA75-CLI-SYNC1・sync yes・_exit_status 1登録前と同じcount 1 msg show hosts16:54:30.926
show historyA75-CLI-SYNC0・sync yes・_exit_status 0空行 1 行(登録前は 10 行)count 1 msg show history16:54:35.461
show clock(パイプで P75PIPE を絞る)A75-CLI-PIPE・sync no skip no登録前と同じ空行 1 行無し無し

資料の説明(§9.1)と、本ラボの出力の形を並べます。出力が空だった 2 本で「コマンドが実行されなかった」とは書きません。撮ったのは出力の形と、history と syslog の行までです。sync no の時の CLI コマンドの実行とポリシーの前後(§9.1 で 2 つの章の書き方が違う所)も撮っておらず、図でも前後を描いていません。

9.5 debug event manager detector cli の窓

CLI 章は、CLI の event の例に debug event manager detector cli の出力を添え、一致した時に num_matches = 1, response_code = 4 と出る見本を載せています。

The debug event manager detector cli output is added to show num_matches is set to one.

(CLI 章「CLI Event Detector」)

*Aug 23 23:19:59.827: check_eem_cli_policy_handler: command_string=show access-lists test *Aug 23 23:19:59.827: check_eem_cli_policy_handler: num_matches = 1, response_code = 4 *Aug 23 23:19:59.843: %HA_EM-6-LOG: EEM-PIPE-TEST: Pattern matched!

(CLI 章「CLI Event Detector」)

本ラボは、窓の始めの show clock(16:55:00.946)の後に debug event manager detector cli を入れ、show hosts(A75-CLI-SYNC1)を 1 回打ち、undebug all の後に窓の終わりの show clock(16:55:10.009)を撮りました。debug は受理の行を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の debug の投入は以下のとおりです。

snippet
CSR1# debug event manager detector cli
Debug EEM CLI Event Detector debugging is on

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の debug の下の show hosts は以下のとおりです。

snippet
CSR1# show hosts
Default domain is lab.local
Name servers are 255.255.255.255
NAME  TTL  CLASS   TYPE      DATA/ADDRESS
-----------------------------------------

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の undebug all の返事は以下のとおりです。

snippet
CSR1# undebug all
All possible debugging has been turned off

窓(16:55:00.946〜16:55:10.009)の中の行は 39 行でした。show hosts の照合の塊(23 行)には command_string=show hosts・num_matches = 1, response_code = 4 の行と A75-CLI-SYNC1 の %HA_EM-6-LOG の行があり、その後に response_code=5 と out of wait EEM policy execution, response_code = 5 の行が続きました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋(207〜209 行目の XML の 3 行を省略)は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:55:05.488: cli_history_entry_add: free_hist_list size=0, hist_list size=7
*Oct 26 16:55:05.488: fh_fd_cli_event_match: fd_reg->cli_match_type = 1, match_info->match_type = 1
*Oct 26 16:55:05.488: fh_fd_cli_event_match: fd_reg->cli_match_type = 1, match_info->match_type = 1
*Oct 26 16:55:05.488: cli_conn_tm_alloc: ptp=0x80007F8EDE42D328 
*Oct 26 16:55:05.488: fh_fd_cli_event_match: publish_timer=0x80007F8F431D1A20, ptp=0x80007F8EDE42D328, max_delay=30000 
*Oct 26 16:55:05.489: cli_conn_tm_add: re=0x80007F8EDE41CE80, ptp=0x80007F8EDE42D328
…(省略)
*Oct 26 16:55:05.514: cli_pubinfo_enqueue: publish_entry EOK 
*Oct 26 16:55:05.514: fh_fd_cli_event_match: re=0x80007F8EDE41CE80, ptp=0x80007F8EDE42D328, str=show hosts 
*Oct 26 16:55:05.514: fh_fd_cli_event_match: fd_reg->cli_match_type = 1, match_info->match_type = 1
*Oct 26 16:55:05.514: fh_fd_cli_event_match: fd_reg->cli_match_type = 1, match_info->match_type = 1
*Oct 26 16:55:05.514: fh_fd_cli_event_match: fd_reg->cli_match_type = 1, match_info->match_type = 1
*Oct 26 16:55:05.514: check_eem_cli_policy_handler: command_string=show hosts
*Oct 26 16:55:05.515: check_eem_cli_policy_handler: num_matches = 1, response_code = 4
*Oct 26 16:55:05.518: %HA_EM-6-LOG: A75-CLI-SYNC1: A75-CLI-SYNC1 saw: show hosts 
*Oct 26 16:55:05.518: fh_fd_cli_publish_done: errc=1, publish_expired=0
*Oct 26 16:55:05.518:   sid=38, ptp=0x80007F8EDE42D328, connp=0x80007F8F47157A70
*Oct 26 16:55:05.518: fh_fd_cli_publish_done: num_sync_msgs=0, response_code=5
*Oct 26 16:55:05.519: cli_conn_tm_remove: re=0x80007F8EDE41CE80, ptp=0x80007F8EDE42D328
*Oct 26 16:55:05.519: fh_fd_cli_conn_tm_free: ptp=0x80007F8EDE42D328
*Oct 26 16:55:05.519: check_eem_cli_policy_handler: out of wait EEM policy execution, response_code = 5
…(省略)
*Oct 26 16:55:07.755: check_eem_cli_policy_handler: command_string=undebug all
*Oct 26 16:55:07.755: check_eem_cli_policy_handler: num_matches = 0, response_code = 1
…(省略)
*Oct 26 16:55:07.780: check_eem_cli_policy_handler: command_string=no debug platform all
*Oct 26 16:55:07.780: check_eem_cli_policy_handler: num_matches = 0, response_code = 1

省略した XML の 3 行には、tcl="msg">show hosts・tcl="username">netops・tcl="tty">2・tcl="host">192.168.1.65・tcl="privilege">15 の値と、pdir="_cli_msg" の属性がありました。applet が使った $_cli_msg と同じ綴りの名前です。command_string=undebug all と command_string=no debug platform all の 2 つの塊は、どちらも num_matches = 0, response_code = 1 でした。

この窓の後の見出しは、overruns が 0 → 1 に増えました。この窓では「窓の中に〜の行は無い」を書きません。窓の中に在った行を並べるだけです。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の見出しの抜粋は以下のとおりです。

snippet
CSR1# show logging | include Syslog logging|Buffer logging|Log Buffer
Syslog logging: enabled (0 messages dropped, 3 messages rate-limited, 0 flushes, 1 overruns, xml disabled, filtering disabled)
    Buffer logging:  level debugging, 269 messages logged, xml disabled,
…(省略)

窓の後の history は、A75-CLI-SYNC1 の 2 回目の行(16:55:05)を増やしました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events
…(省略)
10   43     Actv success  Mon Oct26 16:55:05 2026  cli               applet: A75-CLI-SYNC1 

取得スクリプトは、PG の最後に、5 本の applet を外しました。外した後の registered と running-config に A75-CLI を含む行は 0 行でした(数えた)。


10. action cli の vty と設定変更の記録

10.1 資料の action cli と vty

CLI 章は、action cli を、applet が起動した時に Cisco IOS の CLI のコマンドを実行する action としています。手順の例は、最初の action で enable を打っています。

Specifies the action of executing a Cisco IOS CLI command when an EEM applet is triggered.

(CLI 章「Registering and Defining an Embedded Event Manager Applet」の Step 8)

Device(config-applet)# action 1.0 cli command “enable” Example: Device(config-applet)# action 2.0 cli command “clear counters Ethernet0/1” pattern “confirm” Example: Device(config-applet)# action 3.0 cli command “y”

(CLI 章「Registering and Defining an Embedded Event Manager Applet」の Step 8)

同じ章の SNMP Event Detector の見本は、action cli の後ろの action で $_cli_result を使っています。

action 1.0 cli command “enable” action 2.0 cli command “show process cpu” action 3.0 mail server “192.168.1.146” to “engineer@cisco.com” from “devtest@cisco.com” subject “B25 PBX Alert” body “$_cli_result”

(CLI 章「SNMP Event Detector」)

取得した 8 章で vty の語を大文字と小文字を区別せずに数えると、CLI Library 章に 27 回(どれも小文字の vty)、Python 章に 3 回(大文字の VTY。eem_cli_open と eem_cli_close の説明の中)、Tcl 章に 2 回(syslog の行の見本の vty0)で、CLI 章と Overview 章を含むほかの 5 章には 0 回でした(数えた)。

CLI Library 章は、CLI library を、exec を起こして virtual terminal の channel を開き、コマンドを書き込んで出力を読み返す仕組みとしています。

This library provides users the ability to run CLI commands and get the output of the commands in Tcl. Users can use commands in this library to spawn an exec and open a virtual terminal channel to it, write the command to execute to the channel so that the command will be executed by exec, and read back the output of the command.

(CLI Library 章の冒頭)

同じ章の冒頭の段落は、EEM が使う vty の条件を 4 つの文で書いています。1 文目は vty を line vty で設定した pool から割り当てるという文、2 文目と 3 文目は EEM が vty を使う条件、4 文目は空きが 3 本未満の時に接続が失敗するという文です。

The vty lines are allocated from the pool of vty lines that are configured using the line vty CLI configuration command.

(CLI Library 章の冒頭)

EEM will use a vty line when a vty line is not being used by EEM and there are available vty lines. EEM will also use a vty line when EEM is already using a vty line and there are three or more vty lines available.

(CLI Library 章の冒頭)

Be aware that the connection will fail when fewer than three vty lines are available, preserving the remaining vty lines for Telnet use.

(CLI Library 章の冒頭)

2 文目は EEM がまだ vty を使っていない時、3 文目は EEM が既に vty を使っている時の条件です。4 つの文は Tcl の CLI library の章の冒頭の文で、この章に applet の語は 0 回です(数えた)。applet の action cli に当たるかは書かれていません。

同じ章の cli_open の節は、cli_open が vty を割り当てて EXEC の CLI のセッションを作り、cli_close を呼ぶまで vty を使い続けると書いています。cli_close は exec の process を閉じ、vty を返すと書かれています。

Allocates a vty, creates an EXEC command-line interface (CLI) session, and connects the vty to a channel handler. Returns an array including the channel handler.

(CLI Library 章「cli_open」)

Each call to cli_open initiates a Cisco IOS EXEC session that allocates a Cisco IOS vty line. The vty remains in use until the cli_close routine is called.

(CLI Library 章「cli_open」)

Closes the exec process and releases the vty and the specified channel handler connected to the command-line interface (CLI).

(CLI Library 章「cli_close」)

10.2 vty の本数

本ラボの CSR1 の running-config は line vty 0 4 でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の running-config の抜粋は以下のとおりです。

snippet
CSR1# show running-config | include ^line|^ transport|^event manager
line con 0
line vty 0 4
 transport input ssh

show line の VTY の行は 5 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の show line は以下のとおりです。

snippet
CSR1# show line
   Tty Typ     Tx/Rx    A Modem  Roty AccO AccI   Uses   Noise  Overruns   Int
      0 CTY              -    -      -    -    -      0       0     0/0       -
      1 VTY              -    -      -    -    -      1       0     0/0       -
*     2 VTY              -    -      -    -    -      1       0     0/0       -
      3 VTY              -    -      -    -    -      0       0     0/0       -
      4 VTY              -    -      -    -    -      0       0     0/0       -
      5 VTY              -    -      -    -    -      0       0     0/0       -

P0 の show users は、取得スクリプトの永続のセッション(vty 1 の netops)の 1 行です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の show users は以下のとおりです。

snippet
CSR1# show users
    Line       User       Host(s)              Idle       Location
*  2 vty 1     netops     idle                 00:00:00 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

10.3 applet の action cli と show users

本ラボの PD では、Loopback76 と、action cli を持つ applet 3 本を入れました。A75-VTY は、enable と show users を打ち、$_cli_result を puts で出す applet です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーの抜粋(Loopback76 と A75-VTY)は以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#interface Loopback76
CSR1(config-if)# ip address 10.7.5.76 255.255.255.255
CSR1(config-if)#event manager applet A75-VTY
CSR1(config-applet)# event none
CSR1(config-applet)# action 1.0 cli command "enable"
CSR1(config-applet)# action 2.0 cli command "show users"
CSR1(config-applet)# action 3.0 puts "A75-VTY show users begin"
CSR1(config-applet)# action 4.0 puts "$_cli_result"
CSR1(config-applet)# action 5.0 puts "A75-VTY show users end"
…(省略)
CSR1(config-applet)#end
CSR1#

run の前の show users は、vty 1 の netops の 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の前の show users は以下のとおりです。

snippet
CSR1# show users
    Line       User       Host(s)              Idle       Location
*  2 vty 1     netops     idle                 00:00:00 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

run の中の show users($_cli_result)には、Location が EEM:A75-VTY の行(vty 0)が加わり、行頭の * はこの行に付いていました。EEM の行の User の欄は空です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-VTY
A75-VTY show users begin

    Line       User       Host(s)              Idle       Location
*  1 vty 0                idle                 00:00:00 EEM:A75-VTY
   2 vty 1     netops     idle                 00:00:00 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

CSR1#
A75-VTY show users end

10.4 debug event manager action cli

Tcl 章は、CLI library の debug を debug event manager tcl cli_library で入れると書き、その出力の IN を TTY に渡したデータ、OUT を TTY から読み戻したデータ、CTL を CLI library の補助の関数と説明しています。見本は sl_intf_down.tcl の出力です。

The IN keyword signifies all data passed in to the TTY through the CLI library. The OUT keyword signifies all data read back from the TTY through the CLI library. The CTL keyword signifies helper functions used in the CLI library.

(Tcl 章「Example of the debug event manager tcl cli_library Command」)

01:17:07: sl_intf_down.tcl[0]: DEBUG(cli_lib) : CTL : cli_open called. 01:17:07: sl_intf_down.tcl[0]: DEBUG(cli_lib) : OUT : nelson> 01:17:07: sl_intf_down.tcl[0]: DEBUG(cli_lib) : IN : nelson>enable 01:17:07: sl_intf_down.tcl[0]: DEBUG(cli_lib) : OUT : nelson#

(Tcl 章「Example of the debug event manager tcl cli_library Command」)

取得した 8 章に、debug event manager action cli の語は 0 回でした(数えた)。

本ラボは、機器の debug event manager の ? のヘルプの項目に在る action を使いました。窓の始めの show clock(16:27:49.355)の後に debug event manager action cli を入れて A75-VTY を走らせ(run の逐語は §10.3 に載せたもの)、undebug all の後に窓の終わりの show clock(16:28:00.896)を撮っています。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の debug の投入は以下のとおりです。

snippet
CSR1# debug event manager action cli
Debug EEM action cli debugging is on

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の undebug all の返事は以下のとおりです。

snippet
CSR1# undebug all
All possible debugging has been turned off

窓(16:27:49.355〜16:28:00.896)の中の行は 15 行でした。13 行が A75-VTY : DEBUG(cli_lib) で始まる本文を持つ %HA_EM-6-LOG の行で、CTL が 2 行・IN が 2 行・OUT が 9 行です(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:27:53.902: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : CTL : cli_open called.
*Oct 26 16:27:54.003: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT : CSR1>
*Oct 26 16:27:54.003: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : IN  : CSR1>enable
*Oct 26 16:27:54.014: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT : CSR1#
*Oct 26 16:27:54.014: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : IN  : CSR1#show users
*Oct 26 16:27:54.125: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT :     Line       User       Host(s)              Idle       Location
*Oct 26 16:27:54.126: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT : *  1 vty 0                idle                 00:00:00 EEM:A75-VTY
*Oct 26 16:27:54.126: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT :    2 vty 1     netops     idle                 00:00:00 192.168.1.65
*Oct 26 16:27:54.126: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT : 
*Oct 26 16:27:54.126: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT :   Interface    User               Mode         Idle     Peer Address
*Oct 26 16:27:54.126: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT : 
*Oct 26 16:27:54.126: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : OUT : CSR1#
*Oct 26 16:27:54.128: %HA_EM-6-LOG: A75-VTY : DEBUG(cli_lib) : : CTL : cli_close called.
*Oct 26 16:27:54.129: 
*Oct 26 16:27:54.129: tty is now going through its death sequence

debug の行の名前は DEBUG(cli_lib) で、接頭辞は applet の名前 A75-VTY です。最初の OUT の行のプロンプトは CSR1> で、IN の enable の後の OUT が CSR1# でした。cli_open called(16:27:53.902)から cli_close called(16:27:54.128)までは 0.226 秒でした。OUT の show users の 3 行は、§10.3 の run の中の show users の 3 行と同じ文字列です。

資料の Tcl の見本(この節の冒頭)も、debug の行の名前が DEBUG(cli_lib) で、cli_open の後の最初のプロンプトが nelson>、enable の後が nelson# です。見本の形と本ラボの applet の debug の行の形を並べます。

10.5 enable を打たない applet

A75-NOENABLE は、enable を打たずに、action 1.0 の action cli で show running-config | include hostname を打つ applet です(§10.3 と同じ 1 回の投入)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーの抜粋は以下のとおりです。

snippet
…(省略)
CSR1(config-applet)#event manager applet A75-NOENABLE
CSR1(config-applet)# event none
CSR1(config-applet)# action 1.0 cli command "show running-config | include hostname"
CSR1(config-applet)# action 2.0 puts "A75-NOENABLE begin"
CSR1(config-applet)# action 3.0 puts "$_cli_result"
CSR1(config-applet)# action 4.0 puts "A75-NOENABLE end"
CSR1(config-applet)#end
CSR1#

run は、^ の行と % Invalid input で始まる行と、CSR1> のプロンプトの行を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-NOENABLE
A75-NOENABLE begin

show running-config | include hostname
^
% Invalid input detected at '^' marker.

CSR1>
A75-NOENABLE end

A75-NOENABLE の action cli のセッションの権限の水準(show privilege)は撮っていません。この run に debug と窓は撮っていません。

資料の手順の例は、最初の action で enable を打っています(§10.1)。

10.6 設定変更の記録

Tcl 章の debug の見本は、CLI library で設定に入った記録を %SYS-5-CONFIG_I の Configured from console by vty0 の形で示しています。

01:17:07: sl_intf_down.tcl[0]: DEBUG(cli_lib) : CTL : cli_close called. 01:17:07: sl_intf_down.tcl[0]: DEBUG(cli_lib) : IN : nelson#exit 01:17:07: sl_intf_down.tcl[0]: config_cmds are show event manager environment 01:17:07: %SYS-5-CONFIG_I: Configured from console by vty0

(Tcl 章「Example of the debug event manager tcl cli_library Command」)

本ラボの A75-CONF は、enable・configure terminal・interface Loopback76・description・end を action cli で打つ applet です(§10.3 と同じ 1 回の投入)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーの抜粋は以下のとおりです。

snippet
…(省略)
CSR1(config-applet)#event manager applet A75-CONF
CSR1(config-applet)# event none
CSR1(config-applet)# action 1.0 cli command "enable"
CSR1(config-applet)# action 2.0 cli command "configure terminal"
CSR1(config-applet)# action 3.0 cli command "interface Loopback76"
CSR1(config-applet)# action 4.0 cli command "description set-by-eem-a75-conf"
CSR1(config-applet)# action 5.0 cli command "end"
…(省略)
CSR1(config-applet)#end
CSR1#

窓(16:28:14.703〜16:28:21.928)の中で打った run の逐語は空行 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-CONF

窓の中の syslog の行は %SYS-5-CONFIG_I の 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:28:17.440: %SYS-5-CONFIG_I: Configured from console by  on vty0 (EEM:A75-CONF)

CONFIG_I の行は、by と on の間が空白 2 つで、line は vty0、括弧の中が EEM:A75-CONF です。§7.2 の (EEM:A75-SYSLOG-LO) の行と同じ形でした。run の後の running-config の Loopback76 には、A75-CONF の action 4.0 の文字列と同じ description の行が在りました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show running-config interface Loopback76
Building configuration...

Current configuration : 99 bytes
!
interface Loopback76
 description set-by-eem-a75-conf
 ip address 10.7.5.76 255.255.255.255
end

投入(§10.3)の interface Loopback76 の下(CSR1(config-if)# の行)に description の行は 0 行で(数えた)、running-config の set-by-eem-a75-conf の行は A75-CONF の action 4.0 の文字列と同じです。show users の EEM の行の番号は、本ラボで撮った 3 つの run で vty 0・vty 3・vty 2 と違い(§10.3・§10.7)、CONFIG_I の行の EEM の line は 2 回とも vty0 でした。並べるだけで、理由は書きません。

10.7 空いている vty の本数(EEM がまだ vty を使っていない時)

本ラボの PD-b では、取得スクリプトが SSH を k 本保持した状態で A75-VTY を走らせ、run の中の show users で vty の行を数えました。k = 2 → k = 1 の順です。run の少し前の show users に Location が EEM: の行は 0 行で、EEM がまだ vty を使っていない状態(§10.1 の 2 文目の場合)から 1 本目を開いた観測です。

k = 2 では、run の前の show users の vty の行が 3 本でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の前の show clock と show users(1 つの取得の記録)は以下のとおりです。

snippet
CSR1# show clock
*16:28:34.479 UTC Mon Oct 26 2026
CSR1# show users
    Line       User       Host(s)              Idle       Location
   1 vty 0     netops     idle                 00:00:03 192.168.1.65
*  2 vty 1     netops     idle                 00:00:00 192.168.1.65
   3 vty 2     netops     idle                 00:00:02 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

run の中の show users は vty の行が 4 本で、うち 1 本が Location EEM:A75-VTY の vty 3 です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-VTY
A75-VTY show users begin

    Line       User       Host(s)              Idle       Location
   1 vty 0     netops     idle                 00:00:08 192.168.1.65
   2 vty 1     netops     idle                 00:00:00 192.168.1.65
   3 vty 2     netops     idle                 00:00:07 192.168.1.65
*  4 vty 3                idle                 00:00:00 EEM:A75-VTY

  Interface    User               Mode         Idle     Peer Address

CSR1#
A75-VTY show users end

k = 1 では、run の前の show users の vty の行が 2 本でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の前の show clock と show users(1 つの取得の記録)は以下のとおりです。

snippet
CSR1# show clock
*16:28:52.778 UTC Mon Oct 26 2026
CSR1# show users
    Line       User       Host(s)              Idle       Location
   1 vty 0     netops     idle                 00:00:21 192.168.1.65
*  2 vty 1     netops     idle                 00:00:00 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

run の中の show users は vty の行が 3 本で、うち 1 本が Location EEM:A75-VTY の vty 2 です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-VTY
A75-VTY show users begin

    Line       User       Host(s)              Idle       Location
   1 vty 0     netops     idle                 00:00:26 192.168.1.65
   2 vty 1     netops     idle                 00:00:00 192.168.1.65
*  3 vty 2                idle                 00:00:00 EEM:A75-VTY

  Interface    User               Mode         Idle     Peer Address

CSR1#
A75-VTY show users end

vty の総数 5 本(§10.2)から数えると、run の中の EEM を除いた使用中は、k = 2 で 3 本・空き 2 本、k = 1 で 2 本・空き 3 本です(数えた。〔ツール側〕取得スクリプトの判定メモも同じ数)。どちらの run でも、A75-VTY の action cli は show users の結果を返しました。

本ラボのこの run(line vty 0 4 = §10.2・day0 の設定に aaa new-model の行は無い =〔ツール側〕)で、空き 2 本の状態から EEM が 1 本目の vty を使った、という観測です。空きが 1 本以下になる状態は撮っていません(取得スクリプトと MG の分を残す設計)。保持を閉じた後の show users は、vty 1 の netops の 1 行に戻りました。

資料の 4 文目(空きが 3 本未満で失敗する。§10.1)と、この観測を並べます。4 文目がこの場合に掛かるかは解釈しません。

10.8 2 本目の cli_open(EEM が既に vty を使っている時)

§10.1 の 3 文目は、EEM が既に vty を使っている時は、空きが 3 本以上の時に vty を使うと書いています。本ラボの PE-c では、cli_open を閉じずに 2 回呼ぶ Tcl のポリシー no_t75two.tcl を、保持する SSH が 0 本(k = 0)と 1 本(k = 1)の状態で走らせました。Tcl のポリシーの置き方と登録は §11 と同じ形です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)のポリシーの本文(more で読み戻したもの)は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/no_t75two.tcl
::cisco::eem::event_register_none maxrun 60
namespace import ::cisco::eem::*
namespace import ::cisco::lib::*

set first_ok 0
if [catch {cli_open} result] {
    puts "no_t75two: first cli_open failed: $result"
} else {
    array set cli1 $result
    set first_ok 1
    puts "no_t75two: first cli_open tty_id=$cli1(tty_id)"
}
if {$first_ok == 1} {
    if [catch {cli_open} result] {
        puts "no_t75two: second cli_open failed: $result"
    } else {
        array set cli2 $result
        puts "no_t75two: second cli_open tty_id=$cli2(tty_id)"
        if [catch {cli_exec $cli2(fd) "enable"} result] {
            puts "no_t75two: second enable failed: $result"
        }
        if [catch {cli_exec $cli2(fd) "show users"} result] {
            puts "no_t75two: second show users failed: $result"
        } else {
            puts $result
        }
        catch {cli_close $cli2(fd) $cli2(tty_id)}
    }
    catch {cli_close $cli1(fd) $cli1(tty_id)}
}

k = 0 では、run の前の show users が vty 1 の netops の 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の前の show users は以下のとおりです。

snippet
CSR1# show users
    Line       User       Host(s)              Idle       Location
*  2 vty 1     netops     idle                 00:00:00 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

run は 1 本目の tty_id=1 と 2 本目の tty_id=3 を返し、2 本目のセッションの show users には Location EEM:no_t75two.tcl の行が 2 本(vty 0 と vty 2)出ました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_t75two.tcl
no_t75two: first cli_open tty_id=1
no_t75two: second cli_open tty_id=3

    Line       User       Host(s)              Idle       Location
   1 vty 0                idle                 00:00:00 EEM:no_t75two.tcl
   2 vty 1     netops     idle                 00:00:00 192.168.1.65
*  3 vty 2                idle                 00:00:00 EEM:no_t75two.tcl

  Interface    User               Mode         Idle     Peer Address

CSR1#

k = 1 では、run の前の show users が vty 0 と vty 1 の netops の 2 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の前の show clock と show users(1 つの取得の記録)は以下のとおりです。

snippet
CSR1# show clock
*16:34:06.004 UTC Mon Oct 26 2026
CSR1# show users
    Line       User       Host(s)              Idle       Location
   1 vty 0     netops     idle                 00:00:02 192.168.1.65
*  2 vty 1     netops     idle                 00:00:00 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

run は 1 本目の tty_id=3 を返し、2 本目は second cli_open failed: の行を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_t75two.tcl
no_t75two: first cli_open tty_id=3
no_t75two: second cli_open failed: cannot get pty for exec: Error opening vty 'Embedded Event Manager' detected the 'fatal' condition 'no tty lines available, minimum of 2 required by EEM'

vty の総数 5 本から、run の前の show users の行の数と 1 本目の 1 本を引くと、2 本目の cli_open の時の空きは k = 0 で 3 本、k = 1 で 2 本です(数えた。〔ツール側〕判定メモも同じ数)。本ラボのこの run(§10.7 と同じ line vty 0 4・day0 の設定に aaa new-model の行は無い =〔ツール側〕)で、空き 3 本の時に 2 本目は開き、空き 2 本の時に 2 本目は開きませんでした。

2 本目の失敗の行は、機器の返事の逐語として並べます。行の末尾は no tty lines available, minimum of 2 required by EEM です。no_t75two.tcl の 2 回の run の history の Status は、2 回とも success でした(§12.3 に載せる history の No. 8 と No. 9)。

資料の 3 文目(§10.1)は three or more と書いています。機器の返事の minimum of 2 と資料の three or more を並べ、どちらが正しいとは書きません。


11. TCL のポリシー

11.1 資料の Tcl のポリシー

Tcl 章は、EEM が対応する Tcl の版を 8.3.4 としています。スクリプトは機器の外の ASCII のエディタで書き、機器にコピーしてから EEM に登録すると書かれています。

The version of Tcl supported is Tcl version 8.3.4 plus added script support.

(Tcl 章「EEM Script」)

Scripts are defined using an ASCII editor on another device, not on the networking device. The script is then copied to the networking device and registered with EEM.

(Tcl 章「EEM Script」)

同じ章のサンプルのポリシーの手順は、ファイルを機器の flash のファイルシステム(例は bootflash:)にコピーすると書き、コピーの方法の詳細は別の資料(Configuration Fundamentals Configuration Guide の Using the Cisco IOS File System の章)を指しています。取得した EEM の章に、コピーに使うコマンドの手順はありません。同じ章のライブラリの索引の手順は、workstation(UNIX・Linux・PC・Mac)の tclsh で索引を作る形です。

Copy the file to the flash file system on the device–typically bootflash:.

(Tcl 章のサンプルのポリシーの手順の Step 5)

ポリシーは経過時間 20 秒未満で終える決まりで、それより長く要る時は event_register の文に maxrun を書くと書かれています。Event Registration 章も、maxrun を書かない時の既定の上限を 20 秒としています。

As an enforced rule, Embedded Event Manager policies are short-lived run time routines that must be interpreted and executed in less than 20 seconds of elapsed time. If more than 20 seconds of elapsed time are required, the maxrun parameter may be specified in the event_register statement to specify any desired value.

(Tcl 章「EEM Script」)

(Optional) Maximum run time of the script (specified in SSSSSSSSSS[.MMM] format, where SSSSSSSSSS must be an integer representing seconds between 0 and 4294967295, inclusive, and where MMM must be an integer representing milliseconds between 0 and 999). If this argument is not specified, the default 20-second run-time limit is used.

(Event Registration 章「event_register_appl」ほかの各節)

ポリシーで必須の部分は event_register の拡張コマンドと本体の 2 つで、ポリシーの先頭で検出する event を書いて登録します。名前空間の import は省略できる部分です。

There are two parts of an EEM policy that are required: the event_register Tcl command extension and the body. The remaining parts of the policy are optional: environment must defines, namespace import, entry status, and exit status.

(Tcl 章「Tcl Policy Structure and Requirements」)

namespace import ::cisco::eem::* namespace import ::cisco::lib::*

(Tcl 章「Tcl Policy Structure and Requirements」)

event_register_none は event manager run で起こる event に登録し、その event は None の event detector が扱います。action_syslog は syslog のメッセージを出し、priority を省くと LOG_INFO になると書かれています。

Registers for an event that is triggered by the event manager run command. These events are handled by the None event detector that screens for this event.

(Event Registration 章「event_register_none」)

action_syslog [priority emerg|alert|crit|err|warning|notice|info|debug] [msg ?] [facility ?]

(Action 章「action_syslog」)

(Optional) The action_syslog message facility level. If this argument is not specified, the default priority is LOG_INFO.

(Action 章「action_syslog」)

ポリシーの登録のコマンドは event manager policy で、type は system か user を書く省略できる指定です。type user は利用者が定義したポリシーの登録に使い、type を付けない例も利用者が定義したポリシーの登録と呼ばれています。type を省いた時の既定の値そのものは書かれていません。

event manager policy policy-filename [type {system | user }] [trap ]

(Tcl 章「Registering and Defining an EEM Tcl Script」)

Use the user keyword to register a user-defined system policy.

(Tcl 章「Registering and Defining an EEM Tcl Script」)

Use this command to register a user-defined EEM policy. In this example, the policy named libtest.tcl is registered.

(Tcl 章「Creating an EEM User Tcl Library Index」)

同じ章は、見本のポリシー(ap_perf_test_base_cpu.tcl・sl_intf_down.tcl など)を、EEM の system のポリシーとして入っている見本と書いています。その見本を走らせる手順(Using the Sample Policies の節)の登録の行も、event manager policy ap_perf_test_base_cpu.tcl・event manager policy sl_intf_down.tcl のように type を付けていません。

This section contains some of the sample policies that are included as EEM system policies.

(Tcl 章「Programming Policies with Tcl Sample Scripts Example」)

type を付けない登録の例は、利用者のポリシー(libtest.tcl)と、system のポリシーとして入っている見本の両方に在ります。

user policy の置き場は event manager directory user policy で指定します。Tcl 章は、この作業を Tcl で書いたポリシーだけに当てています(Python 章は同じコマンドで .py の置き場を指す。§12.1)。

This task applies only to EEM policies that are written using Tcl scripts.

(Tcl 章「Managing EEM Policies」)

11.2 ファイルの置き方(本ラボの方式)

本ラボは、Tcl のポリシーのファイルを、機器の tclsh で bootflash: に書きました。ファイルの中身を 16 進の文字列にして binary format H* で書き戻す形です。

この書き方は、§11.1 の資料の手順(機器の外で書いて機器にコピーする)に無い方式です。

まず mkdir で bootflash:eem75 を作りました(確認の問いに改行で答えたのは〔ツール側〕の操作)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の mkdir の表示は以下のとおりです。

snippet
CSR1# mkdir bootflash:eem75
Create directory filename [eem75]? 
Created dir bootflash:/eem75
…(省略)

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の作った直後の dir は以下のとおりです。

snippet
CSR1# dir bootflash:eem75/
Directory of bootflash:eem75/

No files in directory

6286540800 bytes total (5436391424 bytes free)

書き方の試しのファイル w75.txt の tclsh のエコーは以下のとおりです(CSR1 csr1000v 17.03.08a・RAM 4096 MB。open の返事は file10)。

snippet
tclsh
CSR1(tcl)#set f [open "bootflash:/eem75/w75.txt" w]
file10
CSR1(tcl)#fconfigure $f -translation binary
CSR1(tcl)#puts -nonewline $f [binary format H* 7037352074636c73682066696c65207465737420287737352e7478742920666f7220626f6f74666c6173683a2f65656d37352f0a3a3a636973636f3a3a65656d3a3a6576656e745f72656769737465725f]
CSR1(tcl)#puts -nonewline $f [binary format H* 6e6f6e65206d617872756e2036300a6e616d65737061636520696d706f7274203a3a636973636f3a3a65656d3a3a2a203b20246172725f65696e666f286d736729205b6576656e745f726571696e666f5d]
CSR1(tcl)#puts -nonewline $f [binary format H* 207b787d202271220a6966207b245f636572726e6f20213d20307d207b20707574732022613d622c20632d642e20652b66203e20672023206822207d0a6261636b736c617368205c20616e64205c6e2061]
CSR1(tcl)#puts -nonewline $f [binary format H* 6e64205c2220616e64205c247820737461792061732074686579206172650a6469676974732030313233343536373839202f20454c4e5049202f206162636465666768696a6b6c6d6e6f70717273747576]
CSR1(tcl)#puts -nonewline $f [binary format H* 7778797a0a20202020666f757220737061636573206f6620696e64656e746174696f6e0a0a656e64206f66207737352e7478740a]
CSR1(tcl)#close $f
CSR1(tcl)#tclquit
CSR1#

書いたファイルは、verify /md5 で確かめました。6 本のファイル(w75.txt と Tcl のポリシー 5 本)について、〔ツール側〕取得スクリプトの判定メモは、機器の値と手元で計算した値が一致したと記録しています。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の w75.txt の表示は以下のとおりです。

snippet
CSR1# verify /md5 bootflash:/eem75/w75.txt
.Done!
verify /md5 (bootflash:/eem75/w75.txt) = d392bd829dbb049e4628038e8cc750bf

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の no_t75.tcl の表示は以下のとおりです。

snippet
CSR1# verify /md5 bootflash:/eem75/no_t75.tcl
.Done!
verify /md5 (bootflash:/eem75/no_t75.tcl) = c7c1ecc6e80acb68764d9df0a90af7b7

11.3 directory と登録

本ラボは、user policy の directory を bootflash:/eem75 にし、show event manager policy available user で 4 本のポリシーを確かめてから登録しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の directory の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager directory user policy bootflash:/eem75
CSR1(config)#end
CSR1#

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の directory の読み返しは以下のとおりです。

snippet
CSR1# show event manager directory user policy
bootflash:/eem75

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の available user の表示は以下のとおりです。

snippet
CSR1# show event manager policy available user

No.  Type    Time Created              Name
1    user    Fri Oct26  16:29:37 1956  no_t75.tcl
2    user    Fri Oct26  16:29:51 1956  no_t75maxrun.tcl
3    user    Fri Oct26  16:29:58 1956  no_t75safe.tcl
4    user    Fri Oct26  16:29:44 1956  sl_t75.tcl

available user の Time Created の年は 1956 と表示され、show clock の 2026 と違いました。理由は調べていません(§15.8)。w75.txt の行は 0 行で、.tcl の行は 4 行でした(数えた)。

登録前の ? のヘルプには、type のほかに authorization・checksum・class・remote・secure-mode・trap が在りました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1(config)# event manager policy no_t75.tcl ?
  authorization  Specify an authorization type for the policy.
  checksum       Specify Embedded Event Manager policy checksum
  class          Specify a class for the policy
  remote         Specify the path to the remote policy.
  secure-mode    Specify Embedded Event Manager policy security policy
  trap           Generate an SNMP trap when policy is triggered.
  type           Type of Embedded Event Manager policy
  <cr>           <cr>

CSR1(config)#event manager policy no_t75.tcl 
…(省略)

4 本のうち 3 本は type user を付け、no_t75safe.tcl は type を付けずに登録しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager policy no_t75.tcl type user
CSR1(config)#event manager policy sl_t75.tcl type user
CSR1(config)#event manager policy no_t75maxrun.tcl type user
CSR1(config)#event manager policy no_t75safe.tcl
CSR1(config)#end
CSR1#

registered は、4 本を Class script・Type user で表示しました。type を付けなかった no_t75safe.tcl も Type は user です。event none の 3 本には policyname {…} sync {yes} の行が付き、event syslog の sl_t75.tcl には pattern の行が付きました。maxrun は、各ファイルの 1 行目の event_register の行に書いた値(60・60・5・30)でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager policy registered
…(省略)
10   script    user    none                Off   Mon Oct 26 16:30:25 2026  no_t75.tcl
 policyname {no_t75.tcl} sync {yes}
 nice 0 queue-priority normal maxrun 60.000 scheduler rp_primary Secu none


11   script    user    syslog              Off   Mon Oct 26 16:30:28 2026  sl_t75.tcl
 pattern {Interface Loopback77, changed state to administratively down}
 nice 0 queue-priority normal maxrun 60.000 scheduler rp_primary Secu none


12   script    user    none                Off   Mon Oct 26 16:30:32 2026  no_t75maxrun.tcl
 policyname {no_t75maxrun.tcl} sync {yes}
 nice 0 queue-priority normal maxrun 5.000 scheduler rp_primary Secu none


13   script    user    none                Off   Mon Oct 26 16:30:35 2026  no_t75safe.tcl
 policyname {no_t75safe.tcl} sync {yes}
 nice 0 queue-priority normal maxrun 30.000 scheduler rp_primary Secu none
…(省略)

本ラボのこの run では、type を省いた no_t75safe.tcl の登録の行が Type user と表示されました。

資料は type を省いた時の既定を書いていません(§11.1)。資料と本ラボの表示を並べ、既定の値がどれかは書きません。

11.4 run と cli_open・action_syslog の行

no_t75.tcl は、event_register_none のポリシーで、event_reqinfo の event_type_string を puts で出し、action_syslog を 1 本出し、cli_open で開いたセッションで enable と show users を打って結果を puts で出します。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の本文(more で読み戻したもの。3〜5 行目のコメントは省略)は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/no_t75.tcl
::cisco::eem::event_register_none maxrun 60
…(省略)
namespace import ::cisco::eem::*
namespace import ::cisco::lib::*

array set arr_einfo [event_reqinfo]
puts "no_t75: event_type_string=$arr_einfo(event_type_string)"
action_syslog priority info msg "no_t75 action_syslog line"
if {$_cerrno != 0} {
    puts "no_t75: action_syslog _cerrno=$_cerrno"
}
if [catch {cli_open} result] {
    error $result $errorInfo
} else {
    array set cli1 $result
}
puts "no_t75: cli_open tty_id=$cli1(tty_id)"
if [catch {cli_exec $cli1(fd) "enable"} result] {
    error $result $errorInfo
}
if [catch {cli_exec $cli1(fd) "show users"} result] {
    error $result $errorInfo
}
puts "no_t75: show users begin"
puts $result
puts "no_t75: show users end"
if [catch {cli_close $cli1(fd) $cli1(tty_id)} result] {
    error $result $errorInfo
}

本ラボは、窓の始めの show clock(16:30:49.990)の後に debug event manager tcl cli_library を入れて、特権 EXEC で event manager run no_t75.tcl を打ち、undebug all の後に窓の終わりの show clock(16:31:01.890)を撮りました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の debug の投入は以下のとおりです。

snippet
CSR1# debug event manager tcl cli_library
Debug EEM Tcl CLI library debugging is on

puts の行は run を打った端末に出て、cli_open の tty_id は 1、show users の EEM の行は Location EEM:no_t75.tcl の vty 0 でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_t75.tcl
no_t75: event_type_string=none
no_t75: cli_open tty_id=1
no_t75: show users begin

    Line       User       Host(s)              Idle       Location
*  1 vty 0                idle                 00:00:00 EEM:no_t75.tcl
   2 vty 1     netops     idle                 00:00:00 192.168.1.65

  Interface    User               Mode         Idle     Peer Address

CSR1#
no_t75: show users end

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の undebug all の返事は以下のとおりです。

snippet
CSR1# undebug all
All possible debugging has been turned off

run の逐語に action_syslog の文字列の行は 0 行で、窓(16:30:49.990〜16:31:01.890)の中の syslog に 1 行在りました。窓の中の行は 14 行で、1 行目が action_syslog の行、残りの 13 行が no_t75.tcl : DEBUG(cli_lib) の行です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:30:54.713: %HA_EM-6-LOG: no_t75.tcl: no_t75 action_syslog line
*Oct 26 16:30:54.714: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : CTL : cli_open called.
*Oct 26 16:30:54.832: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT : CSR1>
*Oct 26 16:30:54.834: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : IN  : CSR1>enable
*Oct 26 16:30:54.946: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT : CSR1#
*Oct 26 16:30:54.946: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : IN  : CSR1#show users
*Oct 26 16:30:55.158: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT :     Line       User       Host(s)              Idle       Location
*Oct 26 16:30:55.158: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT : *  1 vty 0                idle                 00:00:00 EEM:no_t75.tcl
*Oct 26 16:30:55.158: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT :    2 vty 1     netops     idle                 00:00:00 192.168.1.65
*Oct 26 16:30:55.158: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT : 
*Oct 26 16:30:55.158: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT :   Interface    User               Mode         Idle     Peer Address
*Oct 26 16:30:55.158: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT : 
*Oct 26 16:30:55.158: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : OUT : CSR1#
*Oct 26 16:30:55.161: %HA_EM-6-LOG: no_t75.tcl : DEBUG(cli_lib) : CTL : cli_close called.

action_syslog の行の接頭辞は no_t75.tcl: で、eem_policy/ を含む行は PE の出力に 0 行でした(数えた)。

Tcl 章の見本には、2 つの形が在ります。利用者のライブラリの例(libtest.tcl)を global config から run した出力は、%HA_EM-6-LOG: libtest.tcl: の形です。Cisco の見本のポリシー(ap_perf_test_base_cpu.tcl)の注釈には、no_perf_test_init.tcl を run した時の行として、eem_policy/ の付いた形が書かれています。

01:24:37: %HA_EM-6-LOG: libtest.tcl: In procedure test1 01:24:37: %HA_EM-6-LOG: libtest.tcl: In procedure test2 01:24:37: %HA_EM-6-LOG: libtest.tcl: In procedure test3

(Tcl 章「Creating an EEM User Tcl Library Index」)

### eem_policy/no_perf_test_init.tcl: EEM performance test start

(Tcl 章「ap_perf_test_base_cpu.tcl Sample Policy」)

見本の種類と出し方が違う 2 つを、本ラボの no_t75.tcl: の行と並べるだけにします。

libtest.tcl の見本の run は Device(config)# のプロンプトで打たれ、puts の行が %HA_EM-6-LOG の syslog の形で示されています。

Device(config)# event manager run libtest.tcl

(Tcl 章「Creating an EEM User Tcl Library Index」)

本ラボで global config から event manager run no_t75.tcl を打つと、% Invalid input で始まる行が返り、no_t75: の行は 0 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager run no_t75.tcl
                           ^
% Invalid input detected at '^' marker.

CSR1(config)#end
CSR1#

本ラボの no_t75.tcl の puts は、特権 EXEC の run の端末に出ました。

資料の見本の run のモード(Device(config)#)と puts の出方(%HA_EM-6-LOG の syslog の形)を、本ラボの run と並べます。

11.5 syslog で発火する Tcl のポリシー

Event Registration 章は、event_register_syslog の priority を省いた時の既定の priority を 0 としています。

(Optional) The message priority to be screened. If this argument is specified, only messages that are at the specified logging priority level, or lower, are screened. If this argument is not specified, the default priority is 0.

(Event Registration 章「event_register_syslog」)

本ラボの sl_t75.tcl は、priority を書かずに、Loopback77 の administratively down の文を pattern に登録し、action_syslog と puts を 1 本ずつ出すポリシーです。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の本文(more で読み戻したもの)は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/sl_t75.tcl
::cisco::eem::event_register_syslog pattern "Interface Loopback77, changed state to administratively down" maxrun 60
namespace import ::cisco::eem::*
namespace import ::cisco::lib::*

array set arr_einfo [event_reqinfo]
set ifname none
regexp {Interface (Loopback[0-9]+)} $arr_einfo(msg) m ifname
action_syslog priority info msg "sl_t75 fired if=$ifname"
puts "sl_t75 puts if=$ifname"

取得スクリプトは、窓(16:31:32.122〜16:32:00.815)の中で Loopback77 を shutdown しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#interface Loopback77
CSR1(config-if)# shutdown
CSR1(config-if)#end
CSR1#

窓の中の syslog の行は 5 行でした。%LINK-5-CHANGED の行(16:31:41.871)の 0.194 秒後に、sl_t75 fired if=Loopback77 と sl_t75 puts if=Loopback77 の 2 行が同じ時刻で在ります。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:31:41.871: %LINEPROTO-5-UPDOWN: Line protocol on Interface Loopback77, changed state to down
*Oct 26 16:31:41.871: %LINK-5-CHANGED: Interface Loopback77, changed state to administratively down
*Oct 26 16:31:42.065: %HA_EM-6-LOG: sl_t75.tcl: sl_t75 fired if=Loopback77
*Oct 26 16:31:42.065: %HA_EM-6-LOG: sl_t75.tcl: sl_t75 puts if=Loopback77
*Oct 26 16:31:43.144: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)

puts の文字列は、窓の中では %HA_EM-6-LOG: sl_t75.tcl: の形の syslog の行に在り、引き金を打った投入のエコーに sl_t75 を含む行は 0 行でした(数えた)。

Tcl 章の別の見本は、syslog で発火する sl_intf_down.tcl の puts の行を、次の形で示しています。

When this is placed in a policy, a message is displayed anytime a scalar variable is set, for example:

(Tcl 章「Tracing Tcl set Command Operations Example」)

02:17:58: sl_intf_down.tcl[0]: setting test_var 1

(Tcl 章「Tracing Tcl set Command Operations Example」)

本ラボの窓の中の 5 行に [0] を含む行は 0 行でした(数えた)。sl_t75.tcl の event_register_syslog の行に priority は書いていません。窓の中の 5 行で pattern の文字列を含む行は %LINK-5-CHANGED の 1 行で(数えた)、その 0.194 秒後に sl_t75 fired の行が在ります。history は、sl_t75.tcl の行を Event Type syslog・Status success で表示しました(§11.6 に載せる history の No. 8)。

資料の <ファイル名>[0]: の形と、本ラボの %HA_EM-6-LOG: <ファイル名>: の形を並べます。資料の「既定の priority は 0」と、priority を書かない sl_t75.tcl の上の観測も並べるだけで、priority の数え方は解釈しません。

11.6 maxrun

no_t75maxrun.tcl は、maxrun 5 で登録し、puts の後に after 15000 で待つポリシーです。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の本文は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/no_t75maxrun.tcl
::cisco::eem::event_register_none maxrun 5
namespace import ::cisco::eem::*
namespace import ::cisco::lib::*

puts "no_t75maxrun: start"
after 15000
puts "no_t75maxrun: after 15000"

run は、no_t75maxrun: start の後に MAXRUN timer expired を含む行と、Tcl の追跡の行を返しました。追跡の中には interp create -safe slave の行が在ります。no_t75maxrun: after 15000 の行は 0 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_t75maxrun.tcl
no_t75maxrun: start
Process Forced Exit- MAXRUN timer expired.
    while executing
"after 15000"
    invoked from within
"$slave eval $Contents"
    (procedure "eval_script" line 7)
    invoked from within
"eval_script slave $scriptname"
    invoked from within
"if {$security_level == 1} {       #untrusted script
     interp create -safe slave
     interp share {} stdin slave
     interp share {} stdout slave
..."
    (file "tmpsys:/lib/tcl/base.tcl" line 50)
Tcl policy execute failed: Process Forced Exit- MAXRUN timer expired.

後の history は、この run を Status abort で記録しました。PE の history の 10 行のうち abort は 1 行で、残りの 9 行は success です(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager history events
No.  Job Id Proc Status   Time of Event            Event Type        Name
1    17     Actv success  Mon Oct26 16:26:00 2026  timer cron        applet: A75-CRON 
2    18     Actv success  Mon Oct26 16:27:53 2026  none              applet: A75-VTY 
3    19     Actv success  Mon Oct26 16:28:09 2026  none              applet: A75-NOENABLE 
4    20     Actv success  Mon Oct26 16:28:16 2026  none              applet: A75-CONF 
5    21     Actv success  Mon Oct26 16:28:41 2026  none              applet: A75-VTY 
6    22     Actv success  Mon Oct26 16:28:59 2026  none              applet: A75-VTY 
7    23     Actv success  Mon Oct26 16:30:54 2026  none              script: no_t75.tcl 
8    24     Actv success  Mon Oct26 16:31:41 2026  syslog            script: sl_t75.tcl 
9    25     Actv abort    Mon Oct26 16:32:09 2026  none              script: no_t75maxrun.tcl 
10   26     Actv success  Mon Oct26 16:32:48 2026  none              script: no_t75safe.tcl 

打ち切られるまでの秒数を機器の時計で撮った行はありません。interp create -safe slave の行が、ほかの Tcl のポリシーの実行にも当たるかは撮っていません。

11.7 Safe-Tcl

Tcl 章は、Safe-Tcl を、信頼しない Tcl のスクリプトを safe mode で作ったインタプリタで動かし、使えるコマンドを絞る仕組みとしています。Cisco が定義したスクリプトは full Tcl のモードで、利用者が定義したスクリプトは Safe-Tcl のモードで動くと書かれています。制限の一覧には exec と pwd が在ります。

Safe-Tcl is a safety mechanism that allows untrusted Tcl scripts to run in an interpreter that was created in the safe mode. The safe interpreter has a restricted set of commands that prevent accessing some system resources and harming the host and other applications.

(Tcl 章「Safe-Tcl」)

Cisco-defined scripts run in full Tcl mode, but user-defined scripts run in Safe-Tcl mode.

(Tcl 章「Safe-Tcl」)

exec –Not permitted.

(Tcl 章「Safe-Tcl」)

pwd –The pwd command is not permitted.

(Tcl 章「Safe-Tcl」)

本ラボの no_t75safe.tcl は、exec と pwd を catch で囲んで呼び、結果を puts で出すポリシーです。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の本文(more で読み戻したもの)は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/no_t75safe.tcl
::cisco::eem::event_register_none maxrun 30
namespace import ::cisco::eem::*
namespace import ::cisco::lib::*

if [catch {exec "show clock"} result] {
    puts "no_t75safe: exec rejected: $result"
} else {
    puts "no_t75safe: exec returned: $result"
}
if [catch {pwd} result] {
    puts "no_t75safe: pwd rejected: $result"
} else {
    puts "no_t75safe: pwd returned: $result"
}

run は、exec と pwd のどちらも invalid command name の形の拒否の行を返しました。returned を含む行は 0 行です(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_t75safe.tcl
no_t75safe: exec rejected: invalid command name "exec"
no_t75safe: pwd rejected: invalid command name "pwd"

撮った拒否は exec と pwd の 2 つだけです。ほかのコマンド(file・open・socket など)は撮っていません。

11.8 後片付け

取得スクリプトは、PE の最後に、4 本のポリシーの登録を外しました。外した後の registered に Class が script の行は 0 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#no event manager policy no_t75.tcl
CSR1(config)#no event manager policy sl_t75.tcl
CSR1(config)#no event manager policy no_t75maxrun.tcl
CSR1(config)#no event manager policy no_t75safe.tcl
CSR1(config)#end
CSR1#

12. Python のポリシー

12.1 資料の Python のポリシー

17.3 の Python 章は、冒頭で、EEM のポリシーが Python のスクリプトを扱え、applet の action の一部として Python のスクリプトを走らせることもできると書いています。前提は、Guest Shell が動いていることで、Guest Shell は既定では有効でないと書かれています。

Embedded Event Manager (EEM) policies support Python scripts. Python scripts can be executed as part of EEM actions in EEM applets.

(Python 章の冒頭)

Guest Shell must be working within the container. Guest Shell is not enabled by default.

(Python 章「Prerequisites for the EEM Python Module」)

7-4 §15 は、同じ章の Python Scripting in EEM の節から 2 つの段落を引きました。1 つ目の段落の 1 文目は、上の冒頭の 1 文目と同じ文です。続く 2 文は、Python のスクリプトを EEM のポリシーとして登録でき、event の指定の書き方は Tcl のポリシーと同じだと書いています。

You can register Python scripts as EEM policies, and execute the registered Python scripts when a corresponding event occurs. The EEM Python script has the same event specification syntax as the EEM TCL policy.

(Python 章「Python Scripting in EEM」)

2 つ目の段落は、設定した EEM のポリシーは Guest Shell の中で動き、Python のインタプリタは Guest Shell のコンテナが持つと書いています。この文そのものに Python に限る語は無く、Python Scripting in EEM の節の中の文です。

Configured EEM policies run within the Guest Shell. Guest Shell is a virtualized Linux-based environment, designed to run custom Linux applications, including Python for automated control and management of Cisco devices. The Guest Shell container provides a Python interpreter.

(Python 章「Python Scripting in EEM」)

「Guest Shell の中で動く」はこの資料の文として残します。本ラボの側(§12.2〜§12.12)では、ポリシーがどこで動いたかを書きません。

同じ章は、EEM の Python の package(eem)を、EEM に登録するスクリプト(1 行目に event の指定を持つもの)の中だけで使え、スクリプトの名前で走らせる標準の Python のスクリプトでは使えないものとしています。

The EEM Python package is available only within the EEM Python script (The package can be registered with EEM, and has the EEM event specification in the first line of the script.) and not in the standard Python script (which is run using the Python script name).

(Python 章「EEM Python Package」)

package の Action の API は、EEM の action を行い、引数に既定の値を持つと書かれています。Python から使える action には、syslog のメッセージの出力が含まれます。

Action APIs—Perform EEM actions and have default parameters.

(Python 章「EEM Python Package」)

The Python package (is available only within the EEM script, and not available for the standard Python script) supports the following EEM actions: Syslog message printing Send SNMP traps Reload the box Switchover to the standby device Run a policy Track Object read Track Object Set Cisco Networking Services event generation

(Python 章「Python-Supported EEM Actions」)

API の一覧の名前は、CLI の API が eem_cli_ で始まり、変数を取る API が eem_event_reqinfo () と eem_user_variables() です。環境変数を出す見本のスクリプトは、eem.env_reqinfo() を呼んでいます。

CLI-execution APIs—Run IOS commands, and return the output. The following are the list of CLI-execution APIs: eem_cli_open() eem_cli_exec() eem_cli_read() eem_cli_read_line() eem_cli_run() eem_cli_run_interactive() eem_cli_read_pattern() eem_cli_write() eem_cli_close()

(Python 章「EEM Python Package」)

Environment variables-accessing APIs—Get the list of built-in or user-defined variables. The following are the environment variables-accessing APIs: eem_event_reqinfo ()-Returns the built-in variables list. eem_user_variables()-Returns the current value of an argument.

(Python 章「EEM Python Package」)

c = eem.env_reqinfo()

(Python 章「Python Script: eem_script.py」)

同じ章は、Python のスクリプトから呼んだ action が、Python の package から Cisco Plug N Play(PnP)を通って action handler に渡ると書いています。

The EEM Python package exposes the interfaces for executing EEM actions. You can use the Python script to call these actions, and they are forwarded from the Python package via Cisco Plug N Play (PnP) to the action handler.

(Python 章「Python-Supported EEM Actions」)

登録の手順は、event manager directory user policy でポリシーの置き場を指してから、event manager policy で登録する形です。ポリシーの解釈は拡張子で決まり、.py なら Python のポリシーとして登録されると書かれています。Tcl 章はこの directory の作業を Tcl のポリシーだけに当てており(§11.1)、2 つの章の書き方が違います。

enable configure terminal event manager directory user policy path event manager policy policy-filename exit show event manager policy registered show event manager history events

(Python 章「Registering a Python Policy」)

Device(config)# event manager directory user policy flash:/user_library

(Python 章「Registering a Python Policy」)

The policy is parsed based on the file extension. If the file extension is .py, the policy is registered as Python policy.

(Python 章「Registering a Python Policy」)

同じ手順の event manager policy の説明は、EEM がポリシーの中の event の指定に従ってポリシーを走らせ、event manager policy を打った時にポリシーを調べて登録すると書いています(CLI 章の applet の文と同じ形。§5.1)。

EEM schedules and runs policies on the basis of an event specification that is contained within the policy itself. When the event manager policy command is invoked, EEM examines the policy and registers it to be run when the specified event occurs.

(Python 章「Registering a Python Policy」)

同じ手順の show event manager policy registered の見本は、.py のポリシーを Class script・Type user で表示しています。

Device# show event manager policy registered No. Class Type Event Type Trap Time Registered Name 1 script user multiple Off Tue Aug 2 22:12:15 2016 multi_1.py

(Python 章「Registering a Python Policy」)

applet から標準の Python のスクリプトを走らせる例もあります。その中では EEM の package は使えず、IOS のコマンドは cli の package で実行すると書かれています。例の applet は、action 0.0 で en を打ち、action 1.0 の action cli で guestshell run python3 を打っています。

An EEM applet can include a Python script with an action command. In this example, an user is trying to run a standard Python script as part of the EEM action, however; EEM Python package is not available in the standard Python script. The standard Python script in IOS has a package named from cli import cli,clip and this package can be used to execute IOS commands.

(Python 章「Python Script: eem_script.py」)

Device(config-applet)# action 0.0 cli command “en”

(Python 章「Adding a Python Script in an EEM Applet」)

Device(config-applet)# action 1.0 cli command “guestshell run python3 /bootflash/eem_script.py loop55”

(Python 章「Adding a Python Script in an EEM Applet」)

syslog を出す Python のポリシーの見本は、ファイルに保存して機器にコピーし、event manager policy で登録するものとされ、1 行目は Tcl と同じ ::cisco::eem::event_register_syslog の形で、eem.action_syslog を 3 つの引数で呼んでいます。

The following is a sample script for printing messages to the syslog. This script must be stored in a file, copied to the file system on the device, and registered using the event manager policy file.

(Python 章「Python Script: eem_script.py」)

::cisco::eem::event_register_syslog tag “1” pattern COUNTER maxrun 200

(Python 章「Python Script: eem_script.py」)

eem.action_syslog(“SAMPLE SYSLOG MESSAGE”,“6”,“TEST”)

(Python 章「Python Script: eem_script.py」)

Python 章の Feature Information の節は、3 文の前置きと、機種と image の対応は Cisco Feature Navigator で調べるよう案内する文で始まります。前置きの 3 文は、Overview 章の機能表の前置き(下の引用。§2.5 に 2 文目と 3 文目を引いた)と同じ文字列です。表の行は、16.5.1a・16.5.1b・16.6.2・16.8.1a で機能を実装した機種(Catalyst 3650・3850・9300・ISR 4000・Catalyst 9400・Catalyst 9500-High Performance)です。

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

(Overview 章「Feature Information for Embedded Event Manager 4.0 Overview」。Python 章の「Feature Information for EEM Python Module」の前置きも同じ 3 文)

Use Cisco Feature Navigator to find information about platform support and Cisco software image support.

(Python 章「Feature Information for EEM Python Module」)

In Cisco IOS XE Everest 16.5.1a, this feature was implemented on the following platforms: Cisco Catalyst 3650 Series Switches Cisco Catalyst 3850 Series Switches Cisco Catalyst 9300 Series Switches

(Python 章「Table 1. Feature Information for EEM Python Module」)

In Cisco IOS XE Everest 16.5.1b, this feature was implemented on the following platforms: Cisco ISR 4000 Series Integrated Service Routers

(Python 章「Table 1. Feature Information for EEM Python Module」)

Cisco IOS XE Everest 16.6.2 In Cisco IOS XE Everest 16.6.2, this feature was implemented on Cisco Catalyst 9400 Series Switches. Cisco IOS XE Fuji 16.8.1a In Cisco IOS XE Fuji 16.8.1a, this feature was implemented on Cisco Catalyst 9500-High Performance Series Switches

(Python 章「Table 1. Feature Information for EEM Python Module」)

表の行に CSR1000V(csr1000v)の行はありません。表は導入の版と機種を挙げるもので、機種と image の対応は Feature Navigator で調べよと書かれているので、csr1000v が対応するかはこの表からは言えません。

12.2 IOx と Guest Shell の有効化

本ラボの Guest Shell の有効化は、7-4 §4・§5 と同じ形です。7-4 §5.2 と違い、本ラボは NAT と Gi2 の行を入れていません(投入のエコーに nat と GigabitEthernet を含む行は 0 行。数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の iox の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#iox
CSR1(config)#end
CSR1#

iox を入れた後の 2 回目の show iox-service で、IOxman は Running でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の 2 回目の show clock と show iox-service(1 つの取得の記録)は以下のとおりです。

snippet
CSR1# show clock
*16:35:13.740 UTC Mon Oct 26 2026
CSR1# show iox-service

IOx Infrastructure Summary:
---------------------------
IOx service (CAF) 1.11.0.7     : Running
IOx service (HA)               : Not Supported 
IOx service (IOxman)           : Running 
IOx service (Sec storage)      : Not Supported 
Libvirtd 1.3.4                 : Running

続いて、VirtualPortGroup0 と app-hosting を入れました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#interface VirtualPortGroup0
CSR1(config-if)# ip address 192.168.35.1 255.255.255.0
CSR1(config-if)# no mop enabled
CSR1(config-if)# no mop sysid
CSR1(config-if)#app-hosting appid guestshell
CSR1(config-app-hosting)# app-vnic gateway1 virtualportgroup 0 guest-interface 0
CSR1(config-app-hosting-gateway1)#  guest-ipaddress 192.168.35.2 netmask 255.255.255.0
CSR1(config-app-hosting-gateway1)#  exit
CSR1(config-app-hosting)# app-default-gateway 192.168.35.1 guest-interface 0
CSR1(config-app-hosting)#end
CSR1#

guestshell enable の返事は、Current state の行が DEPLOYED → ACTIVATED → RUNNING の順でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の guestshell enable は以下のとおりです。

snippet
CSR1# guestshell enable
Interface will be selected if configured in app-hosting
Please wait for completion
guestshell installed successfully
Current state is: DEPLOYED
guestshell activated successfully
Current state is: ACTIVATED
guestshell started successfully
Current state is: RUNNING
Guestshell enabled successfully

show app-hosting list で、guestshell は RUNNING でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の show clock と show app-hosting list(1 つの取得の記録)は以下のとおりです。

snippet
CSR1# show clock
*16:37:33.999 UTC Mon Oct 26 2026
CSR1# show app-hosting list
App id                                   State
---------------------------------------------------------
guestshell                               RUNNING

〔ツール側〕取得スクリプトが撮った順では、有効化の後(show app-hosting list が RUNNING の後)で、Guest Shell の bash でファイルを書く(§12.10・§12.11)前に、dir bootflash:guest-share/ を撮りました。表示は No files in directory でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# dir bootflash:guest-share/
Directory of bootflash:guest-share/

No files in directory

6286540800 bytes total (4407812096 bytes free)

12.3 bootflash:/eem75 に置いた .py の登録と run

本ラボの Python のポリシーのファイル 6 本は、§11.2 と同じ tclsh の方式で bootflash:/eem75 に書き、verify /md5 で確かめました(〔ツール側〕判定メモは 6 本とも一致と記録)。no_p75.py は、print で Python の版と eem の属性の名前を出し、eem.action_syslog を 3 つの引数で呼び、event_reqinfo と env_reqinfo を在れば呼んで結果を print で出すポリシーです。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の本文(more で読み戻したもの)は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/no_p75.py
::cisco::eem::event_register_none maxrun 60
import sys
import eem
print("no_p75: python " + sys.version.split()[0])
print("no_p75: eem attrs " + " ".join(sorted(a for a in dir(eem) if not a.startswith("_"))))
eem.action_syslog("no_p75 action_syslog line", "6", "P75")
for name in ("event_reqinfo", "env_reqinfo"):
    f = getattr(eem, name, None)
    if f is None:
        print("no_p75: eem." + name + " missing")
        continue
    try:
        print("no_p75: eem." + name + " -> " + repr(f()))
    except Exception as e:
        print("no_p75: eem." + name + " raised " + type(e).__name__ + ": " + str(e))

user policy の directory は、PE で入れた bootflash:/eem75 のままにしました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の directory の読み返しは以下のとおりです。

snippet
CSR1# show event manager directory user policy
bootflash:/eem75

no_p75.py と sl_p75.py は type user で登録しました。登録の直後に機器が出した行は 0 行です(〔ツール側〕判定メモ)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager policy no_p75.py type user
CSR1(config)#event manager policy sl_p75.py type user
CSR1(config)#end
CSR1#

registered は、2 本を Class script・Type user で表示し、no_p75.py に policyname {no_p75.py} sync {yes} の行と maxrun 60.000 の行を付けました。Tcl のポリシー(§11.3)と同じ形の行です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager policy registered
…(省略)
10   script    user    none                Off   Mon Oct 26 16:39:01 2026  no_p75.py
 policyname {no_p75.py} sync {yes}
 nice 0 queue-priority normal maxrun 60.000 scheduler rp_primary Secu none


11   script    user    syslog              Off   Mon Oct 26 16:39:05 2026  sl_p75.py
 pattern {Interface Loopback78, changed state to administratively down}
 nice 0 queue-priority normal maxrun 60.000 scheduler rp_primary Secu none
…(省略)

窓(16:39:12.855〜16:39:35.952)の中で打った event manager run no_p75.py の逐語は、空行 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_p75.py

直後の show event manager policy active も空行 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager policy active

run の逐語に no_p75: を含む行は 0 行で、窓の中の syslog の行も 0 行でした(数えた)。print の行と action_syslog の行の行き先は、この 2 つの記録からは撮れていません。窓の後の history は、no_p75.py の run を Event Type none・Status success で記録しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager history events
No.  Job Id Proc Status   Time of Event            Event Type        Name
1    20     Actv success  Mon Oct26 16:28:16 2026  none              applet: A75-CONF 
2    21     Actv success  Mon Oct26 16:28:41 2026  none              applet: A75-VTY 
3    22     Actv success  Mon Oct26 16:28:59 2026  none              applet: A75-VTY 
4    23     Actv success  Mon Oct26 16:30:54 2026  none              script: no_t75.tcl 
5    24     Actv success  Mon Oct26 16:31:41 2026  syslog            script: sl_t75.tcl 
6    25     Actv abort    Mon Oct26 16:32:09 2026  none              script: no_t75maxrun.tcl 
7    26     Actv success  Mon Oct26 16:32:48 2026  none              script: no_t75safe.tcl 
8    27     Actv success  Mon Oct26 16:33:48 2026  none              script: no_t75two.tcl 
9    28     Actv success  Mon Oct26 16:34:12 2026  none              script: no_t75two.tcl 
10   29     Actv success  Mon Oct26 16:39:15 2026  none              script: no_p75.py 

〔ツール側〕取得スクリプトの経過秒では、この run は 8.0 秒で戻りました(§5 と §10 で exec から打った applet の run は 2.2〜2.6 秒)。

12.4 Loopback78 の引き金と sl_p75.py

sl_p75.py は、Loopback78 の administratively down の文を pattern に登録し、eem.action_syslog で sl_p75 fired を出すポリシーです。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の本文は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/sl_p75.py
::cisco::eem::event_register_syslog pattern "Interface Loopback78, changed state to administratively down" maxrun 60
import eem
eem.action_syslog("sl_p75 fired", "6", "P75")

取得スクリプトは、窓(16:39:44.952〜16:40:22.068)の中で Loopback78 を作って shutdown しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#interface Loopback78
CSR1(config-if)# ip address 10.7.5.78 255.255.255.255
CSR1(config-if)# shutdown
CSR1(config-if)#end
CSR1#

窓の中の syslog の行は 4 行でした。4 行に sl_p75 fired・HA_EM・P75 を含む行は 0 行です(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:39:49.423: %LINEPROTO-5-UPDOWN: Line protocol on Interface Loopback78, changed state to up
*Oct 26 16:39:58.023: %LINEPROTO-5-UPDOWN: Line protocol on Interface Loopback78, changed state to down
*Oct 26 16:39:58.023: %LINK-5-CHANGED: Interface Loopback78, changed state to administratively down
*Oct 26 16:39:59.332: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)

後に撮った history detailed は、sl_p75.py の発火を Event Type syslog・Status success で記録し、msg の下に窓の中の %LINK-5-CHANGED の行と同じ文字列を付けていました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events detailed
…(省略)
9    30     Actv success  Mon Oct26 16:39:58 2026  syslog            script: sl_p75.py 
   msg 
  *Oct 26 16:39:58.023: %LINK-5-CHANGED: Interface Loopback78, changed state to administratively down
…(省略)

12.5 .eem_mlang_scripts の中

2 本の登録と run の後、/bootflash/guest-share/ に .eem_mlang_scripts というディレクトリが在り、comp_no_p75.py と comp_sl_p75.py の 2 本が在りました。所有者は 2 本とも nobody です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の ls の表示は以下のとおりです。

snippet
CSR1# guestshell run ls -la /bootflash/guest-share/.eem_mlang_scripts/
total 32
drwxr-xr-x. 2 nobody nobody        4096 Oct 26 16:39 .
drwxrwxr-x. 3 nobody network-admin 4096 Oct 26 16:39 ..
-rw-r--r--. 1 nobody nobody         613 Oct 26 16:39 comp_no_p75.py
-rw-r--r--. 1 nobody nobody         176 Oct 26 16:39 comp_sl_p75.py

comp_no_p75.py の中身は、bootflash:/eem75 の no_p75.py の 1 行目の頭に # を付け、その次に空行を 1 行入れた形で、ほかの行は同じでした。大きさは、〔ツール側〕tclsh で書いた時の 611 bytes に対し、ls の表示が 613 bytes です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の cat -v の表示は以下のとおりです。

snippet
CSR1# guestshell run cat -v /bootflash/guest-share/.eem_mlang_scripts/comp_no_p75.py
#::cisco::eem::event_register_none maxrun 60

import sys
import eem
print("no_p75: python " + sys.version.split()[0])
print("no_p75: eem attrs " + " ".join(sorted(a for a in dir(eem) if not a.startswith("_"))))
eem.action_syslog("no_p75 action_syslog line", "6", "P75")
for name in ("event_reqinfo", "env_reqinfo"):
    f = getattr(eem, name, None)
    if f is None:
        print("no_p75: eem." + name + " missing")
        continue
    try:
        print("no_p75: eem." + name + " -> " + repr(f()))
    except Exception as e:
        print("no_p75: eem." + name + " raised " + type(e).__name__ + ": " + str(e))

comp_sl_p75.py も、1 行目の頭の # と次の空行のほかは sl_p75.py と同じでした(〔ツール側〕tclsh で書いた時の 174 bytes に対し、ls の表示が 176 bytes)。登録前の guest-share に .eem_mlang_scripts の行は 0 行でした(数えた)。comp_ の 2 本がいつ・何を契機に作られたかと、先頭の # と空行が何のためかは撮っていません。

12.6 本文の無いポリシー(U0)

出力の行き先を切り分けるために、本ラボは 4 本の .py を足しました。U0 の no_p75z.py は、1 行目の event_register_none の行だけで本文の無いポリシーです。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の本文は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/no_p75z.py
::cisco::eem::event_register_none maxrun 60

4 本は type user で登録しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の登録の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager policy no_p75z.py type user
CSR1(config)#event manager policy no_p75w.py type user
CSR1(config)#event manager policy no_p75s.py type user
CSR1(config)#event manager policy no_p75s3.py type user
CSR1(config)#end
CSR1#

no_p75z.py の run の逐語は空行 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_p75z.py

run の後の history detailed は success・argc 0 でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history detailed の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events detailed
…(省略)
10   31     Actv success  Mon Oct26 16:41:19 2026  none              script: no_p75z.py 
   argc 0

後に撮った show event manager statistics policy は、.py のポリシー 6 本の Average Run Time を 5.206〜5.936 と表示しました。本文の無い no_p75z.py の 5.206 は、本文の在る 5 本(5.399〜5.936)より小さい値です。applet の 9 本は 0.001〜0.456 でした。Run Time の単位は表に書かれていません。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の .py の行の抜粋は以下のとおりです。

snippet
CSR1# show event manager statistics policy

                                       Average        Maximum        
No.  Class     Triggered   Suppressed  Run Time       Run Time       Name
-------------------------------------------------------------------------------
…(省略)
10   script    1           0           5.936          5.936          no_p75.py
 event {} none

11   script    1           0           5.891          5.891          sl_p75.py
 event {} syslog

12   script    1           0           5.206          5.206          no_p75z.py
 event {} none

13   script    1           0           5.399          5.399          no_p75w.py
 event {} none

14   script    1           0           5.483          5.483          no_p75s.py
 event {} none

15   script    1           0           5.829          5.829          no_p75s3.py
 event {} none

各ポリシーは 1 回ずつの run で、run の時間が本文に依らないとは書きません。

12.7 ファイルを書くポリシー(U2)

U2 の no_p75w.py は、/tmp/p75w-ran.txt と /bootflash/guest-share/p75w-ran.txt に、印の行と host=・python=・uid= の行を書くポリシーです。印は "p75w" + "-tmp-" + "ran" のような文字列の連結で、ポリシーの本文には完成した形が出ません。書けなかった時は、もう一方の場所の error のファイルに例外を書きます。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の本文は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/no_p75w.py
::cisco::eem::event_register_none maxrun 60
import os
import socket
import sys
try:
    f = open("/tmp/p75w-ran.txt", "w")
    f.writelines(["p75w" + "-tmp-" + "ran" + "\n", "host=" + socket.gethostname() + "\n", "python=" + sys.version.split()[0] + "\n", "uid=" + str(os.getuid()) + "\n"])
    f.close()
except Exception as e:
    try:
        d = open("/bootflash/guest-share/p75w-error.txt", "a")
        d.writelines(["tmp " + type(e).__name__ + ": " + str(e) + "\n"])
        d.close()
    except Exception:
        pass
try:
    g = open("/bootflash/guest-share/p75w-ran.txt", "w")
    g.writelines(["p75w" + "-gs-" + "ran" + "\n", "host=" + socket.gethostname() + "\n", "python=" + sys.version.split()[0] + "\n", "uid=" + str(os.getuid()) + "\n"])
    g.close()
except Exception as e:
    try:
        h = open("/tmp/p75w-error.txt", "a")
        h.writelines([type(e).__name__ + ": " + str(e) + "\n"])
        h.close()
    except Exception:
        pass

U0 の run の後の時点では、2 つの p75w-ran.txt はどちらも無く、/tmp/ にファイルの行は 0 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# guestshell run ls -la /tmp/ /bootflash/guest-share/
/bootflash/guest-share/:
total 33
drwxrwxr-x. 3 nobody     network-admin 4096 Oct 26 16:39 .
drwxr-xr-x. 3 root       root          1024 Oct 26 16:37 ..
drwxr-xr-x. 2 nobody     nobody        4096 Oct 26 16:41 .eem_mlang_scripts
-rw-rw-r--. 1 guestshell guestshell     227 Oct 26 16:38 p75_import.py
-rw-rw-r--. 1 guestshell guestshell      77 Oct 26 16:38 p75_std.py

/tmp/:
total 0
drwxrwxrwx. 2 root root 40 Oct 26 16:38 .
drwxrwxrwt. 4 root root 80 Oct 26 16:37 ..

no_p75w.py の run の逐語は空行 1 行で、窓(16:43:00.400〜16:43:22.781)の中の syslog の行は 0 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_p75w.py

run の後には、2 つの場所に p75w-ran.txt が在りました。所有者は 2 本とも guestshell guestshell です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の ls の表示は以下のとおりです。

snippet
CSR1# guestshell run ls -la /tmp/ /bootflash/guest-share/
/bootflash/guest-share/:
total 41
drwxrwxr-x. 3 nobody     network-admin 4096 Oct 26 16:43 .
drwxr-xr-x. 3 root       root          1024 Oct 26 16:37 ..
drwxr-xr-x. 2 nobody     nobody        4096 Oct 26 16:41 .eem_mlang_scripts
-rw-rw-r--. 1 guestshell guestshell     227 Oct 26 16:38 p75_import.py
-rw-rw-r--. 1 guestshell guestshell      77 Oct 26 16:38 p75_std.py
-rw-rw-r--. 1 guestshell guestshell      50 Oct 26 16:43 p75w-ran.txt

/tmp/:
total 4
drwxrwxrwx. 2 root       root       60 Oct 26 16:43 .
drwxrwxrwt. 4 root       root       80 Oct 26 16:37 ..
-rw-rw-r--. 1 guestshell guestshell 51 Oct 26 16:43 p75w-ran.txt

2 本の中身は、印の行(p75w-tmp-ran と p75w-gs-ran)だけが違い、host=guestshell・python=3.6.8・uid=1000 の 3 行は同じでした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の /tmp の側の cat -v の表示は以下のとおりです。

snippet
CSR1# guestshell run cat -v /tmp/p75w-ran.txt
p75w-tmp-ran
host=guestshell
python=3.6.8
uid=1000

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の guest-share の側の cat -v の表示は以下のとおりです。

snippet
CSR1# guestshell run cat -v /bootflash/guest-share/p75w-ran.txt
p75w-gs-ran
host=guestshell
python=3.6.8
uid=1000

IOS の側の dir bootflash:guest-share/ は同じファイル(p75w-ran.txt・50 バイト)を表示し、more は同じ 4 行を表示しました。error のファイルは、2 つの場所とも No such file or directory でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の IOS の側の dir は以下のとおりです。

snippet
CSR1# dir bootflash:guest-share/
Directory of bootflash:guest-share/

225804  -rw-               50  Oct 26 2026 16:43:07 +00:00  p75w-ran.txt
225797  drwx             4096  Oct 26 2026 16:41:09 +00:00  .eem_mlang_scripts
225796  -rw-              227  Oct 26 2026 16:38:44 +00:00  p75_import.py
225795  -rw-               77  Oct 26 2026 16:38:43 +00:00  p75_std.py

6286540800 bytes total (4406755328 bytes free)

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の IOS の側の more は以下のとおりです。

snippet
CSR1# more bootflash:guest-share/p75w-ran.txt
p75w-gs-ran
host=guestshell
python=3.6.8
uid=1000

guest-share に p75w-gs-ran の行のファイルが現れたことから言えるのは、no_p75w.py の本文が走ってそのファイルを書いたことまでです。/tmp/ の側は、guestshell run ls -la /tmp/ に p75w-ran.txt の行が現れた(Guest Shell の /tmp に書かれた)という形です。host=・python=・uid= の値と所有者は並べるだけで、本文がどこで走ったかは書きません。

資料の「Guest Shell の中で動く」は、§12.1 の資料の文のままにします。

12.8 action_syslog の前後の印(U3・U3’)

U3 の no_p75s.py は、/tmp/p75s-mark.txt に、import eem の前・後と、eem.action_syslog を 1 つの引数で呼んだ後の印を書き、例外の時はその名前と文言を書くポリシーです。U3’ の no_p75s3.py は、同じ本文の呼び出しだけを 3 つの引数にしたポリシーです。

1 つの引数の呼び方は資料の見本に無い形で、資料の Action の API の「既定の値を持つ」という文(§12.1)に依って選びました。3 つの引数の呼び方は、資料の見本と同じ数です。

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の no_p75s.py の本文は以下のとおりです。

snippet
CSR1# more bootflash:/eem75/no_p75s.py
::cisco::eem::event_register_none maxrun 60
try:
    f = open("/tmp/p75s-mark.txt", "w")
    f.writelines(["p75s" + "-before" + "\n"])
    f.close()
    import eem
    f = open("/tmp/p75s-mark.txt", "a")
    f.writelines(["p75s" + "-imported" + "\n"])
    f.close()
    r = eem.action_syslog("p75s" + "-one-" + "arg")
    f = open("/tmp/p75s-mark.txt", "a")
    f.writelines(["p75s" + "-after ret=" + repr(r) + "\n"])
    f.close()
except Exception as e:
    f = open("/tmp/p75s-mark.txt", "a")
    f.writelines(["p75s" + "-error " + type(e).__name__ + ": " + str(e) + "\n"])
    f.close()

2 本とも、run の逐語は空行 1 行でした。run の後の印のファイルは、2 本とも -before → -imported → -error NameError: name 'log' is not defined の 3 行で、-after ret= の行は 0 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の no_p75s.py の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_p75s.py

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の no_p75s.py の印のファイルは以下のとおりです。

snippet
CSR1# guestshell run cat -v /tmp/p75s-mark.txt
p75s-before
p75s-imported
p75s-error NameError: name 'log' is not defined

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の no_p75s3.py の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_p75s3.py

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の no_p75s3.py の印のファイルは以下のとおりです。

snippet
CSR1# guestshell run cat -v /tmp/p75s3-mark.txt
p75s3-before
p75s3-imported
p75s3-error NameError: name 'log' is not defined

2 本の印のファイルは、名前の接頭辞(p75s と p75s3)のほかは同じ文字列でした。NameError の log が何の名前かは書きません。

2 本の run の窓(16:44:45.786〜16:45:08.163 と 16:46:30.648〜16:46:53.406)の中の syslog の行は、どちらも 0 行でした。run の後の全体の logging にも、action_syslog に渡した文字列(連結の完成形の p75s-one-arg と p75s3-three-args)の一部の「one-arg」と「three-args」を含む行は 0 行です(数えた)。

12.9 directory を guest-share に替えた後(B)

〔ツール側〕取得スクリプトは、B に進むかを A の 4 つの記録(登録のエコー・registered・run の逐語・run の窓の logging)だけで決める設計です。判定メモは、成り立った条件を「run の逐語にも logging にも no_p75: python も no_p75 action_syslog line も無い」と記録し、B に進んでいます。Loopback78 の窓(§12.4)で sl_p75 fired を含む行が 0 行だったことは、この判定の材料ではありません。

B は、no_p75.py と sl_p75.py の登録を外し、user policy の directory を bootflash:/guest-share に替え、Guest Shell の bash の heredoc で同じ本文の 2 本を guest-share に書いて登録し直す形です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の directory の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager directory user policy bootflash:/guest-share
CSR1(config)#end
CSR1#

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の directory の読み返しは以下のとおりです。

snippet
CSR1# show event manager directory user policy
bootflash:/guest-share

registered の表示は、Time Registered のほかは A と同じ形でした。窓(16:49:27.494〜16:49:49.678)の中の no_p75.py の run の逐語は空行 1 行で、窓の中の syslog の行は 0 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_p75.py

その後の history は、この run を success で表示しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の history の抜粋は以下のとおりです。

snippet
CSR1# show event manager history events
…(省略)
10   35     Actv success  Mon Oct26 16:49:29 2026  none              script: no_p75.py 

B の Loopback78 の引き金は、窓(16:49:58.734〜16:50:41.025)の中の no shutdown の後の shutdown です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#interface Loopback78
CSR1(config-if)# no shutdown
CSR1(config-if)# shutdown
CSR1(config-if)#end
CSR1#

窓の中の syslog の行は 5 行で、sl_p75 fired を含む行は 0 行でした(数えた)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:50:08.550: %LINEPROTO-5-UPDOWN: Line protocol on Interface Loopback78, changed state to up
*Oct 26 16:50:08.551: %LINK-3-UPDOWN: Interface Loopback78, changed state to up
*Oct 26 16:50:16.982: %LINEPROTO-5-UPDOWN: Line protocol on Interface Loopback78, changed state to down
*Oct 26 16:50:16.982: %LINK-5-CHANGED: Interface Loopback78, changed state to administratively down
*Oct 26 16:50:18.232: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)

A の窓の 4 行との違いは、B の窓に %LINK-3-UPDOWN の up の行(184 行目)が在ることです。A の投入は ip address の後に shutdown、B の投入は no shutdown の後に shutdown でした。並べるだけにします。後の history(§13.4 の PZ の history)は、この発火を script: sl_p75.py・Status success で記録しています。B の後の .eem_mlang_scripts の ls は、時刻の表示(16:39 → 16:49)のほかは A の後と同じ 2 本でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# guestshell run ls -la /bootflash/guest-share/.eem_mlang_scripts/
total 32
drwxr-xr-x. 2 nobody nobody        4096 Oct 26 16:49 .
drwxrwxr-x. 3 nobody network-admin 4096 Oct 26 16:49 ..
-rw-r--r--. 1 nobody nobody         613 Oct 26 16:49 comp_no_p75.py
-rw-r--r--. 1 nobody nobody         176 Oct 26 16:49 comp_sl_p75.py

12.10 applet から guestshell run python3(A75-PYSTD)

A75-PYSTD は、action 1.0 で enable を打ち、action 2.0 の action cli で guestshell run python3 /bootflash/guest-share/p75_std.py を打って、$_cli_result を puts で出す applet です。p75_std.py は、cli の package で show clock を打つ標準のスクリプトです。

p75_std.py は、IOS の CLI の guestshell run bash で入った Guest Shell の bash の heredoc で書きました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の Guest Shell の bash の heredoc のエコーは以下のとおりです(末尾の …(省略) は取得スクリプトの sha256 の照合の記録の行)。

snippet
[guestshell@guestshell ~]$ cat > /bootflash/guest-share/p75_std.py <<'PYEOF'
> from cli import cli
> print("p75_std" + "-" + "done")
> print(cli("show clock"))
> PYEOF
[guestshell@guestshell ~]$ sha256sum /bootflash/guest-share/p75_std.py
ec3dfa1d60542917a333fbb4d016039d03a2afd4da23ac6866405819bcf9dde9  /bootflash/guest-share/p75_std.py
…(省略)

applet は、bash を exit で出た後(exit の逐語は §12.11)の IOS の CLI で入れました(〔ツール側〕取得スクリプトが撮った順で、PF の後半)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の applet の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager applet A75-PYSTD
CSR1(config-applet)# event none
CSR1(config-applet)# action 1.0 cli command "enable"
CSR1(config-applet)# action 2.0 cli command "guestshell run python3 /bootflash/guest-share/p75_std.py"
CSR1(config-applet)# action 3.0 puts "A75-PYSTD begin"
CSR1(config-applet)# action 4.0 puts "$_cli_result"
CSR1(config-applet)# action 5.0 puts "A75-PYSTD end"
CSR1(config-applet)#end
CSR1#

窓(16:51:41.593〜16:51:55.161)の中の run は、puts の行の間に、p75_std-done の行と show clock の形の行(16:51:48.816)を返しました。p75_std-done は、p75_std.py の print の文字列の連結の完成形と同じ文字列です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-PYSTD
A75-PYSTD begin
p75_std-done
*16:51:48.816 UTC Mon Oct 26 2026



CSR1#
A75-PYSTD end

本ラボの A75-PYSTD は、action 1.0 で enable を打ち、7-4 で IOS の CLI から打った guestshell run python3 と同じコマンドを、applet の action cli から打った形です。

資料の例(§12.1)は、action 0.0 で en を打っています。

12.11 Guest Shell の中の import eem

資料は、EEM の package は EEM に登録するスクリプトの中だけで使え、標準のスクリプトでは使えないと書いています(§12.1)。

本ラボは、import eem を try で囲み、属性の名前を print する標準のスクリプト p75_import.py を、§12.10 と同じ Guest Shell の bash の heredoc で書きました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の heredoc のエコーは以下のとおりです(末尾の …(省略) は取得スクリプトの sha256 の照合の記録の行)。

snippet
[guestshell@guestshell ~]$ cat > /bootflash/guest-share/p75_import.py <<'PYEOF'
> try:
>     import eem
>     print("p75_import: import eem ok " + " ".join(sorted(a for a in dir(eem) if not a.startswith("_"))))
> except Exception as e:
>     print("p75_import: import eem failed " + type(e).__name__ + ": " + str(e))
> PYEOF
[guestshell@guestshell ~]$ sha256sum /bootflash/guest-share/p75_import.py
d3c4fed5d3e4f4ea466f72a6786afd86dfb3cf87034c5e36300bb074a20debfb  /bootflash/guest-share/p75_import.py
…(省略)

この後、bash を exit で出て、IOS の CLI のプロンプト CSR1# に戻りました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の exit の逐語は以下のとおりです。

snippet
[guestshell@guestshell ~]$ exit
exit

CSR1#

p75_import.py は、PF の後半に IOS の CLI の guestshell run python3 で走らせました(〔ツール側〕取得スクリプトが撮った順)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の出力は以下のとおりです。

snippet
CSR1# guestshell run python3 /bootflash/guest-share/p75_import.py
Please note, this package[eem] is ONLY for EEM Python Scripts
p75_import: import eem ok action_export_to_telemetry action_reload action_snmp_trap action_switch action_syslog action_track_read action_track_set cli_close cli_exec cli_get_ttyname cli_open cli_read cli_read_drain cli_read_line cli_read_pattern cli_run cli_run_interactive cli_write env_reqinfo event_publish event_reqinfo event_reqinfo_multi

出力の 1 行目は Please note, this package[eem] is ONLY for EEM Python Scripts で、2 行目は p75_import: import eem ok の後に 22 個の名前を並べました。22 個のうち cli_ で始まる名前が 11 個、action_ が 7 個、event_ が 3 個、env_ が 1 個で、eem_ で始まる名前は 0 個でした(数えた)。

資料の API の一覧の名前(eem_cli_・eem_event_reqinfo ()・eem_user_variables())と、機器の属性の名前(cli_open・event_reqinfo・env_reqinfo など)を並べ、どちらが正しいとは書きません。

この import は IOS の CLI の guestshell run python3 での記録で、ポリシーの本文の中の import(§12.8 の -imported の行)とは別の記録です。ポリシーの中と外で eem の中身が同じかは撮っていません。

標準のスクリプトの記録は import と属性の名前の表示までで、標準のスクリプトから eem の API を呼ぶ操作は撮っていません。

12.12 Guest Shell を止めた後

PH-a では、no_p75.py を登録し直し、guestshell disable を打ってから、no_p75.py の run と、登録を外す操作を撮りました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の登録の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager policy no_p75.py type user
CSR1(config)#end
CSR1#

登録の後、disable の前に撮った show event manager policy registered には、no_p75.py の行(Time Registered 16:56:01)が在りました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の guestshell disable は以下のとおりです。

snippet
CSR1# guestshell disable
Guestshell disabled successfully 

disable の後の run の逐語は空行 1 行で、窓(16:56:16.260〜16:56:23.000)の中の syslog の行は 0 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run no_p75.py

この run の直後の history は撮っていません。後に撮った history(§13.4)に、窓の時刻(16:56:16〜16:56:23)の行は 0 行で、job id は 43 の次が 45 です(どちらも数えた)。この 44 の欠けとこの run を結び付ける記録は撮っていません。

disable の状態で no event manager policy no_p75.py を打つと、機器は guestshell is in disabled state の行と Unknown policy extension found の行を返しました。2 行とも % で始まりません。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#no event manager policy no_p75.py
Error, guestshell is in disabled state, execute 'guestshell enable' before attempting this CLI
EEM configuration: fsp : Unknown policy extension found.
CSR1(config)#end
CSR1#

その後の running-config には、event manager policy no_p75.py type user の行が残っていました。PZ の statistics にも no_p75.py の行(Triggered 0)が在ります。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の running-config の抜粋は以下のとおりです。

snippet
CSR1# show running-config | section event manager
…(省略)
event manager applet A75-PYSTD
 event none
 action 1.0 cli command "enable"
 action 2.0 cli command "guestshell run python3 /bootflash/guest-share/p75_std.py"
 action 3.0 puts "A75-PYSTD begin"
 action 4.0 puts "$_cli_result"
 action 5.0 puts "A75-PYSTD end"
event manager policy no_p75.py type user

PH の後に show event manager policy registered は撮っておらず、登録が残ったかは running-config と statistics の行までしか言えません。Guest Shell を戻した後に同じ操作を打った時の返事も撮っていません。


13. 止める操作

13.1 資料の登録の解除と suspend

CLI 章は、登録の解除を running-config からポリシーを外す作業とし、ポリシーの実行が取り消されると書いています。suspend は、全 EEM ポリシーの実行を直ちに止める作業で、登録を外す代わりに止める理由として、一時的な性能や安全を挙げています。

Perform this task to remove an EEM policy from the running configuration file. Execution of the policy is canceled.

(CLI 章「Unregistering Embedded Event Manager Policies」)

Perform this task to immediately suspend the execution of all EEM policies. Suspending policies, instead of unregistering them might be necessary for reasons of temporary performance or security.

(CLI 章「Suspending All Embedded Event Manager Policy Execution」)

event manager scheduler suspend Example: Device(config)# event manager scheduler suspend Immediately suspends the execution of all EEM policies.

(CLI 章「Suspending All Embedded Event Manager Policy Execution」)

suspend の手順の要約は exit で終わり、戻す手順はありません。取得した 8 章に no event manager scheduler suspend の語は 0 回でした(数えた)。

SUMMARY STEPS enable show event manager policy registered [description [policy-name ] | detailed policy-filename [system | user ] | [event-type event-name ] [system | user ] [time-ordered | name-ordered ]] configure terminal event manager scheduler suspend exit

(CLI 章「Suspending All Embedded Event Manager Policy Execution」)

Tcl 章の suspend の例は、投入の直後に %HA_EM-6-FMS_POLICY_EXEC の syslog の行が出る見本です。

The event manager scheduler suspend command is entered to immediately suspend the execution of all EEM policies: Device# configure terminal Device(config)# event manager scheduler suspend *Nov 2 15:34:39.000: %HA_EM-6-FMS_POLICY_EXEC: fh_io_msg: Policy execution has been suspended

(Tcl 章「Suspending EEM Policy Execution」)

CLI 章の release の手順は、hold の手順で保留にしたポリシーの実行を再開させる手順として書かれています。Action 章の action_script は、Tcl のスクリプトの実行(スクリプトのスケジューラ)を有効・無効にする action です。どちらも、suspend との関係は書かれていません。

To resume the execution of specified EEM policies, perform this task. In this task, the policy that was put on hold in the Holding a Scheduled EEM Policy Event or Event Queue task is now allowed to resume execution.

(CLI 章「Resuming Execution of EEM Policy Events or Event Queues」)

Allows a Tcl script to enable or disable the execution of all Tcl scripts (enables or disables the script scheduler).

(Action 章「action_script」)

13.2 suspend と run

本ラボの PH-b では、窓(16:56:39.887〜16:56:56.678)の中で event manager scheduler suspend を入れ、A75-NONE を run し、show event manager policy active と pending を撮りました。suspend の投入のエコーに % を含む行は 0 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の suspend の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#event manager scheduler suspend
CSR1(config)#end
CSR1#

suspend の間の run の逐語は空行 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-NONE

直後の show event manager policy active も空行 1 行でした。active に行が無いことからは、走り終えた・積まれた・捨てられた、を分けられません。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の active の表示は以下のとおりです。

snippet
CSR1# show event manager policy active

pending は EEM server has been suspended の 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の pending の表示は以下のとおりです。

snippet
CSR1# show event manager policy pending

EEM server has been suspended

窓の中の syslog の行は 2 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の窓の後の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:56:44.438: %HA_EM-7-FMS_POLICY_EXEC: fh_io_ipc_msg: Policy execution has been suspended
*Oct 26 16:56:47.688: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)

本ラボのこの run で、窓の中の FMS_POLICY_EXEC の行は 1 行で、%HA_EM-7-FMS_POLICY_EXEC の中央の数字は 7 です。窓の中に A75-NONE を含む行は 0 行でした(数えた)。後に撮った history は、この窓の時刻(16:56:49)の A75-NONE の行を Status abort で表示しています(§13.4)。

資料の見本の行(§13.1)は %HA_EM-6-FMS_POLICY_EXEC の 6 です。本ラボの 7 と並べ、どちらが正しいとは書きません。

13.3 戻し

取得した 8 章に no event manager scheduler suspend の語は 0 回です(§13.1)。

本ラボは、no event manager scheduler suspend を投入しました。投入のエコーに % を含む行は 0 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#no event manager scheduler suspend
CSR1(config)#end
CSR1#

その後の A75-NONE の run は、PA と同じ形の puts の行を返しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の run の逐語は以下のとおりです。

snippet
CSR1# event manager run A75-NONE
A75-NONE puts: event_type=none
A75-NONE cli_result begin

*16:57:11.552 UTC Mon Oct 26 2026
CSR1#
A75-NONE cli_result end

run の後には show event manager policy active(空行 1 行)と pending を撮りました。pending は空行 1 行でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の pending の表示は以下のとおりです。

snippet
CSR1# show event manager policy pending

戻しの後は show clock の対を撮っておらず、窓はありません。後の Log Buffer には、resumed の FMS_POLICY_EXEC の行(16:57:05.745)と、A75-NONE の syslog の action の行(16:57:11.331)が在りました(窓の外の行)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の PZ の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:56:44.438: %HA_EM-7-FMS_POLICY_EXEC: fh_io_ipc_msg: Policy execution has been suspended
*Oct 26 16:56:47.688: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)
*Oct 26 16:57:05.745: %HA_EM-7-FMS_POLICY_EXEC: fh_io_ipc_msg: Policy execution has been resumed
*Oct 26 16:57:09.019: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)
*Oct 26 16:57:11.331: %HA_EM-6-LOG: A75-NONE: A75-NONE syslog line
…(省略)

戻しの後の run の中の show clock(16:57:11.552)は、後の history の A75-NONE の行(16:57:11)と同じ時・分・秒でした。

13.4 history と statistics

PZ の show event manager history events は、job id 36〜43・45・46 の 10 行で、44 の行はありませんでした。Status は 9 行が success、job 45(suspend の窓の A75-NONE)が abort です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show event manager history events
No.  Job Id Proc Status   Time of Event            Event Type        Name
1    36     Actv success  Mon Oct26 16:50:16 2026  syslog            script: sl_p75.py 
2    37     Actv success  Mon Oct26 16:51:43 2026  none              applet: A75-PYSTD 
3    38     Actv success  Mon Oct26 16:54:17 2026  cli               applet: A75-CLI-ASYNC 
4    39     Actv success  Mon Oct26 16:54:21 2026  cli               applet: A75-CLI-ASYNC 
5    40     Actv success  Mon Oct26 16:54:26 2026  cli               applet: A75-CLI-SKIP 
6    41     Actv success  Mon Oct26 16:54:30 2026  cli               applet: A75-CLI-SYNC1 
7    42     Actv success  Mon Oct26 16:54:35 2026  cli               applet: A75-CLI-SYNC0 
8    43     Actv success  Mon Oct26 16:55:05 2026  cli               applet: A75-CLI-SYNC1 
9    45     Actv abort    Mon Oct26 16:56:49 2026  none              applet: A75-NONE 
10   46     Actv success  Mon Oct26 16:57:11 2026  none              applet: A75-NONE 

1 行目の job 36 は、B の Loopback78 の引き金(§12.9)の時刻の sl_p75.py の行です。statistics の A75-NONE の行は、Triggered が 3、Average Run Time が 886.652、Maximum Run Time が 2659.408 で、他の 10 行の Run Time(0.000〜6.740)の範囲の外でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の抜粋は以下のとおりです。

snippet
CSR1# show event manager statistics policy

                                       Average        Maximum        
No.  Class     Triggered   Suppressed  Run Time       Run Time       Name
-------------------------------------------------------------------------------
1    applet    3           0           886.652        2659.408       A75-NONE
 event {} none
…(省略)
10   applet    1           0           6.740          6.740          A75-PYSTD
 event {} none

11   script    0           0           0.000          0.000          no_p75.py
 event {} none

job id 44 が欠けた理由・job 45 の abort の理由・A75-NONE の Run Time の値が何を数えたかは、撮っていません。本ラボは event manager history size を設定しておらず、history の表示は毎回 10 行以下でした(§15.4)。


14. 本ラボで確かめていないこと

本ラボの実測は、csr1000v 17.03.08a(RAM 4096 MB)の 1 回の run の撮影です。以下は観測していません。

14.1 撮らなかったもの

  • AAA の下の設定。本ラボの day0 の設定(〔ツール側〕取得スクリプトが入れた設定)に aaa new-model の行は無く、機器の出力で aaa の設定は撮っていません。また、資料が AAA の command 単位の authorization の下の設定として書く event manager session cli username と、applet の authorization bypass は撮っていません(§4.3)
  • 受け手の要る action(action mail・snmp-trap)と、一覧に在るほかの event と action(§4.2)
  • absolute の timer・timer の name の指定・cron の別の書式(§8)
  • system のサンプルのポリシー 7 本の中身と、Client Policies の CH(CiscoTAC-1)の 8 行が何をするか(§4.3・§7.4)
  • event manager history size の設定と、既定の行数(§15.4)
  • run の引数の上限(資料の 15)・空白や引用符を含む引数・3 つ以上の引数・引数なしの時の $_none_arg1 の値(§5.6)
  • 非同期の applet の puts の行き先と、applet・Tcl・Python の maxrun を書かない時の既定(§5.3・§5.4・§11.1)
  • event syslog の occurs・period・priority の指定と、pattern の正規表現の規則(大文字と小文字・記号の扱い)(§7)
  • event cli の occurs・period・enter などの指定と、ほかの利用者・privilege 1・config モードから打った入力(§9)
  • sync no の applet とコマンドの実行の前後(§9.1)
  • tag を付けた複数の event の appletと、trigger・correlate の文(§5.1)
  • 空いている vty が 1 本以下になる状態と、cli_open の 3 本目(§10.7・§10.8)
  • action cli のセッションの権限の水準(§10.5)
  • Safe-Tcl の exec・pwd 以外のコマンドと、type system・secure-mode などを付けた登録(§11.3・§11.7)
  • Python のポリシーの本文がどこで走ったか、timer と cli の event の Python のポリシー、ポリシーの中と外の eem の中身の違い、標準のスクリプトから eem の API を呼んだ時(§12)
  • pnp_python の profile が何のためのものかと、最初の Guest Shell の操作の前に在ったか(§3.3)
  • Guest Shell を戻した後の登録の解除と、PH の後の registered(§12.12)
  • suspend のほかの形と、hold・release(§13)
  • logging buffered を同じ水準で入れ直した時(§15.1)
  • 別の機種と、同じ手順を繰り返した時に同じ値になるか

14.2 撮れなかったもの

  • debug event manager multi-lang の下の Python のポリシーの run。設計では、Python のポリシーの run をこの debug の下で撮る予定でした。P0 の debug event manager multi-lang の ? のヘルプの項目は action・cli・common・event・msg の 5 つで、<cr> の行は 0 行でした(数えた)。取得スクリプトの規則(<cr> が無ければ流さない)で、この debug は入れていません(〔ツール側〕)

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の debug event manager multi-lang の ? のヘルプは以下のとおりです。

snippet
CSR1# debug event manager multi-lang ?
  action  Debug Event Manager multi-lang action
  cli     Debug Event Manager multi-lang cli
  common  Debug Event Manager multi-lang common
  event   Debug Event Manager multi-lang event
  msg     Debug Event Manager multi-lang msg

CSR1#debug event manager multi-lang 
…(省略)
  • Python のポリシーの print の行と eem.action_syslog の行の行き先。A と B の no_p75.py・sl_p75.py・U3・U3’ の run の逐語と、各窓の中の syslog に、print と action_syslog の文字列の行は 0 行でした(§12.3〜§12.9)。どこに出たか(出なかったか)は撮れていません

15. 落とし穴・補足

15.1 logging buffered の投入し直しと Log Buffer

本ラボは、run の最後(PZ-b)に、send log 6 で印の行を出してから、logging buffered 512000 informational(サイズは同じで水準だけ変えた形)を投入しました。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の send log の逐語は以下のとおりです。

snippet
CSR1# send log 6 P75PZB before

投入の前の全体の logging の最後の行は、印の行(16:57:59.857)です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入の前の show logging の抜粋は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:57:59.857: %SYS-6-USERLOG_INFO: Message from tty2(user id: netops): P75PZB before

CSR1(csr1000v 17.03.08a・RAM 4096 MB)の投入のエコーは以下のとおりです。

snippet
configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
CSR1(config)#logging buffered 512000 informational
CSR1(config)#end
CSR1#

投入した後の全体の logging は、Buffer logging の見出しが level informational, 2 messages logged に変わり、Log Buffer の時刻つきの行は 2 行(投入の %SYS-5-LOG_CONFIG_CHANGE の行と %SYS-5-CONFIG_I の行)でした。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の表示は以下のとおりです。

snippet
CSR1# show logging
Syslog logging: enabled (0 messages dropped, 3 messages rate-limited, 0 flushes, 1 overruns, xml disabled, filtering disabled)

No Active Message Discriminator.



No Inactive Message Discriminator.


    Console logging: level debugging, 299 messages logged, xml disabled,
                     filtering disabled
    Monitor logging: level debugging, 0 messages logged, xml disabled,
                     filtering disabled
    Buffer logging:  level informational, 2 messages logged, xml disabled,
                    filtering disabled
    Exception Logging: size (4096 bytes)
    Count and timestamp logging messages: disabled
    Persistent logging: disabled

No active filter modules.

    Trap logging: level informational, 170 message lines logged
        Logging Source-Interface:       VRF Name:
    TLS Profiles: 

Log Buffer (512000 bytes):

*Oct 26 16:58:06.661: %SYS-5-LOG_CONFIG_CHANGE: Buffer logging: level informational, xml disabled, filtering disabled, size (512000)
*Oct 26 16:58:09.935: %SYS-5-CONFIG_I: Configured from console by netops on vty1 (192.168.1.65)

本ラボのこの run では、投入の前の時刻つきの行(218 行)と同じ行は、投入し直した後の表示に 0 行でした(数えた)。本ラボの run は、この 1 回のほかは途中で logging buffered を投入し直さない設計で撮り、logging の事実を時刻の窓で切りました(§3.2)。同じ水準で入れ直した時は撮っていません。

15.2 パースが通らないコマンドと CLI の event

Overview 章の文は、CLI の event の照合を、パースに成功した後・実行の前に置いています(§9.1)。本ラボは、引き金のコマンドを、登録前に打って正の出力が返ることを確かめてから使いました(§9.2。show privilege は Current privilege level is 15)。パースが通らないコマンドを引き金にした形は撮っていません。

15.3 history の success と出力

Python のポリシーの run は、history の Status が success で、run の逐語と窓の中の syslog には print と action_syslog の文字列の行が 0 行でした(§12.3〜§12.9)。history の Status と、ポリシーの本文の出力が端末や syslog に出たかは、別の記録として並べます。本ラボでは、U2 のファイル(§12.7)のように、本文が書いたものを別の場所で読む形で確かめました。

15.4 history の行数

CLI 章の history の手順は、event manager history size で表の大きさを変える例(30 件)を載せていますが、既定の件数は書いていません。

event manager history size {events | traps } [size ] Use this command to change the size of the EEM event history table or the size of the EEM SNMP trap history table. In the following example, the size of the EEM event history table is changed to 30 entries: Example: Device(config)# event manager history size events 30

(CLI 章「Displaying Embedded Event Manager History Data」)

本ラボは history size を設定しておらず、show event manager history events の表は最大で 10 行でした。10 行を超えた後は、古い job id の行が表示に無くなりました(例: PD の debug の窓の前の表に job 7 の行は 0 行。数えた)。本ラボは、撮りたい run の history を、その run の直後に撮る順にしました。表示の 10 行を既定の値だとは書きません。

15.5 .py のポリシーの登録と guestshell disable

Guest Shell を disable にした後に .py のポリシーの登録を外す操作を打つと、機器は guestshell is in disabled state と Unknown policy extension found の 2 行を返し、その後の running-config に登録の行が残っていました(§12.12)。.py のポリシーを外す操作と disable の順を組む時の罠として、ここに再掲します。

15.6 CLI library の debug の綴り

Tcl 章には、CLI library の debug のコマンドをハイフンの cli-library と書く文と、下線の cli_library と書く文があります。Debug 章の cli_debug の説明は、下線の cli_library です。

Use the debug event manager tcl cli-library CLI command to debug issues with the CLI library.

(Tcl 章「Troubleshooting Tips」)

The command to enable CLI library debugging is debug event manager tcl cli_library . When enabled, this command displays all data that is passed in and read back from the TTY session that handles the CLI interactions.

(Tcl 章「Debugging the CLI Library」)

Prints a command-line interface (CLI) debug statement to syslog. This Tcl command extension is used to print a CLI debug statement to syslog if the debug event manager tcl cli_library Cisco IOS CLI command is in effect.

(Debug 章「cli_debug」)

本ラボの機器の debug event manager tcl の ? のヘルプの項目は cli_library の綴りで、debug event manager tcl cli_library は受理の行を返しました(§11.4)。CSR1(csr1000v 17.03.08a・RAM 4096 MB)のヘルプは以下のとおりです。

snippet
CSR1# debug event manager tcl ?
  cli_library   Debug Event Manager tcl cli library
  commands      Debug Event Manager tcl commands
  smtp_library  Debug Event Manager tcl smtp library

CSR1#debug event manager tcl 
…(省略)

ハイフンの綴りを打った時の応答は撮っていません。

15.7 資料と実機が割れた所の一覧

両方を並べた所は以下のとおりです。どれも、どちらが正しいとは書いていません。

項目資料本ラボ(csr1000v 17.03.08a・RAM 4096 MB の 1 回の run)場所
ポリシーの種類と言語17.x の章は applet と Tcl。17.3 の Python 章は Python もポリシーとして登録できる.py を登録し、Class script・Type user と表示された§2.3・§12.3
空の applet を抜けた時警告が出る・抜けた時に消える端末に警告の行は無く、running-config にも行が無い§5.2
applet の Type の表示見本は systemuser§5.3
event manager run を打つモード特権 EXEC と書く文と、global configuration mode と書く文がある特権 EXEC で走り、global config では % Invalid input§5.5・§11.4
action の実行順ラベルの辞書順(4 か所)と、変数の論理の前は設定した順(条件つき)表示の順と出力の順が同じ(1.0 → 10.0 → 2.0)で、投入の順と違う§6.1
syslog の見本の行の組%LINK-5-CHANGED に Line protocol の本文%LINK-5-CHANGED に administratively down の本文§7.1・§7.2
2 本目の cli_open の失敗の返事の数CLI Library 章の冒頭の vty の段落の 3 文目(§10.1 の番号)は、EEM が既に vty を使っている時は空き 3 本以上(three or more)で使うと書くTcl の 2 本目の cli_open は空き 3 本で開き、空き 2 本で開かなかった。失敗の返事の末尾は minimum of 2 required by EEM§10.8
type を省いた時の既定書かれていない。type を省いた登録の例は、利用者のポリシー(libtest.tcl)と、system のポリシーとして入っている見本(sl_intf_down.tcl ほか)の両方にある省いた登録の行が Type user§11.1・§11.3
Tcl の puts の出方config から run した見本は %HA_EM-6-LOG・syslog で発火する見本は <ファイル名>[0]:特権 EXEC の run は端末・syslog で発火した時は %HA_EM-6-LOG: <ファイル名>:§11.4・§11.5
%HA_EM-6-LOG の行の接頭辞見本のポリシーの注釈(no_perf_test_init.tcl の run の行)は eem_policy/ 付き・libtest.tcl の puts の行は無しaction_syslog の行は no_t75.tcl: で、eem_policy/ は無し§11.4
syslog の event の priority省いた時の既定は 0priority を書かない sl_t75.tcl で、pattern の文字列を含む行は %LINK-5-CHANGED の 1 行。その 0.194 秒後に sl_t75 fired の行が在り、history は syslog・success§11.5
user policy の directoryTcl 章は Tcl のポリシーだけ・Python 章は .py にも使う.py も bootflash:/eem75 と bootflash:/guest-share の両方で登録された§11.1・§12.3・§12.9
eem の API の名前API の一覧は eem_cli_・eem_event_reqinfo ()・eem_user_variables()。見本のスクリプトは eem.action_syslog・eem.env_reqinfo() を呼ぶ属性の名前は cli_open・event_reqinfo・env_reqinfo など§12.1・§12.11
標準のスクリプトの eemEEM のスクリプトの中だけで使え、標準のスクリプトでは使えない標準のスクリプトの import は警告の行の後に通り、属性の名前を 22 個表示した。API を呼ぶ操作は撮っていない§12.11
suspend の syslog の行%HA_EM-6-FMS_POLICY_EXEC%HA_EM-7-FMS_POLICY_EXEC§13.2
debug の綴りcli-library と cli_libraryヘルプは cli_library§15.6

15.8 表示の日付

show event manager policy available user の Time Created の年は 1956(§11.3)、system のサンプルの Time Created は Thu Feb 7 06:28:15 2036(§4.3)でした。Guest Shell の有効化の syslog の行は、行頭の日付が Oct 26 で、行の中の日付が 09/26/2026 です。CSR1(csr1000v 17.03.08a・RAM 4096 MB)の行は以下のとおりです。

snippet
CSR1# show logging
…(省略)
*Oct 26 16:37:31.674: %IM-6-IOX_INST_INFO: R0/0: ioxman: IOX SERVICE guestshell LOG: Guestshell is up at 09/26/2026 16:37:31

show clock の日付は Mon Oct 26 2026 です。どの日付の表示も、並べるだけで理由は調べていません。

15.9 そのまま写すと形が崩れる原典の見本

資料の見本には、そのまま写すと形が崩れる箇所があります。形が崩れる箇所は、見本のまま引いて注記します。

全角の引用符(“ ”)を使った見本の行は、CLI 章に 10 行(applet の設定の行)、Tcl 章に 3 行(Tcl のスクリプトの行)あります(数えた。地の文の行は除く)。Tcl 章の 3 行のうち 1 行には、閉じる引用符がありません。CLI 章の 10 行には、次の action syslog の例と、if / else の手順の例が含まれます。

Device(config-applet)# action 1.0 syslog priority errors facility EEM-FAC message “TEST MSG”

(CLI 章「Registering and Defining an Embedded Event Manager Applet」の手順)

Device(config-applet)# action 3.0 puts “$x is less than 10”

(CLI 章「Specifying if else Conditional Blocks」)

Python 章の環境変数を出す見本は、戻りを c に入れ、定義していない a を回しています。

c = eem.env_reqinfo()

(Python 章「Python Script: eem_script.py」)

for i,j in a.iteritems() :

(Python 章「Python Script: eem_script.py」)

同じ章の標準のスクリプトの見本は、if と else の中の行に字下げがありません(行頭に空白なし)。Python は字下げでブロックを決めるので、このまま写すと形が崩れます。

if intf == ’loopback55’: configurep([“interface loopback55”,“no shutdown”,“end”]) else : cmd=‘int %s,no shut ,end’ % intf configurep(cmd.split(’,’))

(Python 章「Python Script: eem_script.py」)

CLI Library 章の cli_write の使い方の見本は、catch の後に } が 1 つ余り、if の本体を閉じる } が無いまま次の節に移ります。

if [catch {cli_close $cli1(fd) $cli1(tty_id)} } result] { puts stderr $result exit 1

(CLI Library 章「cli_write」)

CLI 章の action の一覧表は、action end を if / else と while のブロックの終わりとしていますが、if / else の手順の最後の Step 9 の例は、Device(config-applet)# end の形です。

action end Specifies the identification of the end of an conditional action block in the if / else and while conditional action block when an EEM applet is triggered.

(CLI 章「Table 6. Available action commands」)

Event Registration 章の event_register_none の表(と RPC の表)は、arg4 の次が arg6 で、arg5 の行がありません。CLI 章の None Event Detector の表には _none_arg5 の行が在ります。

CLI 章の None Event Detector の表の _event_id の説明は、OIR Event Detector の表の _oir_event の説明と同じ文です。

A value of 1 indicates an insertion event; a value of 2 indicates a removal event.

(CLI 章「None Event Detector」)

CLI 章の event snmp-object の節の maxrun の説明は、構文に無い milliseconds の引数を書き、applet を apple と綴っています。

The milliseconds argument is the maximum runtime of the apple in milliseconds. If the argument is not specified, the default 20-second run-time limit is used.

(CLI 章「Configuring Event SNMP Object」)

15.10 見本どうしの食い違い

Python 章の見本どうしでは、同じスクリプトの置き場とインタフェースの名前の書き方が違います。CLI で走らせる見本は guestshell run python3 /flash/eem_script.py loop55 の形で、applet の見本は /bootflash/eem_script.py loop55 の形です(§12.1)。スクリプトの本文は 'loopback55' と比べ、引数の見本は loop55 です。

同じ章の環境変数を出す見本は、print "EEM Environment Variables" のように、print を括弧なしで書いています。7-4 §13.5 の Guest Shell の python3 は Python 3.6.8 で、本ラボの U2 のファイルの python= の行も 3.6.8 でした(§12.7)。2 つを並べるだけにします。


16. まとめ

資料は、EEM を、機器の中の event detector が event を検出し、ポリシーの action で回復する仕組みとしています。17.x の EEM の章はポリシーを applet と Tcl の 2 種類と書き、17.3 の Python 章は Python のスクリプトもポリシーとして登録できると書いています(§2)。csr1000v 17.03.08a(RAM 4096 MB)の show event manager version は Embedded Event Manager Version 4.00 で、event detector は 28 行でした(§4)。

本ラボの applet は Type user で表示され、どの event の applet にも maxrun 20.000 の行が付き、event none の applet には policyname {…} sync {yes} の行も付きました。event manager run の puts の行は端末の逐語に、action syslog の文字列は %HA_EM-6-LOG の行に在りました。global config からの run は % Invalid input でした。action の出力の順は 1.0 → 10.0 → 2.0 で、running-config の表示の順と同じでした(§5・§6)。

syslog の event の applet A75-SYSLOG-LO の窓では、Loopback75 の administratively down の行の 0.005 秒後に A75-SYSLOG-LO の %HA_EM-6-LOG の行が在り、その後に (EEM:A75-SYSLOG-LO) の vty0 の CONFIG_I の行と up の行が並びました(§7)。timer は、窓の中の watchdog の 5 行が約 30 秒おきで、撮った cron の 3 行は、どれも秒の部分が 00.001 でした(§8)。CLI の event は、短縮形の sh inventory も show inventory として記録し、skip yes の show privilege と _exit_status 0 の show history は出力が空行 1 行でした(§9)。

A75-VTY の 3 回の run では、run の中の show users に EEM の vty の行が 1 本ずつ在りました。debug event manager action cli の行は、Tcl の CLI library の見本と同じ DEBUG(cli_lib) の名前で入出力を表示しました。本ラボのこの run で、EEM は空き 2 本の状態から 1 本目の vty を使い、Tcl のポリシーの 2 本目の cli_open は空き 3 本で開いて空き 2 本で開きませんでした(§10)。本ラボのこの run では、Tcl のポリシーは type を省いた登録も Type user と表示され、maxrun 5 の打ち切りは history の abort、no_t75safe.tcl の exec と pwd は invalid command name の形の拒否の行を返しました(§11)。

Python のポリシーは、登録と history の success は撮れましたが、print と action_syslog の行の行き先は撮れませんでした。ファイルを書くポリシーは Guest Shell の /tmp と guest-share に host=guestshell・python=3.6.8・uid=1000 の行を書き、action_syslog の前後の印のファイルは、1 引数・3 引数とも -imported の次が NameError の行でした。Guest Shell を disable にした後は、.py の登録を外す操作が 2 行の返事を返しました(§12)。本ラボのこの run で、suspend の間の pending は EEM server has been suspended で、窓の中に %HA_EM-7-FMS_POLICY_EXEC の行が在り、no event manager scheduler suspend の後の run は puts の行を返しました(§13)。確かめていないことは §14 にまとめてあります。


17. 次節(7-6 Day 0 ZTP)

本節の EEM は、設定が入った後の機器の上で、syslog の行・timer・CLI のコマンドと event manager run を契機に、登録したポリシーを動かしました。次節 7-6 は、初期設定を自動で入れる Day 0 ZTP を扱います。

本節が設定の入った後の機器の上の仕組みだったのに対し、次節は設定が入る前(Day 0)の機器に初期設定を入れる仕組みです。次節では、Day 0 ZTP の仕組みを見ていきましょう。


18. 出典

本節が参照した資料です。引用の原典 8 章(17.x の EEM の 7 章と、17.3 の EEM Python Module 章)を 2026 年 10 月 25 日に取得しました。本文中の > の引用は、表の参照日の時点のページのテキストの逐語です。

CSR1 は csr1000v 17.03.08a なので、EEM の設定の章は IOS XE 17.x の System Management Configuration Guide から、Python のポリシーは 17.3.x の Programmability Configuration Guide から取りました。IOS XE 17 の EEM の本の URL は、取得の時に 17.x の System Management Configuration Guide の目次のページへ移りました(表の最後の行・リダイレクトの記録)。17.x の 7 章の本文に 17.3 の語は 0 回です(数えた)。17.x の Embedded Event Manager の章は 15 章で、本節はそのうち 7 章を取りました。本文の「資料に無い」「資料は書いていない」は、取得した 8 章の中での話です。

目次の 2 ページとリダイレクトの記録は、章の資料名と URL の出所で、> の引用の原典ではありません。

資料版・更新日(資料の表記)参照日URL
System Management Configuration Guide, Cisco IOS XE 17.x — Chapter: Embedded Event Manager OverviewIOS XE 17.x・Updated: August 21, 20232026-10-25https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management/m_eem-overview.html
System Management Configuration Guide, Cisco IOS XE 17.x — Chapter: Writing Embedded Event Manager Policies Using the Cisco IOS CLIIOS XE 17.x・Updated: August 21, 20232026-10-25https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management/m_eem-policy-cli.html
System Management Configuration Guide, Cisco IOS XE 17.x — Chapter: Writing Embedded Event Manager Policies Using TclIOS XE 17.x・Updated: August 21, 20232026-10-25https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management/m_eem-policy-tcl.html
System Management Configuration Guide, Cisco IOS XE 17.x — Chapter: EEM Event Registration Tcl Command ExtensionsIOS XE 17.x・Updated: August 21, 20232026-10-25https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management/m_eem-event-reg-tcl.html
System Management Configuration Guide, Cisco IOS XE 17.x — Chapter: EEM Action Tcl Command ExtensionIOS XE 17.x・Updated: August 21, 20232026-10-25https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management/m_eem-action-tcl.html
System Management Configuration Guide, Cisco IOS XE 17.x — Chapter: EEM CLI Library Command ExtensionsIOS XE 17.x・Updated: August 21, 20232026-10-25https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management/m_eem-cli-library-tcl.html
System Management Configuration Guide, Cisco IOS XE 17.x — Chapter: EEM Library Debug Command ExtensionsIOS XE 17.x・Updated: August 21, 20232026-10-25https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management/m_eem-debug-tcl.html
Programmability Configuration Guide, Cisco IOS XE Amsterdam 17.3.x — Chapter: EEM Python ModuleIOS XE Amsterdam 17.3.x・Updated: July 31, 20202026-10-25https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/prog/configuration/173/b_173_programmability_cg/eem_python_module.html
System Management Configuration Guide, Cisco IOS XE 17.x — 本の目次のページ(Embedded Event Manager の 15 章の一覧。引用の原典ではない)IOS XE 17.x(取得したテキストに Updated の行は無い)2026-10-25https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management.html
Programmability Configuration Guide, Cisco IOS XE Amsterdam 17.3.x — 本の目次のページ(Shells and Scripting の 4 章の一覧。引用の原典ではない)IOS XE Amsterdam 17.3.x(取得したテキストに Updated の行は無い)2026-10-25https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/prog/configuration/173/b_173_programmability_cg.html
IOS XE 17 の EEM の本の URL(リダイレクトの記録。引用の原典ではない)HTTP 200・移った先は上の 17.x の目次のページ2026-10-25https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/eem/configuration/xe-17/eem-xe-17-book.html → https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/syst-mgmt/b-system-management.html