Fmmonitor - Brocade Communications Systems Brocade 8/12c Command Reference Manual

fmMonitor

Manages frame monitor configuration.
SYNOPSIS
fmmonitor --create frame_type -pat bit_pattern
[-port port_list] [-highth value]
[-action actions] [-timebase time_base] [-nosave]
fmmonitor --delete frame_type
fmmonitor --show [frame_type] [-port port_list | -all]
[-timeinterval interval]
fmmonitor --change frame_type [-pat bit_pattern]
[-highth value] [-action actions][-timebase time_base]
fmmonitor --addmonitor frame_type -port port_list [-nosave]
fmmonitor --delmonitor frame_type [-port port_list] [-nosave]
fmmonitor --clear frame_type -port port_list
fmmonitor --save frame_type
fmmonitor --help
DESCRIPTION
Use this command to configure, install, and display frame monitors across port ranges on a switch. This
command supports predefined and user-defined names for frame types defined by their offset, bit mask,
and frame values. For each frame type you can configure a threshold and specify one or more alert
mechanisms, such as RAS log, SNMP trap and email.
Frame monitors count the number of frames transmitted through a port that match specific values in the
first 64 bytes of the frame. Because the entire Fibre Channel frame header and many upper protocol (for
example, SCSI) headers fall within the first 64 bytes of a frame, frame monitors can detect different types
of traffic transmitted through a port. Each frame monitor keeps a timestamp of its last refresh. It also
keeps a generation count, which is incremented each time the monitor is cleared.
Frame monitors generate alerts whenever the frame count for a certain frame type crosses the threshold
configured for that frame type. You can configure high thresholds for every frame type, specify actions to
be taken when the threshold is exceeded, and configure how often the data are sampled. When you
create a new frame type without specifying the events, a generic filter monitor configuration for
generating events is applied.
The fmMonitor command supports basic Fabric Watch configurations for frame monitors. Use thConfig
with the FILTER class for more advanced configurations.
When you create, add, or delete a monitor, the changes are saved persistently by default. Use the
-nosave option with --create, --addmonitor, and --delmonitor to override the default behavior.
NOTES
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in
place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for
details.
The number of monitors supported per port is platform-specific. Refer to the Fabric OS Administrator's
Guide for more information.
Fabric OS Command Reference
53-1001764-01
22
fmMonitor
367