The zone server database is constantly monitored by NX-OS. When the threshold of any of the monitored zone database parameters
is exceeded an Embedded Event Manager (EEM) event is triggered. This is used to generate an EEM action for the event. To override
the system default thresholds at which each parameter triggers an EEM event, use the event zone command.
event zone {zones max-per-switch
| zonesets
max-per-switch
| zonemembers max-per-switch
| dbsize max-per-vsan
|
zone-member-ratio
} count
no event zone {zones max-per-switch
| zonesets max-per-switch
| zonemembers max-per-switch
| dbsize max-per-vsan
|
zone-member-ratio
} count
Syntax Description
zones
|
Specifies the total number of configured zones at which to trigger an Embedded Event Manager event.
|
zonesets
|
Specifies the threshold zoneset count at which to trigger an Embedded Event Manager event.
|
zonemembers
|
Specifies the total number of zone members at which to trigger an Embedded Event Manager event.
|
dbsize
|
Specifies the threshold zone database size in bytes at which to trigger an Embedded Event Manager event.
|
max-per-switch
|
Configures the number of allowed zones on the switch.
|
max-per-vsan
|
Configures the value for each VSAN.
|
zone-member-ratio
|
Specifies the threshold zone member ratio of a device at which to trigger an Embedded Event Manager event. The range is 2
to 2000.
|
count
|
Specifies the threshold value.
|
Command Default
This feature is not configured by default.
Command Modes
EEM applet configuration (config-applet).
Command History
Release
|
Modification
|
8.5(1)
|
Added the zone-member-ratio keyword.
|
6.2(11)
|
This
command was introduced.
|
Usage Guidelines
By default, zoning resource alert thresholds are controlled by system EEM policies. These are:
Policy Name |
Default Value |
Default Action |
__zone_zones_max_per_sw
|
16000 for the switch
|
syslog
|
__zone_zonesets_max_per_sw
|
1000 for the switch
|
syslog
|
__zone_members_max_per_sw
|
32000 for the switch
|
syslog
|
__zone_dbsize_max_per_vsan
|
4000000 bytes per VSAN
|
syslog
|
__zone_member_ratio
|
8 peers per device
|
syslog
|
Fan-out ratio is the number of target ports zoned to a single initiator. Fan-in ratio is the number of initiators zoned to
a single target port. Zone member ratio is a superset of fan-out and fan-in ratios.
These policies log
syslog messages when preconfigured thresholds are reached to alert the user of
high resource usage by the zone service. The thresholds and actions may be over
ridden by the user or the actions augmented by further actions (such as sending
an SNMP trap).
Examples
This example shows the default system per VSAN maximum zone database size EEM policy and, overrides the database size alert
threshold and shows the new policy information.. The default action is retained.
switch# show event manager system-policy __zone_dbsize_max_per_vsan
Name : __zone_dbsize_max_per_vsan
Description : Syslog warning when Zone database size exceeds the max limit of 4000000 bytes for a vsan.
Overridable : Yes
switch# configure terminal
switch(config)# event manager applet newzonedb override __zone_dbsize_max_per_vsan
switch(config-applet)# event zone dbsize max-per-vsan 1000000
switch(config-applet)# action 1.0 policy-default
switch(config-applet)# end
switch# show ev man policy internal newzonedb
Name : newzonedb (overrides __zone_dbsize_max_per_vsan)
Policy Type : applet
Event Specification : event zone dbsize max-per-vsan 1000000
action 1.0 policy-default
Event Specification active on : Active
This example shows how to configure and activate an EEM applet to override the maximum zone count on a system. The default
action is overridden by an action to generate a syslog message.
switch# configure terminal
switch(config)# event manager applet zonemaxsw override __zone_zones_max_per_sw
switch(config-applet)# action 1.0 syslog priority informational msg "zone zonemaxswitch override"
switch(config-applet)# end
This example shows how to configure and activate an EEM applet to override the maximum zoneset count on a system. The default
action is overridden by an action to generate a syslog message.
switch# configure terminal
switch(config)# event manager applet zonesetmaxsw override __zone_zonesets_max_per_sw
switch(config-applet)# action 1.0 syslog priority informational msg "zone zonesetmaxswitch override"
switch(config-applet)# end
This example shows how to configure and activate an EEM applet called zoneratio to override the default system policy and configure the zone member ratio limit to 20. The default action, syslog, is retained.
switch# configure terminal
switch(config)# event manager applet zoneratio override __zone_member_ratio
switch(config-applet)# event zone zone-member-ratio 20
switch(config-applet)# action 1.0 policy-default
switch(config-applet)# end