Owner's manual

Advanced Performance Monitoring User’s Guide 3-9

Using Advanced Performance Monitoring

Adding User-Defined Filter-Based Monitors

In addition to the standard filters (read, write, read/write, and frame count), you can create custom

filters to qualify frames for statistics gathering to fit your own special needs.

To define a custom filter, use the perfAddUserMonitor telnet command. With this command, you

must specify a series of offsets, masks, and values. The following actions are performed. For all

incoming frames, the switch:

• 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

You can specify up to six different offsets for each port, and 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 0 or must be between 4–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 may 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 frame (SOF). When

the offset is 0, the values are from 0–7, indicating the following:

sw1:admin> perfAddReadMonitor 2

SCSI Read filter monitor #0 added

sw1:admin> perfAddWriteMonitor 2

SCSI Write monitor #1 added

sw1:admin> perfAddRWMonitor 2

SCSI Read/Write monitor #2 is added

sw1:admin> perfAddSCSIMonitor 2

SCSI traffic frame monitor #3 added

sw1:admin> perfAddIPMonitor 2,

IP traffic frame monitor #4 added

sw1:admin> perfShowFilterMonitor 2

There are 5 filter-based monitors defined on port 2.

KEY ALIAS OWNER_APP OWNER_IP_ADDR FRAME_COUNT

----------------------------------------------------------------

0 SCSI_RD TELNET N/A 0x0000000000000000

1 SCSI_WR TELNET N/A 0x0000000000000000

2 SCSI_RW TELNET N/A 0x0000000000000000

3 SCSI_Frame TELNET N/A 0x0000000000000000

4 IP_Frame TELNET N/A 0x0000000000000000