Nimsoft Monitor iis Guide v1.5 series
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 editions. Further, to the maximum extent permitted by applicable 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 license 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 translation 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 clause. 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, Acrobat, 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 Open 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 site where you can access information about Nimsoft products. At http://support.nimsoft.com/, you can access the following: Online and telephone contact information for 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 comments or questions about Nimsoft product documentation, you can send a message to support@nimsoft.com.
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 Settings... 48 Contents 5
Chapter 1: iis 1.5 This description applies to iis probe version 1.5x. This section contains the following topics: iis Overview (see page 8) Documentation Changes (see page 10) Installation Notes (see page 11) iis Server Configuration (see page 13) Chapter 1: iis 1.5 7
iis Overview 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/sec 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 8 iis Guide
iis Overview 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 properties 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. Chapter 1: iis 1.5 9
iis Overview Documentation Changes This table describes the version history for this document. Version Date What's New? 1.5 February 2013 Added support to define the severity of alerts and reading alarm tokens from configuration. Related Documentation Added Probe Defaults topic. 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 10 iis Guide
Installation Notes 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 if 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 authentication. 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. It 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 Chapter 1: iis 1.5 11
Installation Notes Please refer to the following link: http://www.iis.net/configreference/system.webserver/isapifilters Installing Metabase Compatibility Support on IIS 7 or above Probe shows wrong status information for IIS 7 local 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/ 12 iis Guide
iis Server Configuration 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 default 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 number 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. Chapter 1: iis 1.5 13
iis Server Configuration 14 iis Guide
iis Server Configuration 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. Chapter 1: iis 1.5 15
iis Server Configuration Check that the filter is active: 16 iis Guide
iis Server Configuration 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. For 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 Managed 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 version 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\application\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.) Chapter 1: iis 1.5 17
iis Server Configuration 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 IISRequest.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 IISRequest.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. Add 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 registration, 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 wrong 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 Infrastructure 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. 18 iis Guide
iis Server Configuration 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 done by removing or unregistering the module from the IIS manager. An unregistering at web site level should be done first. Chapter 1: iis 1.5 19
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 Nimsoft 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 version 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. Chapter 2: iis Probe Deployment 21
Monitoring System Requirements Monitoring System Requirements The iis probe is used to monitor the health and performance 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 use the standalone Nimsoft Distribution application. See Probe Deployment for more information on deploying probes. 22 iis Guide
Chapter 3: iis Configuration This section describes the configuration concepts 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. Chapter 3: iis Configuration 23
Probe GUI 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 (see 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. 24 iis Guide
Probe GUI 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, all 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. Chapter 3: iis Configuration 25
Probe GUI Note the symbols indicating if a monitored host responds or not: Indicates that the host responds. Indicates that the host does not respond. Initializing, waiting for measured values from the profile. Indicates 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 the 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 only 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 you 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 selected 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. 26 iis Guide
Probe GUI 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 another by left-clicking the host, dragging it and dropping it in another group. Chapter 3: iis Configuration 27
Probe GUI 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 available. 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. 28 iis Guide
Probe GUI 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 monitor 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. Chapter 3: iis Configuration 29
Probe GUI 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, the 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). Show/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 Unavailable Checkpoints (see page 43). 30 iis Guide
Probe Configuration 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 Chapter 3: iis Configuration 31
Probe Configuration Clicking the General Setup button opens the Setup dialog. The fields in the above dialog are explained below: General Tab Log-level Advanced Tab Set the detail level for messages logged to the log-file. 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. 32 iis Guide
Probe Configuration 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 number 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. Chapter 3: iis Configuration 33
Probe Configuration 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. 34 iis Guide
Probe Configuration 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/sec is selected. Object Preferences Description Specifies an optional description of the object. Make Available As QoS Unit If selected, the measured value is available as QoS. 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. Chapter 3: iis Configuration 35
Probe Configuration Create a New Host Profile You may create a new host profile by selecting the group it should belong to and click the 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. 36 iis Guide
Probe Configuration The fields in the above dialog are explained below: Hostname or IP address Active Group Specifies the name or IP address of the host to be monitored. If the probe is located on the same computer 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. 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. 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://www.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 minimum 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 the 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. Chapter 3: iis Configuration 37
Probe Configuration Test Clicking this button verifies if your windows authentication works. Http Server Authentication None Basic Indicates no authentication against the http server (will still require windows authentication for performance data). 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. 38 iis Guide
Probe Configuration 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. Chapter 3: iis Configuration 39
Probe Configuration Note: You have to select the IIS sub node for a host in the left pane to activate the button. The IIS Summary Report 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 day. 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>. 40 iis Guide
Probe Configuration 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. Chapter 3: iis Configuration 41
Probe Configuration Using the tool buttons located in the upper part of the window, you can select between different statistics 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. 42 iis Guide
Probe Configuration 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. Chapter 3: iis Configuration 43
Probe Configuration 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 Threshold 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 Operator 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. 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 condition if the measured value (current sample or average value see above) is above 90. Threshold Value Unit The alarm threshold value. If this value is exceeded (see value and operator above). Specifies the unit of the monitored value. (For example %, Mbytes etc.). This is a read-only field. 44 iis Guide
Probe Configuration 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 3: iis Configuration 45
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 QOS_CPU_USAGE Percent CPU Usage QOS_CURRENTCONNECTS Current connections Connection attempts per second 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 Chapter 4: QoS Threshold Metrics 47
iis Alert Metrics Default Settings 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 available. MsgWarning - - - warning Message warning MsgError - - - critical Message Error 48 iis Guide