Foglight 6.3.0 - Web Component Guide

Comparison

This is the most common type of condition. A comparison consists of:

The path on the left of the operator is compared to whatever is selected on the right of the operator, using the selected operator.

The operator can be:

For the ‘=’, ‘!=’ and ‘like’ operators, the case insensitive attribute applies (the corresponding check box is enabled). Note that the case insensitive attribute will only be used if both the right hand and left hand values are strings.

The comparison value is set in one of two ways:

You can use the value of the parameter. You can also drill down to a lower-level path in the parameter’s type by selecting a node from the Path drop-down tree.

For example, if you are selecting Hosts, and want to only select one host named MainServer, you would enter the path of name, the operator =, and the specific value MainServer.

When the in operator is used, the value on the right must be a list. This can occur when parameters are used. The comparison is true for a given data object if the value in the Path field is contained in the list specified by the From Parameter field on the right.

The like operator is used for wildcard matching, and behaves exactly as it does in standard SQL. The pattern of characters and wildcards in the right field are compared against the entire value of the entry in the Path field.

The wildcards are:

A match is found only if the pattern is a complete match against the Path value. For example, the following patterns will all match MachineOne:

But chi%O is not a match because it only matches a part of MachineOne.

Paths are allowed to have several levels, (such as events/name under Hosts), if an appropriate comparison can be made with the results.

The <, <=, > and >= operators can be used with numbers, strings or dates. If the Path on the left of the comparison evaluates to a number, and a Specific Value on the right of the comparison is a string, the string is treated as a number. If it cannot be converted to a number, the comparison will evaluate to false.

Is Set

Is Set requires a single Path selected from the drop-down tree of data objects. It evaluates to True if the value of that path is not empty (not null) and is not an empty list (in the case when the property always evaluates to a list).

In the rare case where the path points to a list of lists, the Is Set is True if at least one of the sub-lists is not empty. For example, if the elements the query is selecting are WebApplications, and you use Is Set with a path of appServers/slowestRequests, the condition is True for a given Web application if it contains at least one AppServer that contains at least one request in its slowest requests list.

Sub Type is

Sub Type requires a type to be selected from a drop-down list of types. The listed types are the sub types of the selected Object Type for the query. If there are no sub types of the Object Type, you receive an error message if you try to select this type of condition. It evaluates to true if the object is of the selected type (or one of its sub types). For instance, if you are selecting with an Object Type of Host, and you use a Sub Type is condition with type WindowsHost, only the Windows® Hosts are selected.

NOTE: For this usage, you could just have selected WindowsHost as the Object Type and embed this condition in a Not condition, to select all Hosts that were not Windows Hosts.

And

The And condition is true if all of the conditions below it are true, and is false if at least one of them is false. Use And to apply more than one condition.

1	Select And, and click the button below it.