OneSight Administrator Guide

Configuring TCP/IP Socket Monitors
Perl Expression –Specifies a Perl Expression used to collect
numerical performance data from a log file entry. The monitor
checks the last entry whenever the log file changes. This
returned data can then be used within OneSight, both for
alerting, using threshold alerts, and reporting.
To check whether the file exists, use the File/directory exits
metric type and leave this field blank.
String Mappings – Displays the String Mappings dialog box for
specifying string mappings.
String Mappings – OneSight collects numeric performance
data. If you are measuring a log file response that is a string,
it can be converted to a number for use in OneSight by using
the String Mappings field. Simply specify a semicolon
delimited mapping of Strings to Integers. For example,
―false=0;true=1‖; will convert a ―false‖ reading to a 0 value
in OneSight, and this will be displayed in OneSight Status as
―false=0‖. If you only want to display the string on the
OneSight status page, use a colon, rather than a semi-colon to
delimit the values.
If you neglect to provide a mapping for a specific string,
OneSight will consider this a Sample Failure, and report the
String that was returned. String Mappings can also be used to
translate a number to a String for display in OneSight Status.
This is helpful when numbers represent an objects state.
Note that string matching is case-insensitive and data that has
a colon cannot be used in string mapping.
Record Type – Specifies the operating mode:
Each record is one line – select this option to use one line at a
time operating mode. In this mode each line read from the
file is treated as a single log file entry and is processed
individually.
Chapter 5: Configuring Monitors 341