CA Unified Infrastructure Management

Transcription

1 CA Unified Infrastructure Management Probe Guide for IIS Server Monitoring v1.7 series

2 Copyright Notice This online help system (the "System") is for your informational purposes only and is subject to change or withdrawal by CA at any time. This System may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This System is confidential and proprietary information of CA and protected by the copyright laws of the United States and international treaties. This System may not be disclosed by you or used for any purpose other than as may be permitted in a separate agreement between you and CA governing your use of the CA software to which the System relates (the CA Software ). Such agreement is not modified in any way by the terms of this notice. Notwithstanding the foregoing, if you are a licensed user of the CA Software you may make one copy of the System for internal use by you and your employees, provided that all CA copyright notices and legends are affixed to the reproduced copy. The right to make a copy of the System is limited to the period during which the license for the CA Software remains in full force and effect. Should the license terminate for any reason, it shall be your responsibility to certify in writing to CA that all copies and partial copies of the System have been destroyed. TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS SYSTEM AS IS WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS SYSTEM, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE. The manufacturer of this System is CA. Provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections , , and (c)(1) - (2) and DFARS Section (b)(3), as applicable, or their successors. Copyright 2014 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. Legal information on third-party and public domain software used in this product is documented in the Third-Party Licenses and Terms of Use (

3 Contact CA Contact CA Support For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At you can access the following resources: Online and telephone contact information for technical assistance and customer services Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your product Providing Feedback about Product Documentation Send comments or questions about CA Technologies product documentation to To provide feedback about general CA Technologies product documentation, complete our short customer survey which is available on the support website at

4

5 Contents Chapter 1: iis iis Overview v Installation Notes iis Server Configuration Chapter 2: iis Probe Deployment 19 Prerequisites Supported Platforms System Requirements Software Requirements Monitoring System Requirements Probe Deployment Information Chapter 3: iis Configuration v Probe Defaults Probe Configuration Interface Installation iis Probe GUI Reference v The Left Pane The Right Pane The Tool Buttons Probe Configuration General Setup Show Summary Database Status Show User Specified Objects Create a New Group Folder Create a New Host Profile Launch the Message Pool Manager View IIS Summary View IIS Server Data (Requests) Show/Hide Unavailable Checkpoints Configure the Counter Properties Monitor Application Pools Chapter 4: IIS Server Monitoring (iis) Metrics 45 QoS Metrics Contents 5

6 iis Alert Metrics Default Settings Probe Guide for IIS Server Monitoring

7 Chapter 1: iis 1.7 This description applies to iis probe version 1.7x. This section contains the following topics: iis Overview v1.7 (see page 8) Documentation Changes (see page 10) Installation Notes (see page 10) iis Server Configuration (see page 12) Chapter 1: iis 1.7 7

8 iis Overview v1.7 iis Overview v1.7 The iis probe is a tool for monitoring the health and performance of your Internet Information Servers. The IIS Server Monitoring (iis) probe for Internet Information Servers performs HTTP GET queries to the selected Microsoft IIS servers. The probe then transforms the query result into alarms and/or quality of service for SLA purposes. 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 URL Cache Hits % 8 Probe Guide for IIS Server Monitoring

9 iis Overview v1.7 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.7 9

10 Installation Notes Documentation Changes This table describes the version history for this document. Version Date What's New? 1.7 September 2014 Updated the Monitor the Application Pool topic. 1.7 June 2014 Added the Prerequisites, Configure the Counter Properties, and Monitor the Application Pool topics. Updated the Left Pane, Show/Hide Unavailable Checkpoints, and QoS Metrics topics. 1.6 November 2013 No functional updates in the document only support matrix is updated for 64 bit support. 1.5 February 2013 Added support to define the severity of alerts and reading alarm tokens from configuration. Added Probe Defaults topic. Installation Notes You can install the IIS Server Monitoring probe for monitoring the IIS server while considering the following points: Provide admin access to the probe in Admin Console by using the Settings > Probe Security option. Alternatively, use the Security > Probe Administration option in the Infrastructure Manager. Restart the Performance Collector probe after installing or upgrading the IIS Server Monitoring probe. Use the 'localhost' as the hostname for monitoring the local IIS server to skip the performance authentication. Ensure that the remote registry is enabled on the IIS server for remote monitoring. 10 Probe Guide for IIS Server Monitoring

11 Installation Notes Installation Notes for IISRequest.dll The IISRequest.dll is an ISAPI filter add-on for the IIS server and used by the IIS Server Monitoring probe. This add-on supports several versions of the IIS server and Operating Systems. You can go through the readme.txt file for supported versions and for details about how to add this functionality. The readme.txt is available at Nimsoft Installation Directory > Nimsoft > Applications > iis location. 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 library file is used. You must have the Microsoft Visual C Redistributable Package on the server running IIS (web server, not probe). You can download this Microsoft Visual C Redistributable Package from the following link: 3-D6ACABD5D13B&displaylang=en Activating the ASP Counters on IIS 7 or above Refer to the following link: Installing Metabase Compatibility Component on IIS 7 or above The IIS Server Monitoring probe displays a wrong status when monitoring local IIS 7 server. The probe requires the Metabase Compatibility component for displaying correct status which is not available on IIS 7, by default. Refer the following link for installing this component: patibility-with-iis-7-and-above Documentation Changes 11

12 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 as explained below: 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. 12 Probe Guide for IIS Server Monitoring

13 iis Server Configuration Select the ISAPI Filters tab and click the Add button. Documentation Changes 13

14 iis Server Configuration Give the filter a name and browse to add the IISRequest.dll Click OK to add the filter. Click Apply in the Properties dialog to activate the filter. Check that the filter is active: 14 Probe Guide for IIS Server Monitoring

15 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 must be **Started IISRequest**. 4. Check the output from the filter in the iis probe GUI. Note: The 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 Redistributable Package installed on the server running IIS (web server, not probe). This is the link from where you can download this package: D6ACABD5D13B&displaylang=en Documentation Changes 15

16 iis Server Configuration IISRequest: Provides status and statistics on IIS requests. Files: IISRequest.dll An IIS ISAPI filter add-on for the 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 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 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 iis probe. For IIS 7, on 64 bits versions of Windows Vista. Works the same way as the IIS ISAPI filter. Note: Any one of these DLLs is used on IIS server, based on the version of Windows and IIS server. The steps required to use the IISRequest.dll file, are as follows: 1. Locate the IISRequest.dll, IISRequest.cfg and the IISRequest.log files on the computer on which iis probe is deployed. The typical location is C:\Program Files\Nimsoft\probes\application\iis folder. The files are available only after deploying the iis probe. 2. Create a folder on the computer running IIS server, for instance C:\Inetpub\wwwroot\myserver\IISRequest and copy the IISRequest.dll, IISRequest.cfg and the IISRequest.log files to this folder. 3. 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 iis 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 <producname> probe configuration details. On WINDOWS XP, 2003: 1. Add necessary permissions to the IISRequest.cfg file by following these steps: 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. 16 Probe Guide for IIS Server Monitoring

17 iis Server Configuration 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 must be **Started IISRequest**. On WINDOWS VISTA: 1. Add necessary permissions to the IISRequest.cfg file by following these steps: 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. Important! Be careful with the path, a wrong path may 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 must be **Started IISRequest** 3. Check the output from the filter in the iis probe GUI. 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. On IIS6 and older, a restart of the IIS server is required, execute the command iisreset /restart, to properly reload the filter (for instance after an upgrade or a change to the cfg - configuration file). Uninstall is done by removing or unregistering the module from the IIS manager. An unregistering at web site level should be done first. Documentation Changes 17

18

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: Prerequisites (see page 19) Supported Platforms (see page 19) System Requirements (see page 19) Software Requirements (see page 19) Monitoring System Requirements (see page 20) Probe Deployment Information (see page 20) Prerequisites The Performance Collector probe version 1.53 or later is required before deploying the IIS Server Monitoring probe. Supported Platforms Refer to the Compatibility Support Matrix for the latest information about supported platforms. See also the Support Matrix for Probes for more specific information about the probe. 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 or later. Nimsoft robot version 5.23 or later. Java Virtual Machine version 1.6 or later. Chapter 2: iis Probe Deployment 19

20 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 three ways to distribute archive packages. You can distribute the package within the web-based Admin Console (for supported probes), from within Infrastructure Manager, or use the standalone Distribution application. 20 Probe Guide for IIS Server Monitoring

21 Chapter 3: iis Configuration v1.7 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 21) Probe Configuration Interface Installation (see page 22) iis Probe GUI Reference v1.7 (see page 22) Probe Configuration (see page 29) 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. The following table describes the application pool defaults of the IIS Server Monitoring probe: Counter Name Is Active by Default? QoS Alarm Alarm Threshold Current Worker Processes Yes Yes No - Recent Worker Process Failures No Yes No - Total Worker Process Startup Failures Yes Yes No - Current Application Pool State Yes Yes Yes!=3 Application Pool Running No Yes Yes!=1 Total Worker Process Failures Yes Yes No - Total Application Pool Recycles No Yes No - Total Worker Process Ping Failures Total Worker Process Shutdown Failures No Yes No - No Yes No - Chapter 3: iis Configuration v1.7 21

22 Probe Configuration Interface Installation Counter Name Is Active by Default? QoS Alarm Alarm Threshold Application Pool Memory Yes Yes Yes >=90% Application Pool CPU Yes Yes Yes >=75% Probe Configuration Interface Installation The probe configuration interface is automatically downloaded and installed by the Infrastructure Manager when the probe is deployed on a robot. iis Probe GUI Reference v1.7 The iis probe is configured by double-clicking the line representing the probe in the Infrastructure Manager. The probe configuration interface consists of a row of tool buttons and two window panes, as follows: Left pane (see page 23) Right pane (see page 26) Toolbar buttons (see page 28) Note: When you have made configuration modifications, you must click the Apply button to activate the new settings. 22 Probe Guide for IIS Server Monitoring

23 iis Probe GUI Reference v1.7 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 v1.7 23

24 iis Probe GUI Reference v1.7 The symbols indicate if a monitored host responds or not: Indicates that the host responds. Indicates that the host does not respond. indicates that the host is initializing and 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 41)). 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 Edit Opens the profile dialog, enabling you to define a new host to be monitored. 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. 24 Probe Guide for IIS Server Monitoring

25 iis Probe GUI Reference v1.7 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 v1.7 25

26 iis Probe GUI Reference v1.7 The Right Pane The right-pane is multi-functional and shows: Hosts when a group is selected in the left-pane. List of monitoring counters when a host is selected in the left-pane. List of checkpoints belonging to the selected class when a class is selected in the left-pane. The right-pane displays the counters status using the following symbols:note the meaning of the different icons in the window, which can be: : Counter value is not breaching the threshold value. : Counter value is breaching the threshold value. : Counter is not selected for monitoring. : Counter values is not available. : Counter value is being fetched. 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. 26 Probe Guide for IIS Server Monitoring

27 iis Probe GUI Reference v1.7 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 v1.7 27

28 iis Probe GUI Reference v1.7 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 29). 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 31). 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 31). Create a New Group Folder Creates a new group folder in the left window pane. See Create a New Group Folder (see page 33). 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 34). 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 36). 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 37). 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 41). 28 Probe Guide for IIS Server Monitoring

29 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 12)). Probe Configuration This section contains the configuration information for the iis probe. It contains the below listed sections: General Setup (see page 29) Show Summary database Status (see page 31) Show User Specified Objects (see page 31) Create a New Group Folder (see page 33) Create a New Host Profile (see page 34) Launch the Message Pool Manager (see page 36) View IIS Summary (see page 37) View IIS Server Data (Requests) (see page 39) General Setup Chapter 3: iis Configuration v1.7 29

30 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 Probe Guide for IIS Server Monitoring

31 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 v1.7 31

32 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. 32 Probe Guide for IIS Server Monitoring

33 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 v1.7 33

34 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. 34 Probe Guide for IIS Server Monitoring

35 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: or 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 v1.7 35

36 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. 36 Probe Guide for IIS Server Monitoring

37 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 v1.7 37

38 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>. 38 Probe Guide for IIS Server Monitoring

39 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 v1.7 39

40 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. 40 Probe Guide for IIS Server Monitoring

41 Probe Configuration Show/Hide Unavailable Checkpoints 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. You can click the Show/Hide checkpoints that are unavailable button in the tool bar for this purpose. 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. Configure the Counter Properties The IIS Server Monitoring displays the list of available monitoring counters in the right-pane for the selected component in the left-pane. You can configure the counter properties for generating corresponding QoS and alarm messages. Follow these steps: 1. Double-click the checkpoint in the right-pane and the Monitor Properties dialog appears. The fields in the Message Properties dialog are as follows: Description Displays the counter description. Monitoring Object Identifies the counter name. Enable Monitoring Activates the counter for generating alarms when the threshold breaches. Value Decides which value to be compared with the Threshold Value as follows: Current Value: uses the last measured value to be compared with the Threshold Value. Compute Average: calculates the average of the values as measured in the given time interval. Chapter 3: iis Configuration v1.7 41

42 Probe Configuration Operator Specifies the threshold operator while comparing the threshold value with the actual value. For example, use the => operator for generating alarm when the measured value is greater than or equal to the threshold value. Threshold Value Unit Define the alarm threshold value. Identifies the unit of the monitored value. For example, % and Mbytes. Message Token Specifies the alarm message to be issued when the threshold value is breached. These messages are kept in the message pool and can be modified there (see Launch the Message Pool Manager (see page 36)). Publish Quality of Service (QoS) Generates the QoS messages on the counter. 2. Click OK and save the counter properties. 3. Click Apply on the probe interface for applying the changes. The probe is restarted and starts measuring the counter value for generating QoS and alarm messages. 42 Probe Guide for IIS Server Monitoring

43 Probe Configuration Monitor Application Pools An application pool lets you run web sites or URL in groups. Each group is part of the different application pool. Each application pool runs in a different worker process of the IIS server where each worker process runs in isolation. This isolation prevents other application pools from going down when one application pool is down. You can also define different security rights for each application pool. The IIS Server Monitoring probe lets you select more than one application pools of the IIS server for monitoring. Being a web site administrator, monitoring the heath and status of the application pool is important. This monitoring ensures the web site availability and response time at an expected level. Important! The Application Pool monitoring feature is supported for IIS 7.0 or later. The APP_POOL_WAS counter must be available on the Windows Performance Monitor of the system where IIS 7.0 server or later is installed. The probe gives the following list of counters for monitoring the application pool: Current Worker Processes: fetches the total number of worker processes that are currently running in the application pool. Recent Worker Process Failures: fetches the total number of times that worker processes for the application pool has failed during the rapid-fail protection interval. Total Worker Process Startup Failures*: fetches the total number of times the Windows Process Activation Service (WAS) has failed to start a worker process. Current Application Pool State: fetches the current status value of the application pool, which can be one of the following values: 1 - Uninitialized 2 - Initialized 3 - Running 4 - Disabling 5 - Disabled 6 - Shutdown Pending 7 - Delete Pending Application Pool Running: fetches the current running status of the application pool, which can be one of the following values: 1 - Running 0 - Not Running Total Worker Process Failures*: fetches the total number of times the worker processes have crashed after starting the application pool. Chapter 3: iis Configuration v1.7 43

44 Probe Configuration Total Application Pool Recycles*: fetches the total number of times the application pool is recycled after the WAS is started. Total Worker Process Ping Failures*: fetches the total number of times the WAS has failed to receive a ping response from the worker process. Total Worker Process Shutdown Failures*: fetches the total number of times the WAS has failed to shut down a worker process. Application Pool Memory: fetches the total memory all the worker processes of the application pool. Application Pool CPU: fetches the total CPU used by all the worker processes of the application pool. Note: The counters marked with an asterisk (*) return the difference between values of the current and last monitoring interval. You can configure more than one counter for each application pool for monitoring, after adding the IIS server host to the probe. Follow these steps: 1. Right-click the Application Pool group for the appropriate IIS host and select the Rediscover option. 2. Select the appropriate application pool from the Available Application Pools list to the Selected Application Pools list. 3. Click OK. The selected application pools appear under the Application Pool group in the left-pane. 4. Select the application pool from the left-pane and its counters are displayed in the right-pane. 5. Select the check box for each checkpoint and activate the counter for monitoring. 6. Double-click the counter and configure the counter properties in the Monitor Properties dialog. The probe start fetching values for the activated counters of the application pool for generating QoS and alarm messages. 44 Probe Guide for IIS Server Monitoring

45 Chapter 4: IIS Server Monitoring (iis) Metrics Many CA Nimsoft Monitor probes ship with the default QoS threshold values set. These 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: QoS Metrics (see page 45) iis Alert Metrics Default Settings (see page 47) QoS Metrics This section contains the QoS metrics for the IIS Server Monitoring probe. Monitor Name Units Description QOS_ASYNCIO_BWUSAGE Measured Async I/O Bandwidth Usage Measured Async I/O Bandwidth QOS_BYTESRECEIVD_PS Bytes received/sec Web server bytes received per QOS_BYTESSENT_PS Bytes sent/sec Web server bytes sent per seco QOS_BYTESTOTAL_PS Bytes Total/sec Web server bytes total per seco QOS_CONNATTEMPTS_PS Connection attempts/sec QOS_CPU_USAGE Percent CPU Usage Connection attempts per secon QOS_CURRENTCONNECTS Current connections Current connections QOS_IIS_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 % Chapter 4: IIS Server Monitoring (iis) Metrics 45

46 QoS Metrics Monitor Name Units Description QOS_MEMORY_USAGE Megabytes Memory Usage QOS_MEMORYAVAILPHYS Megabytes Physical Memory available QOS_NETWORK_BTPS Bytes Total/sec Network interface bytes total p 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 QoS on Application Pool Units Description QOS_IIS_RECENT_WRKR_PROCESSES_FAILURE Total number of times the wor the application pool has failed rapid-fail protection interval. QOS_IIS_WRKR_PROCESSES Count Total number of worker proces currently running in the applica QOS_IIS_TOT_WRKR_PROCESS_STARTUP_FAILU RE Count Total number of times the Win Activation Service (WAS) has fa worker process. QOS_IIS_APP_RUNNING_STATE State Current status value of the app QOS_IIS_APP_RUNNING State Current running status of the a QOS_IIS_TOT_WRKR_PROCESSES_FAILURE Count Total number of times the wor crashed after starting the appli QOS_IIS_TOT_APP_POOLS_RECYCLES Count Total number of times the appl recycled after the WAS is starte QOS_IIS_TOT_WRKR_PROCESSES_PING_FAILURE S QOS_IIS_TOT_WRKR_PROCESSES_SHUTDOWN_F AILURES Count Count Total number of times the WAS receive a ping response from th Total number of times the WAS down a worker process. QOS_IIS_APP_POOL_MEMORY Percent Total memory used by all work the application pool. QOS_IIS_APP_POOL_CPU Percent Tota work the a 46 Probe Guide for IIS Server Monitoring

47 iis Alert Metrics Default Settings 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 Chapter 4: IIS Server Monitoring (iis) Metrics 47