FilterByIP

Wed May 27 04:16:49 EDT 2009

This handler compares an IP address within an alert (from a parsed variable that you name) to a list of filters (address ranges). You can use this handler to create include/exclude logic for paging according to IP address domains.

An instance of this handler contains one or more filters. Each filter an IP address range.

When this handler is called, it at compares all the IP ranges you defined to the the variable you named in the "variable" property. The variable is parsed as an IP address, and then tested against the list of ranges. The variable must contain the dot-notation numberic IP address, e.g. "127.0.0.1"

If the IP address matches a range, the handler returns true; otherwise false. However, if there was a problem parsing the IP address in the variable, the handler returns the value of the "valueIfVariableNotFound" property.

Ranges for each of four octets in the IP address can be a single number, multiple numbers with commas, or ranges using hyphens. The following example will ultimately match any number between 1 and 10:

1,2,3-6,7,8-10