Adding Custom Filter-Based Monitors - HP A7533A - Brocade 4Gb SAN Switch Base Administrator's Manual

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
----------------------------------------------------------------
0 SCSI Read
1 SCSI Write TELNET
2 SCSI R/W
3 SCSI Frame TELNET
4 IP Frame

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.
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 4/32, 4/64 SAN Switch, SAN Switch 4/32B, 400 Multi-protocol Router, 4/256 SAN
Director, and DC Director models
Up to 15 different offsets per port (14 offsets when FICON Management Server mode, or fmsmode, is
enabled).
• 4/8 SAN Switch, 4/16 SAN Switch and Brocade 4Gb SAN Switch for HP p-Class BladeSystem models
Up to 7 different offsets per port (6 offsets when fmsmode is enabled).
You can specify up to four values to compare against each offset. If more than one offset is required to
properly define a filter, the bytes found at each offset must match one of the given values for the filter to
increment its counter. If one or more of the given offsets does not match any of the given values, the counter
does not increment. The value of the offset must be between 0 and 63, in decimal format. Byte 0 indicates
the first byte of the Start of Frame (SOF), byte 4 is the first byte of the frame header, and byte 28 is the first
byte of the payload. Thus only the SOF, frame header, and first 36 bytes of payload can be selected as
part of a filter definition. Offset 0 is a special case, which can be used to monitor the first 4 bytes of the
350 Administering Advanced Performance Monitoring
OWNER_APP FRAME_COUNT
TELNET 0x0000000000000000
0x0000000000000000
TELNET 0x0000000000000000
0x0000000000000000
TELNET 0x0000000000000000
OWNER_IP_ADDR
N/A
N/A
N/A
N/A
N/A