SiteScope User's Guide

NT Performance Counter Monitor

The NT Performance Counter Monitor tracks the values of any Window NT performance statistic. These are the same statistics that can be viewed using the "Performance Monitor" application under Windows NT. This monitor is only available on the Windows NT version of SiteScope.

Each time the NT Performance Counter Monitor runs, it returns a reading and a status message and writes them in the monitoring log file. The status is displayed in the group detail table for the monitor which represents the current value returned by this monitor. For example, 1.24 Interrupts/sec. The status is logged as either OK or warning. An error occurs if the counter could not be read.

Completing the NT Performance Counter Monitor Form

To display the NT Performance Counter Monitor form, either click the edit link of an existing NT Performance Counter Monitor in a monitor table, or click the "Add a new Monitor to this group" link on a group's detail page and choose the "Add NT Performance Counter Monitor" link.

Complete the items on the NT Performance Counter Monitor form as follows. When the required items are complete, click the "Add Monitor button". The easiest way to fill in the boxes for an NT Performance Counter Monitor is to open up the "Performance Monitor" application, click "Add To Chart...", and browser to find the performance measurement that you'd like the monitor to make. Setting files (ending in .pmc or pmw) from the NT Performance Monitor can be used to specify which counters you would like to monitor.

Server: Choose the server that you want to monitor. The default is to monitor a performance counter on this server. Click the choose server link to monitor a performance counter on another NT server. When using a setting file from the NT Performance Monitor, all counters will be measured on the server specified by this entry.

Perfmon Chart File

Choose the NT Performance Monitor setting file you would like to use for your settings. These files can be saved in the NT Performance Monitor (perfmon) and have either a .pmc or .pmw extension. On Windows 2000 Platform these can be saved using the .htm format.

The files in this list all reside in the templates.perfmon directory under SiteScope. There are a number of default files in the standard SiteScope distribution.

Note: If you make your own settings file, it will need to be placed in the /SiteScope/templates.perfmon directory. You can optionally specify the settings directly for a single counter below under the Advanced Options section.

Note: If you create your own .pmc file, it is important to note that any server specified in the .pmc file will be ignored by SiteScope. The server to be queried will be the one selected via the Server selection box on monitor setup page (see above). Therefore, you should not include identical counters directed at different servers in a single .pmc file. One .pmc file can be used by more than one NT Performance Monitor instance but any single instance of the NT Performance Monitor will only query one server regardless of the servers assigned in the .pmc.

If you have specified the settings directly below in the Advanced Options section, this list will display "(Custom Object)".

Update every

Enter how frequently the performance counter should be read. The drop-down list to the right of the text box lets you specify time increments of seconds, minutes, hours, or days. You must specify a time increment of at least 15 seconds.

Title (Optional)

Enter a name for this monitor. This name appears in the Name text box on the monitor table when you open the group's detail page. If you don't enter a name, a default name will be created.

Advanced Options

The advanced options give you the ability to customize error and warning thresholds. If you choose not to set them, SiteScope will use preset defaults if available. If a default is not available, SiteScope will not be able to utilize the condition.

Disable

Check this box to temporarily disable this monitor and any associated alerts. To enable the monitor again, clear the box.

Object

The Object is the same as the "Object" in the Performance Monitor application - just type it in this box. The Object is the high level item that will be measured, such as Processor or Server. Note that the object name is case-sensitive. If you are using a Performance Monitor file for counter settings, leave This item blank.

Counter

The counter is the same as the "Counter" in the Performance Monitor application - just type it in this box. The Counter is the specific aspect of the Object that will measured, such as Interrupts/sec. Note that the counter name is case-sensitive. If you are using a Performance Monitor file for counter settings, leave This item blank.

Instance

Some counters can have multiple instances - for example, on machines with two CPUs, there are two instances of the Processor object. The instance is the same as the "Instance" in the Performance Monitor application - just type it in this box. Note that the instance name is case-sensitive. If you are using a Performance Monitor file for counter settings, leave This item blank.

Units

If you'd like units to be displayed with the counter's values to make them more readable, enter the units here.

Scale

If you'd like the raw performance counter value scaled to make it more readable, choose the scale here. The raw value of the counter will be multiplied by the scale to determine the value of the monitor. The kilobytes option divides the raw value by 1,024 (the number of bytes in 1 K), and the megabytes option divides the raw value by 1,048,576 (the number of bytes in 1 MB). If there are multiple counters specified via a Performance Monitor file, this scaling applies to all counters.

Baseline Interval

Enter the number of monitor runs to be averaged for use as a Rolling Baseline. Rolling baselines are calculated for an interval equal to time to complete the number of monitor runs entered here. See more information.

Verify Error

Check this box to have SiteScope verify an error by immediately performing the check again.

Schedule (Optional)

By default, SiteScope's monitors are enabled every day of the week. You may, however, schedule your monitors to run only on certain days or on a fixed schedule. Choose the Edit schedule link to create or edit a monitor schedule. For information about creating schedules, read these instructions.

Monitor Description (Optional)

Enter additional information about this monitor. The Monitor Description can include HTML tags such as the <BR> <HR>, and <B> tags to control display format and style. The description will appear on the Monitor Detail page.

Report Description (Optional)

Enter a description for this monitor that will make it easier to understand what this monitor does. The description will appear on Management Reports and on the info list for a monitor.

Depends On (Optional)

To make the running of this monitor dependent on the status of another monitor or monitor group, use the drop-down list to select the monitor or group on which this monitor is dependent. Select None to remove any dependency.

Depends Condition (Optional)

If you choose to make the running of this monitor dependent on the status of another monitor, choose the status condition that the other monitor or monitor group should have in order for the current monitor to run normally. The current monitor will be run normally as long as the monitor or group on which it depends reports the condition selected in this option.

List Order (Optional)

By default, new monitors are listed last on the Monitor Detail page. You may use this drop-down list to choose a different placement for this monitor.

Update Every (on error)

This options allows you to set a new monitoring interval for monitors that have registered an error condition. For example, you may want SiteScope to monitor this item every 10 minutes normally, but as often as every 2 minutes if an error has been detected. Note that this increased scheduling will also affect the number of alerts generated by this monitor.

Error if

Set the level of the specific counter value that should trigger an error status. Choose [value] >= from the drop-down list and then, in the text entry box, enter the lowest value which should trigger an error condition.

Warning if

Set the level of the counter value that should trigger a warning status. This level should be lower than the error level you set. SiteScope will report a warning status when the counter value reaches or exceeds the warning level you set, but is still lower than the defined error level.

To set the warning level, choose value >= from the drop-down list and then, in the text entry box, enter the lowest value which should trigger a warning condition.

Good if

Enter the value that should indicate a good reading for this monitor. By default, SiteScope assumes that the monitor is in a good status if the error and warning conditions are not met.