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