HP StorageWorks Fabric OS 5.3.x administrator guide (5697-0244, November 2009)

344 Administering Advanced Performance Monitoring (APM)
Example: Add filter-based monitors to slot 1, port 2 and displays the results
Adding custom filter-based monitors
In addition to the standard filters—read, write, read/write, SCSI frame and IP frame—you can create
custom filters to gather statistics that fit your needs.
To define a custom filter, use the perfAddUserMonitor command. With this command, you must
specify a series of
offsets
,
masks
, and
values
. For all transmitted frames, the switch performs these tasks:
Locates the byte found in the frame at the specified
offset.
Applies the
mask
to the byte found in the frame.
Compares the value with the given
values
in the perfAddUserMonitor command.
Increments the filter counter if a match is found.
The following number of offsets can be specified:
NOTE: Bloom-based switches provide 2 unique unused offsets per port for user-defined filter monitors
other than the 6 offsets already reserved for pre-defined filter monitors. Condor-based switches provide 15
unused offsets per port.
To illustrate, if you were to enter:
perfaddusermonitor 30 “4, 0xff, 0x06; 6, 0xff, 0x02; 7, 0xff, 0xd4”
The operation would be successful because offset 4 is a canned monitor and has a resource already
reserved for it. Offsets 6 and 7 would exhaust all unique filter monitor resources on port 30. Therefore, any
additional filter monitors created on port 30 would have to be canned filter monitors.
SAN Switch 2/8V, SAN Switch 2/16V, SAN Switch 2/32 and SAN Director 2/128 models (Fabric OS
v4.0.0 or later)
Up to two different offsets per port (one offset when FICON management server mode (FMS)
is enabled).
4/64 SAN Switch, 400 MP Router and 4/256 SAN Director models (Fabric OS 5.1.0b minimum)
Up to 15 different offsets per port (14 offsets when fmsmode is enabled).
HP StorageWorks SAN Switch 2/8 EL, SAN Switch 2/16 (Fabric OS v3.0.0 or later)
Up to three different offsets per port.
SAN Switch 4/32, SAN Switch 4/32B models (Fabric OS v4.4.0 or later)
Up to 15 different offsets per port (14 offsets when FMS is enabled).
switch:admin> perfaddreadmonitor 1/2
SCSI Read filter monitor #0 added
switch:admin> perfaddwritemonitor 1/2
SCSI Write filter monitor #1 added
switch:admin> perfaddrwmonitor 1/2
SCSI Read/Write filter monitor #2 added
switch:admin> perfaddscsimonitor 1/2
SCSI traffic frame monitor #3 added
switch:admin> perfaddipmonitor 1/2
IP traffic frame monitor #4 added
switch:admin> perfmonitorshow --class FLT 1/2
There are 5 filter-based monitors defined on port 2.
KEY ALIAS OWNER_APP OWNER_IP_ADDR FRAME_COUNT
----------------------------------------------------------------
0 SCSI Read TELNET N/A 0x0000000000000000
1 SCSI Write TELNET N/A 0x0000000000000000
2 SCSI R/W TELNET N/A 0x0000000000000000
3 SCSI Frame TELNET N/A 0x0000000000000000
4 IP Frame TELNET N/A 0x0000000000000000