Nimsoft Monitor iis Guide - Docs.nimsoft.com

echinoidqueenΔιακομιστές

4 Δεκ 2013 (πριν από 3 χρόνια και 4 μήνες)

286 εμφανίσεις



iis Guide

v1.5 series

Nimsoft® Monitor™







Legal Notices

Copyright © 2013, CA. All rights reserved.

Warranty

The material contained in this document is provided "as is," and is subject to being changed, without notice, in future editi
ons.
Further, to the maximum extent permitted by applica
ble law, Nimsoft LLC disclaims all warranties, either express or implied,
with regard to this manual and any information contained herein, including but not limited to the implied warranties of
merchantability and fitness for a particular purpose. Nimsoft
LLC shall not be liable for errors or for incidental or consequential
damages in connection with the furnishing, use, or performance of this document or of any information contained herein.
Should Nimsoft LLC and the user have a separate written agreement
with warranty terms covering the material in this
document that conflict with these terms, the warranty terms in the separate agreement shall control.

Technology Licenses


The hardware and/or software described in this document are furnished under a licens
e and may be used or copied only in
accordance with the terms of such license.

No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translati
on
into a foreign language) without prior agreement
and written consent from Nimsoft LLC as governed by United States and
international copyright laws.

Restricted Rights Legend

If software is for use in the performance of a U.S. Government prime contract or subcontract, Software is delivered and
licensed as

"Commercial computer software" as defined in DFAR 252.227
-
7014 (June 1995), or as a "commercial item" as
defined in FAR 2.101(a) or as "Restricted computer software" as defined in FAR 52.227
-
19 (June 1987) or any equivalent agency
regulation or contract c
lause. Use, duplication or disclosure of Software is subject to Nimsoft LLC’s standard commercial license
terms, and non
-
DOD Departments and Agencies of the U.S. Government will receive no greater than Restricted Rights as
defined in FAR 52.227
-
19(c)(1
-
2)
(June 1987). U.S. Government users will receive no greater than Limited Rights as defined in
FAR 52.227
-
14 (June 1987) or DFAR 252.227
-
7015 (b)(2) (November 1995), as applicable in any technical data.

Trademarks

Nimsoft is a trademark of CA.

Adobe®, Acroba
t®, Acrobat Reader®, and Acrobat Exchange® are registered trademarks of Adobe Systems Incorporated.

Intel® and Pentium® are U.S. registered trademarks of Intel Corporation.

Java(TM) is a U.S. trademark of Sun Microsystems, Inc.

Microsoft® and Windows® are
U.S. registered trademarks of Microsoft Corporation.

Netscape(TM) is a U.S. trademark of Netscape Communications Corporation.

Oracle® is a U.S. registered trademark of Oracle Corporation, Redwood City, California.

UNIX® is a registered trademark of the Ope
n Group.

ITIL® is a Registered Trade Mark of the Office of Government Commerce in the United Kingdom and other countries.

All other trademarks, trade names, service marks and logos referenced herein belong to their respective companies.

For information on licensed and public domain software, see the
Nimsoft Monitor Third
-
Party Licenses and Terms of Use

document at:
http://docs.nimsoft.com/
prodhelp/en_US/Library/index.htm?toc.htm?1981724.html
.




Contact Nimsoft

For your convenience, Nimsoft provides a single s
ite where you can access information
about Nimsoft products.

At
http://support.nimsoft.com/
, you can access the following:



Online and telephone contact information f
or technical assistance and customer
services



Information about user communities and forums



Product and documentation downloads



Nimsoft Support policies and guidelines



Other helpful resources appropriate for your product

Provide Feedback

If you have commen
ts or questions about Nimsoft product documentation, you can
send a message to
support@nimsoft.com
.



Contents

5



Contents


Chapter 1: iis 1.5

7

iis Overview

................................
................................
................................
................................
................................
..

8

Installation Notes

................................
................................
................................
................................
.......................

11

iis Server Configuration

................................
................................
................................
................................
..............

13

Chapter 2: iis Probe Deployment

21

Supported Platforms

................................
................................
................................
................................
..................

21

System Requirements

................................
................................
................................
................................
................

21

Software Requirements

................................
................................
................................
................................
.............

21

Monitoring System Requirements

................................
................................
................................
.............................

22

Probe Deployment Information

................................
................................
................................
................................
.

22

Chapter 3: iis Configuration

23

Probe Defaults

................................
................................
................................
................................
............................

23

Probe Configuration Interface Installation

................................
................................
................................
.................

23

Probe GUI

................................
................................
................................
................................
................................
...

24

The Left Pane

................................
................................
................................
................................
......................

25

The Right Pane

................................
................................
................................
................................
....................

28

The Tool Buttons

................................
................................
................................
................................
.................

30

Probe Configuration

................................
................................
................................
................................
...................

31

General Setup

................................
................................
................................
................................
.....................

31

Show Summary Database Status

................................
................................
................................
........................

33

Show User Specified Objects

................................
................................
................................
...............................

33

Create a New Group Folder

................................
................................
................................
................................

35

Create a New Host Profile

................................
................................
................................
................................
...

36

Launch the Message Pool Manager

................................
................................
................................
....................

38

View IIS Summary
................................
................................
................................
................................
................

39

View IIS Server Data (Requests)

................................
................................
................................
..........................

41

Show/Hide Checkpoints that are Unavailable

................................
................................
................................
....

43

Chapter 4: QoS Threshold Metrics

47

iis QoS Metrics

................................
................................
................................
................................
............................

47

iis Alert Metrics Default Setti
ngs

................................
................................
................................
................................

48




Chapter 1: iis 1.5

7



Chapter 1:
iis 1.5


This description applies to
iis

probe version
1.5
x.

This section contains the following topics:

iis Overview

(se
e page
8
)

Documentation Changes

(see page
10
)

Installation Notes

(see page
11
)

iis Server Configuration

(see page
13
)


iis Overview


8

iis Guide


iis Overview

The Nimsoft iis probe is a tool for monitoring the health and performance of your
Internet Information Servers.

The NMS IIS probe performs HTTP GET queries to selected Microsoft IIS servers
transforming the query result into alarms and/or quality of service for SLA purposes. The
user may configure the profile to his/her requirements in order to integrate the device
seamlessly into the NMS monitoring solution. The IIS probe includes a UI to configure
the probe.

The probe monitors checkpoints on the Internet Information Servers defined in profiles,
and includes a set of predefined checkpoints available on most systems
, grouped in
different classes. The probe monitors the following checkpoints:

System checkpoints



Available Physical Memory



Memory In Use



Memory Usage



NW Bytes Total/sec



Total CPU



Total Memory

Webservices checkpoints



Bytes received/sec



Bytes sent/s
ec



Bytes Total/sec



Connection Attempts/sec



Current Connections



Get Requests/sec



Measured Async I/O Bandwidth Usage

IIS checkpoints



HTTP Response Time



HTTP Response Value



IIS Status Value



Total Allowed Async I/O Requests



URL Cache Flushes



URL Cache Hits

i
is Overview


Chapter 1: iis 1.5

9





URL Cache Hits %



URL Cache Hits/minute



URL Cache Misses



URL Cache Misses/min

ASP checkpoints



Request Bytes in Total



Requests Executing



Requests Queued

The probe also includes a GUI, which can be used to:



Configure the general prope
rties of the probe.



Define the hosts to be monitored. Group folders can be created to place the hosts
in logical groups.



Activate the checkpoints to be monitored and set the monitoring conditions for
these checkpoints.



Create your own alarm messages.



Monitor the different checkpoints.



Support the Nimsoft SLA system as the probe is QoS enabled. It will send QoS data
on profiles where it has been enabled.


iis Overview


10

iis Guide


Documentation Changes

This table describes the version history for this documen
t.

Version

Date

What's New?

1.5

February 2013



Added support to define the severity of alerts
and reading alarm tokens from configuration.



Added Probe Defaults topic.

Related Documentation

Documentation for other versions of the iis probe

The
Release Notes

for the iis probe

Getting Started with CA Nimsoft® Probes

Monitor Metrics Reference Information for CA Nimsoft Probes


Installation Notes


Chapter 1: iis 1.5

11



Installation Notes

Follow these steps for iis probe:

1.

Install the package into your local archive.

2.

Drop the package from your local archive onto the targeted robot.

3.

Add IIS probe in
Infrastructure Manager
, security, probe administration with admin
access and * mask.

4.

A restart of the perfmon probe is needed i
f this was an IIS probe upgrade, and
perfmon still has handles running.

5.

If there are authentication problems, and if the IIS probe is running locally on the IIS
server computer, you can use 'localhost' as the profiles hostname to skip
performance authentic
ation.

6.

Double
-
click the probe for initial configuration.

7.

For remote monitoring, make sure that the remote registry is enabled on the IIS
server.

Installation notes for IISRequest.dll

The iis ISAPI filter add
-
on for Nimsoft iis probe

The iis probe request
add
-
on supports several versions of the IIS server and Operating
Systems.

Check the readme.txt file for supported versions, and for details about how to add this
functionality.

After the probe installation, the readme.txt will typically be found in the C
:
\
Program
Files
\
Nimsoft
\
Applications
\
iis directory.

Installing ISAPI filter on a 64
-
bit OS

If the IIS web server is running on a 64
-
bit version of Windows, the IISRequestNM64.dll
or IISRequest64.dll should be used, as described in the readme.txt above.

I
t is also necessary to have the Microsoft Visual C++ 2005 Redistributable Package
installed on the server running IIS (web server, not probe).

The link to download this package is:

http://www.microsoft.com/downloads/details.aspx?familyid=90548130
-
4468
-
4BBC
-
967
3
-
D6ACABD5D13B&displaylang=en


Activating the ASP Counters on IIS 7 or above

Installation Notes


12

iis Guide


Please refer to the following link:
http://www.ii
s.net/ConfigReference/system.webServer/isapiFilters


Installing Metabase Compatibility Support on IIS 7 or above

Probe shows wrong status information for IIS 7 loca
l server. It shows "IIS is not on local
server".

To get the correct status, probe requires metabase, which is by
-
default disabled on IIS 7
server. To install it, use the follow the link:

http://learn.iis.net/page.aspx/125/metabase
-
compatibility
-
with
-
iis
-
7/



iis Server Configuration


Chapter 1: iis 1.5

13



iis Server Configuration

The iis probe offers the possibility to view iis server data (requests) in a separate
window.

To enable this functionality, some configuration tasks must be done on the computer
running the IIS server software. Further, the Remote registry service must be
running on
the computer running the IIS server software.

When the iis probe package is distributed to the robot, the following two files are
copied to the ..
\
Nimsoft
\
probes
\
application
\
iis folder:



IISRequest.dll



IISRequest.cfg

Continue as described below
on the computer running the IIS server software:

1.

Create a folder on the computer running IIS server, for instance
C:
\
Inetpub
\
wwwroot
\
myserver
\
IISRequest. Copy the files IISRequest.dll and the
IISRequest.cfg to this folder.

2.

Edit the IISRequest.cfg like this:



The first line is the host name of the computer where the iis probe is running
(probe machine).



The second line is the host name of the IIS server computer (iis server
machine).



The port number is in the last line, by d
efault it is 999.

Note
: This third line specifies the port used for communication between the IIS
Request filter on the IIS Server and the probe. If you, for some reason want to
change to another port number other than 999, you must also enter this port
n
umber in the iis.cfg file (typically located in c:/program
files/Nimsoft/probes/iis) as an extra line in the setup section: filterport =
<portnumber> and it has to be identical in IISRequest.cfg file.

Open the IIS server console:



Select Properties from the individual web site.

iis Server Configuration


14

iis Guide






iis Server Configuration


Chapter 1: iis 1.5

15





Select the
ISAPI Filters

tab and click the
Add

button.







Give the filter a name and browse to add the IISRequest.dll and click the
OK

button to add the filter and then the
Apply

button in the
Properties
dialog to activate the filter.




iis Server Configuration


16

iis Guide




Check that the filter is active:




iis Server Con
figuration


Chapter 1: iis 1.5

17



3.

Check that a log file named IISRequest.log is generated in folder containing the
IISRequest.dll
file. The first line in the log file should say: **Started IISRequest**.

4.

Check the output from the filter in the IIS probe GUI, started from the Infrastructure
Manager. Note that first hourly statistics are available after 1 hour. Request data
are sent to
the iis probe each minute.

Note for installing the ISAPI filter on a 64 bits OS:

If the IIS web server is running

on a 64 bits version of windows, it is necessary to
have the Microsoft Visual C++ 2005 Redistributable Package installed on the server
running IIS (web server, not probe).

This is the link to where you can download this package:
http://www.microsoft.com/downloads/details.aspx?familyid=90548130
-
4468
-
4BBC
-
9673
-
D6ACABD5D13B&displaylang=en


IISRequest : Provides status and statistics on IIS requests.

Files:



IISRequest.dll

An IIS ISAPI filter add
-
on for the Nimsoft IIS probe. Fo
r IIS 5, 5.1, 6, on Windows
Server 2003, Windows XP. Not tested against earlier IIS versions.



IISRequest64.dll

An IIS ISAPI filter add
-
on for the Nimsoft IIS probe. For IIS 5, 5.1, 6, on 64 bits
versions
of Windows Server 2003, Windows XP. Not tested against earlier IIS
versions.



IISRequestNM.dll

A Native Managed add
-
on Module for Nimsoft IIS probe. For IIS 7, on Windows
Vista. Works the same way as the IIS ISAPI filter.



IISRequestNM64.dll

A Native Man
aged add on Module for the Nimsoft IIS probe. For IIS 7, on 64
bits versions of Windows Vista. Works the same way as the IIS ISAPI filter.

Just one of the DLLs is to be used on an IIS server. Select the one that is for your
version of IIS, and for your ver
sion of Windows. Below we refer to
IISRequest.dll as the selected dll.

Instructions for use:

1.

Locate the IISRequest.dll, IISRequest.cfg and the IISRequest.log on the IIS probe
computer, typically in the C:
\
Program Files
\
Nimsoft
\
probes
\
ap
plication
\
iis
folder. The files will be available after the IIS probe is installed. (Infrastructure
Manager is used to drop the iis probe from the archive to the probe computer.)

iis Server Configuration


18

iis Guide


2.

Create a folder on the computer running IIS server, for instance
C:
\
Inetpub
\
wwwroot
\
myserver
\
IISRequest. Copy the IISRequest.dll,
IISRequest.cfg and the IISRequest.log to this folder.


Edit the IISRequest.cfg, so the first line is the name of the computer where the
iis probe is running (probe machine), the second line is the name
of the IIS
server computer (iisserver machine). The last line is the port which will be used
to communicate between the add
-
on and the probe. It can be left at default
value 999. If changed, the same port number has to be set at the IIS probe as
well, see
the IIS probe documentation (Help).

On WINDOWS XP, 2003:

1.

Add necessary permissions to the IISRequest.cfg file: Right click the file,
security tab, then edit, add write access for the IIS_WPG user, or the user that
will be running the II
SRequest.dll. Do the same for the IISRequest.log file.

Add the filter: Open IIS server console (IIS Manager, select properties from
individual web site (not web sites), ISAPI filter and add. Give it a name (for
instance IISR), and browse to add the IISRequ
est.dll.

2.

Generate some traffic to the site. Check that the filter is active, and that entries
are made in the IISRequest.log file in the dll folder, the first line in the log file
should say: **Started IISRequest**.

On WINDOWS VISTA:

1.

A
dd necessary permissions to the IISRequest.cfg file: Right click the file,
security tab, then edit, add write access for the IIS_IUSRS user, or the user that
will be running the IISRequest.dll. Do the same for the IISRequest.log file.

Register the module
: (The example gives it the name IISR, and you have to
change the IISRequest.dll to the version you are using ex. IISRequestNM64.dll).

Do the registration from the IIS Manager GUI, on the top level, modules, add
native module, Register. After the registrat
ion, the module will start.

The registration can also be done from the command line:

From the windows
\
system32
\
inetsrv directory: appcmd install module
/name:IISR /image:C:
\
Inetpub
\
wwwroot
\
myserver
\
IISRequest
\
IISRequest.dll.

(Be careful with the path, a wr
ong path can lead to a non functional web
server, then a reset /restart is need to remove the module)

2.

Generate some traffic to the site. From the IIS Manager GUI, check that the IISR
module is loaded for the desired sites. Check that entries are made in the
IISRequest.log file in the dll folder, the first line in the log file should say:
**Started IISRequest**

3.

Check the output from the filter in the iis probe GUI, started from the
Infr
astructure Manager. Note that first hourly statistics are available after 1
hour. Request data are sent to the iis probe each minute. The IIS servers have
to be defined in the IIS probe. The log files at the IIS server and the IIS probe
can be inspected to

further verify correct operations.

iis Server Configuration


Chapter 1: iis 1.5

19



On IIS6 and older, a restart of the IIS server is needed to properly reload the
filter (for instance after an upgrade or a change to the cfg
-

configuration file).
Execute the command: iisreset /restart.

Uninstall is d
one by removing or unregistering the module from the IIS
manager. An unregistering at web site level should be done first.



Chapter 2: iis Probe Deployment

21



Chapter 2:
iis Probe Deployment


This section contains the system requirements and deployment information for the iis
probe.

This section contains the following topics:

Supported Platforms

(see page
21
)

System Requirements

(see page
21
)

Software Requirements

(see page
21
)

Monitoring System Requirements

(see page
22
)

Probe Deployment Information

(see page
22
)


Supported Platforms

The iis probe supports the same set of operating systems and databases as supported by
the Nimsoft Server solution. Please refer to the
Ni
msoft Compatibility Support Matrix

for the latest information on supported platforms.


System Requirements

The iis probe should be installed on systems with the following minimum resources:



Memory: 2
-
4 GB of RAM. Probe's OOB configuration requires 256 MB of RAM.



CPU: 3 GHz dual
-
core processor, 32
-
bit or 64
-
bit.


Software Requirements

The iis probe requires the following software environment:



Nimsoft Monitor Server 5.1.1 or later



Nimsoft robot version 5.23 or later



Java Virtual Machine versio
n 1.6 or later (typically installed with NMS 5.0 and
above)

Note:

For SOC functionality, NM Server 5.6 or later and UMP 2.5.2 or later is required.


Monitoring System Requirements


22

iis Guide


Monitoring System Requirements

The iis probe is used to monitor the health and performa
nce of the Internet Information
Servers through specific checkpoints, defined in profiles.


Probe Deployment Information

There are two ways to distribute archive packages. You can distribute the package
within Infrastructure Manager or us
e the standalone Nimsoft Distribution application.

See
Probe Deployment

f
or more information on deploying probes.



Chapter 3: iis Configuration

23



Chapter 3:
iis Configuration


This section describes the configuration c
oncepts and procedures for setting up the iis
probe. This probe is configured to monitor the health and performance of the Internet
Information Servers.

This section contains the following topics:

Probe Defaults

(see page
23
)

Probe Configuration Interface Installation

(see page
23
)

Probe GUI

(see page
24
)

Probe Configuration

(see page
31
)


Probe Defaults

At the time of deploying a probe for the first time on robot, some default configuration
will get deployed automatically. These probe defaults could be Alarms, QoS, Profiles and
so on which save
time to configure the default settings. These probe defaults will be
seen on a fresh install, that is no instance of that probe is already available on that robot
in activated or deactivated state.


Probe Configuration Interface Installation

The probe configuration interface is automatically downloaded and installed by the
Nimsoft Infrastructure Manager when the probe is deployed on a robot.


Probe GUI


24

iis Guide


Probe GUI

The iis probe is configured by

double
-
clicking the line representing the probe in the
Infrastructure Manager.


The application window of the iis probe consists of a row of tool buttons and two
window panes, as stated below:



Left pane

(s
ee page

25
)



Right pane

(see page

28
)



Toolbar buttons

(see page

30
)

Note:
When you have made configuration modifications, you must click the
Apply
button to activate the new settings.


Probe GUI


Chapter 3: iis Config
uration

25



The Left Pane

The left pane
shows the various groups and all hosts belonging to a group. Under each
host, you will find a number of classes, a way of sorting the different checkpoints.



Selecting a group, all hosts in that group will be listed in the right pane.



Selecting a host, a
ll predefined checkpoints will be listed in the left pane.



Selecting a class, the predefined checkpoints belonging to that class will be listed in
the left pane.


Probe GUI


26

iis Guide


Note the symbols indicating if a monitored host responds or not:


Indicates that the host responds.


Indi
cates that the host does not respond.


Initializing, waiting for measured values from the profile.


Indi
cates that the host responds, but has no monitored interfaces.

Also note that the checkpoints initially are not activated. You must activate the ones you
want to monitor, and you also have the possibility to hide/show the ones that are not
available on th
e host by clicking the rightmost tool button (See the section
Show/Hide
Unavailable Checkpoints

(see page

43
)
).

Right
-
clicking in the pane opens a pop
-
up menu, giving you the following possibilities:



New Host

Available on
ly when a group is selected.

Opens the profile dialog, enabling you to define a new host to be monitored.



New Group

Available only when a group is selected.

Opens the profile dialog, enabling y
ou to define a new group. Use the group folders
to place the hosts in logical groups.



New

Opens the profile dialog, enabling you to define a new host to be monitored.



Edit

Available only when a host is selected.

Opens the profile dialog for the selecte
d host, enabling you to modify the
properties for the host.



Delete

Lets you delete the selected host or group. Note that you are not allowed to delete
the group Default.



Rename

Lets you rename the selected group or host. Note that you are not allowed

to
rename the group Default.



Refresh

Makes a refresh to reflect the current values of the objects listed in the right
window pane.

Note
: When attempting to refresh a host that does not respond, the checkpoints’

description fields in the right pane will appear with red letters.

Probe GUI


Chapter 3: iis Configuration

27





Activate All

Activates all checkpoints on the selected host.



Deactivate All

De
-
activates all checkpoints on the selected host.

Note:

You may easily move a host from one group to anothe
r by left
-
clicking the host,
dragging it and dropping it in another group.


Probe GUI


28

iis Guide


The Right Pane

The right
-
pane is multi
-
functional and shows:



Hosts when a group is selected in the left
-
pane.



All predefined checkpoints when a host is selected in the left
-
pane.



The checkpoints belonging to the selected class when a class is selected in the
left
-
pane.

Note the meaning of the different icons in the window, which can be:



green

(means OK),



red

(indicates an error situation),



black

(means the checkpoint is not active)



yellow

(the last measurement failed).


Value not avail
able.


Waiting for value.

Right
-
clicking in the pane gives you the following possibilities:



Edit

Opens the
Monitor Properties
dialog, enabling you to modify the monitoring
properties for the selected checkpoint.



Activate

Activates the selected checkpoint to be monitored by the probe. Note that you may
also activate it by clicking the check box belonging to the checkpoint.



Deactivate

Deactivates the selected checkpoint
(if activated) after which the probe will stop
monitoring the checkpoint.



Monitor

Opens the monitor window for the selected checkpoint showing the values
recorded since the probe was started.

Probe GUI


Chapter 3: iis Configuration

29




Note:
The horizontal red line in the graph indicates the alarm threshold (in this case
90 %) defined for the checkpoint.

When clicking and holding the left mouse button inside the graph, a red vertical line
appears.
If you continue to hold the left mouse
-
button down and move the cursor,
you can read the exact value at different points in the graph. The value is displayed
in the upper part of the graph on the format: <Day> <Time> <Value>.

Right
-
clicking inside the mon
itor window lets you select the backlog (the time range
shown in the monitor window). In addition, the right
-
click menu lets you select the
option
Show Average
. This adds a horizontal blue line in the graph, representing
the average sample value.


Note the status bar at the bottom of the monitor window. The following
information can be found:



The number of samples since the probe was started.



The minimum value measured.



The average value measured.



The maximum value measured.



The backlog: This is the time range shown in the monitor window. The backlog
can be selected to 6, 12, 24 or 48 hours by right
-
clicking inside the graph. Note
that the graph can not show a time range
greater than the selected Maximum
data storage time setting in the
Setup

section of the GUI.


Probe GUI


30

iis Guide


The Tool Buttons

The configuration tool also contains a row of tool buttons:




General Setup

Clicking this button opens the Setup dialog for the probe, allowing you to modify
the general probe parameters. See
General Setup

(see page

31
)
.



Show Summary Database Status

Clicking this button, the database status for the monitored hosts will be displayed in
the right pane.

The list shows the first and the last date backlog and summary data has been
recorded and written to the database, and also the number of records in the
period. See
Show Summary Database Status

(see page

33
)
.



Show User Specified Objects

Clicking this button, all user specified objects will be listed in the right pane.

Right
-
clicking in the right pane and selecting New, th
e User Object dialog appears,
enabling you to define a new object. See
Show User
-
Defined Objects

(see page

33
)
.



Create a New Group Folder


Creates a new group folder in the left window pane. See
Create a New Group Folder

(see page

35
)
. Use the group folders to place the hosts in logical groups.



Create a New Host Profile

Creates a new host to be monitored in the selected folder in the left window pane.
See
Create a New Host Profile

(see page

36
)
.



Launch the Message Pool Manager


This option lets you customize the alarm text, and you may also create your own
messages. See
Launch the Message Pool Manager

(see page

38
)
.



View IIS Summary

Clicking the button opens the IIS Summary Report for the selected host. The
window contains a graph, showing the HTTP response time and the Cache
hits/misses per day. See
View IIS Summary

(see page

39
)
.



S
how/Hide checkpoints that are not available


Clicking this button hides checkpoints that are not available at the selected host
from the list. Clicking the button again will make the unavailable checkpoints
appear in the list again. See
Show/Hide Unavailab
le Checkpoints

(see page

43
)
.


Probe Configuration


Chapter 3: iis Configuration

31





View IIS Server Requests

Clicking this button gives you the possibility to view IIS server data (requests) in a
separate window. To enable this functionality, some configuration tasks must be
done on the computer running the IIS server software. See
iis Server Configuration

(see page

13
)
).


Probe Configuration

This section contains the configuration information for the iis probe. It contains the
below listed sections:



General Setup

(see page

31
)



Show Summary database Status

(see page

33
)



Show User Specified Objects

(see page

33
)



Create a New Group Folder

(see page

35
)



Create a New Host Profile

(see page

36
)



Launch the Message Pool Manager

(see page

38
)



View IIS Summary

(see page

39
)



View IIS Server Data (Requests)

(see page

41
)


General Setup


Probe Configuration


32

iis Guide


Clicking the
General Setup
button opens the
Setup
dialog.


The fields in the above dialog are explained below:

General Tab

Log
-
level

Set the detail level for messages logged to the log
-
file.

Advanced Tab

Autorefresh GUI

If selected, updates the GUI to display the most recent values.

Maximum Data Storage Time

Select the maximum data storage time from the drop
-
down list. Valid choices
are:



6 hours



12 hours



24 hours



48 hours

This is the time range within which the monitored values are picked when
calculating the
average value (used when setting the alarm threshold). 24 hours
means that the values stored within the last 24 hours will be used.

Maximum concurrent threads

Specifies the maximum number of profiles the probe can run simultaneously.
The valid range is 0

-

100.


Probe Configuration


Chapter 3: iis Configuration

33



Show Summary Database Status


You may show the database status for the monitored hosts by clicking the
Show
Summary Database Status

tool button. The database status for the monitored hosts will
be displayed in the right pane.

The list shows the first and the last day summary data has been recorded and written to
the IIS database (containing summary and backlog data), and also the numb
er of records
in the period.



Show User Specified Objects


The probe includes a
set of pre
-
defined checkpoints available on most hosts running the
IIS software, but you may also define your own objects to be monitored. On clicking this
button, previously user specified objects will be listed in the right pane.


Probe Configurati
on


34

iis Guide


Right
-
clicking in the right pane will give three options:



New



Edit



Delete


Selecting the
New
option, the
User Object

dialog appears enabling you to define a new
object. This enables you to extend objects that are not a part of the IIS Monitor standard
objects, but are available from the windows performance system.


Probe Configuration


Chapter 3: iis Configuration

35



The fields in the above dialog are explained below:

Login Profile

Select one of the defined hosts from the drop
-
down list as a Login Profile.

Performance Object Selector

Object Name

Defines the name of the new object.

Counter Name

Defines the counter name. For example,
Disk Transfers/sec
, if object
LogicalDisk

is selected.

Instance Name

Defines the instance name. For example, disk drive
D:
, if object and counter
name are selected as
LogicalDisk

and
Disk Transfers/se
c

is selected.

Object Preferences

Description

Specifies an optional description of the object.

Make Available As QoS

If selected, the measured value is available as QoS.

Unit

Specifies the unit of the QoS value, such as Mbytes, %, etc

Note:

When clicking the
Apply

button in the probe GUI, the new user object will be
added to the list of user
-
defined objects and also under the User Objects sub
-
node
under each host listed in the left pane. When restarting the probe, the probe has to wait
for a

couple of minutes before it can show the measured values for the new user
defined object.


Create a New Group Folder


You may create a new group folder by clicking the
Create a New Group Folder

tool
button and giving the new folder a name.


Probe Configuration


36

iis Guide


Create a New Host Profile

You may create a new host profile by selecting the group it should belong to and click
th
e
Create a New Host Profile

tool button.


A dialog
-
box will appear and prompt you for the hostname or IP
-
address to the IIS host
to monitor and some additional parameters.


Probe Configuration


Chapter 3: iis Configuration

37



The fields in the above dialog are explained below:

Hostname or IP address

Specifies the name or IP address of the host to be monitored. If the probe is located
on the same compute
r as the IIS Server, you should just specify localhost instead of
the name or IP address of the host. This is to avoid authentication issues.

Active

If selected, activates or deactivates monitoring of the checkpoints on the host. Note
that
you may also activate/deactivate monitoring of the various checkpoints
individually.

Group

Select from the drop
-
down list which group folder you want to put the host. Use
the group folders to place the hosts in logical groups.

Alarm Message

The alarm message to be issued if the host does not respond. Using the Message
pool, you can edit this message or add other messages.

Server address for http response

The address to be tested for http response on the format: http://193.71.55.8 or
http://w
ww.nimsoft.com.

Description

Specifies a short optional description of the monitored host.

Data collection interval

Select the data collection interval (how often to collect data from the host) from
the drop
-
down menu. This value overrules the Common mini
mum data collection
interval defined on the
General Setup

dialog.

Note:

You may also type in a value. The minimum possible value for data collection
interval is 1 min.

Filter port

Defines the port which will be used to communicate between the add
-
on and t
he
probe. The default value is 999. If changed, the same port number has to be set at
the IIS probe as well.

Windows Authentication

Username and Password

The credentials to login (a valid user name and password with administrator
privileges)
on the monitored host.

Domain

Defines the DNS domain name if the host local machine. The blank field means
that the machine is hosting the probe.

Probe Configuration


38

iis Guide


Test

Clicking this button verifies if your windows authentication works.

Http Server Authentication

None

Indicates no authentication against the http server (will still require windows
authentication for performance data).

Basic

Indicates basic authentication against the http server. Using the Http server
authentication Username and Password specified.

Windows

Uses the Windows authentication, Username and Password specified as
described above (see
Windows Authentication

above).

Username and Password

The login properties (a valid user name and password with administrator
privileges) on the http server.


Launch the Message Pool Manager

The
Message Pool

dialog can be opened by clicking the
Message Pool Manager

button
in the tool bar.


Probe Configuration


Chapter 3: iis Configuration

39



The alarm messages for each alarm situation are stored in the Message Pool. Using the
Message Pool Manager, you can customize the alarm text, and you may also create your
own messages.


Note:

The variable expansion in the message text is supported. If typing a ‘$’ in the
Error
Alarm Text

field, a dialog pops up, offering a set of variables to be chosen.


View IIS Summary

You can open the IIS Summary Report for a
host by clicking the
View IIS Summary

button in the tool bar.


Probe Configuration


40

iis Guide


Note:
You have to select the IIS sub node for a host in the left pane to activate the
button.

The IIS Summary Repor
t window will be opened. The window contains a graph, showing
the HTTP response time and the Cache hits/misses for the selected period.


Clicking the drop
-
down menu in the upper
left corner lets you select to display the
graph with the values for:



Per hour

Displaying the values with a solution of one hour for the period selected using the
From
and
To
fields.

Click the
Submit

button to fetch the values for the selected period.



Per day

Displaying the values with a solution of one day for the period selected using the
From

and
To
fields.

Click the
Submit

button to fetch the values for the selected period.



Last day

Displaying the values with a solution of one hour for the last d
ay.



Last month

Displaying the values with a solution of one hour for the last month.

When clicking and holding the left mouse
-
button down and move the cursor, you
can read the exact value at different points in the graph. The value is displayed in
the upper part of the graph on the format: <Day> <Time> <value>.


Probe Configuration


Chapter 3: iis Configur
ation

41



View IIS
Server Data (Requests)

You can open the IIS Server Requests window by clicking the
View IIS Server Data
(Requests)
button in the tool bar.


The iis probe offers the possibility to view IIS server data (requests) in a separate
window. To enable this functionality, some configuration tasks must be done on the
computer running the IIS server software.

Open the configuration tool for the probe by
double
-
clicking the line representing the
probe in the Infrastructure Manager.


Probe Configuration


42

iis Guide


Using the tool buttons located in the upper part of the window, you can select between
different s
tatistics views. The most recent request running on the IIS server (at the time
of the last sample).



Request statistics (hourly, daily and monthly)

The entries in the list can be selected and copied to clipboard (CTRL + C), in the case
you want to paste
the entries into another application (CTRL + V).

Left
-
click the entries to select them, or select CTRL+ A to select all.



Request database status, showing the number of records in the request database

If you want to delete some or all records, you right
-
click in the list and select
Delete
Request Data
.

The following dialog appears, asking you to select for which period to delete data.
Make your selection and click the
OK
button.




Using the calendar functionality, you can select to show the statistics for a specific
period. Select a period and click the
Submit
button.



Probe Configuration


Chapter 3: iis Configuration

43



Show/Hide Checkpoints that are Unavailable

You can select to show or hide the checkpoints that are not available at the selected
host from the list in the right window pane by clicking the
Show/Hide checkpoints that
are

unavailable

button in the tool bar.


Clicking this button hides checkpoints that are not available at the selected host from
the list. Clicking the button again
will make the unavailable checkpoints appear in the
list again.

Double
-
clicking a checkpoint in the right window pane opens the
Monitor Properties

dialog for the checkpoint, enabling you to modify the monitoring properties for the
checkpoint.


Probe Configuration


44

iis Guide


The fields in the above dialog are explained below:

Description

Allows you to create your own description of the monitoring object (checkpoint). If
desired, replace the original description

text with a description of your own choice.

Monitoring Object

Specifies the the name of the monitoring object (checkpoint). It cannot be changed.

Enable Monitoring

If selected, activates the monitoring of the checkpoint.

Note:
The checkpoint will also be selected in the list of checkpoints in the right
window pane when this option is selected, and that you now enable/disable
monitoring of the checkpoint from that list.

Value

Decides which value to be compared with the
Threshol
d Value
defined below.
The two options are:



Last/current value



Average value

Last/Current Sample

Uses the last measured value to be compared with the
Threshold Value
defined below.

Compute Average

Computes the average of the values measured in the time interval selected
from the drop
-
down list. You may select one of the predefined intervals
from the drop
-
down list or you may type your own value in the field.

Operator

Select from the drop
-
down list the operator to be used when setting the alarm
threshold for the measured value.

Examples:

= 90 means alarm condition if the measured value (current sample or average
value


see above) is exact 90.

=> 90 means alarm conditio
n if the measured value (current sample or average
value


see above) is above 90.

Threshold Value

The alarm threshold value. If this value is exceeded (see value and operator
above).

Unit

Specifies the unit of the monitored value. (For example %, Mby
tes etc.). This is
a read
-
only field.

Probe Configuration


Chapter 3: iis Configuration

45



Message Token

Select the alarm message to be issued if the specified threshold value is
breached. These messages are kept in the message pool and can also be
modified there (see
Launch the Message Pool Manager

(see page

38
)
).

Publish Quality of Service (QoS)

If selected, issues QoS messages on the checkpoint.



Chapter 4: QoS Threshold Metrics

47



Chapter 4:
QoS Threshold Metrics


Many Nimsoft Monitor probes ship with default QoS threshold values set. The default
threshold values provide an idea of the type of values to be entered in the fields and are
not necessarily recommended best practice values. To aid in tuning thresholds and

reducing false
-
positive alarms, this section describes the QoS metrics and provides the
default QoS thresholds.

This section contains the following topics:

iis QoS Metrics

(see page
47
)

iis Alert Metrics Default Settings

(see page
48
)


iis QoS Metrics

This section contains the QoS metrics for the iis

probe.


Monitor Name

Units

Description

QOS_ASYNCIO_BWUSAGE

Measured Async
I/O Bandwidth
Usage

Measured Async I/O Bandwidth Usage

QOS_BYTESRECEIVD_PS

Bytes received/sec

Web server bytes received per second

QOS_BYTESSENT_PS

Bytes sent/sec

Web server bytes sent per second

QOS_BYTESTOTAL_PS

Bytes Total/sec

Web server bytes total per second

QOS_CONNATTEMPTS_PS

Connection
attempts/sec

Connection attempts per second

QOS_CPU_USAGE

Percent

CPU Usage

QOS_CURRENTCONNECTS

Current
connections

Current connections

QOS_DISK_USAGE

Megabytes

Disk Usage

QOS_GET_REQUESTS_PS

Get Requests/sec

Get requests per second

QOS_IIS_HTTPRESTIME

Milliseconds

http response time

QOS_IIS_USEROBJ

Value

IIS User object

QOS_MEMAVPHY

Megabytes

Physical Memory available

QOS_MEMORY_INUSE

Percent

Memory in Use %

QOS_MEMORY_USAGE

Megabytes

Memory Usage

iis Alert Metrics Default Settings


48

iis Guide


Monitor Name

Units

Description

QOS_MEMORYAVAILPHYS

Megabytes

Physical Memory available

QOS_NETWORK_BTPS

Bytes Total/sec

Network interface bytes total per second

QOS_WSC_CACHEHITSPC

Cache hits

Web service cache hits %

QOS_WSC_CACHEHITSPM

Cache hits/minute

Web service cache hits

QOS_WSC_CACHEMISSPM

Cache
misses/minute

Web Service Cache Misses


iis Alert Metrics Default Settings

This section contains the alert metric default settings for the iis probe.


QoS Metric

Warning
Threshold

Warning
Severity

Error
Threshold

Error
Severity

Description

MsgAgentError


-


-


-

critical

The IIS is not running on
host.

MsgPerfHandleError


-


-


-

minor

Unable to obtain handle to
Perfmon probe.

MsgPerfSelectedError


-


-


-

warning

Unable to extract
performance counters.

MsgHostAvailError


-


-


-

warning

Host is not a
vailable.

MsgWarning


-


-


-

warning

Message warning

MsgError


-


-


-

critical

Message Error