Вы находитесь на странице: 1из 344

Tivoli IBM Tivoli Monitoring for Microsoft Applications, V6.2.

0 Interim Feature 1: Microsoft Internet Information Services Agent V6.2.0.1

Users Guide

SC27-2314-01

Tivoli IBM Tivoli Monitoring for Microsoft Applications, V6.2.0 Interim Feature 1: Microsoft Internet Information Services Agent V6.2.0.1

Users Guide

SC27-2314-01

Note Before using this information and the product it supports, read the information in Appendix E, Notices, on page 317.

This edition applies to version 6.2.0.1 of IBM Tivoli Monitoring for Microsoft Applications: Microsoft Internet Information Services Agent (product number 5724-U17) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2008, 2009. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents
Tables . . . . . . . . . . . . . . . vii Chapter 1. Overview of the Monitoring Agent for Microsoft Internet Information Services . . . . . . . . . . . . . . 1
IBM Tivoli Monitoring overview . . . . Features of the monitoring agent . . . Functions of the monitoring agent . . . New in this release . . . . . . . . Components of the IBM Tivoli Monitoring environment . . . . . . . . . . User interface options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 1 4 FTP Server Site Status attribute group . . . . FTP Service attribute group . . . . . . . . FTP Version Information attribute group. . . . HTTP Custom Error Messages attribute group. . Http Error Log attribute group . . . . . . . IIS Application Pools Setting attribute group . . IIS Components attribute group . . . . . . IIS FTP Server Bindings attribute group . . . . IIS FTP Server Status attribute group . . . . . IIS FTP Sites Detail attribute group . . . . . IIS NNTP Server Status attribute group . . . . IIS SMTP Server Status attribute group . . . . IIS Version Information attribute group . . . . IIS Web Server Bindings attribute group . . . . IIS Web Server Site Status attribute group . . . IIS Web Server Status attribute group. . . . . IIS Web Sites Detail attribute group . . . . . Internet Information Services Gl attribute group . Microsoft FTP Service attribute group . . . . Mime Types attribute group . . . . . . . . NNTP Server attribute group . . . . . . . NNTP Version Information attribute group . . . Performance Object Status attribute group . . . SMTP Server attribute group . . . . . . . SMTP Version Information attribute group . . . Thread Pool Status attribute group . . . . . W3SVC W3WP attribute group . . . . . . WAS W3WP attribute group . . . . . . . Web Service attribute group . . . . . . . Web Service Cache attribute group . . . . . Web Service Extensions Restricted List attribute group . . . . . . . . . . . . . . . Disk capacity planning for historical data . . . . 40 . 41 . 48 . 49 . 50 . 52 . 64 . 65 . 66 . 67 . 68 . 69 . 70 . 71 . 72 . 73 . 74 . 75 . 80 . 87 . 88 . 89 . 90 . 94 . 95 . 96 . 100 . 111 . 115 . 128 . 132 . 134

. 5 . 5

Chapter 2. Requirements and agent-specific installation and configuration information for the monitoring agent . . . . . . . . . . . 7
Requirements for the monitoring agent . . . . . 7 Installing language packs . . . . . . . . . . 9 Windows systems. . . . . . . . . . . . 9 UNIX or Linux systems. . . . . . . . . . 9 Agent-specific installation and configuration . . . 10 Configuration values . . . . . . . . . . 10 Remote installation and configuration . . . . 10

Chapter 3. Workspaces reference . . . 11


About workspaces . . . . . . . . More information about workspaces . . Cross-linked workspaces . . . . . . Predefined workspaces . . . . . . Agent Navigator items . . . . . . Microsoft Internet Information Services item . . . . . . . . . . . . Active Server Pages Navigator item . ASP NET Navigator item . . . . . Availability Navigator item . . . . Event Log Navigator item . . . . FTP Server Navigator item . . . . IIS Configuration Navigator item . . IIS Global Navigator item . . . . NNTP Server Navigator item . . . SMTP Server Navigator item . . . Web Server Navigator item . . . . Worker Process Navigator item . . . . . . . . . . . . . . . . . . . . . . . Navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 11 11 12 13 13 14 15 15 16 16 18 19 20 20 20 22

Chapter 5. Situations reference. . . . 137


About situations . . . . . . . . . . . More information about situations . . . . . Predefined situations . . . . . . . . . . Microsoft Internet Information Services Navigator item . . . . . . . . . . . . . . . Active Server Pages Navigator item . . . . . KQ7_ASP_Que_Size_Increased situation . . KQ7_ASP_Req_Dispatch_Slow situation . . KQ7_ASP_Req_Que_Size_Large situation . . KQ7_ASP_High_Error_Rate situation . . . ASP NET Navigator item . . . . . . . . Availability Navigator item . . . . . . . . KQ7_Web_Server_Down situation . . . . KQ7_IISADMIN_Service_Down situation . . KQ7_WAS_Service_Down situation . . . . KQ7_AppHostSvc_Service_Down situation . KQ7_WMSvc_Service_Down situation . . . KQ7_MSFtpsvc_Service_Down situation . . KQ7_SMTPSVC_Service_Down situation . . KQ7_NntpSvc_Service_Down situation . . . . 137 . 137 . 138 . . . . . . . . . . . . . . . . 140 140 140 141 141 142 142 142 142 143 143 144 145 145 146 146

Chapter 4. Attributes reference . . . . 23


About attributes . . . . . . . . . . . . More information about attributes . . . . . . Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services Active Server Pages attribute group . . . . . ASP NET attribute group . . . . . . . . . Availability attribute group . . . . . . . . Event Log attribute group . . . . . . . .
Copyright IBM Corp. 2008, 2009

. 23 . 23 . . . . . 23 26 34 35 39

iii

KQ7_HTTPFilter_Service_Down situation . . . KQ7_NetPipeAct_Service_Down situation . . . KQ7_NetTcpAct_Service_Down situation . . . KQ7_NetMsmqAct_Service_Down situation . . KQ7_NetTcpPShr_Service_Down situation . . . KQ7_Ftpsvc_Service_Down situation . . . . Event Log Navigator item . . . . . . . . . KQ7_WP_Start_Fail situation . . . . . . . KQ7_App_Load_Fail situation . . . . . . . KQ7_VirtualDir_CfgLost situation . . . . . KQ7_W3_ETW_Tracing_Init_Failed situation KQ7_WP_Memory_Leak situation . . . . . KQ7_W3SVC_App_Pool_Cmd_Err situation . . KQ7_W3SVC_Bind_Fail_Invald_URL situation KQ7_FTP_Pasport_MB_Access_Fail situation KQ7_W3SVC_Fail_2_Set_Queue_Len situation KQ7_WAS_Fail_To_Config_Job_Obj situation KQ7_FTP_Pasvport_Invalid_Value situation . . KQ7_IISWMSVC_Login_Unknown_Err situation KQ7_WMSVC_Auth_Read_Conf_Err situation KQ7_WMSVC_SvcHand_Unknown_Err situation . . . . . . . . . . . . . . KQ7_WMSVC_UNABLE_2_READ_SETGS situation . . . . . . . . . . . . . . KQ7_Process_Stop_Responding situation . . . KQ7_WP_Terminated situation . . . . . . KQ7_AppHostSvc_SID_Config_Err situation . . KQ7_AppHostSvc_Hist_Config_Err situation KQ7_W3SVC_Binding_Fail situation. . . . . KQ7_W3SVC_Listen_2_Many_Port situation . . KQ7_W3SVC_Filters_Load_Fail situation . . . KQ7_W3SVC_Fail_2_Init situation . . . . . KQ7_W3SVC_Perfmon_Init_Err situation . . . KQ7_W3_Out_Of_Memory situation. . . . . KQ7_WPHOST_Failed_Init situation. . . . . KQ7_WP_Module_DLL_Load_Fail situation . . KQ7_WAS_Process_Creation_Fail situation . . KQ7_W3_Fail_2_Create_FREB_Dir situation . . KQ7_WAS_Rapid_Fail_Protection situation . . KQ7_WAS_Fail_2_Reg_Protocol situation . . . KQ7_FTP_System_Call_Failed situation. . . . KQ7_WAS_High_Load_Dynamic_Idle situation FTP Server Navigator item . . . . . . . . . KQ7_FTP_Site_Down situation . . . . . . IIS Configuration Navigator item . . . . . . . KQ7_HTTP_Log_Serv_Unavailable situation . . IIS Global Navigator item . . . . . . . . . NNTP Server Navigator item . . . . . . . . SMTP Server Navigator item . . . . . . . . Web Server Navigator item . . . . . . . . . KQ7_Web_TooMany_Requests situation . . . KQ7_Web_TooMany_Connections situation . . KQ7_Web_TooMany_KB_Sent situation . . . . KQ7_Web_TooMany_KB_Received situation . . KQ7_IIS_Web_Site_Down situation . . . . . Worker Process Navigator item . . . . . . .

147 147 148 149 149 150 150 150 151 151 152 152 153 154 154 155 155 156 156 157 157 158 159 159 160 160 161 161 162 162 163 163 164 165 165 166 166 167 167 168 169 169 169 169 170 170 170 170 170 171 171 172 172 173

Predefined Take Action commands . . . . . Start Application Host Helper Service action . . Start FTP Publishing Service action . . . . . Start FTP Site action . . . . . . . . . . Start FTP Site by Name action . . . . . . . Start HTTP SSL Service action . . . . . . . Start IIS Admin Service action . . . . . . . Start IIS Web Server action . . . . . . . . Start Microsoft FTP Service action . . . . . Start Net.Msmq Listener Adapter Service action Start Net.Pipe Listener Adapter Service action . Start Net.Tcp Listener Adapter Service action . . Start Net.Tcp Port Sharing Service action . . . Start Network News Transfer Protocol Service action . . . . . . . . . . . . . . . Start Simple Mail Transfer Protocol Service action Start Web Management Service action . . . . Start Website action . . . . . . . . . . Start Website by Name action . . . . . . . Start Windows Process Activation Service action Stop Application Host Helper Service action . . Stop FTP Publishing Service action . . . . . Stop FTP Site action . . . . . . . . . . Stop FTP Site by Name action . . . . . . . Stop HTTP SSL Service action . . . . . . . Stop IIS Admin Service action . . . . . . . Stop IIS Web Server action . . . . . . . . Stop Microsoft FTP Service action . . . . . Stop Net.Msmq Listener Adapter Service action Stop Net.Pipe Listener Adapter Service action . Stop Net.Tcp Listener Adapter Service action . . Stop Net.Tcp Port Sharing Service action . . . Stop Network News Transfer Protocol Service action . . . . . . . . . . . . . . . Stop Simple Mail Transfer Protocol Service action Stop Web Management Service action . . . . Stop Website action . . . . . . . . . . Stop Website by Name action . . . . . . . Stop Windows Process Activation Service action

. . . . . . . . .

175 176 177 178 179 180 180 181 182 183 . 184 . 185 . 185

. 186 187 . 188 . 189 . 190 190 . 191 . 192 . 192 . 193 . 194 . 194 . 195 . 195 196 . 196 . 197 . 198 . 198 199 . 199 . 200 . 200 201

Chapter 7. Policies reference. . . . . 203


About policies . . . . . . . More information about policies . Predefined policies . . . . . . . . . . . . . . . . . . . . . 203 . 203 . 203

Chapter 8. Tivoli Common Reporting for the monitoring agent . . . . . . 205


Category 1: Performance reports . . . . . . Web Service Data Transfer report . . . . . Web Service Data Transfer Subreport . . . Web Service Files Transfer report . . . . . Web Service Files Transfer Subreport . . . Web Service Anonymous And NonAnonymous Users report . . . . . . . . . . . . Web Service Anonymous and NonAnonymous Users Subreport . . . . . . . . . . Web Service Connection And Logon Attempts report . . . . . . . . . . . . . . Web Service Connection And Logon Attempts Subreport. . . . . . . . . . . . . . . . . . 208 208 210 212 213

. 215 . 216 . 217 . 219

Chapter 6. Take Action commands reference . . . . . . . . . . . . . 175


About Take Action commands. . . . . . . More information about Take Action commands . 175 175

iv

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Web Service HTTP Requests report . . . . . Web Service HTTP Requests Subreport . . . . Web Service Request Errors and Error Rate report . . . . . . . . . . . . . . . FTP Service Files Transfer report [FTP 6.0]. . . FTP Service Files Transfer Subreport [FTP 6.0] FTP Service Anonymous And NonAnonymous Users report [FTP 6.0] . . . . . . . . . FTP Service Anonymous and NonAnonymous Users Subreport [FTP 6.0] . . . . . . . . FTP Service Connection And Logon Attempts report [FTP 6.0]. . . . . . . . . . . . FTP Service Connection And Logon Attempts Subreport [FTP 6.0] . . . . . . . . . . Active Server Pages Request And Error report Active Server Pages Transactions report . . . Active Server Pages Requests report . . . . . Microsoft FTP Service Files Transfer report [FTP 7.0] . . . . . . . . . . . . . . . . Microsoft FTP Service Files Transfer Subreport [FTP 7.0] . . . . . . . . . . . . . . Microsoft FTP Service Connection And Logon Attempts report [FTP 7.0] . . . . . . . . Microsoft FTP Service Connection And Logon Attempts Subreport [FTP 7.0] . . . . . . . Category 2: Memory Utilization reports . . . . Web Service Cache Utilization report . . . . IIS Global Cache Utilization report . . . . . ASP.NET Site Cache Memory Usage report . . ASP.NET Site Cache Memory Usage Subreport Category 3: Availability reports . . . . . . . Web Site Availability report. . . . . . . . Web Site Availability Subreport . . . . . . Web Server Availability report . . . . . . . FTP Site Availability report . . . . . . . . FTP Site Availability Subreport . . . . . . FTP Server Availability report . . . . . . . Web Server Availability In Terms Of Hours report [Hourly Heat Map] . . . . . . . . Web Server Availability In Terms Of Hours report [Daily Heat Map] . . . . . . . . . FTP Server Availability In Terms Of Hours report [Hourly Heat Map] . . . . . . . . FTP Server Availability In Terms Of Hours report [Daily Heat Map] . . . . . . . . . Category 4: Event details report . . . . . . . IIS Event Log report . . . . . . . . . .

220 221 223 224 226 228 229 230 232 233 234 235 236 238 240 241 242 242 243 245 246 248 248 248 249 250 251 251 252 253 254 254 255 255

Built-in troubleshooting features . . . . . . Problem classification. . . . . . . . . . Trace logging . . . . . . . . . . . . Overview of log file management . . . . Principal trace log files . . . . . . . . Setting RAS trace parameters . . . . . . Problems and workarounds . . . . . . . Installation and configuration troubleshooting Remote deployment troubleshooting . . . Agent troubleshooting . . . . . . . . Workspace troubleshooting . . . . . . . Situation troubleshooting . . . . . . . Take Action commands troubleshooting . . Tivoli Common Reporting troubleshooting . Support information . . . . . . . . . . Informational, warning, and error messages . . Message format . . . . . . . . . . Monitoring Agent for Microsoft Internet Information Services messages . . . . .

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

257 258 258 258 259 261 263 263 266 266 271 275 278 279 281 281 282

. 282

Appendix A. IBM Tivoli Enterprise Console event mapping . . . . . . . 293 Appendix B. Discovery Library Adapter for the monitoring agent . . . 309
About the DLA. . . . . . . More information about DLAs. . Microsoft IIS DLA data model class represented in CDM . . . . . IIsWebServer class . . . . . IISWebServices class . . . . IIsModule class . . . . . . TMSAgent class . . . . . . . . . types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 . 309 . . . . . 309 309 310 311 311

Appendix C. Documentation library


Monitoring Agent for Microsoft Internet Information Services library . . . . Prerequisite publications. . . . . . Related publications . . . . . . . Other sources of documentation . . . . . . . . . . . . . . .

313
. . . . 313 313 314 314

Appendix D. Accessibility . . . . . . 315


Navigating the interface using the keyboard . Magnifying what is displayed on the screen . . . . 315 . 315

Appendix E. Notices . . . . . . . . 317


Trademarks . . . . . . . . . . . . . . 319

Chapter 9. Troubleshooting . . . . . 257


Gathering product information for IBM Software Support . . . . . . . . . . . . . . . 257

Index . . . . . . . . . . . . . . . 321

Contents

vi

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Tables
1. 2. 3. 4. Supported operating system and application versions . . . . . . . . . . . . . . 7 Cross-linked workspaces to the .NET Framework agent . . . . . . . . . . 11 Cross-linked workspaces to the Windows OS agent. . . . . . . . . . . . . . . 12 Capacity planning for historical data logged by IBM Tivoli Monitoring for Microsoft Applications, V6.2.0 Interim Feature 1: Microsoft Internet Information Services Agent V6.2.0.1 . . . . . . . . . . . . . 135 Supported databases . . . . . . . . . 205 Information to gather before contacting IBM Software Support . . . . . . . . . . 257 Trace log files for troubleshooting agents 259 Problems and solutions for installation and configuration . . . . . . . . . . . 264 9. 10. 11. 12. 13. 14. 15. 16. 17. General problems and solutions for uninstallation . . . . . . . . . . . Remote deployment problems and solutions Agent problems and solutions . . . . . . Workspace problems and solutions . . . . General situation problems and solutions Problems with configuring situations that you solve in the Situation Editor . . . . . . Problems with configuration of situations that you solve in the Workspace area . . . . . Take Action commands problems and solutions . . . . . . . . . . . . . Tivoli Common Reporting for Monitoring Agent for Microsoft Internet Information Services problems and solutions . . . . . 265 266 267 272 275 276 277 278

5. 6. 7. 8.

279

Copyright IBM Corp. 2008, 2009

vii

viii

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 1. Overview of the Monitoring Agent for Microsoft Internet Information Services
The Monitoring Agent for Microsoft Internet Information Services provides you with the capability to monitor Microsoft Internet Information Server, and to perform basic actions with Microsoft Internet Information Server. This chapter provides a description of the features, components, and interface options for the Monitoring Agent for Microsoft Internet Information Services.

IBM Tivoli Monitoring overview


IBM Tivoli Monitoring is the base software for the Monitoring Agent for Microsoft Internet Information Services. IBM Tivoli Monitoring provides a way to monitor the availability and performance of all the systems in your enterprise from one or several designated workstations. It also provides useful historical data that you can use to track trends and to troubleshoot system problems. You can use IBM Tivoli Monitoring to perform the following tasks: v Monitor for alerts on the systems that you are managing by using predefined situations or custom situations. v Establish your own performance thresholds. v Trace the causes leading to an alert. v Gather comprehensive data about system conditions. v Use policies to perform actions, schedule work, and automate manual tasks. The Tivoli Enterprise Portal is the interface for IBM Tivoli Monitoring products. By providing a consolidated view of your environment, the Tivoli Enterprise Portal permits you to monitor and resolve performance issues throughout the enterprise. See the IBM Tivoli Monitoring publications listed in Prerequisite publications on page 313 for complete information about IBM Tivoli Monitoring and the Tivoli Enterprise Portal.

Features of the monitoring agent


The Monitoring Agent for Microsoft Internet Information Services software can identify, notify you of, and correct common problems with the application that it monitors. The software includes the following features: v Monitoring v Data gathering v Event management v Operations management

Functions of the monitoring agent


The Monitoring Agent for Microsoft Internet Information Services provides the following functions: Availability Monitoring Monitors the following services and processes:
Copyright IBM Corp. 2008, 2009

v v v v v v v v v v v v v v v v

IIS Admin Service World Wide Web Publishing Service FTP Publishing Service [MS FTP V6.0] Network News Transfer Protocol (NNTP) Service [MS IIS V6.0] Simple Mail Transfer Protocol (SMTP) Service HTTP SSL Service [MS IIS V6.0] Windows Process Activation Service (WAS) [MS IIS V7.0] Application Host Helper Service [MS IIS V7.0] Web Management Service [MS IIS V7.0] Net.Pipe Listener Adapter Service [MS IIS V7.0] Net.Tcp Listener Adapter Service [MS IIS V7.0] Net.Msmq Listener Adapter Service [MS IIS V7.0] Net.Tcp Port Sharing Service Microsoft FTP Service [MS FTP V7.0] DCOM DLL Host Process ASP.Net Worker Process

Note: The services for which the IIS version is not explicitly mentioned are applicable to both IIS V6.0 and IIS V7.0. Error and Event log Monitoring Monitors for the following event sources affecting Microsoft IIS Server availability or performance: v IISADMIN v FtpCtrs v v v v v v v IISInfoCtrs W3Ctrs W3SVC-WP HostableWebCore Microsoft-Windows-IIS-IISManager WMSVC IISService

v WAS-LA v Http v v v v v IIS Config IISCTLS IISLOG IISMAP IISWMI

v isapnp v MSFTPSVC v v v v v NNTPSVC SMTPSVC W3SVC APPHOSTSVC IIS-METABASE

v SMSvcHost 3.0.0.0

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v v v v

WAS FTPSVC DCOM IIS-METABASE

Performance monitoring Collects performance attributes in the following areas, providing situations where appropriate: v Web Service v v v v v v v v v v v v Web Service Cache Internet Information Service Gl FTP Service ASP ASP.NET Applications WAS-W3WP W3SVC-W3WP IIS IIS IIS IIS IIS Web Server Status FTP Server Status SMTP Server Status NNTP Server Status Version Information

v Microsoft FTP Service

v FTP Version Information v SMTP Version Information v NNTP Version Information v IIS Web Server Sites Status v FTP Server Sites Status v v v v v v v v SMTP Server NNTP Server IIS Components Application Pools Settings Mime Types HTTP Error Log Web Service Extensions Restricted List HTTP Custom Error Messages

v IIS Web Server Bindings v IIS Web Sites Detail v IIS FTP Server Bindings v IIS FTP Sites Detail Actions Provides actions to start and stop the Web site, FTP sites, and the following services: v IIS Admin Service v World Wide Web Publishing Service v FTP Publishing Service v Network News Transfer Protocol (NNTP) Service
Chapter 1. Overview of the Monitoring Agent for Microsoft Internet Information Services

v v v v v v v v v v

Simple Mail Transfer Protocol (SMTP) Service HTTP SSL Service Windows Process Activation Service (WAS) Application Host Helper Service Web Management Service Net.Pipe Listener Adapter Service Net.Tcp Listener Adapter Service Net.Msmq Listener Adapter Service Net.Tcp Port Sharing Service Microsoft FTP Service

Reporting Provides a history enablement file that generates reports for all attributes collected.

New in this release


For version 6.2.0.1 of the Monitoring Agent for Microsoft Internet Information Services, the following enhancements have been made since version 6.2: v Additional supported operating systems as listed in Requirements for the monitoring agent on page 7 v New attribute groups IIS Web Server Bindings IIS Web Sites Detail IIS FTP Server Bindings IIS FTP Sites Detail v New situations KQ7_AppHostSvc_SID_Config_Err KQ7_AppHostSvc_Hist_Config_Err KQ7_W3SVC_Binding_Fail KQ7_W3SVC_Listen_2_Many_Port KQ7_W3SVC_Filters_Load_Fail KQ7_W3SVC_Fail_2_Init KQ7_W3SVC_Perfmon_Init_Err KQ7_W3_Out_Of_Memory

KQ7_WPHOST_Failed_Init KQ7_WP_Module_DLL_Load_Fail KQ7_WAS_Process_Creation_Fail KQ7_W3_Fail_2_Create_FREB_Dir KQ7_WAS_Rapid_Fail_Protection KQ7_WAS_Fail_2_Reg_Protocol KQ7_FTP_System_Call_Failed

KQ7_WAS_High_Load_Dynamic_Idle v New Take Actions commands Start Website by Name WebSiteName Stop Website by Name WebSiteName Start FTP Site by Name FTPSiteName

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Stop FTP Site by Name FTPSiteName v Updated kq7.baroc file to support TEC event mapping v Integration with the Tivoli Common Reporting infrastructure to create historical reports from the data that is collected in the Tivoli Data Warehouse.

Components of the IBM Tivoli Monitoring environment


After you install and set up the Monitoring Agent for Microsoft Internet Information Services, you have an environment that contains the client, server, and monitoring agent implementation for IBM Tivoli Monitoring that contains the following components: v Tivoli Enterprise Portal client with a Java-based user interface for viewing and monitoring your enterprise. v Tivoli Enterprise Portal Server that is placed between the client and the Tivoli Enterprise Monitoring Server and enables retrieval, manipulation, and analysis of data from the monitoring agents. The Tivoli Enterprise Portal Server is the central repository for all user data. v Tivoli Enterprise Monitoring Server that acts as a collection and control point for alerts received from the monitoring agents, and collects their performance and availability data. The Tivoli Enterprise Monitoring Server is also a repository for historical data. v Tivoli Enterprise Monitoring Agent, Monitoring Agent for Microsoft Internet Information Services. This monitoring agent collects and distributes data to a Tivoli Enterprise Portal Server. v IBM Tivoli Enterprise Console is an optional component, which acts as a central collection point for events from a variety of sources, including those from other Tivoli software applications, Tivoli partner applications, custom applications, network management platforms, and relational database systems. You can view these events through the Tivoli Enterprise Portal (using the event viewer), and you can forward events from IBM Tivoli Monitoring situations to the IBM Tivoli Enterprise Console component. v Tivoli Common Reporting is a separately installable feature available to users of Tivoli software that provides a consistent approach to generating and customizing reports. Some individual products provide reports that are designed for use with Tivoli Common Reporting, and have a consistent look and feel.

User interface options


Installation of the base software and other integrated applications provides the following interfaces that you can use to work with your resources and data: Tivoli Enterprise Portal browser client interface The browser client interface is automatically installed with the Tivoli Enterprise Portal Server. To start the Tivoli Enterprise Portal browser client in your Internet browser, enter the URL for a specific Tivoli Enterprise Portal browser client installed on your Web server. Tivoli Enterprise Portal desktop client interface The desktop client interface is a Java-based graphical user interface (GUI) on a Windows or Linux workstation. IBM Tivoli Enterprise Console An event management application that integrates system, network, database, and application management to help ensure the optimal availability of an IT services for an organization.
Chapter 1. Overview of the Monitoring Agent for Microsoft Internet Information Services

Manage Tivoli Enterprise Monitoring Services window The window for the Manage Tivoli Enterprise Monitoring Services utility is used for configuring the agent and starting Tivoli services not already designated to start automatically. Tivoli Common Reporting A Web user interface for specifying report parameters and other report properties, generating formatted reports, scheduling reports, and viewing reports. The user interface is based on the Tivoli Integrated Portal.

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 2. Requirements and agent-specific installation and configuration information for the monitoring agent
This chapter contains information about the requirements for the Monitoring Agent for Microsoft Internet Information Services, and agent-specific information related to installation and configuration of the agent. To install and configure the Monitoring Agent for Microsoft Internet Information Services, use the procedures for installing monitoring agents in the IBM Tivoli Monitoring Installation and Setup Guide along with the information in this chapter. If you are performing a silent installation using a response file, see the information about performing a silent installation in the IBM Tivoli Monitoring Installation and Setup Guide.

Requirements for the monitoring agent


In addition to the requirements described in the IBM Tivoli Monitoring Installation and Setup Guide, the Monitoring Agent for Microsoft Internet Information Services has the following requirements: v The monitoring agent runs on any of these operating systems:
Table 1. Supported operating system and application versions Operating system versions Windows Web Edition 2003 (32 bit) with Service Pack 1 Microsoft Internet Information Services IIS V6.0 Yes No No No No No No No No Yes Yes Yes IIS V7.0

Windows Server 2003 SE (32 bit) with Service Yes Pack 1 or Service Pack 2 Windows Server 2003 EE (32 bit) with Service Yes Pack 1 or Service Pack 2 Windows Server 2003 Datacenter Edition (32 bit) with Service Pack 1 Yes

Windows Server 2003 SE (64 bit) with Service Yes Pack 1 or Service Pack 2 Windows Server 2003 EE (64 bit) with Service Yes Pack 1 or Service Pack 2 Windows Server 2003 Datacenter Edition (64 bit) with Service Pack 1 Windows Server 2003 on Itanium2 (IA64) with Service Pack 2 Windows Web Edition 2008 (32 bit) with Service Pack 1 Yes Yes No

Windows Server 2008 SE (32 bit) with Service No Pack 1 Windows Server 2008 EE (32 bit) with Service No Pack 1

Copyright IBM Corp. 2008, 2009

Table 1. Supported operating system and application versions (continued) Operating system versions Windows Server 2008 Datacenter Edition (32 bit) with Service Pack 1 Windows Web Edition 2008 (64 bit) with Service Pack 1 Microsoft Internet Information Services IIS V6.0 No No Yes Yes Yes Yes Yes Yes Yes Yes IIS V7.0

Windows Server 2008 SE (64 bit) with Service No Pack 1 Windows Server 2008 EE (64 bit) with Service No Pack 1 Windows Server 2008 Datacenter Edition (64 bit) Windows Server 2008 on Itanium2 (IA64) with Service Pack 1 No No

Windows Server 2008 Datacenter on Itanium2 No (IA64) Virtual machines that are created on Hyper-V Yes Server 2008 (64 bit)

The operating system user account must have administrative privileges. The agent service runs under the operating system user account. Note: For the most current information about the operating systems that are supported, see http://www-306.ibm.com/software/sysmgmt/products/ support/Tivoli_Supported_Platforms.html. v This agent monitors the following versions: Microsoft Internet Information Server v6.0, v7.0 v A single computer that hosts the hub monitoring server, portal server, and a monitoring agent requires approximately 300 MB of space. A computer that hosts only the monitoring agent requires approximately 30 MB of space, including the specific enablement code for the monitoring agent. More space is required for each additional monitoring agent that you deploy on the monitoring computer. v The monitoring agent must be connected to the following software: IBM Tivoli Monitoring V6.2.0 Fix Pack 1 or later. After you install the prerequisite software, install the following software, which is required for the Monitoring Agent for Microsoft Internet Information Services to operate: Monitoring Agent for Microsoft Internet Information Services Monitoring Agent for Microsoft Internet Information Services for Tivoli Enterprise Monitoring Server support Monitoring Agent for Microsoft Internet Information Services for Tivoli Enterprise Portal Server support Monitoring Agent for Microsoft Internet Information Services for Tivoli Enterprise Portal Desktop Client support Monitoring Agent for Microsoft Internet Information Services for Tivoli Enterprise Portal Browser Client support

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Installing language packs


To install a language pack for the agent support files on the Tivoli Enterprise Monitoring Server, the Tivoli Enterprise Monitoring Agent, and the Tivoli Enterprise Portal Server, first make sure that you have already installed the product in English, then perform the following steps depending on which operating system you are using.

Windows systems
1. Double-click lpinstaller.bat in the language pack CD to launch the installation program. 2. Select the language of the installer and click OK. 3. Click Next on the Introduction panel. 4. Click Add/Update and click Next. 5. Select the folder in which the National Language Support package (NLSPackage) files are located. Note: Usually the NLSPackage files are located in the nlspackage folder where the installer executable is located. 6. Select the language support for the agent of your choice and click Next. Note: Hold down the Ctrl key for multiple selections. 7. Select the languages that you want to install and click Next. 8. Examine the installation summary page and click Next to begin installation. 9. Click Finish after installation completes to exit the installer. 10. Restart Tivoli Enterprise Portal Desktop Client, Tivoli Enterprise Portal Server, and Eclipse Help Server if any of these components are installed.

UNIX or Linux systems


1. Run the following command to create a temporary directory on the computer. Make sure that the full path of the directory does not contain any spaces:
mkdir dir_name

2. Mount the language pack CD to the temporary directory you just created. 3. Run the following command to launch the installation program:
cd dir_name lpinstaller.sh -c ITM Home Directory

4. 5. 6. 7.

Where ITM Home Directory is where you installed IBM Tivoli Monitoring. Usually it is /opt/IBM/ITM for AIX and Linux. Select the language of the installer and click OK. Click Next on the Introduction panel. Click Add/Update and click Next. Select the folder in which the National Language Support package (NLSPackage) files are located.

Note: Usually, the NLSPackage files are located in the nlspackage folder where the installer executable is located. 8. Select the language support for the agent of your choice and click Next. Note: Hold down the Ctrl key for multiple selections.
Chapter 2. Requirements and agent-specific installation and configuration information for the monitoring agent

9. 10. 11. 12.

Select the languages that you want to install and click Next. Examine the installation summary page and click Next to begin installation. Click Finish after installation completes to exit the installer. Restart Tivoli Enterprise Portal Desktop Client, Tivoli Enterprise Portal Server, and Eclipse Help Server if any of these components are installed.

Agent-specific installation and configuration


In addition to the installation and configuration information in the IBM Tivoli Monitoring Installation and Setup Guide, use the information in this section to install and configure the Monitoring Agent for Microsoft Internet Information Services. No special setup is necessary to manage this application.

Configuration values
For both local and remote configuration, provide the configuration values for the agent to operate. When configuring an agent, a panel is displayed so you can enter each value. When there is a default value, this value is pre-entered into the field. If a field represents a password, two entry fields are displayed. You must enter the same value in each field. The values you type are not displayed to help maintain the security of these values. The configuration for this agent is organized into the following groups: HTTP Error Log Configuration (HTTP_ERROR_LOG) The configuration elements defined in this group are always present in the agents configuration. This group defines information that applies to the entire agent. Log File Directory HTTP Error Log File Directory The type is string. This value is optional.

Remote installation and configuration


When installing the agent remotely, you must provide the configuration values for the agent to operate. See Configuration values. See the tacmd describeSystemType section in the IBM Tivoli Monitoring Command Reference for information on displaying the configuration options that are available to use with the configureSystem or addSystem commands. The following command is an example of remote installation and configuration for Windows operating systems:
tacmd addSystem -t Q7 -n Primary:sample.node.name:NT -p HTTP_ERROR_LOG.KQ7_HTTP_ERROR_LOG_FILE=value

10

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 3. Workspaces reference


This chapter contains an overview of workspaces, references for detailed information about workspaces, and descriptions of the predefined workspaces included in this monitoring agent.

About workspaces
A workspace is the working area of the Tivoli Enterprise Portal application window. At the left of the workspace is a Navigator that you use to select the workspace you want to see. As part of the application window, the right side of the status bar shows the Tivoli Enterprise Portal server name and port number to which the displayed information applies, and the ID of the current user. When you select an item in the Navigator tree, a default workspace is displayed. When you right-click a Navigator item, a menu that includes a Workspace item is displayed. The Workspace item contains a list of workspaces for that Navigator item. Each workspace has at least one view. This monitoring agent provides predefined workspaces. You cannot modify or delete the predefined workspaces, but you can create new workspaces by editing them and saving the changes with a different name. A table view within a workspace corresponds to a group of attributes; the columns in the table view show some or all of the attributes available in the attribute group.

More information about workspaces


For more information about creating, customizing, and working with workspaces, see the IBM Tivoli Monitoring Users Guide. For a list of the predefined workspaces for this monitoring agent and a description of each workspace, refer to the Predefined workspaces section in this chapter and the information in that section for each individual workspace. Some attribute groups for this monitoring agent might not be represented in the predefined workspaces or views for this agent. For a full list of the attribute groups, see the Attributes reference section.

Cross-linked workspaces
This section contains cross-links from the IIS agent navigator items and workspaces to the .NET Framework agent and Windows OS agent workspaces. Table 2 and Table 3 on page 12 contains source, target, and filtering criteria for the cross-linked workspaces.
Table 2. Cross-linked workspaces to the .NET Framework agent Source navigator item ASP.NET Source workspace name N.A Source view name N.A Target Navigator Item ASP NET Target workspace name ASP NET

Filter N.A

Copyright IBM Corp. 2008, 2009

11

Table 2. Cross-linked workspaces to the .NET Framework agent (continued) Source navigator item ASP.NET ASP.NET ASP.NET Source workspace name N.A N.A N.A Source view name N.A N.A N.A Target Navigator Item ASP NET ASP NET Applications ASP NET Applications Target workspace name ASP.NET Details ASP NET Applications ASP.NET Applications Cache Utilizations ASP.NET Applications Requests Status

Filter N.A N.A N.A

ASP.NET

N.A

N.A

ASP NET Applications

N.A

ASP.NET

N.A

N.A

ASP NET Applications

ASP.NET N.A Applications Sessions State

Table 3. Cross-linked workspaces to the Windows OS agent Source navigator item SMTP Server SMTP Server Source workspace name N.A. N.A. Source view name N.A. N.A. N.A. N.A. N.A. N.A. Target Navigator Item Enterprise Services Enterprise Services Enterprise Services Enterprise Services Enterprise Services Enterprise Services Target workspace name SMTP Server Historical SMTP Server

Filter N.A. N.A.

NNTP Server N.A. NNTP Server N.A. NNTP Server N.A. NNTP Server N.A.

NNTP Server N.A. Historical N.A. NNTP Server NNTP Commands Historical NNTP Commands N.A. N.A.

Predefined workspaces
The Monitoring Agent for Microsoft Internet Information Services provides the following predefined workspaces, which are organized by Navigator item. v Microsoft Internet Information Services Navigator item Microsoft Internet Information Services workspace v Active Server Pages Navigator item Active Server Pages workspace Session and Transaction Statistics workspace v ASP NET Navigator item ASP NET workspace

12

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Availability Navigator item Availability workspace Performance Object Status workspace Thread Pool Status workspace v Event Log Navigator item Event Log workspace v FTP Server Navigator item Data and File Traffic Statistics for Microsoft FTP v7 workspace FTP Server workspace User and Connection Statistics workspace User and Connection Statistics for Microsoft FTP v7 workspace v IIS Configuration Navigator item Identity and Recycling Application Pool Setting workspace IIS Configuration workspace Mime Types and Extension Restriction List workspace Performance and Health Application Pool Setting workspace v IIS Global Navigator item IIS Global workspace IIS v7 Installed Components workspace Server Status workspace v NNTP Server Navigator item NNTP Server workspace v SMTP Server Navigator item SMTP Server workspace v Web Server Navigator item CGI and ISAPI Extension Request Statistics workspace Data and File Transfer Statistics workspace Error Statistics workspace User Request Statistics workspace

Web Server workspace Web Server Cache Statistics workspace v Worker Process Navigator item WAS Worker Process Statistics workspace Worker Process workspace

Agent Navigator items


This section contains descriptions of predefined workspaces. The workspaces are organized by the Navigator item to which the workspaces are relevant.

Microsoft Internet Information Services Navigator item


Microsoft Internet Information Services workspace This workspace provides information about Microsoft IIS Web Server V6.0 and V7.0, including the application pool state and the availability of services and processes. This workspace contains the following views:
Chapter 3. Workspaces reference

13

ASP Request Traffic Displays the average number of ASP requests that were executed per second. Web Data Traffic Displays the rate in seconds, at which data in KB was sent and received by the Web server. File Cache Lookup Displays the number of successful and unsuccessful lookups in the file cache. BLOB Cache Lookup Displays the number of successful and unsuccessful lookups in the Binary Large Objects (BLOB) cache. Application Pool State Displays the status of the individual application pool. Processes and Services Displays the state of services and processes in the application. The state is UP if the service is running and DOWN if the service exists but is not running.

Active Server Pages Navigator item


Active Server Pages workspace This workspace displays statistics for ASP Requests and Errors. This workspace contains the following views: Request and Error Statistics Displays the information about Request and Error related attributes of ASP. Error Rate Displays the average number of errors that occurred per second. Request Rate Displays the average number of requests that were executed per second. Response Time Displays the time, in milliseconds, that it took to execute the most recent request and the time the most recent request waited in the queue. Request Statistics Displays the number of Rejected, Not Found, Not Authorized, and Timed out requests for ASP. Session and Transaction Statistics workspace This workspace displays the session and transaction statistics for ASP. This workspace contains the following views: Session and Transaction Statistics Displays the information about sessions and transaction related attributes of ASP. Current Sessions Displays the number of sessions currently being serviced.

14

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Transaction Rate Displays the average number of transactions that have been started per second.

ASP NET Navigator item


ASP NET workspace This workspace displays ASP.NET application statistics This workspace contains the following views: ASP .NET Application Statistics Displays the attributes that provide information about a single instance of an ASP.NET application. Infrastructure Error Event Rate Displays the number of HTTP error events raised per second. Cache % Machine Memory Displays the amount of physical memory used by the machine divided by the physical memory limit for the cache, as a percentage. Cache % Process Memory Displays the value of private bytes for the worker process divided by the private bytes memory limit for the cache, as a percentage.

Availability Navigator item


Availability workspace The Availability workspace displays the overall health of the application. This workspace contains the following views: Availability Displays the state of each component in the application. Each process is displayed using a descriptive name, the name of the running process, and the state of the process (UP, DOWN, or PROCESS_DATA_NOT_AVAILABLE). Each service is displayed using a descriptive name, the short name of the service, and the state of the service (UP, DOWN, or UNKNOWN). The state is UP if the service is running, DOWN if the service exists but is not running. UNKNOWN indicates that the service is not installed, so these elements are filtered from the view. When the state of the component is DOWN (for a process, or service) it is highlighted with a red background. Processor Displays the amount of CPU used by each process that is a component of the application. This displays the 2 main components of CPU usage, privileged time which is time spent in the kernel on behalf of the process and user mode time, which is the time spent running the process code. Threads Displays the number of threads used by each process that is a component of the application. Memory Displays the amount of memory being consumed by each process

Chapter 3. Workspaces reference

15

that is a component of the application. This total (virtual) size of the process and the size of the process in memory (working set) are displayed. Performance Object Status workspace This workspace displays the overall health of the application. This workspace contains the following view: Performance Object Status Displays the status of the data collection from the application. Usually this will display NO ERROR indicating that the agent is collecting application data correctly. If some of the agents other views are empty, then this view will help isolate the cause of the failure. PerfMon objects will display the object class name. Thread Pool Status workspace This workspace displays the information of the Thread Pool Status attribute group. This workspace contains the following view: Thread Pool Status Provides information about the Thread Pool Status attribute group and the status of the internal thread pool used to collect the data asynchronously.

Event Log Navigator item


Event Log workspace The Event Log workspace shows the details for the recent events logged by the application to the Windows Event Log. By default, the agent only displays events that occur after the agent is started. Events are removed from the Event Log view 1 hour after they occur. This workspace contains the following view: Event Log Shows the recent Event Log entries for Microsoft Internet Information Server.

FTP Server Navigator item


Data and File Traffic Statistics for Microsoft FTP v7 workspace This workspace displays the data and file traffic statistics of the new Microsoft FTP service of IIS 7.0. This workspace contains the following views: Data and File Traffic Statistics Displays the attributes that provide information about data and file traffic of new Microsoft FTP service of IIS 7.0. Data Traffic Displays the rate of data sent, received, and transferred by the Microsoft FTP service in KB per second. File Traffic Displays the rate of files sent, received, and transferred by the Microsoft FTP service per second. FTP Server workspace This workspace displays the data and file traffic statistics of FTP service.

16

Monitoring Agent for Microsoft Internet Information Services: Users Guide

This workspace contains the following views: Data and File Traffic Statistics Displays the attributes that provide information about data and file traffic of FTP service. FTP Sites Displays status for FTP sites running on Microsoft IIS FTP Server. Data Traffic Displays the rate of data sent, received, and transferred by the FTP service in KB per second. File Traffic Displays the rate of files sent, received, and transferred by the FTP service per second. User and Connection Statistics workspace This workspace displays the user and connection statistics of FTP service. This workspace contains the following views: User and Connection Statistics Displays the information about user and connection related attributes of FTP service. Current Users Displays the number of users who currently have anonymous and nonanonymous connections that were made by using the FTP service. Current Connections Displays the current number of connections that have been established with the FTP service. % Current Users Displays the percentage of users who have anonymous and nonanonymous connections that were made by using the FTP service. Logon Attempt Rate Displays the rate of number of logons that have been attempted by using the FTP service per second. User and Connection Statistics for Microsoft FTP v7 workspace This workspace displays the user and connection statistics of the new Microsoft FTP service of IIS 7.0. This workspace contains the following views: User and Connection Statistics Displays the information about user and connection related attributes of Microsoft FTP service. Current Users Displays the number of users who currently have anonymous and nonanonymous connections that were made by using the Microsoft FTP service. Current Connections Displays the current number of connections that have been established with the Microsoft FTP service.

Chapter 3. Workspaces reference

17

% Current Users Displays the percentage of users who have anonymous and nonanonymous connections that were made by using the Microsoft FTP service. Logon Attempt Rate Displays the rate of number of logons that have been attempted by using the Microsoft FTP service per second.

IIS Configuration Navigator item


Identity and Recycling Application Pool Setting workspace This workspace displays the identity and recycling related setting for an application pool. This workspace contains the following views: Recycling Displays the recycling related configuration settings of an application pool. Identity Displays the identity related configuration settings of an application pool. IIS Configuration workspace This workspace displays the HTTP custom error messages configured with Web server and HTTP errors logged by HTTP API. This workspace contains the following views: HTTP Custom Error Messages Displays the information related to HTTP custom error messages. HTTP Error Log Displays the information about HTTP errors logged by HTTP sys kernel in the Httperr log file. Mime Types and Extension Restriction List workspace This workspace displays the MIME types and Web service extensions associated with Web server. This workspace contains the following views: Mime Types Displays all the Multipurpose Internet Mail Extensions (MIME) types so that you can identify the types of content that can be served from a Web server to a browser or a mail client. Web Service Extension Restriction List Displays information about all the available Web service extensions for Microsoft IIS. Performance and Health Application Pool Setting workspace This workspace displays the performance and health related setting for an application pool. This workspace contains the following views: Performance Displays the performance related configuration settings of an application pool.

18

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Health Displays the health related configuration settings of an application pool.

IIS Global Navigator item


IIS Global workspace This workspace displays the statistics for Internet Information Services Global object. This workspace contains the following views: Global Parameters Displays the attributes that show statistics for Internet Information Services Global object. % Cache Hits Displays the percentage(%) hits for file cache and BLOB cache. Current Files Cached Displays the number of files that are currently in the cache. Cache Memory Usage Displays the current and maximum number of KB used for the file cache. Current BLOB Cached Displays the number of BLOB information blocks that are currently in the cache. Active Flushed Entries Displays the number of cached file handles that will close when all current transfers are complete. IIS v7 Installed Components workspace This workspace displays the installed modules of IIS 7.0. This workspace contains the following view: IIS 7.0 Installed Components Displays the installed module names of Microsoft IIS 7.0. Server Status workspace This workspace displays the status and version information for SMTP, NNTP, FTP, and IIS Web Server. This workspace contains the following views: Web Server Status Displays the current status of the Microsoft IIS Web Server. IIS Version Displays the information about Microsoft IIS Web Server version. FTP Server Status Displays the current status of the Microsoft IIS FTP Server. FTP Version Displays the information about Microsoft IIS FTP Server version. NNTP Server Status Displays the current status of the NNTP Server on Microsoft IIS 6.0.

Chapter 3. Workspaces reference

19

NNTP Version Displays the information about NNTP Server version on Microsoft IIS 6.0. SMTP Server Status Displays the current status of the Microsoft IIS SMTP Server. SMTP Version Displays the information about Microsoft IIS SMTP Server version.

NNTP Server Navigator item


NNTP Server workspace This workspace displays the status for each NNTP Virtual Server running on Microsoft IIS 6.0. This workspace contains the following view: NNTP Virtual Server Status Displays the status for each NNTP Virtual Server running on Microsoft IIS 6.

SMTP Server Navigator item


SMTP Server workspace This workspace displays the status for each SMTP Virtual Server running on Microsoft IIS SMTP server. This workspace contains the following view: SMTP Virtual Server Status Displays the status for each SMTP Virtual Server running on Microsoft IIS SMTP server.

Web Server Navigator item


CGI and ISAPI Extension Request Statistics workspace This workspace displays the request statistics for CGI/ISAPI extension requests made to the Web service. This workspace contains the following views: CGI/ISAPI Extension Request Statistics Displays the information about the CGI / ISAPI Extension Requests attributes of Web service. CGI Request Rate Displays the rate, in seconds, at which CGI requests are processed simultaneously by the Web service. ISAPI Request Rate Displays the rate, in seconds, at which ISAPI extension requests are processed by the Web service. Data and File Transfer Statistics workspace This workspace displays the data and file traffic statistics of Web service. This workspace contains the following views: Data and File Transfer Statistics Displays the attributes that provide information about data and file traffic of Web service.

20

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Data Transfer Rate Displays the rate of data sent, received, and transferred by the Web service in KB per second. File Transfer Rate Displays the rate of files sent and received by the Web service per second. Error Statistics workspace This workspace displays the error statistics of the Web service. This workspace contains the following views: Error and Request Statistics Displays the information about the error related attributes of the Web service. Page Not Found Error Rate Displays the rate, in seconds, at which requests were not satisfied by the server because the requested document was not found. Locked Error Rate Displays the rate, in seconds, at which requests were not satisfied because the requested document was locked. User Request Statistics workspace This workspace displays the user request statistics of the Web service. This workspace contains the following views: User Request Statistics Displays the information about user and request related attributes of the Web service. Current Users Request Displays the number of users who currently have anonymous and nonanonymous requests pending with the Web service. User Request Rate Displays the rate, in seconds, at which users made anonymous and nonanonymous requests to the Web service. % Current Users Displays the percentage of users who currently have anonymous and nonanonymous requests pending with the Web service. Web Server workspace This workspace displays connection and logon attempts statistics of Web service and status of each Web site hosted on Microsoft IIS. This workspace contains the following views: Connection and Logon Attempt Statistics Displays the attributes that provide information about connection and logon attempts of Web service. Web Sites Displays status for Web sites running on Microsoft IIS Web Server. Current Connections Displays the number of active connections made to the Web service.

Chapter 3. Workspaces reference

21

Connection and Logon Attempts Displays the rate, in seconds, at which logon and connections are attempted to the Web service. Web Server Cache Statistics workspace This workspace displays the Web server cache statistics. This workspace contains the following views: Web Server Cache Statistics Displays the information about the Web server cache attributes. Current File Cache Memory Usage Displays the current number of KB that are used for the user-mode file cache. Current File Cached Displays the current number of files that are in the user-mode cache. Flushed Entries Displays the file handles cached in user-mode that will be closed when all current transfers complete.

Worker Process Navigator item


WAS Worker Process Statistics workspace This workspace displays the statistics of worker processes running on Microsoft IIS 7.0. This workspace contains the following views: WAS Worker Process Statistics Displays data about a specific worker process. Message Received Rate Displays the rate of total number of messages received by the worker process from Web Admin service per second. Health Ping Rate Displays the rate of total number of health pings received by the process per second. Message Sent Rate Displays the rate of total number of messages sent to Web Admin service by the worker process per second. Worker Process workspace This workspace displays the HTTP request processing related data for the worker processes on Microsoft IIS 7.0. This workspace contains the following views: W3SVC Worker Process Statistics Displays the HTTP request processing related data for the worker processes on Microsoft IIS 7.0. HTTP Request Rate Displays the HTTP requests being processed by the worker process per second. Active Thread Count Displays the number of threads actively processing requests in the worker process.

22

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 4. Attributes reference


This chapter contains an overview of attributes, references for detailed information about attributes, and descriptions of the attributes for each attribute group included in this monitoring agent.

About attributes
Attributes are the application properties being measured and reported by the Monitoring Agent for Microsoft Internet Information Services. Attributes are organized into groups according to their purpose. The attributes in a group can be used in the following two ways: v Chart or table views Attributes are displayed in chart and table views. The chart and table views use queries to specify which attribute values to request from a monitoring agent. You use the Query editor to create a new query, modify an existing query, or apply filters and set styles to define the content and appearance of a view based on an existing query. v Situations You use attributes to create situations that monitor the state of your operating system, database, or application. A situation describes a condition you want to test. When you start a situation, the Tivoli Enterprise Portal compares the values you have assigned to the situation attributes with the values collected by the Monitoring Agent for Microsoft Internet Information Services and registers an event if the condition is met. You are alerted to events by indicator icons that are displayed in the Navigator.

More information about attributes


For more information about using attributes and attribute groups, see the IBM Tivoli Monitoring Users Guide. For a list of the attributes groups, a list of the attributes in each attribute group, and descriptions of the attributes for this monitoring agent, see the Attribute groups and attributes section in this chapter.

Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services
This monitoring agent contains the following attribute groups. The table name depends on the maximum table name limits of the target database being used for the Tivoli Data Warehouse. If the maximum name is 30 characters, then any warehouse table name longer than 30 characters is shortened to the table name. v Attribute group name: Active Server Pages Table name: KQ7ACTIVES Warehouse table name: KQ7_ACTIVE_SERVER_PAGES or KQ7ACTIVES v Attribute group name: ASP NET Table name: KQ7ASPNETA Warehouse table name: KQ7_ASP_NET or KQ7ASPNETA
Copyright IBM Corp. 2008, 2009

23

v Attribute group name: Availability Table name: KQ7AVAIL Warehouse table name: KQ7_AVAILABILITY or KQ7AVAIL v Attribute group name: Event Log Table name: KQ7EVTLOG Warehouse table name: KQ7_EVENT_LOG or KQ7EVTLOG v Attribute group name: FTP Server Site Status Table name: KQ7IISFTPS Warehouse table name: KQ7_FTP_SERVER_SITE_STATUS or KQ7IISFTPS v Attribute group name: FTP Service Table name: KQ7FTPSERV Warehouse table name: KQ7_FTP_SERVICE or KQ7FTPSERV v Attribute group name: FTP Version Information Table name: KQ7IISFTPI Warehouse table name: KQ7_FTP_VERSION_INFORMATION or KQ7IISFTPI v Attribute group name: HTTP Custom Error Messages Table name: KQ7HTTPCUS Warehouse table name: KQ7_HTTP_CUSTOM_ERROR_MESSAGES or KQ7HTTPCUS v Attribute group name: Http Error Log Table name: KQ7HTTPERR Warehouse table name: KQ7_HTTP_ERROR_LOG or KQ7HTTPERR v Attribute group name: IIS Application Pools Setting Table name: KQ7IISAPPL Warehouse table name: KQ7_IIS_APPLICATION_POOLS_SETTING or KQ7IISAPPL v Attribute group name: IIS Components Table name: KQ7IISCOMP Warehouse table name: KQ7_IIS_COMPONENTS or KQ7IISCOMP v Attribute group name: IIS FTP Server Bindings Table name: KQ7FTPBIND Warehouse table name: KQ7_IIS_FTP_SERVER_BINDINGS or KQ7FTPBIND v Attribute group name: IIS FTP Server Status Table name: KQ7IISFTPM Warehouse table name: KQ7_IIS_FTP_SERVER_STATUS or KQ7IISFTPM v Attribute group name: IIS FTP Sites Detail Table name: KQ7FSITDTL Warehouse table name: KQ7_IIS_FTP_SITES_DETAIL or KQ7FSITDTL v Attribute group name: IIS NNTP Server Status Table name: KQ7IISNNT2 Warehouse table name: KQ7_IIS_NNTP_SERVER_STATUS or KQ7IISNNT2 v Attribute group name: IIS SMTP Server Status Table name: KQ7IISSMM Warehouse table name: KQ7_IIS_SMTP_SERVER_STATUS or KQ7IISSMM v Attribute group name: IIS Version Information

24

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table name: KQ7IISWEBI Warehouse table name: KQ7_IIS_VERSION_INFORMATION or KQ7IISWEBI v Attribute group name: IIS Web Server Bindings Table name: KQ7WEBBIND Warehouse table name: KQ7_IIS_WEB_SERVER_BINDINGS or KQ7WEBBIND v Attribute group name: IIS Web Server Site Status Table name: KQ7IISWEBS Warehouse table name: KQ7_IIS_WEB_SERVER_SITE_STATUS or KQ7IISWEBS v Attribute group name: IIS Web Server Status Table name: KQ7IISWEB1 Warehouse table name: KQ7_IIS_WEB_SERVER_STATUS or KQ7IISWEB1 v Attribute group name: IIS Web Sites Detail Table name: KQ7WSITDTL Warehouse table name: KQ7_IIS_WEB_SITES_DETAIL or KQ7WSITDTL v Attribute group name: Internet Information Services Gl Table name: KQ7INTERNE Warehouse table name: KQ7_INTERNET_INFORMATION_SERVICES_GL or KQ7INTERNE v Attribute group name: Microsoft FTP Service Table name: KQ7WIN32P1 Warehouse table name: KQ7_MICROSOFT_FTP_SERVICE or KQ7WIN32P1 v Attribute group name: Mime Types Table name: KQ7MIMETYP Warehouse table name: KQ7_MIME_TYPES or KQ7MIMETYP v Attribute group name: NNTP Server Table name: KQ7IISNNTP Warehouse table name: KQ7_NNTP_SERVER or KQ7IISNNTP v Attribute group name: NNTP Version Information Table name: KQ7IISNNT0 Warehouse table name: KQ7_NNTP_VERSION_INFORMATION or KQ7IISNNT0 v Attribute group name: Performance Object Status Table name: KQ7POBJST Warehouse table name: KQ7_PERFORMANCE_OBJECT_STATUS or KQ7POBJST v Attribute group name: SMTP Server Table name: KQ7IISSMTP Warehouse table name: KQ7_SMTP_SERVER or KQ7IISSMTP v Attribute group name: SMTP Version Information Table name: KQ7IISSMT0 Warehouse table name: KQ7_SMTP_VERSION_INFORMATION or KQ7IISSMT0 v Attribute group name: Thread Pool Status Table name: KQ7THPLST Warehouse table name: KQ7_THREAD_POOL_STATUS or KQ7THPLST
Chapter 4. Attributes reference

25

v Attribute group name: W3SVC W3WP Table name: KQ7WIN32PE Warehouse table name: KQ7_W3SVC_W3WP or KQ7WIN32PE v Attribute group name: WAS W3WP Table name: KQ7WIN32P0 Warehouse table name: KQ7_WAS_W3WP or KQ7WIN32P0 v Attribute group name: Web Service Table name: KQ7WEBSERV Warehouse table name: KQ7_WEB_SERVICE or KQ7WEBSERV v Attribute group name: Web Service Cache Table name: KQ7WEBSER1 Warehouse table name: KQ7_WEB_SERVICE_CACHE or KQ7WEBSER1 v Attribute group name: Web Service Extensions Restricted List Table name: KQ7RESTRIC Warehouse table name: KQ7_WEB_SERVICE_EXTENSIONS_RESTRICTED_LIST or KQ7RESTRIC The remaining sections of this chapter contain descriptions of these attribute groups, which are listed alphabetically. The following information is provided for each attribute group: Historical group Whether the attribute group is a historical type that you can roll off to a data warehouse Attribute descriptions Description and type for each attribute in the attribute group Some attributes are designated as key attributes. A key attribute is an attribute that is used in warehouse aggregation to identify rows of data that represent the same object.

Active Server Pages attribute group


This attribute group monitors Active Server Pages performance. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Active Server Pages attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute

26

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Description The local time at the agent when the data was collected. Type String

Error Rate (per sec) attribute Description The average number of errors that occurred per second. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Errors During Script Runtime attribute Description The number of requests that failed because run-time errors occurred. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Errors From ASP Preprocessor attribute Description The number of requests that failed because preprocessor errors occurred. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Errors From Script Compilers attribute Description The number of requests that failed because script compilation errors occurred. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

Chapter 4. Attributes reference

27

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Request KBytes In Total attribute Description The total size, in KB, of data received due to ASP requests. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Request KBytes Out Total attribute Description The total size, in KB, of responses sent to clients and does not include standard HTTP response headers. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Request Execution Time (ms) attribute Description The number of milliseconds that it took to execute the most recent request. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Request Wait Time (ms) attribute Description The number of milliseconds that the most recent request waited for in the queue. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

28

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Request Wait GT Execution Time (ms) attribute Description The difference between request wait time and request execution time. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Disconnected Count attribute Description The number of requests that were disconnected because the communication had failed. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Executing Count attribute Description The number of requests that are currently executing. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Failed Total attribute Description The number of requests that failed due to errors, authorization failure, and rejections. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Chapter 4. Attributes reference

29

Requests Not Authorized Count attribute Description The number of requests that failed because access rights were insufficient. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Not Found Count attribute Description The number of requests that were made for files that were not found. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Queued Count attribute Description The number of requests that are waiting in the queue for service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Queued Delta attribute Description The change in requests queued. Type Integer (difference between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Rejected Count attribute

30

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Description The number of requests that were not executed because there were insufficient resources to process them. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Succeeded Count attribute Description The number of requests that executed successfully. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Timed Out Count attribute Description The number of requests that timed out. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Total attribute Description The number of requests that have been made since the service was started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Request Rate (per sec) attribute Description The average number of requests that were executed per second.

Chapter 4. Attributes reference

31

Type

Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Current Sessions attribute Description The number of sessions currently being serviced. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Timed Out Sessions attribute Description The number of sessions that have timed out. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Sessions attribute Description The number of sessions that have run since the service was started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Transaction Rate (per sec) attribute Description The average number of transactions that have been started per second. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli

32

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Transactions Aborted attribute Description The number of transactions that have been aborted. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Transactions Committed attribute Description The number of transactions that have been committed. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Transactions Pending Count attribute Description The number of transactions that are pending. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Transactions attribute Description The number of transactions that have occurred since the service was started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference

33

v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

ASP NET attribute group


The attribute group includes attributes that provide information about a single instance of an ASP.NET application. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the ASP NET attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Cache % Machine Memory Limit Used attribute Description The amount of physical memory used by the machine divided by the physical memory limit for the cache, as a percentage. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Cache % Process Memory Limit Used attribute Description The value of private bytes for the worker process divided by the private bytes memory limit for the cache, as a percentage. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647)

34

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Infrastructure Error Event Raised Rate (per sec) attribute Description The number of HTTP error events raised per second. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Membership Authentication Failures attribute Description The number of failed membership credential validations since the application was started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Name attribute - This attribute is a key attribute. Description The name of the instance. Type String

Availability attribute group


The Availability attribute group contains the availability data for all processes and services that make up this application. If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Availability attribute group: Node attribute - This attribute is a key attribute.

Chapter 4. Attributes reference

35

Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Application Component attribute - This attribute is a key attribute. Description The descriptive name of a part of the application. Type Name attribute Description The name of the process, service, or functionality test. This name matches the executable name of the process, the service short name or the name of the process used to test the application. Type String with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v N/A (N/A) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Status attribute Description The status of the application component. v For processes UP, DOWN, WARNING, or PROCESS_DATA_NOT_AVAILABLE: PROCESS_DATA_NOT_AVAILABLE is displayed for a process when the matching process is running but the resource use information cannot be collected for that process. v For services UP, DOWN, or UNKNOWN: UNKNOWN is displayed when the service is not installed. v For functionality tests: PASSED or FAILED is displayed. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v DOWN (0) v UP (1) v WARNING (2) v UNKNOWN (3) v PASSED (4) v FAILED (5) v PROCESS_DATA_NOT_AVAILABLE (6) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. String

36

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Full Name attribute Description The full name of the process including the path. Type String with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v N/A (N/A) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Type attribute Description The type of the application component. Components are processes, services, or functionality tests. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v PROCESS (0) v SERVICE (1) v FUNCTIONALITY_TEST (2) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Virtual Size attribute Description The virtual size (in MB) of the process. Type Integer (Gauge)

Page Faults per Sec attribute Description The rate of page faults for the process measured in faults per second. This attribute only contains valid data for processes. Type Integer (Gauge)

Working Set Size attribute Description The working set size of the process in MB. This attribute only contains valid data for processes. Type Integer (Gauge)

Thread Count attribute Description The number of threads currently allocated by this process. This attribute only contains valid data for processes. Type PID attribute Description The process ID associated with the process. This attribute only contains valid data for processes.
Chapter 4. Attributes reference

Integer (Gauge)

37

Type

Integer (Gauge)

Percent Privileged Time attribute Description The percentage of the available CPU time that is being used by this process for privileged operation. Type Integer (Gauge)

Percent User Mode Time attribute Description The percentage of the available CPU time that is being used by this process for user mode operation. Type Integer (Gauge)

Percent Processor Time attribute Description The percentage of the elapsed time that this process used the processor to execute instructions. Type Integer (Gauge)

Command Line attribute Description The program name and any arguments specified on the command line when the process was started. This has the value N/A if this is a Service, or Functionality test. Type String with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v N/A (N/A) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Functionality Test Status attribute Description The return code of the functionality test. When the monitored application is running correctly, SUCCESS is displayed. NOT_RUNNING is displayed when it is not running correctly. N/A is displayed when the row does not represent a functionality test. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v SUCCESS (0) v N/A (1) v GENERAL_ERROR (2) v WARNING (3) v NOT_RUNNING (4) v DEPENDENT_NOT_RUNNING (5) v ALREADY_RUNNING (6) v PREREQ_NOT_RUNNING (7)

38

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v v v v v

TIMED_OUT (8) DOESNT_EXIST (9) UNKNOWN (10) DEPENDENT_STILL_RUNNING (11) INSUFFICIENT_USER_AUTHORITY (12)

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Functionality Test Message attribute Description The text message that corresponds to the Functionality Test Status. This is only valid for functionality tests. Type String with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v N/A (N/A) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Event Log attribute group


The Event Log attribute group contains any event log entries that pertain to this application. If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Event Log attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Log Name attribute Description The name of the event log - Application, System, Security or an application-specific log Type String

Event Source attribute Description The event source defined by the application Type String

Event Type attribute


Chapter 4. Attributes reference

39

Description Event Type - Error(0), Warning(1), Informational(2), Audit_Success(3), Audit_Failure(4), Unknown(5) Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v v v v v v Error (0) Warning (1) Informational (2) Audit_Success (3) Audit_Failure (4) Unknown (5)

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Event ID attribute Description The ID of the event Type Integer (Counter)

Event Category attribute Description The Category of the event Type String with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v None (None) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Message attribute Description The event message Type String

Time Generated attribute Description The time the event was generated Type Timestamp

FTP Server Site Status attribute group


This attribute group displays information related to each FTP site status running on Microsoft IIS FTP server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

40

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Attribute descriptions
The following list contains information about each attribute in the FTP Server Site Status attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

FTP Site attribute - This attribute is a key attribute. Description The name used to identify FTP site. Type State attribute Description The current state of FTP site. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v v v v Starting (1) Started (2) Stopping (3) Stopped (4) String

v Pausing (5) v Paused (6) v Continuing (7) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

FTP Service attribute group


This attribute group monitors the FTP Service If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the FTP Service attribute group: Node attribute - This attribute is a key attribute.

Chapter 4. Attributes reference

41

Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

KB Sent Rate (per sec) attribute Description The rate at which KB are sent by the FTP service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. KB Received Rate (per sec) attribute Description The rate at which KB are received by the FTP service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. KB Total Rate (per sec) attribute Description The total rate of KB transferred by the FTP service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Sent attribute Description The total number of files that are sent by the FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are

42

Monitoring Agent for Microsoft Internet Information Services: Users Guide

displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Received attribute Description The total number of files that are received by the FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Transferred attribute Description The sum of total files sent and received by the FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Sent Rate (per sec) attribute Description The total number of files that are sent by the FTP service per second. Type Real number (rate of change between successive values) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Files Received Rate (per sec) attribute

Chapter 4. Attributes reference

43

Description The total number of files that are received by the FTP service per second. Type Real number (rate of change between successive values) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Files Transferred Rate (per sec) attribute Description The rate of total files transferred by the FTP service per second. Type Real number (rate of change between successive values) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Anonymous Users attribute Description The number of users who currently have an anonymous connection that was made by using the FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Current Anonymous Users attribute Description The percentage of users who have an anonymous connection that was made by using the FTP service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

44

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Current NonAnonymous Users attribute Description The number of users who currently have a nonanonymous connection that was made by using the FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Current NonAnonymous Users attribute Description The percentage number of users who currently have a nonanonymous connection that was made by using the FTP service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Anonymous Users attribute Description The number of users who have established an anonymous connection with the FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Total Anonymous Users attribute Description The percentage of users who established an anonymous connection with the FTP service since the service started. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

Chapter 4. Attributes reference

45

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total NonAnonymous Users attribute Description The number of users who established nonanonymous connections with the FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Total NonAnonymous Users attribute Description The percentage of users who established nonanonymous connections with the FTP service since the service started. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum Anonymous Users attribute Description The maximum number of users who have established concurrent anonymous connections using the FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum NonAnonymous Users attribute Description The maximum number of users who have established concurrent nonanonymous connections using the FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are

46

Monitoring Agent for Microsoft Internet Information Services: Users Guide

displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Connections attribute Description The current number of connections that have been established with the FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum Connections attribute Description The maximum number of simultaneous connections that have been established with the FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Connection Attempts (all instances) attribute Description The number of connections that have been attempted by using the FTP service for all instances since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Logon Attempts attribute Description The number of logons that have been attempted by using the FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference

47

displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Logon Attempt Rate (per sec) attribute Description The rate of number of logons that have been attempted by using the FTP service per second. Type Real number (rate of change between successive values) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. FTP Service Uptime (hrs) attribute Description The amount of time, in hours, that the FTP service has been running. Type Real number (Counter) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Name attribute - This attribute is a key attribute. Description The name of the instance. Type String

FTP Version Information attribute group


This attribute group displays information about the Microsoft IIS FTP Server version. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

48

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Attribute descriptions
The following list contains information about each attribute in the FTP Version Information attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Server Name attribute Description The name that is used to identify the IIS FTP server. Type String

Major FTP Version Number attribute Description The major version number of the IIS FTP Server. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Minor FTP Version Number attribute Description The minor version number of the IIS FTP Server. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

HTTP Custom Error Messages attribute group


This attribute group displays configuration information related to HTTP custom error messages. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Chapter 4. Attributes reference

49

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the HTTP Custom Error Messages attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

HTTP Status attribute Description The HTTP status code for the custom error message. Type String

Error Sub Code attribute Description The HTTP sub status code for the custom error message. Type String

Error Code attribute - This attribute is a key attribute. Description The error code. Type String

Message Source attribute Description The custom error message source. Type String

Message Location attribute Description The location of custom error message file. Type String

Http Error Log attribute group


This attribute group displays information about HTTP errors logged by HTTP sys kernel in the Httperr log file. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

50

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Http Error Log attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type Date attribute Description The date on which the error occurred. Type Time attribute Description The time, in Coordinated Universal Time (UTC), at which the activity occurred. Type String String String

Client IP Address attribute Description The IP address of the client that made the request. Type String

Client Port attribute Description The port number of the client that made the request. Type String

Server IP Address attribute Description The IP address of the server on which the log file entry was generated. Type String

Server Port attribute Description The server port number that is configured for the service. Type String

Protocol Version attribute


Chapter 4. Attributes reference

51

Description The protocol version that the client used. Type String

Method attribute Description The requested action, for example, a GET method. Type URL attribute Description The target of the action. Type String String

HTTP Status attribute Description The HTTP status code. Type String

Protocol Sub Status attribute Description The sub status error code. Type String

Error Code attribute Description The error code. Type String

Error Description attribute Description The error description. Type String

IIS Application Pools Setting attribute group


This attribute group shows the individual application pool settings. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS Application Pools Setting attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent.

52

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Type

String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

AppPool AutoStart attribute Description Indicates to the World Wide Web Publishing Service (WWW service) to automatically start an application pool when the application pool is created or when IIS is started. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v FALSE (0) v TRUE (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Application Pool Name attribute - This attribute is a key attribute. Description The label by which the application pool is known. Type String

AppPool Command attribute Description Allows an application to send commands to the application pool to start or stop the application pool. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v START (1) v STOP (2) v NONE (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Identity Type attribute Description Allows application pools to run as a specific user account. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v LOCALSYSTEM (0) v LOCALSERVICE (1) v NETWORKSERVICE (2) v SPECIFICUSER (3)

Chapter 4. Attributes reference

53

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Queue Length attribute Description Indicates to the Universal Listener how many requests to queue up for an application pool before rejecting future requests. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Recycle Config Change attribute Description Specifies that IIS should log an event when an application pool is recycled.In order for IIS to log the event, the LogEventOnRecycle attribute must have a bit set corresponding to the reason for the recycle. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v TRUE (-1) v FALSE (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Recycle Isapi Unhealthy attribute Description Specifies that IIS should log an event when an application pool is recycled.In order for IIS to log the event, the LogEventOnRecycle attribute must have a bit set corresponding to the reason for the recycle. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v TRUE (-1) v FALSE (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Recycle Memory attribute Description Specifies that IIS should log an event when an application pool is

54

Monitoring Agent for Microsoft Internet Information Services: Users Guide

recycled.In order for IIS to log the event, the LogEventOnRecycle attribute must have a bit set corresponding to the reason for the recycle. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v FALSE (0) v TRUE (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Recycle OnDemand attribute Description Specifies that IIS should log an event when an application pool is recycled.In order for IIS to log the event, the LogEventOnRecycle attribute must have a bit set corresponding to the reason for the recycle. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v FALSE (0) v TRUE (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Recycle Private Memory attribute Description Specifies that IIS should log an event when an application pool is recycled.In order for IIS to log the event, the LogEventOnRecycle attribute must have a bit set corresponding to the reason for the recycle. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v FALSE (0) v TRUE (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Recycle Requests attribute Description Specifies that IIS should log an event when an application pool is recycled.In order for IIS to log the event, the LogEventOnRecycle attribute must have a bit set corresponding to the reason for the recycle. Type Integer with enumerated values. The strings are displayed in the

Chapter 4. Attributes reference

55

Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v FALSE (0) v TRUE (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Recycle Schedule attribute Description Specifies that IIS should log an event when an application pool is recycled.In order for IIS to log the event, the LogEventOnRecycle attribute must have a bit set corresponding to the reason for the recycle. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v FALSE (0) v TRUE (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool Recycle Time attribute Description Specifies that IIS should log an event when an application pool is recycled.In order for IIS to log the event, the LogEventOnRecycle attribute must have a bit set corresponding to the reason for the recycle. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v FALSE (0) v TRUE (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. AppPool State attribute Description This value is used by applications to determine the state of an application pool. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v STARTING (1) v STARTED (2) v STOPPING (3) v STOPPED (4)

56

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Auto Shutdown AppPool Exe attribute Description Specifies an executable to run when the World Wide Web Publishing Service (WWW service) shuts down an application pool for rapid fail protection. Type String

Auto Shutdown AppPool Params attribute Description Specifies any command-line parameters for the executable that is specified in the AutoShutdownAppPoolExe attribute. Type String

CPU Action attribute Description Configures the actions that IIS takes when Microsoft Windows NT job objects run.Only one Windows NT job object exists per application pool.Therefore the CPUAction property is configured on a per application pool basis. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO_ACTION (0) v KILL_W3WP (1) v TRACE (2) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. CPU Limit % attribute Description Configures the maximum percentage of CPU resources that worker processes in an application pool are allowed to consume over a period of time, as indicated by the CPUResetInterval attribute. Type Real number (Numeric Property) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. CPU Reset Interval attribute Description Specifies the reset period, in minutes, for CPU monitoring and throttling limits on the application pool. Type Integer (Numeric Property) with enumerated values. The strings

Chapter 4. Attributes reference

57

are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Disallow Overlapping Rotation attribute Description Specifies whether the World Wide Web Publishing Service (WWW Service) should start another worker process to replace the existing worker process while it is shutting down. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v FALSE (0) v TRUE (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Disallow Rotation On Config Change attribute Description Specifies whether the World Wide Web Publishing Service (WWW Service) should rotate worker processes in an application pool when the configuration has changed. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v TRUE (-1) v FALSE (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Idle Timeout attribute Description Specifies the time, in minutes, that a worker process should run idle if no new requests are received and the worker process is not processing requests. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

58

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Load Balancer Capabilities attribute Description Specifies behavior when a service is unavailable. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TERMINATE_CONNECTION (1) v SEND_503_ERROR_CODE (2) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Logon Method attribute Description Specifies the logon method for cleartext logons. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v v v v BATCH (1) NETWORK (2) INTERACTIVE (0) NETWORK_CLEARTEXT (3)

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Max Processes attribute Description The maximum number of worker processes an application pool allows to service requests for an application pool. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Orphan Action Exe attribute Description Specifies an executable file to run when the World Wide Web Publishing Service (WWW service) orphans a worker process. Type String

Orphan Action Params attribute Description Specifies command-line parameters for the executable that is specified by the OrphanActionExe attribute. Type String

Orphan Worker Process attribute


Chapter 4. Attributes reference

59

Description When set to true, this notifies the WWW service not to terminate a worker process that fails to respond to pings.Instead it should orphan the worker process in the application pool if the worker process causes fatal errors. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v TRUE (-1) v FALSE (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Periodic Restart Memory attribute Description Specifies the amount of virtual memory in KB that a worker process can use before the worker process recycles.The maximum value supported for this attribute is 4,294,967 KB. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Periodic Restart Private Memory attribute Description Specifies the amount of private memory in KB that a worker process can use before the worker process recycles.The maximum value supported for this property is 4,294,967 KB. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Periodic Restart Requests attribute Description Indicates the number of requests that the OOP application should process, after which it is recycled. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined:

60

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Periodic Restart Time attribute Description Specifies the period of time, in minutes, after which IIS rotates an isolated OOP application.The maximum supported value for this attribute is 71,582. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Pinging Enabled attribute Description Specifies whether the World Wide Web Publishing Service (WWW Service) should periodically monitor the health of a worker process. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v TRUE (-1) v FALSE (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Ping Interval attribute Description Specifies the period of time, in seconds, between health-monitoring pings that the World Wide Web Publishing Service (WWW Service) sends to a worker process. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Ping Response Time attribute

Chapter 4. Attributes reference

61

Description Specifies the amount of time, in seconds, that a worker process is given to respond to a health monitoring ping. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Rapid Fail Protection attribute Description Indicates whether the Rapid Fail Protection is enabled for application pool. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v TRUE (-1) v FALSE (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Rapid Fail Protection Interval attribute Description Specifies the number of minutes before the failure count for a process is reset. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Rapid Fail Protection Max Crashes attribute Description Specifies the maximum number of failures that are allowed within the number of minutes specified by the RapidFailProtectionInterval attribute. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

62

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Shutdown Time Limit attribute Description Specifies the amount of time, in seconds, after a recycle threshold has reached.IIS waits for all old requests to finish running in a worker process before terminating the worker process. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. SMP Affinitized attribute Description Indicates whether a particular worker process assigned to an application pool should be assigned to a given CPU. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v TRUE (1) v TRUE (-1) v FALSE (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. SMP Processor Affinity Mask attribute Description Configures the hexadecimal processor mask.The hexadecimal processor mask indicates to which CPU the worker processes in an application pool should be bound. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v UNLIMITED (-1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Startup Time Limit attribute Description Specifies the amount of time, in seconds, that the WWW Service should wait for a worker process to finish starting up and reporting to the WWW Service. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined:
Chapter 4. Attributes reference

63

v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. WAM User Name attribute Description Specifies the account user name that IIS uses by default as the COM+ application identity for newly created IIS out-of-process applications. Type String

Win32 Error attribute Description Indicates the Microsoft Win32 error status code. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

IIS Components attribute group


This attribute group displays information about the installed IIS v7 components. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS Components attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Module Name attribute - This attribute is a key attribute. Description The name of the IIS v7 component that is installed.

64

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Type Status attribute

String

Description The status of the component is Installed. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Installed (1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

IIS FTP Server Bindings attribute group


This attribute group displays the server site bindings of FTP sites on the Microsoft IIS FTP server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS FTP Server Bindings attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

FTP Site ID attribute - This attribute is a key attribute. Description The name that is used to identify the FTP site. Type String

FTP Site Name attribute Description The name of the FTP site. Type String

FTP Port attribute Description The port number of the FTP site. Type String
Chapter 4. Attributes reference

65

IIS FTP Server Status attribute group


This attribute group displays the status of the Microsoft IIS FTP Server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS FTP Server Status attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Server Name attribute Description Name of the IIS FTP Server. Type String

Path Name attribute Description Directory path to the executable file. Type String

Process ID attribute Description Process identifier of the service. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. State attribute Description The current state of the IIS FTP Server. Type String

66

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Status attribute Description The current status of the IIS FTP Server (operational and nonoperational status). Type String

IIS FTP Sites Detail attribute group


This attribute group displays detailed information about each FTP site on the Microsoft IIS FTP server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS FTP Sites Detail attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

FTP Site attribute - This attribute is a key attribute. Description The name used to identify FTP site. Type State attribute Description The current state of FTP site. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Starting (1) v Started (2) v Stopping (3) v Stopped (4) v Pausing (5) v Paused (6) v Continuing (7) String

Chapter 4. Attributes reference

67

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. FTP Site ID attribute - This attribute is a key attribute. Description The name that is used to identify the FTP site. Type String

FTP Site Name attribute Description The name of the FTP site. Type String

FTP Port attribute Description The port number of the FTP site. Type String

IIS NNTP Server Status attribute group


This attribute group displays the status of the Microsoft IIS NNTP Server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS NNTP Server Status attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Server Name attribute Description Name of the IIS NNTP Server. Type String

Path Name attribute Description Directory path to the executable file. Type String

68

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Process ID attribute Description Process identifier of the service. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. State attribute Description The current state of the IIS NNTP Server. Type Status attribute Description The current status of the IIS NNTP Server (operational and nonoperational status). Type String String

IIS SMTP Server Status attribute group


This attribute group displays the status of Microsoft IIS SMTP Server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS SMTP Server Status attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Server Name attribute Description Name of the IIS SMTP Server.


Chapter 4. Attributes reference

69

Type

String

Path Name attribute Description Directory path to the executable file. Type String

Process ID attribute Description Process identifier of the service. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. State attribute Description The current state of the IIS SMTP Server. Type Status attribute Description The current status of the IIS SMTP Server (operational and nonoperational status). Type String String

IIS Version Information attribute group


This attribute group displays information about the Microsoft IIS Web Server version. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS Version Information attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute

70

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Description The local time at the agent when the data was collected. Type String

Server Name attribute Description The name that is used to identify IIS Web server. Type String

Major IIS Version Number attribute Description The major version number of the IIS Web Server. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Minor IIS Version Number attribute Description The minor version number of the IIS Web Server. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

IIS Web Server Bindings attribute group


This attribute group displays the site bindings of the Web sites on the Microsoft IIS Web server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS Web Server Bindings attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent.
Chapter 4. Attributes reference

71

Type

String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Site ID attribute - This attribute is a key attribute. Description The name that is used to identify a Web site. Type String

Web Site Name attribute Description The name of a Web site. Type String

HTTP Port attribute Description The HTTP port number of the Web site. Type String

SSL Port attribute Description The SSL port number of the Web site. Type String

IIS Web Server Site Status attribute group


This attribute group displays information related to the status of each Web site that is running on the Microsoft IIS Web Server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS Web Server Site Status attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

72

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Web Site attribute - This attribute is a key attribute. Description The name that is used to identify a Web site. Type State attribute Description The current state of the Web site. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Starting (1) v Started (2) v Stopping (3) v Stopped (4) v Pausing (5) v Paused (6) v Continuing (7) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. String

IIS Web Server Status attribute group


This attribute group displays status of the Microsoft IIS Web Server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS Web Server Status attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Server Name attribute Description Name of the IIS Web Server. Type String
Chapter 4. Attributes reference

73

Path Name attribute Description Directory path to the executable file. Type String

Process ID attribute Description Process identifier of the service. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. State attribute Description The current state of the IIS Web Server. Type Status attribute Description The current status of the IIS Web Server (operational and nonoperational status). Type String String

IIS Web Sites Detail attribute group


This attribute group displays information about each Web site on the Microsoft IIS Web server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the IIS Web Sites Detail attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected.

74

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Type

String

Web Site attribute - This attribute is a key attribute. Description The name that is used to identify a Web site. Type State attribute Description The current state of the Web site. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Starting (1) v Started (2) v v v v v Stopping (3) Stopped (4) Pausing (5) Paused (6) Continuing (7) String

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Site ID attribute - This attribute is a key attribute. Description The name that is used to identify a Web site. Type String

Web Site Name attribute Description The name of a Web site. Type String

HTTP Port attribute Description The HTTP port number of the Web site. Type String

SSL Port attribute Description The SSL port number of the Web site. Type String

Internet Information Services Gl attribute group


This attribute group monitors FTP, SMTP, and NNTP services as a whole. If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Chapter 4. Attributes reference

75

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Internet Information Services Gl attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Current Files Cached attribute Description The number of files that are currently in the cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Cached attribute Description The number of files that are added to the cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Hits attribute Description The number of successful lookups in the file cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

76

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Misses attribute Description The number of unsuccessful lookups in the file cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Hits % attribute Description The ratio of file cache hits to the total number of cache requests. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Flushes attribute Description The number of file cache flushes that occurred since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current File Cache Memory Usage (KB) attribute Description The current number of KB used for the file cache. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference

77

Maximum File Cache Memory Usage (KB) attribute Description The maximum number of KB used for the file cache. Type Real number (Counter) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Active Flushed Entries attribute Description The number of cached file handles that will close when all the current transfers are complete. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Flushed Files attribute Description The number of file handles that are removed from the cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current BLOBs Cached attribute Description The BLOB information blocks that are currently in the cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total BLOBs Cached attribute

78

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Description The number of BLOB information blocks that are added to the cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. BLOB Cache Hits attribute Description The number of successful lookups in the BLOB cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. BLOB Cache Misses attribute Description The number of unsuccessful lookups in the BLOB cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. BLOB Cache Hits % attribute Description The ratio of BLOB cache hits to the total number of cache requests. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. BLOB Cache Flushes attribute Description The number of BLOB cache flushes that occurred since the service started.

Chapter 4. Attributes reference

79

Type

Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Total Flushed BLOBs attribute Description The number of BLOB information blocks that are removed from the cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Microsoft FTP Service attribute group


This attribute group monitors new Microsoft FTP Service of IIS 7. If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Microsoft FTP Service attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Name attribute - This attribute is a key attribute. Description Name of the FTP site. Type String

80

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KB Sent Rate (per sec) attribute Description The rate at which KB are sent by the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. KB Received Rate (per sec) attribute Description The rate at which KB are received by the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. KB Total Rate (per sec) attribute Description The total rate of KB transferred by the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Sent attribute Description The total number of files that have been sent by the Microsoft FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Received attribute

Chapter 4. Attributes reference

81

Description The total number of files that have been received by the Microsoft FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Transferred attribute Description The sum of total number of files sent and received. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Sent Rate (per sec) attribute Description The total number of files that have been sent by the Microsoft FTP service per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Files Received Rate (per sec) attribute Description The total number of files that have been received by the Microsoft FTP service per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

82

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Files Transferred Rate (per sec) attribute Description The rate of total files transferred by the Microsoft FTP service per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Anonymous Users attribute Description The number of users who currently have an anonymous connection that was made by using the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current NonAnonymous Users attribute Description The number of users who currently have a nonanonymous connection that was made by using the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Anonymous Users attribute Description The number of users who have established an anonymous connection with the Microsoft FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference

83

Total NonAnonymous Users attribute Description The number of users who have established nonanonymous connections with the Microsoft FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum Anonymous Users attribute Description The maximum number of users who have established concurrent anonymous connections using the Microsoft FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum NonAnonymous Users attribute Description The maximum number of users who have established concurrent nonanonymous connections using the Microsoft FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Current Anonymous Users attribute Description The percentage number of users who currently have an anonymous connection that was made by using the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined:

84

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Current NonAnonymous Users attribute Description The percentage number of users who currently have a nonanonymous connection that was made by using the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Total Anonymous Users attribute Description The percentage of users who have established an anonymous connection with the Microsoft FTP service since the service started. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Total NonAnonymous Users attribute Description The percentage of users who have established nonanonymous connections with the Microsoft FTP service since the service started. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Connections attribute Description The current number of connections that have been established with the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined:
Chapter 4. Attributes reference

85

v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum Connections attribute Description The maximum number of simultaneous connections that have been established with the Microsoft FTP service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Connection Attempts attribute Description The number of connections that have been attempted by using the Microsoft FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Logon Attempts attribute Description The number of logons that have been attempted by using the Microsoft FTP service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Logon Attempt Rate (per sec) attribute Description The rate of number of logons that have been attempted by using the Microsoft FTP service per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli

86

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Microsoft FTP Service Uptime (hrs) attribute Description The amount of time, in hours, that the Microsoft FTP service has been running. Type Real number (Counter) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Mime Types attribute group


This attribute group lists all Multipurpose Internet Mail Extensions (MIME) types so that you can identify the types of content that can be served from a Web server to a browser or a mail client. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Mime Types attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

File Extension attribute - This attribute is a key attribute. Description Specifies the file name extension. Type String

MIME Type attribute


Chapter 4. Attributes reference

87

Description The MIME type that is used to open the files. Type String

NNTP Server attribute group


This attribute group displays the information related to each NNTP Virtual Server status running on Microsoft IIS NNTP server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the NNTP Server attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

NNTP Virtual Server attribute - This attribute is a key attribute. Description The name used to identify NNTP Virtual Server. Type State attribute Description The current state of the NNTP virtual server. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v v v v v Starting (1) Started (2) Stopping (3) Stopped (4) Pausing (5) String

v Paused (6) v Continuing (7) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

88

Monitoring Agent for Microsoft Internet Information Services: Users Guide

NNTP Version Information attribute group


This attribute group displays information about the Microsoft IIS NNTP Server version. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the NNTP Version Information attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Server Name attribute Description The name that is used to identify IIS NNTP Server. Type String

Major NNTP Version Number attribute Description The major version number of the IIS NNTP Server. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Minor NNTP Version Number attribute Description The minor version number of the IIS NNTP Server. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)
Chapter 4. Attributes reference

89

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Performance Object Status attribute group


The Performance Object Status attribute group contains information that reflects the status of other attribute groups so you can see the status of all of the performance objects that make up this application all at once. Each of these other performance attribute groups is represented by a row in this table (or other type of view). The status for an attribute group reflects the result of the last attempt to collect data for that attribute group, which allows you to see whether the agent is performing correctly. Unlike other attribute groups, the Performance Object Status attribute group does not reflect the state of the monitored application. This attribute group is most often used to determine why data is not available for one of the performance attribute groups. If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Performance Object Status attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Query Name attribute - This attribute is a key attribute. Description The name of the attribute group. Type String

Object Name attribute Description The name of the performance object. Type String

Object Type attribute Description The type of the performance object. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v WMI (0)

90

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v v v v v v v v v v v v v v v v v v

PERFMON (1) WMI_ASSOCIATION_GROUP (2) JMX (3) SNMP (4) SHELL_COMMAND (5) JOINED_GROUPS (6) CIMOM (7) CUSTOM (8) ROLLUP_DATA (9) WMI_REMOTE_DATA (10) LOG_FILE (11) JDBC (12) CONFIG_DISCOVERY (13) NT_EVENT_LOG (14) FILTER (15) SNMP_EVENT (16) PING (17) DIRECTOR_DATA (18)

v DIRECTOR_EVENT (19) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Object Status attribute Description The status of the performance object. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v ACTIVE (0) v INACTIVE (1) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Error Code attribute Description The error code associated with the query Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v v v v v v v v NO_ERROR (0) GENERAL_ERROR (1) OBJECT_NOT_FOUND (2) COUNTER_NOT_FOUND (3) NAMESPACE_ERROR (4) OBJECT_CURRENTLY_UNAVAILABLE (5) COM_LIBRARY_INIT_FAILURE (6) SECURITY_INIT_FAILURE (7)
Chapter 4. Attributes reference

91

v v v v v

PROXY_SECURITY_FAILURE (9) NO_INSTANCES_RETURNED (10) ASSOCIATOR_QUERY_FAILED (11) REFERENCE_QUERY_FAILED (12) NO_RESPONSE_RECEIVED (13)

v CANNOT_FIND_JOINED_QUERY (14) v CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_1_RESULTS (15) v CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_2_RESULTS (16) v QUERY_1_NOT_A_SINGLETON (17) v QUERY_2_NOT_A_SINGLETON (18) v NO_INSTANCES_RETURNED_IN_QUERY_1 (19) v v v v v NO_INSTANCES_RETURNED_IN_QUERY_2 (20) CANNOT_FIND_ROLLUP_QUERY (21) CANNOT_FIND_ROLLUP_ATTRIBUTE (22) FILE_OFFLINE (23) NO_HOSTNAME (24)

v MISSING_LIBRARY (25) v ATTRIBUTE_COUNT_MISMATCH (26) v ATTRIBUTE_NAME_MISMATCH (27) v v v v v v v v COMMON_DATA_PROVIDER_NOT_STARTED (28) CALLBACK_REGISTRATION_ERROR (29) MDL_LOAD_ERROR (30) AUTHENTICATION_FAILED (31) CANNOT_RESOLVE_HOST_NAME (32) SUBNODE_UNAVAILABLE (33) SUBNODE_NOT_FOUND_IN_CONFIG (34) ATTRIBUTE_ERROR (35)

v CLASSPATH_ERROR (36) v CONNECTION_FAILURE (37) v FILTER_SYNTAX_ERROR (38) v FILE_NAME_MISSING (39) v SQL_QUERY_ERROR (40) v v v v v v v v SQL_FILTER_QUERY_ERROR (41) SQL_DB_QUERY_ERROR (42) SQL_DB_FILTER_QUERY_ERROR (43) PORT_OPEN_FAILED (44) ACCESS_DENIED (45) TIMEOUT (46) NOT_IMPLEMENTED (47) REQUESTED_A_BAD_VALUE (48)

v RESPONSE_TOO_BIG (49) v GENERAL_RESPONSE_ERROR (50) v SCRIPT_NONZERO_RETURN (51)

92

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v SCRIPT_NOT_FOUND (52) v SCRIPT_LAUNCH_ERROR (53) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Last Collection Start attribute Description The most recent time a data collection of this group started Type Timestamp with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NOT COLLECTED (0691231190000000) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Last Collection Finished attribute Description The most recent time a data collection of this group finished Type Timestamp with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NOT COLLECTED (0691231190000000) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Last Collection Duration attribute Description The duration of the most recently completed data collection of this group in seconds Type Real number (Counter) with 2 decimal places of precision

Average Collection Duration attribute Description The average duration of all data collections of this group in seconds Type Real number (Counter) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Refresh Interval attribute Description The interval at which this group is refreshed in seconds Type Integer (Counter)

Number of Collections attribute

Chapter 4. Attributes reference

93

Description The number of times this group has been collected since agent start Type Integer (Counter)

Cache Hits attribute Description The number of times an external data request for this group was satisfied from the cache Type Integer (Counter)

Cache Misses attribute Description The number of times an external data request for this group was not available in the cache Type Integer (Counter)

Cache Hit Percent attribute Description The percentage of external data requests for this group that were satisfied from the cache Type Real number (Counter) with 2 decimal places of precision

Intervals Skipped attribute Description The number of times a background data collection for this group was skipped because the previous collection was still running when the next one was due to start Type Integer (Counter)

SMTP Server attribute group


This attribute group displays the information related to each SMTP Virtual server status running on Microsoft IIS SMTP server. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the SMTP Server attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected.

94

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Type

String

SMTP Virtual Server attribute - This attribute is a key attribute. Description The name used to identify SMTP Virtual Server. Type State attribute Description The current state of the SMTP Virtual Server. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Starting (1) v Started (2) v v v v v Stopping (3) Stopped (4) Pausing (5) Paused (6) Continuing (7) String

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

SMTP Version Information attribute group


This attribute group displays information about the Microsoft IIS SMTP Server version. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the SMTP Version Information attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Server Name attribute Description The name that is used to identify IIS SMTP Server.
Chapter 4. Attributes reference

95

Type

String

Major SMTP Version Number attribute Description The major version number of the IIS SMTP Server. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Minor SMTP Version Number attribute Description The minor version number of the IIS SMTP Server. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Thread Pool Status attribute group


The Thread Pool Status attribute group contains information that reflects the status of the internal thread pool used to collect data asynchronously. If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Thread Pool Status attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

96

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Thread Pool Size attribute Description The number of threads currently existing in the thread pool. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Max Size attribute Description The maximum number of threads allowed to exist in the thread pool. Type Integer (Numeric Property) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Active Threads attribute Description The number of threads in the thread pool currently active doing work. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Avg Active Threads attribute Description The average number of threads in the thread pool simultaneously active doing work. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Min Active Threads attribute
Chapter 4. Attributes reference

97

Description The smallest number of threads in the thread pool that have simultaneously been active doing work. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Max Active Threads attribute Description The peak number of threads in the thread pool that have simultaneously been active doing work. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Queue Length attribute Description The number of jobs currently waiting in the thread pool queue. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Avg Queue Length attribute Description The average length of the thread pool queue during this run. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Min Queue Length attribute

98

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Description The minimum length the thread pool queue has reached. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Max Queue Length attribute Description The peak length the thread pool queue has reached. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Avg Job Wait attribute Description The average time a job spends waiting on the thread pool queue in seconds. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Thread Pool Total Jobs attribute Description The number of jobs completed by all threads in the pool since agent start. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v NO DATA (-1) v NO DATA (-100) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Chapter 4. Attributes reference

99

W3SVC W3WP attribute group


This attribute group monitors HTTP request processing related data for the worker process. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the W3SVC W3WP attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Name attribute - This attribute is a key attribute. Description The name of application pool with worker process identifier (ID) for that worker process. Type String

Total HTTP Requests Served attribute Description The total number of HTTP requests served by the worker process. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. HTTP Requests Served Rate (per sec) attribute Description The rate of total number of HTTP requests served by the worker process per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647)

100

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Request Rate (per sec) attribute Description The HTTP requests being processed by the worker process per second. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Active Requests attribute Description The current number of requests being processed by the worker process. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Threads attribute Description The total number of threads available to process requests in the worker process. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Threads Rate (per sec) attribute Description The rate of total number of threads available to process requests in the worker process per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference

101

v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Active Thread Count attribute Description The number of threads actively processing requests in the worker process. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current File Cache Memory Usage (KB) attribute Description The current number of KB used by user-mode file cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum File Cache Memory Usage (KB) attribute Description The maximum number of KB used by user-mode file cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Current Memory Usage (KB) attribute Description The current number of KB used by output cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Files Cached attribute

102

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Description The current number of files whose contents are present in user-mode cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Cached attribute Description The total number of files whose contents were added to the user-mode cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Files Cached Rate (per sec) attribute Description The rate of total number of files whose contents were added to the user-mode cache per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Hits attribute Description The total number of successful lookups in the user-mode file cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Chapter 4. Attributes reference

103

File Cache Misses attribute Description The total number of unsuccessful lookups in the user-mode file cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Flushes attribute Description The total number of files removed from the user-mode cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Active Flushed Entries attribute Description The number of file handles cached in user-mode that will be closed when all current transfers complete. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Flushed Files attribute Description The total number of file handles that have been removed from the user-mode cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

104

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Flushed Files Rate (per sec) attribute Description The rate of total number of file handles that have been removed from the user-mode cache per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Metadata Cached attribute Description The number of metadata information blocks currently present in user-mode cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Metadata Cached attribute Description The total number of metadata information blocks added to the user-mode cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cached Rate (per sec) attribute Description The rate of total number of metadata information blocks added to the user-mode cache per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference

105

v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Hits attribute Description The total number of successful lookups in the user-mode metadata cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Misses attribute Description The total number of unsuccessful lookups in the user-mode metadata cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Flushes attribute Description The total number of user-mode metadata cache flushes since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Flushed Metadata attribute Description The total number of metadata information blocks removed from the user-mode cache since service started. Type Integer (Counter) with enumerated values. The strings are

106

Monitoring Agent for Microsoft Internet Information Services: Users Guide

displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Flushed Metadata Rate (per sec) attribute Description The rate of total number of metadata information blocks removed from the user-mode cache per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Current Items attribute Description The number of items currently present in output cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Total Hits attribute Description The total number of successful lookups in output cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Total Misses attribute Description The total number of unsuccessful lookups in output cache since service started. Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference

107

displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Total Flushes attribute Description The total number of flushes of output cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Flushes Rate (per sec) attribute Description The rate of total number of flushes of output cache per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Total Flushed Items attribute Description The total number of items flushed from output cache since service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Flushed Items Rate (per sec) attribute Description The rate of total number of items flushed from output cache per second. Type Integer (rate of change between successive values) with

108

Monitoring Agent for Microsoft Internet Information Services: Users Guide

enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Hits Rate (per sec) attribute Description The rate of successful lookups in file cache during the last sample interval. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Hits Rate (per sec) attribute Description The rate of successful lookups in metadata cache during the last sample interval. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Misses Rate (per sec) attribute Description The rate of unsuccessful lookups in file cache during the last sample interval. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Misses Rate (per sec) attribute Description The rate of unsuccessful lookups in metadata cache during the last sample interval. Type Integer (Gauge) with enumerated values. The strings are displayed

Chapter 4. Attributes reference

109

in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Misses Rate (per sec) attribute Description The rate of unsuccessful lookups in output cache during the last sample interval. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum Thread Count attribute Description The maximum number of threads to which the thread pool can grow as needed. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Current Flushed Items attribute Description The number of items that have been flushed from output cache but are still being used by outgoing responses and taking up memory. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Output Cache Hits Rate (per sec) attribute Description The rate of successful lookups in output cache during the last sample interval. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined:

110

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

WAS W3WP attribute group


This attribute group monitors a specific worker process. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the WAS W3WP attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Name attribute - This attribute is a key attribute. Description The name of application pool with worker process identifier (ID) for that worker process. Type String

Active Listener Channels attribute Description The number of currently active listener channels in the worker process. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Active Protocol Handlers attribute Description The number of currently active protocol handlers in the worker process.
Chapter 4. Attributes reference

111

Type

Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Health Ping Reply Latency attribute Description The time, in 100-nanosecond intervals, taken by worker process to reply to last health ping. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Health Pings attribute Description The total number of health pings received by the process. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Health Ping Rate (per sec) attribute Description The rate of total number of health pings received by the process per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Messages Sent to WAS attribute Description The total number of messages sent to Web admin service by the worker process. Type Integer (Counter) with enumerated values. The strings are

112

Monitoring Agent for Microsoft Internet Information Services: Users Guide

displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Messages Sent to WAS Rate (per sec) attribute Description The rate of total number of messages sent to Web admin service by the worker process per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Requests Served attribute Description The total number of requests served by the worker process. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Requests Served Rate (per sec) attribute Description The rate of total number of requests served by the worker process per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Runtime Status Queries attribute Description The total number of runtime status queries received by the process. Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference

113

displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Runtime Status Queries Rate (per sec) attribute Description The rate of total number of runtime status queries received by the process per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total WAS Messages Received attribute Description The total number of messages received by the worker process from Web admin service. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. WAS Messages Received Rate (per sec) attribute Description The rate of total number of messages received by the worker process from Web admin service per second. Type Integer (rate of change between successive values) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

114

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Web Service attribute group


This attribute group monitors Web service. If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Web Service attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Total KB Sent attribute Description The number of KB that are sent by the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. KB Sent Rate (per sec) attribute Description The rate, in seconds, at which KB are sent by the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total KB Received attribute

Chapter 4. Attributes reference

115

Description The total KB of data that are received by the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. KB Received Rate (per sec) attribute Description The rate in seconds, at which KB are received by the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total KB Transferred attribute Description The total number of KB of data that are sent and received by the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. KB Total Rate (per sec) attribute Description The sum of KB sent per second and received per second. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

116

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Total Files Sent attribute Description The number of user-mode files that are sent by the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Files Sent Rate (per sec) attribute Description The rate, in seconds, at which files are sent. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Received attribute Description The number of files that are received by the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Files Received Rate (per sec) attribute Description The rate, in seconds, at which files are received by the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

Chapter 4. Attributes reference

117

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Transferred attribute Description The sum of total files sent and received by the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Files Rate (per sec) attribute Description The rate, in seconds, at which files are sent and received by the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Anonymous Users attribute Description The number of users who currently have an anonymous request pending with the WWW service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current NonAnonymous Users attribute Description The number of users who currently have a nonanonymous request pending with the WWW service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

118

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Anonymous Users attribute Description The number of users who have established an anonymous request since the WWW service started.This attribute does not increment when files are served from the kernel cache. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Anonymous Users Rate (per sec) attribute Description The rate, in seconds, at which users made anonymous requests to the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total NonAnonymous Users attribute Description The number of users who made nonanonymous requests to the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. NonAnonymous Users Rate (per sec) attribute Description The rate, in seconds, at which users made nonanonymous requests to the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined:
Chapter 4. Attributes reference

119

v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum NonAnonymous Users attribute Description The maximum number of users who made concurrent nonanonymous requests to the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum Anonymous Users attribute Description The maximum number of users who made concurrent anonymous requests to the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Current Anonymous Users attribute Description The percentage of users who currently have an anonymous request pending with the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Current NonAnonymous Users attribute Description The percentage of users who currently have a nonanonymous request pending with the WWW service. Type Real number (Gauge) with 2 decimal places of precision with

120

Monitoring Agent for Microsoft Internet Information Services: Users Guide

enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Total Anonymous Users attribute Description The percentage of users who established an anonymous request since the WWW service started.This attribute does not increment when files are served from the kernel cache. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. % Total NonAnonymous Users attribute Description The percentage of users who made nonanonymous requests to the WWW service since the service started. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Connections attribute Description The number of active connections to the WWW service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum Connections attribute Description The maximum number of simultaneous connections made to the WWW service since the service started.
Chapter 4. Attributes reference

121

Type

Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Total Connection Attempts (all Instances) attribute Description The number of connections attempted to the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Connection Attempts Rate (per sec) attribute Description The rate, in seconds, at which connections are attempted to the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Logon Attempts attribute Description The number of attempts made to log on to the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Logon Attempts Rate (per sec) attribute

122

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Description The rate, in seconds, at which attempts were made to log on to the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Web Service Uptime (hrs) attribute Description The amount of time, in hours, that the WWW service is running. Type Real number (Counter) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Method Requests attribute Description The number of HTTP requests that are made since the WWW service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Method Requests Rate (per sec) attribute Description The rate, in seconds, at which all HTTP requests are received. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Other Request Methods attribute
Chapter 4. Attributes reference

123

Description The number of HTTP requests that did not use the OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, MOVE, COPY, MKCOL, PROPFIND, PROPPATCH, SEARCH, LOCK, or UNLOCK methods since the WWW service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Other Request Methods Rate (per sec) attribute Description The rate, in seconds, at which HTTP requests that do not use the methods listed for the Total Other Requests Methods attribute are made to the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Requests Rate (per sec) attribute Description The rate, in seconds, at which all the HTTP requests are received. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Not Found Errors attribute Description The number of requests that are made since the service started, but not satisfied by the server because the requested document was not found.This is usually reported as HTTP error 404. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647)

124

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Not Found Error Rate (per sec) attribute Description The rate, in seconds, at which requests were not satisfied by the server because the requested document was not found. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Locked Errors attribute Description The number of requests that are made since the service started, but not satisfied by the server because the requested document was locked.This is usually reported as HTTP error 423. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Locked Error Rate (per sec) attribute Description The rate, in seconds, at which requests were not satisfied because the requested document was locked. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current CGI Requests attribute Description The number of CGI requests that are processed simultaneously by the WWW service. Type Integer (Gauge) with enumerated values. The strings are displayed

Chapter 4. Attributes reference

125

in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total CGI Requests attribute Description The number of all CGI requests that are made since the WWW service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. CGI Requests Rate (per sec) attribute Description The rate, in seconds, at which CGI requests are processed simultaneously by the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum CGI Requests attribute Description The maximum number of CGI requests that are processed simultaneously by the WWW service since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current ISAPI Extension Requests attribute Description The number of ISAPI extension requests that are processed simultaneously by the WWW service.

126

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Type

Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Total ISAPI Extension Requests attribute Description The number of ISAPI extension requests that are made since the WWW service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. ISAPI Extension Requests Rate (per sec) attribute Description The rate, in seconds, at which ISAPI extension requests are processed by the WWW service. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum ISAPI Extension Requests attribute Description The maximum number of ISAPI extension requests that were processed simultaneously by the WWW service. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Name attribute - This attribute is a key attribute. Description The name of the instance. Type String
Chapter 4. Attributes reference

127

Web Service Cache attribute group


This attribute group monitors Web service cache. If the warehouse default setting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.

Historical group
This attribute group is part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Web Service Cache attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Active Flushed Entries attribute Description The file handles cached in user-mode that will be closed when all current transfers complete. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current File Cache Memory Usage (KB) attribute Description The current number of KB that are used for the user-mode file cache. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Current Files Cached attribute

128

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Description The current number of files that are in the user-mode cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Files Cached attribute Description The total number of files that are added to the user-mode cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Hits attribute Description The number of successful lookups in the user-mode file cache that occurred since the WWW service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Hits % attribute Description The ratio of user-mode file cache hits to total cache requests since the service started. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Misses attribute
Chapter 4. Attributes reference

129

Description The total number of unsuccessful lookups in the user-mode file cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. File Cache Flushes attribute Description The number of files that were removed from the user-mode cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Maximum File Cache Memory Usage (KB) attribute Description The maximum number of KB that are used for user-mode file cache since the service started. Type Real number (Counter) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Flushed Files attribute Description The number of file handles that are removed from the user-mode cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

130

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Current Metadata Cached attribute Description The number of metadata information blocks that are currently in the user-mode cache. Type Integer (Gauge) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Metadata Cached attribute Description The total number of metadata information blocks that are added to the user-mode cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Hits attribute Description The number of successful lookups in the user-mode metadata cache that occurred since the WWW service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Misses attribute Description The total number of unsuccessful lookups in the user-mode metadata cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648)

Chapter 4. Attributes reference

131

Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Hits % attribute Description The ratio of user-mode metadata cache hits to total cache requests since the service started. Type Real number (Gauge) with 2 decimal places of precision with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Metadata Cache Flushes attribute Description The number of user-mode metadata cache flushes since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Total Flushed Metadata attribute Description The number of metadata information blocks that are removed from the user-mode cache since the service started. Type Integer (Counter) with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v Value_Exceeds_Maximum (2147483647) v Value_Exceeds_Minimum (-2147483648) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal.

Web Service Extensions Restricted List attribute group


This attribute group displays information about all available Web service extensions for Microsoft IIS. If the warehouse default setting is enabled, data for this attribute group is not stored in Tivoli Data Warehouse.

132

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Historical group
This attribute group is not part of the default historical group, and is eligible for use with Tivoli Data Warehouse.

Attribute descriptions
The following list contains information about each attribute in the Web Service Extensions Restricted List attribute group: Node attribute - This attribute is a key attribute. Description The managed system name of the agent. Type String

Timestamp attribute Description The local time at the agent when the data was collected. Type String

Allow/Deny Flag attribute Description Status of Web service extension. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v ALLOW (1) v DENY (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Physical Path attribute - This attribute is a key attribute. Description The full path to the extension.If the last three characters of the physical path are DLL (case insensitive), then the extension is ISAPI, otherwise it is CGI. Type String

Removable attribute Description Indicates whether the server administrator is allowed to delete the extension from IIS Manager. Type Integer with enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The warehouse and queries return the values shown in parentheses. The following values are defined: v CAN_UNINSTALL_IISMGR (1) v CANT_UNINSTALL_IISMGR (0) Any other values will display the actual value returned by the agent in the Tivoli Enterprise Portal. Group ID attribute

Chapter 4. Attributes reference

133

Description Non-localizable string used to identify groups of extensions. Type String

Description attribute Description Localizable description of the server extension. Type String

Disk capacity planning for historical data


Disk capacity planning for a monitoring agent is a prediction of the amount of disk space to be consumed for each attribute group whose historical data is being collected. Required disk storage is an important factor to consider when you are defining data collection rules and your strategy for historical data collection. The table in this chapter provides the following information required to calculate disk space for this monitoring agent: v Table is the table name as it is displayed in the warehouse database, if the attribute group is configured to be written to the warehouse. The table name listed here corresponds to the Table name in Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 v Attribute group is the name of the attribute group used to create the table in the warehouse database if it is short enough to fit in the table naming constraints of the database being used for the warehouse. The attribute group name listed here corresponds to the Warehouse table name in Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23. v Bytes per instance (agent) is an estimate of the record length for each row or instance written to the agent disk for historical data collection. This estimate can be used for agent disk space planning purposes. v Database bytes per instance (warehouse) is an estimate of the record length for detailed records written to the warehouse database, if the attribute group is configured to be written to the warehouse. Detailed records are those that have been uploaded from the agent for long-term historical data collection. This estimate can be used for warehouse disk space planning purposes. v Aggregate bytes per instance (warehouse) is an estimate of the record length for aggregate records written to the warehouse database, if the attribute group is configured to be written to the warehouse. Aggregate records are created by the Summarization agent for attribute groups that have been configured for summarization. This estimate can be used for warehouse disk space planning purposes. In addition to the information in the tables, you must know the number of instances of data that you plan to collect. An attribute group can have single or multiple instances of data depending on the application environment that is being monitored. For example, if your attribute group is monitoring each processor in your computer and you have a dual processor computer, the number of instances is two. The following table contains capacity planning information for the data logged by IBM Tivoli Monitoring for Microsoft Applications: Microsoft Internet Information Services Agent.

134

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table 4. Capacity planning for historical data logged by IBM Tivoli Monitoring for Microsoft Applications, V6.2.0 Interim Feature 1: Microsoft Internet Information Services Agent V6.2.0.1 Bytes per instance (agent) 192 192 3272 2240 144 276 148 396 1542 612 144 268 336 336 336 336 148 332 144 336 400 144 240 204 144 148 352 144 148 124 308 192 368 144 276 Database bytes per instance (warehouse) 253 229 3296 2246 142 442 147 397 1555 664 142 267 337 337 337 337 147 332 142 337 402 205 274 202 142 147 399 142 147 168 347 202 677 205 277 Aggregate bytes per instance (warehouse) 1337 434 3606 2283 179 1382 184 434 1592 740 179 304 374 374 374 374 184 369 179 374 439 833 1082 239 179 184 664 179 184 550 1638 626 2370 713 314

Table KQ7ACTIVES KQ7ASPNETA KQ7AVAIL KQ7EVTLOG KQ7IISFTPS KQ7FTPSERV KQ7IISFTPI KQ7HTTPCUS KQ7HTTPERR KQ7IISAPPL KQ7IISCOMP KQ7FTPBIND KQ7IISFTPM KQ7FSITDTL KQ7IISNNT2 KQ7IISSMM KQ7IISWEBI KQ7WEBBIND KQ7IISWEBS KQ7IISWEB1 KQ7WSITDTL KQ7INTERNE KQ7WIN32P1 KQ7MIMETYP KQ7IISNNTP KQ7IISNNT0 KQ7POBJST KQ7IISSMTP KQ7IISSMT0 KQ7THPLST KQ7WIN32PE KQ7WIN32P0 KQ7WEBSERV KQ7WEBSER1 KQ7RESTRIC

Attribute group KQ7_ACTIVE_SERVER_PAGES KQ7_ASP_NET KQ7_AVAILABILITY KQ7_EVENT_LOG KQ7_FTP_SERVER_SITE_STATUS KQ7_FTP_SERVICE KQ7_FTP_VERSION_INFORMATION KQ7_HTTP_CUSTOM_ERROR_MESSAGES KQ7_HTTP_ERROR_LOG KQ7_IIS_APPLICATION_POOLS_SETTING KQ7_IIS_COMPONENTS KQ7_IIS_FTP_SERVER_BINDINGS KQ7_IIS_FTP_SERVER_STATUS KQ7_IIS_FTP_SITES_DETAIL KQ7_IIS_NNTP_SERVER_STATUS KQ7_IIS_SMTP_SERVER_STATUS KQ7_IIS_VERSION_INFORMATION KQ7_IIS_WEB_SERVER_BINDINGS KQ7_IIS_WEB_SERVER_SITE_STATUS KQ7_IIS_WEB_SERVER_STATUS KQ7_IIS_WEB_SITES_DETAIL KQ7_INTERNET_INFORMATION_SERVICES_GL KQ7_MICROSOFT_FTP_SERVICE KQ7_MIME_TYPES KQ7_NNTP_SERVER KQ7_NNTP_VERSION_INFORMATION KQ7_PERFORMANCE_OBJECT_STATUS KQ7_SMTP_SERVER KQ7_SMTP_VERSION_INFORMATION KQ7_THREAD_POOL_STATUS KQ7_W3SVC_W3WP KQ7_WAS_W3WP KQ7_WEB_SERVICE KQ7_WEB_SERVICE_CACHE KQ7_WEB_SERVICE_EXTENSIONS_RESTRICTED_\ LIST

Chapter 4. Attributes reference

135

For more information about historical data collection, see the IBM Tivoli Monitoring Administrators Guide.

136

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 5. Situations reference


This chapter contains an overview of situations, references for detailed information about situations, and descriptions of the predefined situations included in this monitoring agent.

About situations
A situation is a logical expression involving one or more system conditions. Situations are used to monitor the condition of systems in your network. You can manage situations from Tivoli Enterprise Portal by using the Situation Editor. The monitoring agents that you use to monitor your system environment are delivered with a set of predefined situations that you can use as-is or you can create new situations to meet your requirements. Predefined situations contain attributes that check for system conditions common to many enterprises. Using predefined situations can improve the speed with which you can begin using the Monitoring Agent for Microsoft Internet Information Services. You can examine and, if necessary, change the conditions or values being monitored by a predefined situation to those best suited to your enterprise. You can display predefined situations and create your own situations using the Situation Editor. The left frame of the Situation editor initially lists the situations associated with the Navigator item that you selected. When you click a situation name or create a new situation, the right frame opens with the following tabs: Formula Formula describing condition being tested Distribution List of managed systems (operating systems, subsystems, or applications) to which the situation can be distributed. All of the Monitoring Agent for Microsoft Internet Information Services managed systems are assigned by default. Expert advice Comments and instructions to be read in the event workspace Action Command to be sent to the system Until Options to close the event after a period of time, or when another situation becomes true

More information about situations


IBM Tivoli Monitoring Users Guide contains more information about predefined and custom situations and how to use them to respond to alerts. For a list of the predefined situations for this monitoring agent and a description of each situation, see the Predefined situations section in this chapter and the information in that section for each individual situation.

Copyright IBM Corp. 2008, 2009

137

Predefined situations
This monitoring agent contains the following predefined situations, which are organized by Navigator item. v Microsoft Internet Information Services Not applicable v Active Server Pages KQ7_ASP_Que_Size_Increased KQ7_ASP_Req_Dispatch_Slow KQ7_ASP_Req_Que_Size_Large KQ7_ASP_High_Error_Rate v ASP NET Not applicable v Availability KQ7_Web_Server_Down KQ7_IISADMIN_Service_Down KQ7_WAS_Service_Down KQ7_AppHostSvc_Service_Down KQ7_WMSvc_Service_Down KQ7_MSFtpsvc_Service_Down KQ7_SMTPSVC_Service_Down KQ7_NntpSvc_Service_Down KQ7_HTTPFilter_Service_Down

KQ7_NetPipeAct_Service_Down KQ7_NetTcpAct_Service_Down KQ7_NetMsmqAct_Service_Down KQ7_NetTcpPShr_Service_Down KQ7_Ftpsvc_Service_Down v Event Log KQ7_WP_Start_Fail KQ7_App_Load_Fail KQ7_VirtualDir_CfgLost KQ7_W3_ETW_Tracing_Init_Failed KQ7_WP_Memory_Leak KQ7_W3SVC_App_Pool_Cmd_Err KQ7_W3SVC_Bind_Fail_Invald_URL KQ7_FTP_Pasport_MB_Access_Fail KQ7_W3SVC_Fail_2_Set_Queue_Len KQ7_WAS_Fail_To_Config_Job_Obj KQ7_FTP_Pasvport_Invalid_Value KQ7_IISWMSVC_Login_Unknown_Err KQ7_WMSVC_Auth_Read_Conf_Err KQ7_WMSVC_SvcHand_Unknown_Err KQ7_WMSVC_UNABLE_2_READ_SETGS KQ7_Process_Stop_Responding

138

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ7_WP_Terminated KQ7_AppHostSvc_SID_Config_Err KQ7_AppHostSvc_Hist_Config_Err KQ7_W3SVC_Binding_Fail KQ7_W3SVC_Listen_2_Many_Port KQ7_W3SVC_Filters_Load_Fail KQ7_W3SVC_Fail_2_Init KQ7_W3SVC_Perfmon_Init_Err KQ7_W3_Out_Of_Memory KQ7_WPHOST_Failed_Init KQ7_WP_Module_DLL_Load_Fail KQ7_WAS_Process_Creation_Fail

KQ7_W3_Fail_2_Create_FREB_Dir KQ7_WAS_Rapid_Fail_Protection KQ7_WAS_Fail_2_Reg_Protocol KQ7_FTP_System_Call_Failed KQ7_WAS_High_Load_Dynamic_Idle v FTP Server KQ7_FTP_Site_Down v IIS Configuration KQ7_HTTP_Log_Serv_Unavailable v IIS Global Not applicable v NNTP Server Not applicable v SMTP Server Not applicable v Web Server KQ7_Web_TooMany_Requests KQ7_Web_TooMany_Connections KQ7_Web_TooMany_KB_Sent KQ7_Web_TooMany_KB_Received KQ7_IIS_Web_Site_Down

v Worker Process Not applicable The remaining sections of this chapter contain descriptions of each of these situations. The situations are organized by Navigator item. The following information is provided about each situation: Description Information about the conditions that the situation tests Formula Syntax that contains one or more logical expressions describing the conditions for the situation to monitor

Chapter 5. Situations reference

139

Run at startup Whether the situation is automatically distributed to instances of the agent or is available for manual distribution Sampling interval Number of seconds that elapses between one sample of data that the monitoring agent collects for the server and the next sample Situation persistence Whether the conditions specified in the situation evaluate to true for the defined number of occurrences in a row before the situation is raised. The default of 1 means no persistence checking takes place. Severity Severity of the predefined events: Warning, Informational, or Critical Clearing conditions Controls when a true situation closes: after a period of time, when another situation is true, or whichever occurs first if both are selected.

Microsoft Internet Information Services Navigator item


There are no predefined situations for this Navigator item.

Active Server Pages Navigator item KQ7_ASP_Que_Size_Increased situation


Description
The size of the Active Server Pages queue increased. The situation will be evaluated for the table.

Formula
*IF *VALUE KQ7_ACTIVE_SERVER_PAGES.Requests_Queued_Delta *GT 0 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
15 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

140

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ7_ASP_Req_Dispatch_Slow situation
Description
The ASP requests are dispatched too slowly. The situation will be evaluated for the table.

Formula
*IF *VALUE KQ7_ACTIVE_SERVER_PAGES.Request_Wait_GT_Execution_Time *GT 0 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_ASP_Req_Que_Size_Large situation
Description
The ASP requests queue size is too large. The situation will be evaluated for the table.

Formula
*IF *VALUE KQ7_ACTIVE_SERVER_PAGES.Requests_Queued *GT 1000 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning
Chapter 5. Situations reference

141

Clearing conditions
The situation clears when the condition becomes false.

KQ7_ASP_High_Error_Rate situation
Description
ASP error rate is above the defined threshold. The situation will be evaluated for the table.

Formula
*IF *VALUE KQ7_ACTIVE_SERVER_PAGES.Errors_Rate *GT 1 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

ASP NET Navigator item


There are no predefined situations for this Navigator item.

Availability Navigator item KQ7_Web_Server_Down situation


Description
Microsoft IIS Web server is down. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ W3SVC *AND KQ7_AVAILABILITY.Status *EQ DOWN *VALUE

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

142

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Run at startup
This situation is automatically distributed to instances of this agent.

Sampling interval
5 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Critical

Clearing conditions
The situation clears when the condition becomes false.

KQ7_IISADMIN_Service_Down situation
Description
IISADMIN service is down. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ IISADMIN *AND KQ7_AVAILABILITY.Status *EQ DOWN *VALUE

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is automatically distributed to instances of this agent.

Sampling interval
5 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Critical

Clearing conditions
The situation clears when the condition becomes false.

KQ7_WAS_Service_Down situation
Description
WAS service is down [MS IIS V7.0]. The situation will be evaluated for each distinct value of Name.

Chapter 5. Situations reference

143

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ WAS *AND KQ7_AVAILABILITY.Status *EQ DOWN *VALUE

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is automatically distributed to instances of this agent.

Sampling interval
5 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Critical

Clearing conditions
The situation clears when the condition becomes false.

KQ7_AppHostSvc_Service_Down situation
Description
AppHostSvc service is down [MS IIS V7.0]. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ AppHostSvc *AND KQ7_AVAILABILITY.Status *EQ DOWN *VALUE

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is automatically distributed to instances of this agent.

Sampling interval
15 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Critical

Clearing conditions
The situation clears when the condition becomes false.

144

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ7_WMSvc_Service_Down situation
Description
Web Management service (WMSvc)is down [MS IIS V7.0]. The situation will be evaluated for each distinct value of Name.

Formula
*IF (*VALUE KQ7_AVAILABILITY.Name *EQ WMSvc *OR *VALUE KQ7_AVAILABILITY.Name *EQ WMSVC) *AND *VALUE KQ7_AVAILABILITY.Status *EQ DOWN See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_MSFtpsvc_Service_Down situation
Description
FTP Publishing Service is down. The situation will be evaluated for each distinct value of Name.

Formula
*IF(*VALUE KQ7_AVAILABILITY.Name *EQ MSFtpsvc *OR *VALUE KQ7_AVAILABILITY.Name *EQ MSFTPSVC) *AND *VALUE KQ7_AVAILABILITY.Status *EQ DOWN See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Chapter 5. Situations reference

145

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_SMTPSVC_Service_Down situation
Description
SMTP service is down. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ SMTPSVC *AND KQ7_AVAILABILITY.Status *EQ DOWN *VALUE

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_NntpSvc_Service_Down situation
Description
NNTP service is down [MS IIS V6.0]. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ NntpSvc *AND KQ7_AVAILABILITY.Status *EQ DOWN *VALUE

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

146

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_HTTPFilter_Service_Down situation
Description
HTTP SSL service is down [MS IIS V6.0]. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ HTTPFilter *AND KQ7_AVAILABILITY.Status *EQ DOWN *VALUE

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_NetPipeAct_Service_Down situation
Description
NetPipeActivator service is down [MS IIS V7.0]. The situation will be evaluated for each distinct value of Name.

Chapter 5. Situations reference

147

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ NetPipeActivator *AND *VALUE KQ7_AVAILABILITY.Status *EQ DOWN See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
1 hour

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Informational

Clearing conditions
The situation clears when the condition becomes false.

KQ7_NetTcpAct_Service_Down situation
Description
NetTcpActivator service is down [MS IIS V7.0]. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ NetTcpActivator *AND *VALUE KQ7_AVAILABILITY.Status *EQ DOWN See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
1 hour

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Informational

Clearing conditions
The situation clears when the condition becomes false.

148

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ7_NetMsmqAct_Service_Down situation
Description
NetMsmqActivator service is down [MS IIS V7.0]. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ NetMsmqActivator *AND *VALUE KQ7_AVAILABILITY.Status *EQ DOWN See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
1 hour

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Informational

Clearing conditions
The situation clears when the condition becomes false.

KQ7_NetTcpPShr_Service_Down situation
Description
Net.Tcp Port Sharing service is down. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ NetTcpPortSharing *AND *VALUE KQ7_AVAILABILITY.Status *EQ DOWN See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
1 hour

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Chapter 5. Situations reference

149

Severity
Informational

Clearing conditions
The situation clears when the condition becomes false.

KQ7_Ftpsvc_Service_Down situation
Description
Microsoft FTP service is down [MS IIS V7.0]. The situation will be evaluated for each distinct value of Name.

Formula
*IF *VALUE KQ7_AVAILABILITY.Name *EQ ftpsvc *AND KQ7_AVAILABILITY.Status *EQ DOWN *VALUE

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

Event Log Navigator item KQ7_WP_Start_Fail situation


Description
Error found during W3WP process startup [MS IIS V6.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC-WP' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2269 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

150

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_App_Load_Fail situation
Description
Server failed to load application. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 36 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_VirtualDir_CfgLost situation
Description
Virtual directory configuration information is lost. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'IIS Config' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 51260

Chapter 5. Situations reference

151

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3_ETW_Tracing_Init_Failed situation
Description
ETW tracing failed to initialize [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC-WP' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2275 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WP_Memory_Leak situation
Description
IIS process consumed excessive memory. The situation will be evaluated for each distinct value of Event_Source.

152

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1077 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3SVC_App_Pool_Cmd_Err situation
Description
Application Pool configuration error [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1042 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Informational

Clearing conditions
The situation does not clear automatically.

Chapter 5. Situations reference

153

KQ7_W3SVC_Bind_Fail_Invald_URL situation
Description
W3SVC binding failed [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1003 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_FTP_Pasport_MB_Access_Fail situation
Description
FTP Pasvportrange MB access failed. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'MSFTPSVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 15) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'MSFtpsvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 15) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

154

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3SVC_Fail_2_Set_Queue_Len situation
Description
Failed to configure AppPoolQueueLen [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1087 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WAS_Fail_To_Config_Job_Obj situation
Description
WAS failed to configure a job object [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WAS' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 5088 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.
Chapter 5. Situations reference

155

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_FTP_Pasvport_Invalid_Value situation
Description
Found invalid FTP configuration property. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'MSFTPSVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 16) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'MSFtpsvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 16) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_IISWMSVC_Login_Unknown_Err situation
Description
IISWMSVC login unexpected error [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'Microsoft-Windows-IISIISManager' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1100 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

156

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WMSVC_Auth_Read_Conf_Err situation
Description
WMSVC authentication read error [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'Microsoft-Windows-IISIISManager' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1102) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'Microsoft-Windows-IIS-IISManager' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1106) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WMSVC_SvcHand_Unknown_Err situation
Description
Error occurred when processing a service request [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Chapter 5. Situations reference

157

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'Microsoft-Windows-IISIISManager' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1300 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WMSVC_UNABLE_2_READ_SETGS situation
Description
WMSVC is unable to read settings [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'Microsoft-Windows-IISIISManager' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1005 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

158

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ7_Process_Stop_Responding situation
Description
W3WP process exceeded time limit during shut down. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'IISService' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1010) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'IISService' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1013) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WP_Terminated situation
Description
W3WP process terminated unexpectedly. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1009) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'DCOM' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 10016) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Chapter 5. Situations reference

159

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_AppHostSvc_SID_Config_Err situation
Description
AppPool name data for SID mapping is incorrect [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'AppHostSvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 9000 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_AppHostSvc_Hist_Config_Err situation
Description
Config history feature of AppHostSvc is disabled [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'AppHostSvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 9006) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'AppHostSvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 9012) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

160

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3SVC_Binding_Fail situation
Description
W3SVC did not configure bindings for an application in Web site. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1029 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3SVC_Listen_2_Many_Port situation
Description
W3SVC did not register the URL prefix for the Web site. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1131 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.
Chapter 5. Situations reference

161

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3SVC_Filters_Load_Fail situation
Description
WP failed to load all ISAPI filters for the Web site or service. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC-WP' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2268 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3SVC_Fail_2_Init situation
Description
W3SVC failed to initialize the HTTP driver [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1173

162

Monitoring Agent for Microsoft Internet Information Services: Users Guide

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Critical

Clearing conditions
The situation does not clear automatically.

KQ7_W3SVC_Perfmon_Init_Err situation
Description
W3SVC has an inaccurate perfmon counter or no counter. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1018) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 1019) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3_Out_Of_Memory situation
Description
The HTTP Server failed to initialize. The situation will be evaluated for each distinct value of Event_Source.
Chapter 5. Situations reference

163

Formula
*IF (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WMSvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2204) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WMSVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2204) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WPHOST_Failed_Init situation
Description
Error found during W3WP process initialization [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WMSvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2276) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WMSVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2276) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

164

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ7_WP_Module_DLL_Load_Fail situation
Description
The Module DLL failed to load [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WMSvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2280) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WMSVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2280) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WAS_Process_Creation_Fail situation
Description
WAS failed to create worker process for AppPool [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WAS' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 5022 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Chapter 5. Situations reference

165

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_W3_Fail_2_Create_FREB_Dir situation
Description
FailedRequestTracing failed to create directory [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'W3SVC-WP' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 2283 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WAS_Rapid_Fail_Protection situation
Description
Application pool is automatically disabled [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WAS' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 5002) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WAS' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 5059) See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

166

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WAS_Fail_2_Reg_Protocol situation
Description
WAS is unable to register protocol [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WAS' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 5136 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_FTP_System_Call_Failed situation
Description
A call to a system service failed unexpectedly. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF(*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'MSFTPSVC' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 9) *OR (*VALUE KQ7_EVENT_LOG.Event_Source *EQ 'MSFtpsvc' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 9)

Chapter 5. Situations reference

167

See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

KQ7_WAS_High_Load_Dynamic_Idle situation
Description
The dynamic idle load is high [MS IIS V7.0]. The situation will be evaluated for each distinct value of Event_Source.

Formula
*IF *VALUE KQ7_EVENT_LOG.Event_Source *EQ 'WAS' *AND *VALUE KQ7_EVENT_LOG.Event_ID *EQ 5193 See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
None. Data is analyzed when it becomes available.

Situation persistence
Not Applicable

Severity
Warning

Clearing conditions
The situation does not clear automatically.

168

Monitoring Agent for Microsoft Internet Information Services: Users Guide

FTP Server Navigator item KQ7_FTP_Site_Down situation


Description
The FTP site is not available. The situation will be evaluated for each distinct value of FTP_Site.

Formula
*IF *VALUE KQ7_FTP_SERVER_SITE_STATUS.State *NE 'Started' See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

IIS Configuration Navigator item KQ7_HTTP_Log_Serv_Unavailable situation


Description
Service Unavailable: Error while trying to access Web site. The situation will be evaluated for each distinct value of Client_IP_Address.

Formula
*IF *VALUE KQ7_HTTP_ERROR_LOG.Error_Code *EQ '503.1' See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Chapter 5. Situations reference

169

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

IIS Global Navigator item


There are no predefined situations for this Navigator item.

NNTP Server Navigator item


There are no predefined situations for this Navigator item.

SMTP Server Navigator item


There are no predefined situations for this Navigator item.

Web Server Navigator item KQ7_Web_TooMany_Requests situation


Description
A Web site received too many requests per second. The situation is evaluated for each distinct value of the NAME attribute.

Formula
*IF *VALUE KQ7_WEB_SERVICE.Total_Requests_Rate *GT 100000 *AND *VALUE KQ7_WEB_SERVICE.Name *NE '_Total' See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
15 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

170

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ7_Web_TooMany_Connections situation
Description
The site currently has too many connections. The situation is evaluated for each distinct value of the NAME attribute.

Formula
*IF *VALUE KQ7_WEB_SERVICE.Current_Connections *GT 1000 *AND *VALUE KQ7_WEB_SERVICE.Name *NE '_Total' See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
15 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_Web_TooMany_KB_Sent situation
Description
A Web site sent too many KB per second. The situation is evaluated for each distinct value of the NAME attribute.

Formula
*IF *VALUE KQ7_WEB_SERVICE.KB_Sent_Rate *GT 10000000 *AND *VALUE KQ7_WEB_SERVICE.Name *NE '_Total' See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Chapter 5. Situations reference

171

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_Web_TooMany_KB_Received situation
Description
A Web site received too many KB per second. The situation is evaluated for each distinct value of the NAME attribute.

Formula
*IF *VALUE KQ7_WEB_SERVICE.KB_Received_Rate *GT 10000000 *AND *VALUE KQ7_WEB_SERVICE.Name *NE '_Total' See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

KQ7_IIS_Web_Site_Down situation
Description
IIS Web site is not available. The situation will be evaluated for each distinct value of Web_Site.

Formula
*IF *VALUE KQ7_IIS_WEB_SERVER_SITE_STATUS.State *NE 'Started' See Attribute groups and attributes for the Monitoring Agent for Microsoft Internet Information Services on page 23 for descriptions of the attributes in this formula.

Run at startup
This situation is available for distribution.

Sampling interval
30 minutes

172

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Situation persistence
The number of times the conditions of the situation must occur for the situation to be true is 1.

Severity
Warning

Clearing conditions
The situation clears when the condition becomes false.

Worker Process Navigator item


There are no predefined situations for this Navigator item.

Chapter 5. Situations reference

173

174

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 6. Take Action commands reference


This chapter contains an overview of Take Action commands, references for detailed information about Take Action commands, and descriptions of the Take Action commands included in this monitoring agent, if any.

About Take Action commands


Take Action commands can be run from the portal client or included in a situation or a policy. When included in a situation, the command runs when the situation becomes true. A Take Action command in a situation is also referred to as reflex automation. When you enable a Take Action command in a situation, you automate a response to system conditions. For example, you can use a Take Action command to send a command to restart a process on the managed system or to send a text message to a cell phone. Advanced automation uses policies to perform actions, schedule work, and automate manual tasks. A policy comprises a series of automated steps called activities that are connected to create a workflow. After an activity is completed, Tivoli Enterprise Portal receives return code feedback, and advanced automation logic responds with subsequent activities prescribed by the feedback. A basic Take Action command displays the return code of the operation in a message box that is displayed after the action completes or in a log file. After you close this window, no further information is available for this action.

More information about Take Action commands


For more information about working with Take Action commands, see the IBM Tivoli Monitoring Users Guide. For a list of the Take Action commands for this monitoring agent and a description of each command, see the Predefined Take Action commands section in this chapter and the information in that section for each individual command.

Predefined Take Action commands


This monitoring agent contains the following Take Action commands: v Start Application Host Helper Service v Start FTP Publishing Service v Start FTP Site v Start FTP Site by Name v v v v v v Start Start Start Start Start Start HTTP SSL Service IIS Admin Service IIS Web Server Microsoft FTP Service Net.Msmq Listener Adapter Service Net.Pipe Listener Adapter Service

Copyright IBM Corp. 2008, 2009

175

v v v v v v v v v v v v v v v v v v

Start Start Start Start Start

Net.Tcp Listener Adapter Service Net.Tcp Port Sharing Service Network News Transfer Protocol Service Simple Mail Transfer Protocol Service Web Management Service

Start Website Start Website by Name Start Windows Process Activation Service Stop Application Host Helper Service Stop FTP Publishing Service Stop FTP Site Stop FTP Site by Name Stop Stop Stop Stop Stop Stop HTTP SSL Service IIS Admin Service IIS Web Server Microsoft FTP Service Net.Msmq Listener Adapter Service Net.Pipe Listener Adapter Service

v Stop Net.Tcp Listener Adapter Service v Stop Net.Tcp Port Sharing Service v Stop Network News Transfer Protocol Service v v v v Stop Stop Stop Stop Simple Mail Transfer Protocol Service Web Management Service Website Website by Name

v Stop Windows Process Activation Service The remaining sections of this chapter contain descriptions of these Take Action commands, which are listed alphabetically. The following information is provided about each Take Action command: Description Which actions the command performs on the system to which it is sent, and the permissions required for the Take Action command to function Return codes Information that the Take Action command returns

Start Application Host Helper Service action Description


Starts the Application Host Helper Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70043I Message: The Application Host Helper service was started.

176

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70044I Message: The Application Host Helper service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70045E Message: Error starting the Application Host Helper service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start FTP Publishing Service action Description


Starts the FTP Publishing Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70013I Message: The FTP Publishing service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70014I Message: The FTP Publishing service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70015E
Chapter 6. Take Action commands reference

177

Message: Error starting the FTP Publishing service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start FTP Site action Description


Starts FTP site selected by the user.

System command
To include the Take Action command in a situation or workflow policy, use the following syntax for the system command:
START_FTP_SITE \ [KQ7_FTP_SERVER_SITE_STATUS.FTP_Site]

You can use attribute substitution to supply the Take Action command arguments for the situation, for example:
START_FTP_SITE \ [&{KQ7_FTP_SERVER_SITE_STATUS.FTP_Site}]

You can also use attribute substitution in a workflow policy though the format is slightly different:
START_FTP_SITE \ [&WaitOnSituation:KQ7_FTP_SERVER_SITE_STATUS.FTP_Site]

Arguments
v Name: KQ7_FTP_SERVER_SITE_STATUS.FTP_Site Description: FTP Site Default: &KQ7_FTP_SERVER_SITE_STATUS.FTP_Site

178

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70095I Message: The FTP site was started. v Return Code: 2 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70096E Message: The FTP site name might be invalid and cannot be started.

Start FTP Site by Name action Description


Starts the FTP site that is selected by the user.

System command
To include the Take Action command in a situation or workflow policy, use the following syntax for the system command:
START_FTP_SITE_BY_NAME \ [KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name]

You can use attribute substitution to supply the Take Action command arguments for the situation, for example:
START_FTP_SITE_BY_NAME \ [&{KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name}]

You can also use attribute substitution in a workflow policy though the format is slightly different:
START_FTP_SITE_BY_NAME \ [&WaitOnSituation:KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name]

Arguments
v Name: KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name Description: FTP Site Default: &KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70095I Message: The FTP site was started. v Return Code: 2 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70096E Message: The FTP site name might be invalid and cannot be started.
Chapter 6. Take Action commands reference

179

Start HTTP SSL Service action Description


Starts the HTTP SSL Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70031I Message: The HTTP SSL service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70032I Message: The HTTP SSL service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70033E Message: Error starting the HTTP SSL service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start IIS Admin Service action Description


Starts the IIS Admin service.

Return codes
v Return Code: 0 Return Code Type: OK

180

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Operating systems: Windows Message ID: KQ70001I Message: The IIS Admin service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70002I Message: The IIS Admin service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70003E Message: Error starting the IIS Admin service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start IIS Web Server action Description


Starts the IIS Web Server.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70007I Message: The IIS Web Server was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70008I Message: The IIS Web Server is already started. v Return Code: 1
Chapter 6. Take Action commands reference

181

Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70009E Message: Error starting the IIS Web Server. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start Microsoft FTP Service action Description


Starts the Microsoft FTP Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70085I Message: The Microsoft FTP service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70086I Message: The Microsoft FTP service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70087E Message: Error starting the Microsoft FTP service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

182

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start Net.Msmq Listener Adapter Service action Description


Starts the Net.Msmq Listener Adapter Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70073I Message: The Net.Msmq Listener Adapter service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70074I Message: The Net.Msmq Listener Adapter service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70075E Message: Error starting the Net.Msmq Listener Adapter service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E
Chapter 6. Take Action commands reference

183

Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start Net.Pipe Listener Adapter Service action Description


Starts Net.Pipe Listener Adapter Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70061I Message: The Net.Pipe Listener Adapter service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70062I Message: The Net.Pipe Listener Adapter service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70063E Message: Error starting the Net.Pipe Listener Adapter service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

184

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Start Net.Tcp Listener Adapter Service action Description


Starts the Net.Tcp Listener Adapter Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70067I Message: The Net.Tcp Listener Adapter service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70068I Message: The Net.Tcp Listener Adapter service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70069E Message: Error starting the Net.Tcp Listener Adapter service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start Net.Tcp Port Sharing Service action Description


Starts the Net.Tcp Port Sharing Service.

Return codes
v Return Code: 0 Return Code Type: OK
Chapter 6. Take Action commands reference

185

Operating systems: Windows Message ID: KQ70079I Message: The Net.Tcp Port Sharing service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70080I Message: The Net.Tcp Port Sharing service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70081E Message: Error starting the Net.Tcp Port Sharing service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start Network News Transfer Protocol Service action Description


Starts the Network News Transfer Protocol Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70019I Message: The Network News Transfer Protocol service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70020I Message: The Network News Transfer Protocol service is already started.

186

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70021E Message: Error starting the Network News Transfer Protocol service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start Simple Mail Transfer Protocol Service action Description


Starts the Simple Mail Transfer Protocol Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70025I Message: The Simple Mail Transfer Protocol service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70026I Message: The Simple Mail Transfer Protocol service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70027E Message: Error starting the Simple Mail Transfer Protocol service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W
Chapter 6. Take Action commands reference

187

Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start Web Management Service action Description


Starts the Web Management Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70049I Message: The Web Management service was started. v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70050I Message: The Web Management service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70051E Message: Error starting the Web Management service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows

188

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Start Website action Description


Starts IIS Web site selected by the user.

System command
To include the Take Action command in a situation or workflow policy, use the following syntax for the system command:
START_WEBSITE \ [KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site]

You can use attribute substitution to supply the Take Action command arguments for the situation, for example:
START_WEBSITE \ [&{KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site}]

You can also use attribute substitution in a workflow policy though the format is slightly different:
START_WEBSITE \ [&WaitOnSituation:KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site]

Arguments
v Name: KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site Description: IIS Web Site Default: &KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70091I Message: The Web site was started. v Return Code: 2 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70092E Message: The Web site name might be invalid and cannot be started.

Chapter 6. Take Action commands reference

189

Start Website by Name action Description


Starts the IIS Web site that is selected by the user.

System command
To include the Take Action command in a situation or workflow policy, use the following syntax for the system command:
START_WEBSITE_BY_NAME \ [KQ7_IIS_Web_Sites_Detail.Web_Site_Name]

You can use attribute substitution to supply the Take Action command arguments for the situation, for example:
START_WEBSITE_BY_NAME \ [&{KQ7_IIS_Web_Sites_Detail.Web_Site_Name}]

You can also use attribute substitution in a workflow policy though the format is slightly different:
START_WEBSITE_BY_NAME \ [&WaitOnSituation:KQ7_IIS_Web_Sites_Detail.Web_Site_Name]

Arguments
v Name: KQ7_IIS_Web_Sites_Detail.Web_Site_Name Description: IIS Web Site Default: &KQ7_IIS_Web_Sites_Detail.Web_Site_Name

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70091I Message: The Web site was started. v Return Code: 2 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70092E Message: The Web site name might be invalid and cannot be started.

Start Windows Process Activation Service action Description


Starts the Windows Process Activation Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70037I Message: The Windows Process Activation service was started.

190

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v Return Code: 2 Return Code Type: ALREADY_RUNNING Operating systems: Windows Message ID: KQ70038I Message: The Windows Process Activation service is already started. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70039E Message: Error starting the Windows Process Activation service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service. v Return Code: 8 Return Code Type: DOESNT_EXIST Operating systems: Windows Message ID: KQ70101I Message: The service is disabled and cannot be started. v Return Code: 7 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70102E Message: The dependency service or group failed to start. v Return Code: 6 Return Code Type: PREREQ_NOT_RUNNING Operating systems: Windows Message ID: KQ70103E Message: The dependency service does not exist or has been marked for deletion.

Stop Application Host Helper Service action Description


Stops the Application Host Helper Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70046I Message: The Application Host Helper service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70047I Message: The Application Host Helper service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70048E
Chapter 6. Take Action commands reference

191

Message: Error stopping the Application Host Helper service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop FTP Publishing Service action Description


Stops the FTP Publishing Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70016I Message: The FTP Publishing service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70017I Message: The FTP Publishing service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70018E Message: Error stopping the FTP Publishing service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop FTP Site action Description


Stops FTP site selected by the user.

System command
To include the Take Action command in a situation or workflow policy, use the following syntax for the system command:
STOP_FTP_SITE \ [KQ7_FTP_SERVER_SITE_STATUS.FTP_Site]

You can use attribute substitution to supply the Take Action command arguments for the situation, for example:
STOP_FTP_SITE \ [&{KQ7_FTP_SERVER_SITE_STATUS.FTP_Site}]

192

Monitoring Agent for Microsoft Internet Information Services: Users Guide

You can also use attribute substitution in a workflow policy though the format is slightly different:
STOP_FTP_SITE \ [&WaitOnSituation:KQ7_FTP_SERVER_SITE_STATUS.FTP_Site]

Arguments
v Name: KQ7_FTP_SERVER_SITE_STATUS.FTP_Site Description: FTP Site Default: &KQ7_FTP_SERVER_SITE_STATUS.FTP_Site

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70097I Message: The FTP site was stopped. v Return Code: 2 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70098E Message: The FTP site name might be invalid and cannot be stopped.

Stop FTP Site by Name action Description


Stops the FTP site that is selected by the user.

System command
To include the Take Action command in a situation or workflow policy, use the following syntax for the system command:
STOP_FTP_SITE_BY_NAME \ [KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name]

You can use attribute substitution to supply the Take Action command arguments for the situation, for example:
STOP_FTP_SITE_BY_NAME \ [&{KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name}]

You can also use attribute substitution in a workflow policy though the format is slightly different:
STOP_FTP_SITE_BY_NAME \ [&WaitOnSituation:KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name]

Arguments
v Name: KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name Description: FTP Site Default: &KQ7_IIS_FTP_Sites_Detail.FTP_Site_Name

Chapter 6. Take Action commands reference

193

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70097I Message: The FTP site was stopped. v Return Code: 2 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70098E Message: The FTP site name might be invalid and cannot be stopped.

Stop HTTP SSL Service action Description


Stops the HTTP SSL Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70034I Message: The HTTP SSL service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70035I Message: The HTTP SSL service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70036E Message: Error stopping the HTTP SSL service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop IIS Admin Service action Description


Stops the IIS Admin Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70004I Message: The IIS Admin service was stopped. v Return Code: 2

194

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70005I Message: The IIS Admin service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70006E Message: Error stopping the IIS Admin service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop IIS Web Server action Description


Stops the IIS Web Server.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70010I Message: The IIS Web Server was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70011I Message: The IIS Web Server is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70012E Message: Error stopping the IIS Web Server. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop Microsoft FTP Service action Description


Stops the Microsoft FTP Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows
Chapter 6. Take Action commands reference

195

Message ID: KQ70088I Message: The Microsoft FTP service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70089I Message: The Microsoft FTP service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70090E Message: Error stopping the Microsoft FTP service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop Net.Msmq Listener Adapter Service action Description


Stops the Net.Msmq Listener Adapter Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70076I Message: The Net.Msmq Listener Adapter service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70077I Message: The Net.Msmq Listener Adapter service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70078E Message: Error stopping the Net.Msmq Listener Adapter service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop Net.Pipe Listener Adapter Service action Description


Stops the Net.Pipe Listener Adapter Service.

196

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70064I Message: The Net.Pipe Listener Adapter service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70065I Message: The Net.Pipe Listener Adapter service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70066E Message: Error stopping the Net.Pipe Listener Adapter service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop Net.Tcp Listener Adapter Service action Description


Stops the Net.Tcp Listener Adapter Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70070I Message: The Net.Tcp Listener Adapter service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70071I Message: The Net.Tcp Listener Adapter service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70072E Message: Error stopping the Net.Tcp Listener Adapter service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Chapter 6. Take Action commands reference

197

Stop Net.Tcp Port Sharing Service action Description


Stops the Net.Tcp Port Sharing Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70082I Message: The Net.Tcp Port Sharing service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70083I Message: The Net.Tcp Port Sharing service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70084E Message: Error stopping the Net.Tcp Port Sharing service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop Network News Transfer Protocol Service action Description


Stops the Network News Transfer Protocol Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70022I Message: The Network News Transfer Protocol service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70023I Message: The Network News Transfer Protocol service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70024E Message: Error stopping the Network News Transfer Protocol service. v Return Code: 9 Return Code Type: WARNING

198

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop Simple Mail Transfer Protocol Service action Description


Stops the Simple Mail Transfer Protocol Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70028I Message: The Simple Mail Transfer Protocol service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70029I Message: The Simple Mail Transfer Protocol service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70030E Message: Error stopping the Simple Mail Transfer Protocol service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop Web Management Service action Description


Stops the Web Management Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70052I Message: The Web Management service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70053I Message: The Web Management service is already stopped. v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70054E
Chapter 6. Take Action commands reference

199

Message: Error stopping the Web Management service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

Stop Website action Description


Stops IIS Web site selected by the user.

System command
To include the Take Action command in a situation or workflow policy, use the following syntax for the system command:
STOP_WEBSITE \ [KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site]

You can use attribute substitution to supply the Take Action command arguments for the situation, for example:
STOP_WEBSITE \ [&{KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site}]

You can also use attribute substitution in a workflow policy though the format is slightly different:
STOP_WEBSITE \ [&WaitOnSituation:KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site]

Arguments
v Name: KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site Description: IIS Web Site Default: &KQ7_IIS_WEB_SERVER_SITE_STATUS.Web_Site

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70093I Message: The Web site was stopped. v Return Code: 2 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70094E Message: The Web site name might be invalid and cannot be stopped.

Stop Website by Name action Description


Stops the IIS Web site that is selected by the user.

200

Monitoring Agent for Microsoft Internet Information Services: Users Guide

System command
To include the Take Action command in a situation or workflow policy, use the following syntax for the system command:
STOP_WEBSITE_BY_NAME \ [KQ7_IIS_Web_Sites_Detail.Web_Site_Name]

You can use attribute substitution to supply the Take Action command arguments for the situation, for example:
STOP_WEBSITE_BY_NAME \ [&{KQ7_IIS_Web_Sites_Detail.Web_Site_Name}]

You can also use attribute substitution in a workflow policy though the format is slightly different:
STOP_WEBSITE_BY_NAME \ [&WaitOnSituation:KQ7_IIS_Web_Sites_Detail.Web_Site_Name]

Arguments
v Name: KQ7_IIS_Web_Sites_Detail.Web_Site_Name Description: IIS Web Site Default: &KQ7_IIS_Web_Sites_Detail.Web_Site_Name

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70093I Message: The Web site was stopped. v Return Code: 2 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70094E Message: The Web site name might be invalid and cannot be stopped.

Stop Windows Process Activation Service action Description


Stops the Windows Process Activation Service.

Return codes
v Return Code: 0 Return Code Type: OK Operating systems: Windows Message ID: KQ70040I Message: The Windows Process Activation service was stopped. v Return Code: 2 Return Code Type: NOT_RUNNING Operating systems: Windows Message ID: KQ70041I Message: The Windows Process Activation service is already stopped.
Chapter 6. Take Action commands reference

201

v Return Code: 1 Return Code Type: GENERAL_ERROR Operating systems: Windows Message ID: KQ70042E Message: Error stopping the Windows Process Activation service. v Return Code: 9 Return Code Type: WARNING Operating systems: Windows Message ID: KQ70100W Message: The service does not exist as an installed service.

202

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 7. Policies reference


This chapter contains an overview of policies, references for detailed information about policies, and descriptions of the predefined policies included in this monitoring agent, if any.

About policies
Policies are an advanced automation technique for implementing more complex workflow strategies than you can create through simple automation. A policy is a set of automated system processes that can perform actions, schedule work for users, or automate manual tasks. You use the Workflow Editor to design policies. You control the order in which the policy executes a series of automated steps, which are also called activities. Policies are connected to create a workflow. After an activity is completed, Tivoli Enterprise Portal receives return code feedback and advanced automation logic responds with subsequent activities prescribed by the feedback.

More information about policies


This monitoring agent does not provide predefined policies. For more information about working with policies, see the IBM Tivoli Monitoring Users Guide. For information about using the Workflow Editor, see the IBM Tivoli Monitoring Administrators Guide or the Tivoli Enterprise Portal online help.

Predefined policies
The Monitoring Agent for Microsoft Internet Information Services does not provide predefined policies.

Copyright IBM Corp. 2008, 2009

203

204

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 8. Tivoli Common Reporting for the monitoring agent


This chapter contains descriptions of the reports that are currently available with the Monitoring Agent for Microsoft Internet Information Services. The IBM Tivoli Monitoring for Microsoft Applications reports are historical reports that provide information about the summarized data that is collected in the Tivoli Data Warehouse. These reports run on the IBM Tivoli Monitoring Internet Information Services (IIS) agent V6.2.0 and later. The supported versions of the Tivoli Common Reporting servers are: V1.1.1.0, V1.2.0.0, and V1.2.0.1.Table 5 contains the supported databases.
Table 5. Supported databases Database Oracle DB2

Version Oracle V9.2, 10g Release 1, and 10g Release 2 DB2 V8.1 FP10 and higher, 8.2 FP3 and higher, V9.1 and fix packs SQL Server 2008 Service Pack 1, SQL Server 2005 Service Pack 2, SQL Server 2000 Service Pack 4

MSSQL

See the following additional information about using reports with this monitoring agent: v The Tivoli Common Reporting Users Guide V1.2.0.1 contains information about prerequisites, importing and configuring the datasource, and running the reports. v Tivoli Common Reporting troubleshooting on page 279 contains information about common errors when using Tivoli Common Reporting with this monitoring agent. Complete documentation for the Tivoli Common Reporting tool is available at: http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/ com.ibm.tivoli.tcr.doc/tcr_welcome.html Use the following image and directory to install the Tivoli Common Reporting files on the Tivoli Common Reporting server: Product image: ITMfMSApps620InterimFeature1 Package: \REPORTS\KQ7\IISReports_V1.0.zip The reports in this chapter are grouped into the following categories: Category 1: Performance reports Web Service Data Transfer report Displays the total KB sent and received, and the rate at which KB are sent and received. Web Service Data Transfer Subreport Displays the total KB sent and received, and the rate at which KB are sent and received for the selected Web site.

Copyright IBM Corp. 2008, 2009

205

Web Service Files Transfer report Displays the total files sent and received by the Web service, and the rate at which the files are sent and received by the Web service. Web Service Files Transfer Subreport Displays the total files sent and received by the Web service, and the rate at which the files are sent and received by the Web service for the selected Web site. Web Service Anonymous And NonAnonymous Users report Displays the number of anonymous and non-anonymous users that made a request to the Web service. Web Service Anonymous And NonAnonymous Users Subreport Displays the number of anonymous and non-anonymous users that requested a Web service. Web Service Connection And Logon Attempts report Displays the number of connections and logon attempts made to the Web service. Web Service Connection And Logon Attempts Subreport Displays the number of connections and logon attempts that are made to the Web service. Web Service HTTP Requests report Displays the number and the rate of HTTP requests received by the Web service. Web Service HTTP Requests Subreport Displays the number and the rate of HTTP requests that are received by the Web service. Web Service Request Errors and Error Rate report Displays the number of not found errors and locked errors encountered, and the error rate for the Web service while processing requests. FTP Service Files Transfer report [FTP 6.0] Displays the total number of files sent and received by FTP service, and the rate at which files are sent and received by the FTP service. FTP Service Files Transfer Subreport [FTP 6.0] Displays the total number of files sent and received by FTP service, and the rate at which files are sent and received by the FTP service for the selected FTP site. FTP Service Anonymous And NonAnonymous Users report [FTP 6.0] Displays the number of users who used the FTP service to make anonymous and non anonymous connections. FTP Service Anonymous And NonAnonymous Users Subreport [FTP 6.0] Displays the number of users who used the FTP service to make anonymous and non anonymous connections. FTP Service Connection And Logon Attempts report [FTP 6.0] Displays the number of connections and logon attempts that are made to the FTP service. FTP Service Connection And Logon Attempts Subreport [FTP 6.0] Displays the number of connections and logon attempts that are made to the FTP service.

206

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Active Server Pages Request And Error report Displays the ASP request rate, ASP request execution time and wait time, ASP error rate, and the total sessions and timed out sessions for ASP. Active Server Pages Transactions report Displays the statistics for ASP transactions. Active Server Pages Requests report Displays the performance of ASP requests. Microsoft FTP Service Files Transfer report [FTP 7.0] Displays the total number of files sent and received by the FTP service, and the rate at which files are sent and received by the FTP service. Microsoft FTP Service Files Transfer Subreport [FTP 7.0] Displays the total number of files sent and received by the FTP service, and the rate at which files are sent and received by the FTP service for the selected FTP site. Microsoft FTP Service Connection And Logon Attempts report [FTP 7.0] Provides details about the number of simultaneous connections and the logon attempts to the Microsoft FTP service. Microsoft FTP Service Connection And Logon Attempts Subreport [FTP 7.0] Provides details about the number of simultaneous connections and the logon attempts to the Microsoft FTP service. Category 2: Memory Utilization reports Web Service Cache Utilization report This report displays the file cache memory used, the total files cached, and the file cache hits. IIS Global Cache Utilization report Displays the number of files and Binary Large Object (BLOB) cached and the percentage of cache hits. ASP.NET Site Cache Memory Usage report Displays the cache memory usage performance report for ASP.NET sites. ASP.NET Site Cache Memory Usage Subreport Displays the performance of cache memory usage for ASP.NET sites. Category 3: Availability reports Web Site Availability report Displays the availability of each Web site that is configured under IIS. Web Site Availability Subreport Displays the availability of each Web site that is configured under IIS. Web Server Availability report Displays the status of the Web server configured under IIS. FTP Site Availability report Displays the availability of each FTP site that is configured under the FTP server.
Chapter 8. Tivoli Common Reporting for the monitoring agent

207

FTP Site Availability Subreport Displays the availability of each FTP site that is configured under the FTP server. FTP Server Availability report Displays the availability of the FTP server configured under IIS. Web Server Availability In Terms Of Hours report [Hourly Heat Map] Displays the availability in hours of the Web server that is configured under IIS. Web Server Availability In Terms Of Hours report [Daily Heat Map] Displays the availability in days of the Web server that is configured under IIS. FTP Server Availability In Terms Of Hours report [Hourly Heat Map] Displays the availability in hours of an FTP server that is configured under IIS. FTP Server Availability In Terms Of Hours report [Daily Heat Map] Displays the availability in days of an FTP server that is configured under IIS. Category 4: Event details report IIS Event Log report Displays the event log details for the IIS Server. The remaining sections in this chapter contain descriptions of the reports. For each report, the following information is included: v Name v v v v Description Purpose Parameters Tables or views used

v Output v Usage

Category 1: Performance reports Web Service Data Transfer report


Name Description Purpose Web Service Data Transfer report This report displays the total KB sent and received by the Web service and the rate at which KB are sent and received by the Web service. You can use this report to identify the Web service data transfer for each Web site on a single server.

208

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (Web Sites) Total KB Sent Total KB Received KB Sent Rate KB Received Rate

Input Attributes

Tables or views used

KQ7_WEB_SERVICE_DV

Chapter 8. Tivoli Common Reporting for the monitoring agent

209

Output

This report contains bar charts and tables. The Total KB Sent And Received Details bar chart displays the total bytes sent and the total bytes received by the Web service. X-Axis: Web Site Y-Axis: Total KB Sent and Total KB Received by the Web service. The output contains a bar chart with two vertical bars (in different colors) for total KB sent and total KB received by the service. You can view the data for multiple Web sites at the same time. Click the hyperlink in the table to drill down to the information about the total number of KB sent and total number of KB received for a particular Web site. X-Axis: Date Y-Axis: Total KB Sent and Total KB Received by the Web service. The Average KB Sent And Received Rate Details bar chart displays the KB sent rate and the KB received rate by the Web service. X-Axis: Web Site Y-Axis: Average KB Sent Rate and Average KB Received Rate for the Web service. The output contains bar chart for the KB sent rate and KB received rate for the Web service. The bars are indicated with different colors. You can view the data for multiple Web sites at the same time. Click the hyperlink in the table to drill down to the information about the KB sent rate and KB received rate for a particular Web site. X-Axis: Date Y-Axis: Average KB Sent Rate and KB Received Rate for the Web service. The Web Site Name table contains the mapping for Web site names and a short name given to Web sites. These short names are used in the bar charts to represent the corresponding sites on the X-axis. The Total KB Sent, Received, Average KB Sent And Received Rate Details table displays the Total KB Sent, Total KB Received, Average KB Sent Rate and Average KB Received Rate by the Web service for all the Web sites.

Usage

An IT administrator can use this report to get the information about the data traffic on a single server.

Web Service Data Transfer Subreport


Name Description Purpose Web Service Data Transfer Subreport This report displays the total KB sent and received by the Web service and the rate at which KB are sent and received by the Web service for the selected Web site. You can use this report to identify the Web service data transfer on a single server for the selected Web site.

210

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Attribute Select the value of the attribute from the Attribute list. Select All to view all sub-reports, Data Transfer to view the data transfer sub-report, and Data Transfer Rate to view the data transfer rate sub-report. Web Site Select the name of the Web site from the Web Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled.

Input Attributes

Name (Web Sites) Total KB Sent Total KB Received KB Sent Rate KB Received Rate

Tables or views used Output

KQ7_WEB_SERVICE_DV This report contains two line charts. The Total Kilo Bytes Sent And Received Details With Respect To Time line chart displays information about the total number of KB sent and the total number of KB received for a particular Web site. X-Axis: Date Y-Axis: Total KB Sent and Total KB Received by the Web service. The Kilo Bytes Sent And Received Rate Details With Respect To Time line chart displays information about the KB sent rate and KB received rate for a particular Web site. X-Axis: Date Y-Axis: Average KB Sent Rate and KB Received Rate for the Web service.

Usage

An IT administrator can use this report to get the information about the data traffic for the selected Web site on a single server.
Chapter 8. Tivoli Common Reporting for the monitoring agent

211

Web Service Files Transfer report


Name Description Purpose Parameters Web Service Files Transfer report This report displays the total files sent and received by the Web service, and the rate at which the files are sent and received by the Web service. You can use this report to identify the performance of the Web service file transfer. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (Web Sites) Files Sent Rate Files Received Rate Total Files Sent Total Files Received Tables or views used KQ7_WEB_SERVICE_DV

Input Attributes

212

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Output

This report contains bar charts and tables. The Total Files Sent And Received bar chart displays the total number of files sent and the total number of files received by the Web service. X-Axis: Web Site Y-Axis: Total Number of Files Sent and Total Number of Files Received by Web service The output contains two vertical bars (in different colors) for total files sent and total files received by Web service. You can view the data for multiple Web sites. Click the hyperlink in the table to drill down to the information about the total files sent and the total files received for that particular Web site. X-Axis: Date Y-Axis: Files Sent and Files Received by Web service The Average Files Sent And Received Rate Details bar chart displays the rate at which the files are sent and received for the Web service. X-Axis: Web Site Y-Axis: Average Files Sent Rate and Received Rate for the Web service The output contains two bars (in different colors) for the average files sent rate and files received rate by the Web service. You can view the data for multiple Web sites. Click the hyperlink in the table to display the information about the total files sent rate and files received rate for that particular Web site. X-Axis: Date Y-Axis: Files Sent Rate and Files Received Rate for the Web service The Web Site Name table contains mapping for Web site names and a short name given to Web sites. The Total Files Sent, Files Received, Average Files Sent And Received Rate table displays the number of files sent and received and the average rate at which the files are sent and received by the Web service for all Web sites.

Usage

An IT administrator can use this report to get the information about files that are transferred on a single server.

Web Service Files Transfer Subreport


Name Description Purpose Web Service Files Transfer Subreport This report displays the total files sent and received by the Web service, and the rate at which the files are sent and received by the Web service for the selected Web site. You can use this report to identify the performance for the Web service file transfer.

Chapter 8. Tivoli Common Reporting for the monitoring agent

213

Parameters

Server Name Select the name of the server from the Server Name list. Attribute Select the value of the attribute from the Attribute list. Select All to view all sub-reports, File Transfer to view the files transfer sub-report, and Files Transfer Rate to view the files transfer rate sub-report. Web Site Select the name of the Web site from the Web Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled.

Input Attributes

Name (Web Sites) Files Sent Rate Files Received Rate Total Files Sent Total Files Received

Tables or views used Output

KQ7_WEB_SERVICE_DV The Total Files Sent And Received Details With Respect To Time line chart displays information about the total files sent and the total files received for a particular Web site. X-Axis: Date Y-Axis: Files Sent and Files Received by Web service The Files Sent And Received Rate Details With Respect To Time line chart displays the information about the total files sent rate and the total files received rate for a particular Web site. X-Axis: Date Y-Axis: Files Sent Rate and Files Received Rate for the Web service

Usage

An IT administrator can use this report to get the information about the files that are transferred for a selected Web site on a single server.
Monitoring Agent for Microsoft Internet Information Services: Users Guide

214

Web Service Anonymous And NonAnonymous Users report


Name Description Purpose Parameters Web Service Anonymous And NonAnonymous Users report This report displays the number of anonymous and non-anonymous users that made a request to the Web service. You can use this report to analyze the users using the IIS Web server. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (Web Sites) Total Anonymous Users Total NonAnonymous Users Tables or views used KQ7_WEB_SERVICE_DV

Input Attributes

Chapter 8. Tivoli Common Reporting for the monitoring agent

215

Output

This report contains bar charts and tables. The stacked bar chart displays the number of anonymous and non-anonymous users who made a request to the Web service. X-Axis: Web Site Y-Axis: Percentage of Anonymous and NonAnonymous users who have made requests to Web service The output contains vertical stacked bars (in different colors) for the total number of anonymous and non-anonymous users who made a request to the Web service. You can view the data for multiple Web sites. Click the hyperlink in the table to drill down to the information about the total number of anonymous and non-anonymous users who made requests to the Web service for a particular Web site. X-Axis: Date Y-Axis: Anonymous and NonAnonymous users who have made requests to Web service The Web Site Name table contains mapping for Web site names and a short name given to Web sites. The Percent Anonymous And Nonanonymous User Details table displays the percentage of anonymous and non-anonymous users who made requests to the Web service.

Usage

An IT administrator can use this report to get the information about the number of users accessing IIS Web server for a single server.

Web Service Anonymous and NonAnonymous Users Subreport


Name Description Purpose Web Service Anonymous and NonAnonymous Users Subreport This report displays the number of anonymous and non-anonymous users that requested a Web service. You can use this report to analyze the users that use the IIS Web Server to request a Web service.

216

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Web Site Select the name of the Web site from the Web Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (Web Sites) Total Anonymous Users Total NonAnonymous Users

Input Attributes

Tables or views used Output

KQ7_WEB_SERVICE_DV The Total Anonymous And NonAnonymous Users Details With Respect To Time line chart displays information about the total number of non-anonymous and anonymous users that made a request for a particular Web site from the Web service. X-Axis: Date Y-Axis: Anonymous and NonAnonymous users who have made requests to Web service

Usage

An IT administrator can use this report to get information about the number of users that request a Web service from the IIS Web Server for a selected Web site on a single server.

Web Service Connection And Logon Attempts report


Name Description Purpose Web Service Connection And Logon Attempts report This report displays the number of connections and logon attempts made to the Web service. You can use this report to see the maximum number of connections and logon attempts made to the Web service.

Chapter 8. Tivoli Common Reporting for the monitoring agent

217

Parameters

Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (Web Sites) Total Connection Attempts Total Logon Attempts

Input Attributes

Tables or views used Output

KQ7_WEB_SERVICE_DV This report contains bar charts and tables. The Total Connection And Logon Attempts Details bar chart displays the number of connections that are made to the Web service. X-Axis: Web Site Y-Axis: Total number of Connections and Logon attempts made to Web service The output contains vertical bars for the total number of connections and logon attempts that are made to Web service. You can view the data for multiple Web sites on a single server. Click the hyperlink in the table to drill down to the information about the total number of connections that are made to the Web service for a particular Web site. X-Axis: Date Y-Axis: Number of Connections and Logon made to Web service The Web Site Name table contains the mapping for Web site names and a short name given to Web sites. The Total Connection And Logon Attempts table displays the total number of connections and logon attempts that are made to the Web service for all Web sites.

Usage

An IT administrator can use this report to monitor the connections and logon attempts that are made to a single server.

218

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Web Service Connection And Logon Attempts Subreport


Name Description Purpose Parameters Web Service Connection And Logon Attempts Subreport This report displays the number of connections and logon attempts that are made to the Web service. You can use this report to see the maximum number of connections and logon attempts that are made to the Web service. Server Name Select the name of the server from the Server Name list. Web Site Select the name of the Web site from the Web Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (Web Sites) Total Connection Attempts Total Logon Attempts Tables or views used Output KQ7_WEB_SERVICE_DV The Total Connection And Logon Attempts Details With Respect To Time line chart displays information about the total number of connections that are made to the Web service for a particular Web site. X-Axis: Date Y-Axis: Number of Connections and Logon made to Web service Usage An IT administrator can use this report to monitor the connections and logon attempts that are made to a single server for a selected Web site.

Input Attributes

Chapter 8. Tivoli Common Reporting for the monitoring agent

219

Web Service HTTP Requests report


Name Description Purpose Parameters Web Service HTTP Requests report This report displays the number and the rate of HTTP requests that are received by the Web service. You can use this report to determine the number and type of requests that are made to the Web service and the rate of requests that are received by the Web service. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (Web Sites) Total Method Requests Total Other Request Methods Total Method Requests Rate Other Request Methods Rate Tables or views used KQ7_WEB_SERVICE_DV

Input Attributes

220

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Output

This report contains bar charts and tables. The Total Method Requests Details chart displays the total method requests that are received by the Web service. X-Axis: Web Site Y-Axis: Total Method Requests Received by the Web service The output contains vertical bars for the total method requests that are received. You can view the data for multiple Web sites on a single server. Click the hyperlink in the table to drill down to the information about the total method requests that are received by the Web service for a particular Web site. X-Axis: Date Y-Axis: Total Method Requests Received The Total Other Request Methods Details bar chart displays the other request methods that are received by the Web service. X-Axis: Web Site Y-Axis: Total Other Request Methods Received by the Web service The output contains vertical bars for the other request methods that are received by the Web service. You can view the data for multiple Web sites on a single server. Click the hyperlink in the table to drill down to the information about the total other request methods that are received by the Web Service for a particular Web site. X-Axis: Date Y-Axis: Total Other Request Methods Received The Average Method Requests Rate Details bar chart displays the average of total method requests rate for a Web service. X-Axis: Web Site Y-Axis: Average Total Method Requests Rate The output contains vertical bars for the average method requests rate. You can view the data for multiple Web sites on a single server. The Average Other Request Methods Details bar chart displays the average of total other request methods rate received by the Web service. X-Axis: Web Site Y-Axis: Average Other Request Methods Rate The output contains vertical bars for the average total other request methods rate. You can view the data for multiple Web sites. The Web Site Name table contains mapping for Web site names and a short name given to Web sites. The Total Method Requests, Total Other Request Methods, Average Method Requests Rate, Average Other Request Methods table displays the Total Method Requests Received, Total Other Request Methods Received, Average Total Method Requests Rate, and Average Other Request Methods Rate by the Web service for all Web sites.

Usage

An IT administrator can use this report to monitor the request traffic on a single server.

Web Service HTTP Requests Subreport


Name Description Web Service HTTP Requests Subreport This report displays the number and the rate of HTTP requests that are received by the Web service.
Chapter 8. Tivoli Common Reporting for the monitoring agent

221

Purpose Parameters

You can use this report to determine the number and type of requests that are made to the Web service and the rate of requests that are received by the Web service. Server Name Select the name of the server from the Server Name list. Attribute Select the value of the attribute from the Attribute list. Select All to view all sub reports, Method Requests to view sub-report for method requests, and Other Request Methods to view the sub-report for other request methods. Web Site Select the name of the Web site from the Web Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled.

Input Attributes

Name (Web Sites) Total Method Requests Total Other Request Methods Total Method Requests Rate Other Request Methods Rate

Tables or views used Output

KQ7_WEB_SERVICE_DV The Total Method Requests Details With Respect To Time line chart displays information about the total method requests that are received by the Web service for a particular Web site. X-Axis: Date Y-Axis: Total Method Requests Received The Total Other Request Methods Details With Respect To Time line chart displays information about the total other request methods that are received by the Web Service for a particular Web site. X-Axis: Date Y-Axis: Total Other Request Methods Received

222

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Usage

An IT administrator can use this report to monitor the traffic of requests on a single server for a selected Web site.

Web Service Request Errors and Error Rate report


Name Description Purpose Parameters Web Service Request Errors and Error Rate report This report displays the number of not found errors and locked errors that are encountered and the error rate for the Web service, while processing requests. You can use this report to determine the type of errors encountered and the error rate for the Web Service. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (Web Sites) Total Not Found Errors Not Found Error Rate Total Locked Errors Locked Error Rate Tables or views used KQ7_WEB_SERVICE_DV

Input Attributes

Chapter 8. Tivoli Common Reporting for the monitoring agent

223

Output

This report contains bar charts and tables. The Total Not Found Errors And Locked Errors Details bar chart displays the total number of not found errors and locked errors that are encountered by the Web service. X-Axis: Web Site Y-Axis: Total Not Found Errors and Total Locked Errors The output contains vertical bars (in different colors) for Total Not Found Errors and Locked Errors. You can view the data for multiple Web sites. The Average Not Found Error Rate, Locked Error Rate Details bar chart displays the error rate for not found errors and locked errors for the Web service. X-Axis: Web Site Y-Axis: Not Found Error Rate and Locked Error Rate The output contains vertical bars (in different colors) for Not Found Error rate and Locked Error rate. You can view the data for multiple Web sites. The Web Site Name table contains mapping for Web site names and a short name given to Web sites. The Total Not Found Errors, Locked Errors, Average Not Found Error Rate And Locked Error Rate table displays the total not found errors and total locked errors for the Web service for all Web sites.

Usage

An IT administrator can use this report to get the information about the errors and error rate for a single server.

FTP Service Files Transfer report [FTP 6.0]


Name Description Purpose FTP Service Files Transfer report [FTP 6.0] This report displays the total number of files sent and received by FTP service, and the rate at which files are sent and received by FTP service. You can use this report to identify the FTP service [FTP 6.0] files that are transferred for each FTP site.

224

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (FTP Sites) Total Files Sent Total Files Received Files Sent Rate Files Received Rate

Input Attributes

Tables or views used

KQ7_FTP_SERVICE_DV

Chapter 8. Tivoli Common Reporting for the monitoring agent

225

Output

This report contains bar charts and tables. The Total Files Sent And Received Details bar chart displays the total number of files sent and the total number of files received by the FTP service. X-Axis: FTP Site Y-Axis: Total Files Sent and Total Files Received by the FTP service [FTP 6.0] The output contains two vertical bars (in different colors) for the total number of files sent and the total number of files received by the FTP service.You can view the data for multiple FTP sites. Click the hyperlink in the table to drill down to the information about the total number of files sent and the total number of files received on a particular FTP site. X-Axis: Date Y-Axis: Total Files Sent and Total Files Received by FTP service [FTP 6.0] The Average Files Sent And Received Rate Details bar chart displays the average number of files sent rate and the average number of files received rate for the FTP service. X-Axis: FTP Site Y-Axis: Average Files Sent Rate and Received Rate for the FTP service [FTP 6.0] The output contains two lines (in different colors) for the average files sent rate and files received rate by the FTP service. You can view the data for multiple FTP sites. Click the hyperlink in the table to drill down to the information about the total files sent rate and files received rate for a particular FTP site. X-Axis: Date Y-Axis: Files Sent Rate and Files Received Rate for the FTP server [FTP 6.0] The FTP Site Name table contains mapping for FTP site names and a short name given to FTP sites. The Total Files Sent, Files Received, Average Files Sent And Received Rate table displays total files sent, total files received, and average files sent rate and received rate by the FTP service for all FTP sites.

Usage

An IT administrator can use this report to get the information about the traffic of files on a single server.

FTP Service Files Transfer Subreport [FTP 6.0]


Name Description Purpose FTP Service Files Transfer Subreport [FTP 6.0] This report displays the total number of files sent and received by FTP service, and the rate at which files are sent and received by FTP service for the selected FTP site. You can use this report to identify the number of FTP files that are transferred for each FTP site on IIS V6.0.

226

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Attribute Select the attribute value from attribute list. Select All to view all sub reports, Files Transfer to view files transfer sub-report, Files Transfer Rate to view the file transfer rate sub-report. FTP Site Select the name of the FTP site from the FTP Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled.

Input Attributes

Name (FTP Sites) Total Files Sent Total Files Received Files Sent Rate Files Received Rate

Tables or views used Output

KQ7_FTP_SERVICE_DV The Files Sent And Received Details With Respect To Time line chart displays information about the total number of files sent and the total number of files received on a particular FTP site. X-Axis: Date Y-Axis: Total Files Sent and Total Files Received by FTP service [FTP 6.0] The Files Sent And Received Rate Details With Respect To Time line chart displays information about the total files sent rate and files received rate for a particular FTP site. X-Axis: Date Y-Axis: Files Sent Rate and Files Received Rate for the FTP server [FTP 6.0]

Usage

An IT administrator can use this report to get the information about the traffic of files on a single server for a selected FTP site.
Chapter 8. Tivoli Common Reporting for the monitoring agent

227

FTP Service Anonymous And NonAnonymous Users report [FTP 6.0]


Name Description Purpose Parameters FTP Service Anonymous And NonAnonymous Users report [FTP 6.0] This report displays the number of users who used the FTP service to make anonymous and non anonymous connections. You can use this report to analyze anonymous and non anonymous users connected to the FTP service. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (FTP Sites) Total Anonymous Users Total NonAnonymous Users Tables or views used KQ7_FTP_SERVICE_DV

Input Attributes

228

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Output

This report contains bar charts and tables. The Percent Anonymous And NonAnonymous Users Details stacked bar chart displays the number of anonymous users who sent requests to the FTP service [FTP 6.0] X-Axis: FTP Site Y-Axis: Percent Anonymous and NonAnonymous Users who have sent requests to FTP service [FTP 6.0] The output contains vertical stacked bars for the total number of anonymous and non anonymous users who have sent a request to the FTP service. You can view the data for multiple FTP sites on a single server. Click the hyperlink in the table to drill down to the information about the total number of anonymous and non anonymous users who sent a request to the FTP service for a particular FTP site. X-Axis: Date Y-Axis: Anonymous and NonAnonymous Users who have sent requests to FTP service [FTP 6.0] The FTP Site Name table contains mapping for FTP site names and a short name given to FTP sites. The Percent Anonymous And NonAnonymous Users table displays the percentage of anonymous and non anonymous users who have sent requests to the FTP service for all FTP sites.

Usage

An IT administrator can use this report to get the information about the number of users who use the FTP service to connect to an FTP server.

FTP Service Anonymous and NonAnonymous Users Subreport [FTP 6.0]


Name Description Purpose FTP Service Anonymous and NonAnonymous Users Subreport [FTP 6.0] This report displays the number of users who used the FTP service to make anonymous and non anonymous connections. You can use this report to analyze the anonymous and non anonymous users that are connected to the FTP service.

Chapter 8. Tivoli Common Reporting for the monitoring agent

229

Parameters

Server Name Select the name of the server from the Server Name list. FTP Site Select the name of the FTP site from the FTP Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (FTP Sites) Total Anonymous Users Total NonAnonymous Users

Input Attributes

Tables or views used Output

KQ7_FTP_SERVICE_DV The Total Anonymous And NonAnonymous Users Details With Respect To Time line chart displays information about the total number of non-anonymous and anonymous users that sent a request to the FTP service for a particular FTP site. X-Axis: Date Y-Axis: Anonymous and NonAnonymous Users who have sent requests to FTP service [FTP 6.0]

Usage

An IT administrator can use this report to get the information about the number of users that use the FTP service to connect to an FTP server. An IT administrator can get this information for a selected FTP site on a single server.

FTP Service Connection And Logon Attempts report [FTP 6.0]


Name Description Purpose FTP Service Connection And Logon Attempts report [FTP 6.0] This report displays the number of connections and logon attempts that are made to the FTP service. You can use this report to view the maximum number of connections and logon attempts that are made to the FTP service.

230

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (FTP Sites) Total Connection Attempts Total Logon Attempts

Input Attributes

Tables or views used Output

KQ7_FTP_SERVICE_DV This report contains bar charts and tables. The Total Connection And Logon Attempts Details bar chart displays the total number of connections and logon attempts that are made to the FTP service. X-Axis: FTP Site Y-Axis: Total number of Connection and Logon Attempts made to the FTP service [FTP 6.0] The output contains vertical bars for the total number of connections and logon attempts that are made to FTP service. You can view the data for multiple FTP sites. Click the hyperlink in the table to drill down to the information about the total number of connections that are made to the FTP service for a particular FTP site. X-Axis: Date Y-Axis: Total Number of Connection and Logon Attempts made to FTP service [FTP 6.0] The FTP Site Name table contains mapping for FTP site names and a short name given to FTP sites. The Total Connection And Logon Attempts Details table displays the total number of connections and logon attempts that are made to the FTP service for all FTP sites.

Chapter 8. Tivoli Common Reporting for the monitoring agent

231

Usage

An IT administrator can use this report to monitor connections and logon attempts that are made to a single server.

FTP Service Connection And Logon Attempts Subreport [FTP 6.0]


Name Description Purpose Parameters FTP Service Connection And Logon Attempts Subreport [FTP 6.0] This report displays the number of connections and logon attempts that are made to the FTP service. You can use this report to view the maximum number of connections and logon attempts that are made to the FTP service. Server Name Select the name of the server from the Server Name list. FTP Site Select the name of the FTP site from the FTP Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (FTP Sites) Total Connection Attempts Total Logon Attempts Tables or views used Output KQ7_FTP_SERVICE_DV The Total Connection And Logon Attempts Details line chart displays information about the total number of connections that are made to the FTP service for a particular FTP site. X-Axis: Date Y-Axis: Total Number of Connection and Logon Attempts made to FTP service [FTP 6.0]

Input Attributes

232

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Usage

An IT administrator can use this report to monitor connections and logon attempts that are made to a single server for a selected FTP site.

Active Server Pages Request And Error report


Name Description Purpose Parameters Active Server Pages Request And Error report This report displays the ASP request rate, ASP request execution time and wait time, ASP error rate, and the total sessions and timed out sessions for ASP. You can use this report to identify the success and error rates for requests and the ASP session performance. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Request Rate Error Rate Request Execution Time Request Wait Time Tables or views used KQ7_ACTIVE_SERVER_PAGES_DV

Input Attributes

Chapter 8. Tivoli Common Reporting for the monitoring agent

233

Output

This report contains bar charts and tables. The ASP Requests And Errors Rate Details bar chart displays the ASP request rate in seconds. X-Axis: Node (Server Name) Y-Axis: ASP Request Rate and Error Rate The output contains vertical bars (in different colors) for ASP request rate and error rate in seconds. You can view the data for multiple servers. The Average ASP Request Execution Time And Request Wait Time In Milliseconds bar chart displays ASP request execution time and ASP request wait time in milliseconds. X-Axis: Node (Server Name) Y-Axis: ASP Request Execution Time and ASP Request Wait Time The output contains two vertical bars (in different colors) for the processing time of ASP requests and the wait time of the ASP request. You can view the data for multiple servers. The ASP Requests And Errors Rate table displays the ASP requests and the error rate. The Average ASP Request Execution Time And Request Wait Time In Milliseconds table displays the average ASP request processing time and request wait time in milliseconds.

Usage

An IT administrator can use this report to identify the success and error rates for ASP requests on multiple servers.

Active Server Pages Transactions report


Name Description Purpose Active Server Pages Transactions report This report displays the statistics for ASP transactions. You can use this report to analyze the number of aborted transactions, committed transactions, and pending transactions.

234

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Aborted Transactions Committed Transactions Pending Transactions

Input Attributes

Tables or views used Output Usage

KQ7_ACTIVE_SERVER_PAGES_DV This report contains a pie chart that displays the percentage of aborted transactions, committed transactions, and pending transactions. An IT administrator can use this report to get information about the ASP transactions for a single server.

Active Server Pages Requests report


Name Description Purpose Active Server Pages Requests report This report displays the performance of ASP requests. You can use this report to analyze the performance of ASP requests.

Chapter 8. Tivoli Common Reporting for the monitoring agent

235

Parameters

Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Not Authorized Requests Not Found Requests Rejected Requests Requests Timed Out

Input Attributes

Tables or views used Output Usage

KQ7_ACTIVE_SERVER_PAGES_DV This report displays a pie chart that displays the percentage of requests not authorized, requests not found, requests rejected, and requests that timed out. An IT administrator can use this report to get information about ASP requests for a single server.

Microsoft FTP Service Files Transfer report [FTP 7.0]


Name Description Purpose Microsoft FTP Service Files Transfer report [FTP 7.0] This report displays the total number of files sent and received by the FTP service, and the rate at which files are sent and received by the FTP service. You can use this report to identify Microsoft FTP service [FTP 7.0] files transferred for each instance.

236

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (FTP Sites) Total Files Sent Total Files Received Files Sent Rate Files Received Rate

Input Attributes

Tables or views used

KQ7_MICROSOFT_FTP_SERVICE _DV

Chapter 8. Tivoli Common Reporting for the monitoring agent

237

Output

This report contains bar charts and tables. The Total Files Sent And Received Details bar chart displays the total number of files sent and received by the Microsoft FTP Service [FTP 7.0] X-Axis: FTP Site Y-Axis: Total Files Sent and Total Files Received by Microsoft FTP Service [FTP 7.0] The output contains two vertical bars (in different colors) for the total number of files sent and received by the Microsoft FTP Service. You can view the data for multiple FTP sites on a single server. Click the hyperlink in the table to drill down to the information about the total files sent on a particular FTP site. X-Axis: Date Y-Axis: Total Files Sent and Total Files Received by Microsoft FTP Service [FTP 7.0] The Average Files Sent And Received Rate Details bar chart displays the files sent rate and the files received rate for the Microsoft FTP Service. X-Axis: FTP Site Y-Axis: Average Files Sent Rate and Files Received Rate for the Web service [FTP 7.0] The output contains lines for files sent rate and files received rate by the Microsoft FTP Service [FTP 7.0]. You can view the data for multiple FTP sites. Click the hyperlink in the table to drill down to the information about the total files sent rate for a particular instance. X-Axis: Date Y-Axis: Files Sent Rate and Files Received Rate for the FTP service [FTP 7.0] The FTP Site Name table contains mapping for FTP site names and a short name given to FTP sites. The Total Files Sent, Files Received, Average Files Sent And Received Rate table displays the total files sent, total files received, average files sent rate and files received rate for Microsoft FTP Service for all FTP sites.

Usage

An IT administrator can use this report to get information about the traffic of files on a single server.

Microsoft FTP Service Files Transfer Subreport [FTP 7.0]


Name Description Microsoft FTP Service Files Transfer Subreport [FTP 7.0] This report displays the total number of files sent and received by the FTP service, and the rate at which files are sent and received by the FTP service for the selected FTP site. You can use this report to identify the Microsoft FTP service files that are transferred for the selected FTP site.

Purpose

238

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Attribute Select the attribute value from the Attribute list. Select All to view all sub-reports, Files Transfer to view the files transfer sub-report, Files Transfer Rate to view the files transfer rate sub-report. FTP Site Select the name of the FTP site from the FTP Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled.

Input Attributes

Name (FTP Sites) Total Files Sent Total Files Received Files Sent Rate Files Received Rate

Tables or views used Output

KQ7_MICROSOFT_FTP_SERVICE _DV The Total Files Sent And Received Details With Respect To Time line chart displays information about the total files sent and received for a particular FTP site. X-Axis: Date Y-Axis: Total Files Sent and Total Files Received by Microsoft FTP Service [FTP 7.0] The Files Sent And Received Rate Details With Respect To Time line chart displays information about the total files are sent and received rate for a particular FTP site. X-Axis: Date Y-Axis: Files Sent Rate and Files Received Rate for the FTP service [FTP 7.0]

Usage

An IT administrator can use this report to get information about the traffic of files on a single server for the selected FTP site.

Chapter 8. Tivoli Common Reporting for the monitoring agent

239

Microsoft FTP Service Connection And Logon Attempts report [FTP 7.0]
Name Description Purpose Parameters Microsoft FTP Service Connection And Logon Attempts report [FTP 7.0] This report provides details about the number of simultaneous connections and the logon attempts to the Microsoft FTP service. You can use this report to see the maximum number of connections and logon attempts made to the Microsoft FTP Service. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (FTP Sites) Total Connection Attempts Total Logon Attempts Tables or views used KQ7_MICROSOFT_FTP_SERVICE_DV

Input Attributes

240

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Output

This report contains bar charts and tables. The Total Connection And Logon Attempts Details bar chart displays the total number of connection and logon attempts made to the Microsoft FTP Service [FTP 7.0]. X-Axis: FTP Site Y-Axis: Total number of Connection and Logon attempts made to Microsoft FTP Service [FTP 7.0] The output contains vertical bars for the total number of connections and logon attempts made to the Microsoft FTP Service [FTP 7.0]. You can view the data for multiple FTP sites on a single server. Click the hyperlink in the table to drill down to the information about the total number of connections made to the Microsoft FTP Service [FTP 7.0] for a particular FTP site. X-Axis: Date Y-Axis: Number of Connection and Logon Attempts made to Microsoft FTP Service [FTP 7.0] FTP Site Name table contains mapping for FTP site names and a short name given to FTP sites. The Total Connection And Logon Attempts table displays the number of connections and logon attempts made to the Microsoft FTP Service for all FTP sites.

Usage

An IT administrator can use this report to monitor the connections and logon attempts made to a single server.

Microsoft FTP Service Connection And Logon Attempts Subreport [FTP 7.0]
Name Description Purpose Microsoft FTP Service Connection And Logon Attempts Subreport [FTP 7.0] This report provides details about the number of simultaneous connections and the logon attempts to the Microsoft FTP service. You can use this report to see the maximum number of connections and logon attempts that are made to the Microsoft FTP service.

Chapter 8. Tivoli Common Reporting for the monitoring agent

241

Parameters

Server Name Select the name of the server from the Server Name list. FTP Site Select the name of the FTP site from the FTP Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Name (FTP Sites) Total Connection Attempts Total Logon Attempts

Input Attributes

Tables or views used Output

KQ7_MICROSOFT_FTP_SERVICE_DV The Total Connection And Logon Attempts Details With Respect To Time line chart displays information about the total number of connections made to the Microsoft FTP Service [FTP 7.0] for a particular FTP site. X-Axis: Date Y-Axis: Number of Connection and Logon Attempts made to Microsoft FTP Service [FTP 7.0]

Usage

An IT administrator can use this report to monitor the connections and logon attempts that are made to a single server for a selected FTP site.

Category 2: Memory Utilization reports Web Service Cache Utilization report


Name Description Web Service Cache Utilization report This report displays the file cache memory used, the total files cached, and the file cache hits.

242

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Purpose Parameters

You can use this report to determine the cache memory usage, cache hits, and flushed cache entries. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Node (Server Name) Maximum File Cache Memory Usage Active Flushed Entries Total Files Cached File Cache Hits Total Flushed Files

Input Attributes

Tables or views used Output Usage

KQ7_WEB_SERVICE_CACHE_DV This report contains a table that displays the average active flushed entries, total files that are cached, file cache hits, and total flushed files for multiple servers. An IT administrator can use this report to get information about the cache usage for multiple servers.

IIS Global Cache Utilization report


Name Description Purpose IIS Global Cache Utilization report This report displays the number of cached files and Binary Large Objects (BLOBs) and the percentage of cache hits. You can use this report to determine the cache usage by the Web service.

Chapter 8. Tivoli Common Reporting for the monitoring agent

243

Parameters

Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Node (Server Name) Total Files Cached Total BLOBs Cached Percent File Cache Hits Percent BLOB Cache Hits Active Flushed Entries

Input Attributes

Tables or views used Output

KQ7INTERNE_DV This report contains a bar chart and tables. The Percent File Cache Hits And Percent BLOB Cache Hits For IIS bar chart displays the percentage of file cache hits by the IIS Server. X-Axis: Node (Server Name) Y-Axis: Percent File Cache Hits and Percent BLOB Cache Hits for IIS The output contains vertical bars (in different colors) for the Percent File Cache Hits and Percent BLOB Cache Hits for IIS attributes.You can view the data for multiple instances. The Percent File Cache Hits And Percent BLOB Cache Hits For IIS table displays the percentage of file cache hits and the percentage of BLOB cache hits for the IIS Server. The Cache Utilization table displays the data for the following attributes: Server Name, Total Files Cached, Total BLOBs Cached, and Average Active Flushed Entries.

Usage

An IT administrator can use this report to get information about the IIS global cache usage on multiple servers.

244

Monitoring Agent for Microsoft Internet Information Services: Users Guide

ASP.NET Site Cache Memory Usage report


Name Description Purpose Parameters ASP.NET Site Cache Memory Usage report This report displays the cache memory usage performance for ASP.NET sites. You can use this report to analyze the percentage of physical memory limit for cache and percentage of private bytes memory limit for cache. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Web Site Name Percent Machine Memory Cache Limit Used Percent Processor Memory Cache Limit Used Average Percent Machine Memory Cache Limit Used Average Percent Processor Memory Cache Limit Used Tables or views used KQ7_ASP_NET_DV

Input Attributes

Chapter 8. Tivoli Common Reporting for the monitoring agent

245

Output

This report displays a bar chart and a table. The Average Percent Cache Memory Limit Used Details chart displays the percentage of computer memory cache limit used for Web sites. X-Axis: Web Site Y-Axis: Percent Machine Memory Cache Limit Used and Percent Processor Memory Cache Limit Used The output contains vertical bars (in different colors) to display the percentage of computer memory cache limit used and the percentage of processor memory cache limit used. You can view the data for multiple instances on a single server. Click the hyperlink in the table to drill down to the information about the percentage of computer memory cache limit and the percentage of processor memory cache limit used for a particular site. X-Axis: Date Y-Axis: Percent Machine Memory Cache Limit Used and Percent Processor Memory Cache Limit Used The Web Site Name table contains mapping for Web site names and a short name given to Web sites. The Percent Cache Memory Limit Used table displays the percentage of computer memory cache limit used and the percentage of processor memory cache limit used by the Web service for all Web sites.

Usage

An IT administrator can use this report to get information about the cache memory limit that is used by a Web site on a single server.

ASP.NET Site Cache Memory Usage Subreport


Name Description ASP.NET Site Cache Memory Usage Subreport This report displays the performance of cache memory usage for ASP.NET sites.

246

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Web Site Select the name of the Web site from the Web Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly, or Default from the list. If you select the Default option, the summarization type is computed based on the number of days for the date range. If the selected or required summarization view does not exist in the database, then the view is set to Hourly or Daily based on the number of days and the chart type. Shift and Vacation Period Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, then the default value is -1. Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled. Web Site Name Percent Machine Memory Cache Limit Used Percent Processor Memory Cache Limit Used Average Percent Machine Memory Cache Limit Used Average Percent Processor Memory Cache Limit Used

Input Attributes

Tables or views used Output

KQ7_ASP_NET_DV The Percent Cache Memory Limit Used Details line chart displays information about the percentage of computer memory cache limit and the percentage of processor memory cache limit that is used by a particular site. X-Axis: Date Y-Axis: Percent Machine Memory Cache Limit Used and Percent Processor Memory Cache Limit Used

Purpose Usage

You can use this report to analyze the percentage of physical memory limit for cache memory and percentage of private bytes memory limit for the cache memory. An IT administrator can use this report to get information about the cache memory limit that is used by a Web site on a single server.

Chapter 8. Tivoli Common Reporting for the monitoring agent

247

Category 3: Availability reports Web Site Availability report


Name Description Purpose Parameters Web Sites Availability report This report displays the availability of each Web site that is configured under IIS. You can use this report to determine the availability of Web sites configured under IIS. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Name (Web Sites) State Tables or views used Output KQ7_IIS_WEB_SERVER_SITE_STATUS This report contains bar charts and tables. The horizontal stacked bar chart displays the percentage of the availability of each Web site on a single server. X-Axis: Percent availability (State) Y-Axis: Web Site The output contains horizontal stacked bars (in different colors) to display the percentage of the availability of Web sites. You can view the data for multiple Web sites on a single server. The Web Site Name table contains mapping for Web site names and a short name given to Web sites. The Percent Status Details For Web Sites table contains the availability of Web sites for different states displayed as a percentage. The value in the Started column is a hyperlink. Click the hyperlink to display the availability heat map (hourly) for more information about the availability of the selected Web site in a started state. Usage An IT administrator can use this report to get information about the availability of Web sites configured under an IIS Server for a single server.

Input Attributes

Web Site Availability Subreport


Name Description Purpose Web Site Availability Subreport This report displays the availability of each Web site that is configured under IIS. You can use this report to determine the availability of a Web site that is configured under IIS.

248

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Web Site Select the name of the Web site from the Web Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Name (Web Sites) State KQ7_IIS_WEB_SERVER_SITE_STATUS The Web Site Availability Heat Map displays information about the availability of the selected Web site that is in a Started state. An IT administrator can use this heat map to get information about the availability of Web sites that are configured under IIS.

Input Attributes

Tables or views used Output Usage

Web Server Availability report


Name Description Purpose Parameters Web Server Availability report This report displays the status of the Web server configured under IIS. You can use this report to determine the availability of the Web server configured under IIS. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Node (Server Name) State Tables or views used KQ7_IIS_WEB_SERVER_STATUS

Input Attributes

Chapter 8. Tivoli Common Reporting for the monitoring agent

249

Output

This report contains bar charts and tables. This report displays a stacked bar chart for the percentage of availability of The Web server. The data can be displayed for multiple servers. X-Axis: Node (Server Name) Y-Axis: Percent availability (State) The output contains the vertical stacked bars (in different colors) for the percentage of the availability of the Web server for different states. You can view the data for multiple servers. The Percent Status Details For Web Server table contains the percentage availability of the Web server for different states with the server name as a hyperlink. Click the hyperlink to display the heat map for the Web server availability as an hours report (Web Server Availability In Terms Of Hours report [Hourly Heat Map])

Usage

An IT administrator can use this report to get information about the availability of a Web server configured under IIS. The data can be displayed for multiple servers.

FTP Site Availability report


Name Description Purpose Parameters FTP Site Availability report This report displays the availability of each FTP site that is configured under the FTP server. You can use this report to determine the availability of FTP sites configured under the FTP server. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. FTP Sites Name State Tables or views used KQ7_FTP_SERVER_SITE_STATUS

Input Attributes

250

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Output

This report contains bar charts and tables. This report displays a horizontal stacked bar chart for the percentage of availability of each FTP site on a single server. X-Axis: Percent availability (State) Y-Axis: FTP Site The output contains the horizontal stacked bars (in different colors) that display the percentage availability of states. You can view the data for multiple FTP sites on a single server. The FTP Site Name table contains mapping for FTP sites and a short name given to FTP sites. The Percent Status Details For FTP Sites table contains the percentage of availability of FTP sites for different states. The column values for the Started state contain a hyperlink to display the availability heat map (hourly) for more information about the availability of the selected FTP site in a started state.

Usage

An IT administrator can use this report to get information about the availability of FTP sites on a single server.

FTP Site Availability Subreport


Name Description Purpose Parameters FTP Site Availability Subreport This report displays the availability of each FTP site that is configured under the FTP server. You can use this report to determine the availability of an FTP site that is configured under an FTP server. Server Name Select the name of the server from the Server Name list. FTP Site Select the name of the FTP site from the FTP Site list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. FTP Sites Name State Tables or views used Output Usage KQ7_FTP_SERVER_SITE_STATUS The FTP Site Availability Heat Map displays more information about the availability of the selected FTP site that is in a Started state. An IT administrator can use this heat map to get information about the availability of each FTP site on a single server.

Input Attributes

FTP Server Availability report


Name FTP Server Availability report

Chapter 8. Tivoli Common Reporting for the monitoring agent

251

Description Purpose Parameters

This report displays the availability of the FTP server configured under IIS. You can use this report to determine the availability of the FTP server configured under IIS. Server Name Select the name of the server from the Server Name list. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Node (Server Name) State KQ7_FTP_SERVER_STATUS This report contains bar charts and tables. This report displays a stacked bar chart for the percentage of availability for multiple servers. X-axis: Node (FTP Server) Y-Axis: Percent availability of FTP Server (State) The output contains the vertical stacked bars (in different colors) for percent states. You can view the data for multiple servers. The Server Name column contains a hyperlink. The Percent Status Details For FTP Server table contains the percentage of availability of the FTP server for different states. The Server Name column contains a hyperlink. Click the hyperlink to display the heat map as an hours report (Hourly heat map) for the FTP server availability (FTP Server Availability In Terms Of Hours report.)

Input Attributes

Tables or views used Output

Usage

An IT administrator can use this report to get information about the availability of the FTP server configured under IIS. You can view the data for multiple servers.

Web Server Availability In Terms Of Hours report [Hourly Heat Map]


Name Description Purpose Web Server Availability In Terms Of Hours report [Hourly Heat Map] This heat map displays the availability in hours of the Web server that is configured under IIS. You can use this report to determine the availability of the Web server configured under IIS.

252

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Threshold specification You can enter threshold specifications for the following status: Fair Warning Bad Critical Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Web Service Uptime In Hours KQ7_WEB_SERVICE_HV This report displays the heat map for hourly views for the Web server availability. An IT administrator can use this report to get information about the availability of the Web server configured under IIS on a single server.

Input Attributes Tables or views used Output Usage

Web Server Availability In Terms Of Hours report [Daily Heat Map]


Name Description Purpose Parameters Web Server Availability In Terms Of Hours report [Daily Heat Map] This heat map displays the availability in days of the Web server that is configured under IIS. You can use this heat map to determine the availability of the Web server that is configured under IIS. Server Name Select the name of the server from the Server Name list. Threshold specification You can enter threshold specifications for the following status: Fair Warning Bad Critical Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Year Select the year for which the data is displayed on the heat map from the Year list. Web Service Uptime In Hours
Chapter 8. Tivoli Common Reporting for the monitoring agent

Input Attributes

253

Tables or views used Output Usage

KQ7_WEB_SERVICE_HV This report displays the heat map that shows the daily view of the availability of the Web server. An IT administrator can use this heat map to get information about the availability of the Web server that is configured under IIS.

FTP Server Availability In Terms Of Hours report [Hourly Heat Map]


Name Description Purpose Parameters FTP Server Availability In Terms Of Hours report [Hourly Heat Map] This heat map displays the availability in hours of an FTP server that is configured under IIS. You can use this report to determine the availability of the FTP server configured under IIS. Server Name Select the name of the server from the Server Name list. Threshold specification You can enter threshold specifications for the following status: Fair Warning Bad Critical Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. FTP Service Uptime In Hours KQ7_FTP_SERVICE_HV This report displays the heat map for hourly views of the FTP server availability. An IT administrator can use this report to get information about the availability of the FTP server configured under IIS on a single server.

Input Attributes Tables or views used Output Usage

FTP Server Availability In Terms Of Hours report [Daily Heat Map]


Name Description Purpose FTP Server Availability In Terms Of Hours report [Daily Heat Map] This report displays the availability in days of an FTP server that is configured under IIS. You can use this daily heat map to determine the availability of an FTP server that is configured under IIS.

254

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Parameters

Server Name Select the name of the server from the Server Name list. Threshold specification You can enter threshold specifications for the following status: Fair Warning Bad Critical Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time. Year Select the year for which the data is displayed on the heat map from the Year list. FTP Service Uptime In Hours KQ7_FTP_SERVICE_HV This report displays the heat map that shows a daily view of the availability of the FTP server. An IT administrator can use this heat map to get information about the availability of an FTP server that is configured under IIS.

Input Attributes Tables or views used Output Usage

Category 4: Event details report IIS Event Log report


Name Description Purpose Parameters IIS Event Log Report This report displays the event log details for IIS Server. An IT administrator can use this report to analyze the event messages and their statistics. Server Name Select the name of the server from the Server Name list. Event Source Select an event source from the Event Source list of the selected server to view the data for that event source. Date Range Report Period Select the report period from a predefined date range, such as Last Week, Current Month, Last 30 Days, and so on. You can also enter a start date, an end date, and the time for the reporting period. Start Date Select a start date from the calendar and the start time from the time widget. You must select both date and time. End Date Select an end date from the calendar and an end time from the time widget. You must select both date and time.

Chapter 8. Tivoli Common Reporting for the monitoring agent

255

Input Attributes

Event Source Event Name Event Type Event Message

Tables or views used Output

KQ7_EVENT_LOG This report contains details about the generated events. The pie chart displays the percentage of the total number of errors and warnings generated. The table displays the event name, event source, event type, and the message for an event. An IT administrator can use this report to get the information about the event log and the details about the events on a single server.

Usage

256

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Chapter 9. Troubleshooting
This chapter provides agent-specific troubleshooting information. See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting information. Also see Support information on page 281 for other problem-solving options. Note: You can resolve some problems by ensuring that your system matches the system requirements listed in Chapter 2, Requirements and agent-specific installation and configuration information for the monitoring agent, on page 7.

Gathering product information for IBM Software Support


Before contacting IBM Software Support about a problem you are experiencing with this product, gather the information in Table 6 that relates to the problem.
Table 6. Information to gather before contacting IBM Software Support Information type Log files Description Collect trace log files from failing systems. Most logs are located in a logs subdirectory on the host computer. See Trace logging on page 258 for lists of all trace log files and their locations. See the IBM Tivoli Monitoring Users Guide for general information about the IBM Tivoli Monitoring environment. v Version number and patch level

Microsoft Internet Information Server information Operating system Messages Version numbers for IBM Tivoli Monitoring

Operating system version number and patch level Messages and other information displayed on the screen Version number of the following members of the monitoring environment: v IBM Tivoli Monitoring. Also provide the patch level, if available. v IBM Tivoli Monitoring for Microsoft Applications: Microsoft Internet Information Services Agent Screen captures of incorrect output, if any.

Screen captures

See http://www.ibm.com/software/support/probsub.html for information about working with IBM Software Support.

Built-in troubleshooting features


The primary troubleshooting feature in the Monitoring Agent for Microsoft Internet Information Services is logging. Logging refers to the text messages and trace data generated by the Monitoring Agent for Microsoft Internet Information Services. Messages and trace data are sent to a file. Trace data captures transient information about the current operating environment when a component or application fails to operate as designed. IBM Software Support personnel use the captured trace information to determine the source of an error or unexpected condition. See Trace logging on page 258 for more information.

Copyright IBM Corp. 2008, 2009

257

Problem classification
The following types of problems might occur with the Monitoring Agent for Microsoft Internet Information Services: v Installation and configuration v General usage and operation v Display of monitoring data v Take Action commands This chapter provides symptom descriptions and detailed workarounds for these problems, as well as describing the logging capabilities of the monitoring agent. See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting information.

Trace logging
Trace logs capture information about the operating environment when component software fails to operate as intended. The principal log type is the RAS (Reliability, Availability, and Serviceability) trace log. These logs are in the English language only. The RAS trace log mechanism is available for all components of IBM Tivoli Monitoring. Most logs are located in a logs subdirectory on the host computer. See the following sections to learn how to configure and use trace logging: v Principal trace log files on page 259 v Examples: using trace logs on page 260 v Setting RAS trace parameters on page 261 Note: The documentation refers to the RAS facility in IBM Tivoli Monitoring as RAS1. IBM Software Support uses the information captured by trace logging to trace a problem to its source or to determine why an error occurred. All components in the IBM Tivoli Monitoring environment have a default tracing level. The tracing level can be changed on a per-component level to adjust the type of trace information collected, the degree of trace detail, the number of trace logs to be kept, and the amount of disk space used for tracing.

Overview of log file management


Table 7 on page 259 provides the names, locations, and descriptions of RAS1 log files. The log file names adhere to the following naming convention: Windows systems
hostname_productcode_program_HEXtimestamp-nn.log

where: v hostname is the host name of the computer where the monitoring component is running. v productcode is the two-character product code. For IBM Tivoli Monitoring for Microsoft Applications: Microsoft Internet Information Services Agent, the product code is q7. v program is the name of the program being run. v HEXtimestamp is a hexadecimal time stamp representing the time at which the program started. v nn is a rolling log suffix.

258

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Principal trace log files


Table 7 contains locations, file names, and descriptions of trace logs that can help determine the source of problems with agents.
Table 7. Trace log files for troubleshooting agents System where log is located On the Tivoli Enterprise Monitoring Server File name and path v Windows: The file in the install_dir\InstallITM path v UNIX: The candle_installation.log file in the install_dir/logs path The Warehouse_Configuration.log file is in the following location on Windows systems: install_dir\InstallITM The name of the RAS log file is as follows: v Windows: install_dir\logs\ hostname_ms_timestamp-nn.log v UNIX: install_dir/logs/ hostname_productcode_timestamp.log Note: File names for RAS1 logs include a hexadecimal time stamp. Also on UNIX, a log with a decimal time stamp is provided: hostname_productcode_timestamp.log and hostname_productcode_ timestamp.pidnnnnn in the install_dir/logs path, where nnnnn is the process ID number. On the Tivoli Enterprise Portal Server The name of the RAS log file is as follows: v Windows: install_dir\logs\ hostname_cq_HEXtimestamp-nn.log v UNIX: install_dir/logs/ hostname_cq_HEXtimestamp-nn.log Note: File names for RAS1 logs include a hexadecimal time stamp. Also on UNIX, a log with a decimal time stamp is provided: hostname_productcode_timestamp.log and hostname_productcode_ timestamp.pidnnnnn in the install_dir/logs path, where nnnnn is the process ID number. The teps_odbc.log file is located in the following path v Windows: install_dir\InstallITM path. v UNIX: install_dir/logs When you enable historical reporting, this log file traces the status of the warehouse proxy agent. Traces activity on the portal server. Description Provides details about products that are installed. Note: Trace logging is enabled by default. A configuration step is not required to enable this tracing. Provides details about the configuration of data warehousing for historical reporting. Traces activity on the monitoring server.

Chapter 9. Troubleshooting

259

Table 7. Trace log files for troubleshooting agents (continued) System where log is located On the computer that hosts the monitoring agent File name and path The RAS1 log files are as follows: v Windows: hostname_q7_kq7agent _HEXtimestamp-nn.log in the install_dir\tmaitm6\logs directory These logs are in the following directories: v Windows: install_dir\tmaitm6\logs The agent operations log files are as follows: Shows whether the agent was able to connect to the monitoring server. Shows which situations instance_hostname_Q7.LG0 is the current log are started and stopped, and shows other events created when the agent was started while the agent is running. A new version of this file is generated every time the agent is instance_hostname_Q7.LG1 is the backup of restarted. the previous log IBM Tivoli Monitoring generates one backup These logs are in the following directory copy of the *.LG0 file with the tag .LG1. View depending on the operating system that you .LG1 to learn the following details regarding the are using: previous monitoring session: v Windows: install_dir\tmaitm6\logs v Status of connectivity with the monitoring server. v Situations that were running. v The success or failure status of Take Action commands. Definitions of variables: timestamp is time stamp whose format includes year (y), month (m), day (d), hour (h), and minute (m), as follows: yyyymmdd hhmm HEXtimestamp is a hexadecimal representation of the time at which the process was started. install_dir represents the directory path where you installed the IBM Tivoli Monitoring component. install_dir can represent a path on the computer that host the monitoring system, the monitoring agent, or the portal. instance refers to the name of the database instance that you are monitoring. hostname refers to the name of the computer on which the IBM Tivoli Monitoring component runs. nn represents the circular sequence in which logs are rotated. Ranges from 1-5, by default, though the first is always retained, because it includes configuration parameters. productcode specifies the product codes, for example, um for Universal Agent or nt for Windows. Description Traces activity of the monitoring agent.

See the IBM Tivoli Monitoring Installation and Setup Guide for more information on the complete set of trace logs that are maintained on the monitoring server.

Examples: using trace logs


Typically, IBM Software Support applies specialized knowledge to analyze trace logs to determine the source of problems. You can open trace logs in a text editor to learn some basic facts about your IBM Tivoli Monitoring environment. The following examples are from the Tivoli Enterprise Monitoring Server log. Example one This excerpt shows the typical log for a failed connection between a monitoring agent and a monitoring server with the host name server1a:
(Thursday, August 11, 2005, 08:21:30-{94C}kdcl0cl.c,105,"KDCL0_ClientLookup") status=1c020006, "location server unavailable", ncs/KDC1_STC_SERVER_UNAVAILABLE (Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1157,"LookupProxy") Unable to connect to broker at ip.pipe:: status=0, "success", ncs/KDC1_STC_OK (Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1402,"FindProxyUsingLocalLookup") Unable to find running CMS on CT_CMSLIST <IP.PIPE:#server1a>

260

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Example two The following excerpts from the trace log for the monitoring server show the status of an agent, identified here as Remote node. The name of the computer where the agent is running is SERVER5B:
(42C039F9.0000-6A4:kpxreqhb.cpp,649,"HeartbeatInserter") Remote node SERVER5B:Q7 is ON-LINE. . . . (42C3079B.0000-6A4:kpxreqhb.cpp,644,"HeartbeatInserter") Remote node SERVER5B:Q7 is OFF-LINE.

Key points regarding the preceding excerpt: v The monitoring server appends the Q7 product code to the server name to form a unique name (SERVER5B:Q7) for this instance of the Monitoring Agent for Microsoft Internet Information Services. This unique name enables you to distinguish multiple monitoring products that might be running on SERVER5B. v The log shows when the agent started (ON-LINE) and later stopped (OFF-LINE) in the environment. v For the sake of brevity an ellipsis (...) represents the series of trace log entries that were generated while the agent was running. v Between the ON-LINE and OFF-LINE log entries, the agent was communicating with the monitoring server. v The ON-LINE and OFF-LINE log entries are always available in the trace log. All trace levels that are described in Setting RAS trace parameters provide these entries. On Windows, you can use the following alternate method to view trace logs: 1. In the Windows Start menu, choose Program Files > IBM Tivoli Monitoring > Manage Tivoli Enterprise Monitoring Services. The Manage Tivoli Enterprise Monitoring Services window is displayed. 2. Right-click a component and select Advanced > View Trace Log in the pop-up menu. For example, if you want to view the trace log of the Microsoft Internet Information Server agent, right-click the name of the that agent in the window. You can also use the viewer to access remote logs. Note: The viewer converts time stamps in the logs to a format that is easier to read.

Setting RAS trace parameters


Objective
Pinpoint a problem by setting detailed tracing of individual components of the monitoring agent and modules.

Background Information
The Monitoring Agent for Microsoft Internet Information Services uses RAS1 tracing and generates the logs described in Table 7 on page 259. The default RAS1 trace level is ERROR.

Before you begin


See Overview of log file management on page 258 to ensure that you understand log rolling and can reference the correct log files when you manage log file generation.

Chapter 9. Troubleshooting

261

After you finish


Monitor the size of the logs directory. Default behavior can generate a total of 45 to 60 MB for each agent that is running on a computer. For example, each database instance that you monitor can generate 45 to 60 MB of log data. See the Procedure section to learn how to adjust file size and numbers of log files to prevent logging activity from occupying too much disk space. Regularly prune log files other than the RAS1 log files in the logs directory. Unlike the RAS1 log files that are pruned automatically, other log types can grow indefinitely, for example, the logs in Table 7 on page 259 that include a process ID number (PID). Consider using collector trace logs as an additional source of troubleshooting information. Note: The KDC_DEBUG setting and the Maximum error tracing setting can generate a large amount of trace logging. Use them only temporarily, while you are troubleshooting problems. Otherwise, the logs can occupy excessive amounts of hard disk space.

Procedure
On Windows systems, you can use the graphical user interface to set trace options: 1. Open the Manage Tivoli Enterprise Monitoring Services window. 2. Right-click the icon of the monitoring agent whose logging you want to modify. 3. Select Advanced > Edit Trace Parms. The Tivoli Enterprise Monitoring Server Trace Parameters window is displayed. 4. Select a new trace setting in the pull-down menu in the Enter RAS1 Filters field or type a valid string. The selections are as follows: v General error tracing. KBB_RAS1=ERROR v Intensive error tracing. KBB_RAS1=ERROR (UNIT:kqz ALL) v Maximum error tracing. KBB_RAS1=ERROR (UNIT:kqz ALL) (UNIT:kra ALL) Note: As this example shows, you can set multiple RAS tracing options in a single statement. 5. Modify the value for Maximum Log Size Per File (MB) to change the log file size (changes LIMIT value). 6. Modify the value for Maximum Number of Log Files Per Session to change the number of log files per startup of a program (changes COUNT value). 7. Modify the value for Maximum Number of Log Files Total to change the number of log files for all startups of a program (changes MAXFILES value). 8. (Optional) Click Y (Yes) in the KDC_DEBUG Setting menu to log information that can help you diagnose communications and connectivity problems between the monitoring agent and the monitoring server. Note: The KDC_DEBUG setting and the Maximum error tracing setting can generate a large amount of trace logging. Use them only temporarily, while you are troubleshooting problems. Otherwise, the logs can occupy excessive amounts of hard disk space. 9. Click OK. You see a message reporting a restart of the monitoring agent so that your changes take effect. You can also manually edit the RAS1 trace logging parameters using this method:

262

Monitoring Agent for Microsoft Internet Information Services: Users Guide

1. Open the trace options file: Windows: install_dir\tmaitm6\KQ7ENV 2. Edit the line that begins with KBB_RAS1= to set trace logging preferences. For example, if you want detailed trace logging, set the Maximum Tracing option:KBB_RAS1=ERROR (UNIT:kqz ALL) (UNIT:kra ALL) 3. Edit the line that begins with KBB_RAS1_LOG= to manage the generation of log files: v MAXFILES: the total number of files that are to be kept for all startups of a given program. When this value is exceeded, the oldest log files are discarded. Default value is 9. v LIMIT: the maximum size, in megabytes (MB) of a RAS1 log file. Default value is 5. v IBM Software Support might guide you to modify the following parameters: COUNT: the number of log files to keep in the rolling cycle of one program startup. Default is 3. PRESERVE: the number of files that are not to be reused in the rolling cycle of one program startup. Default value is 1. Note: The KBB_RAS1_LOG parameter also provides for the specification of the log file directory, log file name, and the inventory control file directory and name. Do not modify these values or log information can be lost. 4. Restart the monitoring agent so that your changes take effect.

Problems and workarounds


The following sections provide symptoms and workarounds for problems that might occur with the Monitoring Agent for Microsoft Internet Information Services: v Installation and configuration troubleshooting on page 263 v Remote deployment troubleshooting on page 266 v Agent troubleshooting on page 266 v Workspace troubleshooting on page 271 v Situation troubleshooting on page 275 Note: You can resolve some problems by ensuring that your system matches the system requirements listed in Chapter 2, Requirements and agent-specific installation and configuration information for the monitoring agent, on page 7. This chapter provides agent-specific troubleshooting information. See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting information.

Installation and configuration troubleshooting


This section provides tables that show solutions for installation, configuration, and uninstallation problems.

Chapter 9. Troubleshooting

263

Table 8. Problems and solutions for installation and configuration Problem Solution

You must reconfigure the previously existing agents to A problem can arise when you install and configure a new monitoring agent to a computer where other agents restore their communication connection with TEMS1. For example, you can right-click the row for a specific agent are running as described in this example: v Agents are running on computer and communicating in the Manage Tivoli Enterprise Monitoring Services, and select Reconfigure. See the IBM Tivoli Monitoring with a Tivoli Enterprise Monitoring Server, called Installation and Setup Guide for more information on TEMS1. reconfiguration. v You install a new agent on the same computer and you want this agent to communicate with a different monitoring server, called TEMS2. v When you configure the new agent to communicate with TEMS2, all the existing agents are re-configured to communicate with TEMS2. Diagnosing problems with product browse settings (Windows systems only). When you have problems with browse settings, perform the following steps: 1. Click Start > Programs > IBM Tivoli Monitoring > Manage Tivoli Enterprise Monitoring Services. The Manage Tivoli Enterprise Monitoring Services window is displayed. 2. Right-click the Windows agent and select Browse Settings. A text window is displayed. 3. Click Save As and save the information in the text file. If requested, you can forward this file to IBM Software Support for analysis. A message similar to Unable to find running CMS on CT_CMSLIST in the log file is displayed. If a message similar to Unable to find running CMS on CT_CMSLIST is displayed in the Log file, the agent is not able to connect to the monitoring server. Confirm the following points: v Do multiple network interface cards (NICs) exist on the system? v If multiple NICs exist on the system, find out which one is configured for the monitoring server. Ensure that you specify the correct host name and port settings for communication in the IBM Tivoli Monitoring environment. The system is experiencing high CPU usage. Agent process: View the memory usage of the KQ7CMA process. If CPU usage seems to be excessive, recycle the monitoring agent. Network Cards: The network card configurations can decrease the performance of a system. Each of the stream of packets that a network card receives (assuming it is a broadcast or destined for the under-performing system) must generate a CPU interrupt and transfer the data through the I/O bus. If the network card in question is a bus-mastering card, work can be off-loaded and a data transfer between memory and the network card can continue without using CPU processing power. Bus-mastering cards are generally 32-bit and are based on PCI or EISA bus architectures.

264

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table 8. Problems and solutions for installation and configuration (continued) Problem After you upgrade the IIS agent from V6.2.0 to V6.2.0.1, the value of the custom variables in the KQ7ENV file is retained but the value of the default environment variables is not retained. Solution During an upgrade process, a backup of the KQ7ENV file is created at this location: <itm_install_dir>\BACKUP\ current_date_timestamp\TMAITM6 You can use the backup KQ7ENV file at this location to manually update any environment variable settings in the new KQ7ENV file if needed.

When new V6.1 or V6.2 agent support files are added to See When new agent support files are added to V6.2.1, IBM Tivoli Monitoring V6.2.1 on Windows 2008, the the portal server configuration portion of the installation portal server configuration portion of the installation hangs in the Installation and configuration hangs. troubleshooting chapter of the IBM Tivoli Monitoring Troubleshooting Guide. Table 9. General problems and solutions for uninstallation Problem On Windows, uninstallation of IBM Tivoli Monitoring fails to uninstall the entire environment. Solution Be sure that you follow the general uninstallation process described in the IBM Tivoli Monitoring Installation and Setup Guide: 1. Remove Tivoli Enterprise Monitoring Server Application support by completing the following steps: a. Use Manage Tivoli Enterprise Monitoring Services. b. Select Tivoli Enterprise Monitoring Server. c. Right-click and select Advanced. d. Select Remove TEMS application support. e. Select the agent to remove its application support. 2. Uninstall monitoring agents first, as in the following examples: v Uninstall a single monitoring agent for a specific database. -ORv Uninstall all instances of a monitoring product, such as IBM Tivoli Monitoring for Databases. 3. Uninstall IBM Tivoli Monitoring. The way to remove inactive managed systems (systems whose status is OFFLINE) from the Navigator tree in the portal is not obvious. Use the following steps to remove, but not uninstall, an offline managed system from the Navigator tree: 1. Click the Enterprise icon in the Navigator tree. 2. Right-click, then click Workspace > Managed System Status. 3. Right-click the offline managed system, and select Clear offline entry. If you also want to uninstall the monitoring agent, use the procedure described in the IBM Tivoli Monitoring Installation and Setup Guide. If both the IIS agent V6.2.0.1 and Windows OS agent V6.2.1 are installed on an Itanium-based managed system, then the IIS agent fails to uninstall when you try to uninstall it. The following error message is displayed: This is Itanium architecture. Please use the installer for Windows Itanium. There is no solution for this problem at this time.

Chapter 9. Troubleshooting

265

Table 9. General problems and solutions for uninstallation (continued) Problem Solution

None. If both the IIS agent and Windows OS agent are installed on a managed system, then if you uninstall the Windows OS agent, the IIS agent and all IBM Tivoli Monitoring components are also uninstalled.

Remote deployment troubleshooting


Table 10 lists problems that might occur with remote deployment. This section provides information about troubleshooting remote deployment of the monitoring agent. See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting information. This section describes problems and solutions for remote deployment and removal of agent software using Agent Remote Deploy.
Table 10. Remote deployment problems and solutions Problem Solution

While you are using the remote deployment feature Do not close or modify this window. It is part of the to install the Monitoring Agent for Microsoft Internet installation process and is dismissed automatically. Information Services, an empty command window is displayed on the target computer. This problem occurs when the target of remote deployment is a Windows computer. (See the IBM Tivoli Monitoring Installation and Setup Guide for more information on the remote deployment feature.) When you right-click the Itanium Machine node in There is no solution for this problem at this time. the Navigator pane of the Tivoli Enterprise Portal client, and select Add Managed System, Itanium bundle is not displayed in the Add Managed System window. So, you cannot select Itanium bundles for remote deployment through the Tivoli Enterprise Portal. Note: This is applicable to IBM Tivoli Monitoring, V6.2.1 Interim Fix 2, and earlier and IBM Tivoli Monitoring, V6.2.0 Fix Pack 1, and earlier. The remote deployment of the IIS agent fails when you use the tacmd addsystem command on the managed system (Itanium workstation) Note: This is applicable to IBM Tivoli Monitoring V6.2.1, Interim Fix 2, and earlier and IBM Tivoli Monitoring, V6.2.0 Fix Pack 1, and earlier. The removal of a monitoring agent fails when you use the remote removal process in the Tivoli Enterprise Portal desktop or browser. There is no solution for this problem at this time.

This problem might occur when you attempt the remote removal process immediately after you have restarted the Tivoli Enterprise Monitoring Server. You must allow time for the monitoring agent to refresh its connection with the Tivoli Enterprise Monitoring Server before you begin the remote removal process.

Agent troubleshooting
This section lists problems that might occur with agents.

266

Monitoring Agent for Microsoft Internet Information Services: Users Guide

This chapter provides agent-specific troubleshooting information. See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting information.
Table 11. Agent problems and solutions Problem Log data accumulates too rapidly. Solution Check the RAS trace option settings, which are described in Setting RAS trace parameters on page 261. The trace options settings that you can set on the KBB_RAS1= and KDC_DEBUG= lines potentially generate large amounts of data.

Ensure that the local site is added to the trusted site for the browser, and then When using the F1 key or selecting Help --> Contents and enable the javascript. Index, you receive a message in your Microsoft Internet Explorer browser which states, It seems javascript is disabled in your browser, please enable it and reload again, or click here to view without javascript. If you select here, the Tivoli Enterprise Portal Help is displayed, but the agent help is not. HTTP error log view displays the There is no solution for this problem at this time. data only for the latest HTTP error log file. The content of the previous error log files is not displayed. For example, if 10 HTTP errors are reported in an hour, then owing to the limitation in file size of error logs, four errors are logged in httperr1.log, and six errors are logged in a new file httperr2.log. The IIS agent scans the latest error log file and displays only 6 rows from the httperr2.log file. There is no solution for this problem at this time. If you have installed the new Microsoft FTP service on IIS 7.0, Tivoli Enterprise Portal client displays the status of IIS FTP site in Web Sites view as Down all the time. None. If you have installed the Microsoft FTP Service V7.0 on IIS 7.0, the information related to the following attribute groups is not displayed on Tivoli Enterprise Portal client: v IIS FTP Server Status v FTP Server Sites Status v FTP version Information v FTP Service v IIS FTP Server Bindings v IIS FTP Sites Detail

Chapter 9. Troubleshooting

267

Table 11. Agent problems and solutions (continued) Problem Solution

If you have installed the None. Microsoft FTP Service V6.0 with IIS V7.0, the information related to the Microsoft FTP Service attribute group is not displayed on Tivoli Enterprise Portal client. The following attribute groups are not displayed on the Tivoli Enterprise Portal client based on the version of the IIS agent that you have installed on your computer: v If you have installed IIS agent V6.0: WAS-W3WP W3SVC-W3WP Microsoft FTP Service IIS Components v If you have installed IIS agent V7.0: NNTP Server NNTP Version Information IIS NNTP Server Status HTTP Error Log view (in HTTP Error Messages workspace under IIS Configuration navigator item) does not display data in Tivoli Enterprise Portal client. The possible causes for this can be: v Cause 1: The HTTP error log file name contains a sequence number greater than nine. The HTTP error log files are created in the directory %systemdrive%\WINDOWS\ system32\LogFiles\HTTPERR. Microsoft IIS agent monitors log files having a maximum sequence number upto nine in the file name. For example HTTPErr1.log to HTTPErr9.log. v Cause 2: The path of log file directory specified during agent configuration might be incorrect. Cause 1: This solution is applicable to HTTP Error logging API settings: 1. Modify the ErrorLogFileTruncateSize registry at the path HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\ Parameters to increase the file size for log files. 2. Restart the HTTP API driver service to update the settings. Use the following commands to read the new values: net stop HTTP net start HTTP For more information visit the following link: http://support.microsoft.com/kb/ 820729 Cause 2: This solution is applicable to Microsoft IIS agent configuration. Re-configure the Microsoft IIS agent and specify the correct path for the log file directory. None.

268

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table 11. Agent problems and solutions (continued) Problem Solution

Recycle the agent so that the values of the newly added performance counters The IIS agent does not collect are retrieved and displayed on the portal client. data for performance counters that are added after starting the agent. Therefore, the Tivoli Enterprise Portal client shows a blank row for the newly added performance counters. For example, if FTP or SMTP or NNTP services are installed after installing the IIS agent, then the IIS agent does not retrieve data for the FTP or SMTP or NNTP performance counters. If you use a script file (%SYSTEMROOT%\system32\ iisweb.vbs for IIS V6.0 or %SYSTEMROOT%\system32\ inetsrv\appcmd for IIS V7.0) to create a Web site that has a tab character in the Web site name (For example: abc<tab_character>xyz), the following attribute groups display incorrect data about the Web Site Name, HTTP Port, and SSL Port: v IIS Web Sites Detail v IIS Web Server Bindings Do not use the tab character when you specify an FTP site name. If you use a script file (%SYSTEMROOT%\system32\ iisftp.vbs for FTP V6.0 or the %SYSTEMROOT%\system32\ inetsrv\appcmd for FTP V6.0 installed on IIS V7.0) to create an FTP site that has a tab character in the FTP site name (For example: abc<tab_character>xyz), the following attribute groups display incorrect data about the FTP Site Name and FTP Port: v IIS FTP Sites Detail v IIS FTP Server Bindings Do not use the tab character when you specify a Web site name.

Chapter 9. Troubleshooting

269

Table 11. Agent problems and solutions (continued) Problem Solution

There is no solution for this problem at this time. The IIS agent permits back leveling of an IBM Tivoli Monitoring for Microsoft Application V6.2.0 agent on an already installed IBM Tivoli Monitoring for Microsoft Applications V6.2.0.1 agent. After back leveling, there is a change in the version of the IIS agent. The IIS agent does not display the new functionalities. However, the entry for IBM Tivoli Monitoring for Microsoft Applications is not removed from Add or Remove Programs.

270

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table 11. Agent problems and solutions (continued) Problem A configured and running instance of the monitoring agent is not displayed in the Tivoli Enterprise Portal, but other instances of the monitoring agent on the same system do appear in the portal. Solution Tivoli Monitoring products use Remote Procedure Call (RPC) to define and control product behavior. RPC is the mechanism that allows a client process to make a subroutine call (such as GetTimeOfDay or ShutdownServer) to a server process somewhere in the network. Tivoli processes can be configured to use TCP/UDP, TCP/IP, SNA, and SSL as the desired protocol (or delivery mechanism) for RPCs. IP.PIPE is the name given to Tivoli TCP/IP protocol for RPCs. The RPCs are socket-based operations that use TCP/IP ports to form socket addresses. IP.PIPE implements virtual sockets and multiplexes all virtual socket traffic across a single physical TCP/IP port (visible from the netstat command). A Tivoli process derives the physical port for IP.PIPE communications based on the configured, well-known port for the HUB Tivoli Enterprise Monitoring Server. (This well-known port or BASE_PORT is configured using the PORT: keyword on the KDC_FAMILIES / KDE_TRANSPORT environment variable and defaults to 1918.) The physical port allocation method is defined as (BASE_PORT + 4096*N) where N=0 for a Tivoli Enterprise Monitoring Server process and N={1, 2, ..., 15} for a non-Tivoli Enterprise Monitoring Server. Two architectural limits result as a consequence of the physical port allocation method: v No more than one Tivoli Enterprise Monitoring Server reporting to a specific Tivoli Enterprise Monitoring Server HUB can be active on a system image. v No more than 15 IP.PIPE processes can be active on a single system image. A single system image can support any number of Tivoli Enterprise Monitoring Server processes (address spaces) provided that each Tivoli Enterprise Monitoring Server on that image reports to a different HUB. By definition, there is one Tivoli Enterprise Monitoring Server HUB per monitoring Enterprise, so this architecture limit has been simplified to one Tivoli Enterprise Monitoring Server per system image. No more than 15 IP.PIPE processes or address spaces can be active on a single system image. With the first limit expressed above, this second limitation refers specifically to Tivoli Enterprise Monitoring Agent processes: no more than 15 agents per system image. This limitation can be circumvented (at current maintenance levels, IBM Tivoli Monitoring V6.1 Fix Pack 4 and later) if the Tivoli Enterprise Monitoring Agent process is configured to use EPHEMERAL IP.PIPE. (This is IP.PIPE configured with the EPHEMERAL:Y keyword in the KDC_FAMILIES / KDE_TRANSPORT environment variable). There is no limitation to the number of ephemeral IP.PIPE connections per system image. If ephemeral endpoints are used, the Warehouse Proxy Agent is accessible from the Tivoli Enterprise Monitoring Server associated with the agents using ephemeral connections either by running the Warehouse Proxy Agent on the same computer or by using the Firewall Gateway feature. (The Firewall Gateway feature relays the Warehouse Proxy Agent connection from the Tivoli Enterprise Monitoring Server computer to the Warehouse Proxy Agent computer if the Warehouse Proxy Agent cannot coexist on the same computer.)

Workspace troubleshooting
Table 12 on page 272 shows problems that might occur with workspaces. This chapter provides agent-specific troubleshooting information. See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting information.
Chapter 9. Troubleshooting

271

Table 12. Workspace problems and solutions Problem The process application components are available, but the Availability status shows PROCESS_DATA_NOT_ AVAILABLE. Solution This problem occurs because the PerfProc performance object is disabled. When this condition exists, IBM Tivoli Monitoring cannot collect performance data for this process. Do the following to confirm that this problem exists and resolve it: 1. Choose Run in the Windows Start menu. 2. Type perfmon.exe in the Open field of the Run window. The Performance window is displayed. 3. Click the plus sign (+) in the tool bar located above the right pane. The Add Counters window is displayed. 4. Look for Process in the Performance object pull-down menu. 5. Perform one of the following actions: v If you see Process in the pull-down menu, the PerfProc performance object is enabled and the problem is coming from a different source. You might need to contact IBM Software Support. v If you do not see Process in the pull-down menu, use the Microsoft utility from the following Web site to enable the PerfProc performance object: http://blogs.technet.com/mscom/archive/2008/12/18/ the-mystery-of-the-missing-process-performancecounter-in-perfmon.aspxThe Process performance object becomes visible in the Performance object pull-down menu of the Add Counters windows, and IBM Tivoli Monitoring is able to detect Availability data. 6. Restart the monitoring agent.

272

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table 12. Workspace problems and solutions (continued) Problem Event Log workspace events are unfiltered, are not collected more than every 60 seconds, and are removed from the Event Log Views after 1 hour of being received. Solution All events currently in the Application Event Log are sent to the Tivoli Enterprise Monitoring Server when the agent starts. Environment variables that control the behavior of the Event Log Workspace are stored in the agent ENV file on the Tivoli Enterprise Monitoring Agent, where the agent is running. These are the variables: CDP_DP_CACHE_TTL This is the minimum number of seconds before data (for a particular table) is collected again. By default this variable is present in the ENV file and the value is set to 60. CDP_NT_EVENT_LOG_GET_ALL_ENTRIES_FIRST_TIME This variable determines whether the agent sends all events currently in the Application Event Log to the Tivoli Enterprise Monitoring Server when the agent starts. Legal values are YES and NO. By default this variable is present in the ENV file and the value is set to NO. CDP_NT_EVENT_LOG_CACHE_TIMEOUT This variable determines how long in seconds, events are displayed in the Tivoli Enterprise Monitoring Server Event Log Views. By default this variable is NOT present in the ENV file. A default value of 3600 (1 Hour) is used unless overridden by the presence of this variable in the agent ENV file. The minimum legal value is 300. To view or edit the agent ENV file, on the Tivoli Enterprise Monitoring agent where the agent is installed, use Manage Tivoli Enterprise Monitoring Services to select the agent. Right-click and select Advanced - Edit ENV File. The agent must be restarted to implement changes. The name of the attribute does not display in a bar chart or graph view. When a chart or graph view that includes the attribute is scaled to a small size, a blank space is displayed instead of a truncated name. To see the name of the attribute, expand the view of the chart until there is sufficient space to display all characters of the attribute name.

You start collection of historical data but the data Managing options for historical data collection: cannot be seen. v Basic historical data collection populates the Warehouse with raw data. This type of data collection is turned off by default. See the IBM Tivoli Monitoring Administrators Guide for information on managing this feature including how to set the interval at which data is collected. By setting a more frequent interval for data collection you reduce the load on the system incurred every time data is uploaded. v You use the Summarization and Pruning monitoring agent to collect specific amounts and types of historical data. Be aware that historical data is not displayed until the Summarization and Pruning monitoring agent begins collecting the data. By default, this agent begins collection at 2 AM daily. At that point, data is visible in the workspace view. See the IBM Tivoli Monitoring Administrators Guide to learn how to modify the default collection settings.

Chapter 9. Troubleshooting

273

Table 12. Workspace problems and solutions (continued) Problem Historical data collection is unavailable because of incorrect queries in the Tivoli Enterprise Portal. Solution The column, Sort By, Group By, and First/Last functions are not compatible with the historical data collection feature. Use of these advanced functions makes a query ineligible for historical data collection. Even if data collection has been started, you cannot use the time span feature if the query for the chart or table includes column functions or advanced query options (Sort By, Group By, First / Last). To ensure support of historical data collection, do not use the Sort By, Group By, or First/Last functions in your queries. See the IBM Tivoli Monitoring Administrators Guide or the Tivoli Enterprise Portal online help for information about the Historical Data Collection function. When you use a long process name in the situation, the process name is truncated. Regular (non-historical) monitoring data fails to be displayed. Navigator items and workspace titles are labeled with internal names such as Kr6:KR60000 or Knt:KNT0000 rather than the correct names (such as Disk). Truncation of process or service names for situations in the Availability table in the portal display is the expected behavior. 100 bytes is the maximum name length. Check the formation of the queries you use to gather data. For example, look for invalid SQL statements. Ensure application support has been added on the monitoring server, portal server, and portal client. For more information and instruction on installing application support see Installing and enabling application support in the IBM Tivoli Monitoring Installation and Setup Guide.

The following workspaces and the views None. belonging to these workspaces are not displayed on the Tivoli Enterprise Portal client based on the version of the IIS agent that you have installed on your computer: v If you have installed IIS agent V6.0: Data and File Traffic Statistics (Microsoft FTP 7.0) User and Connection Statistics (Microsoft FTP 7.0) IIS 7.0 Installed Components WAS Worker Process Statistics W3SVC Worker Process Statistics v If you have installed IIS agent V7.0: NNTP Virtual Server Status None. If you have installed the Microsoft FTP Service V6.0 with IIS V7.0, the following workspaces and the views belonging to these workspaces are not displayed on the Tivoli Enterprise Portal client: v Data and File Traffic Statistics (Microsoft FTP 7.0) v User and Connection Statistics (Microsoft FTP 7.0)

274

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Situation troubleshooting
This section provides information about both general situation problems and problems with the configuration of situations. See the IBM Tivoli Monitoring Troubleshooting Guide for more information about troubleshooting for situations.

General situation problems


Table 13 lists general problems that might occur with situations.
Table 13. General situation problems and solutions Problem Monitoring activity requires too much disk space. Monitoring activity requires too many system resources. A formula that uses mathematical operators appears to be incorrect. For example, if you were monitoring Linux, a formula that calculates when Free Memory falls under 10 percent of Total Memory does not work: LT #'Linux_VM_Stats.Total_Memory' / 10 You want to change the appearance of situations when they are displayed in the Navigation tree. Solution Check the RAS trace logging settings that are described in Setting RAS trace parameters on page 261. For example, trace logs grow rapidly when you apply the ALL logging option. Disk capacity planning for historical data on page 134 describes the performance impact of specific attribute groups. If possible, decrease your use of the attribute groups that require greater system resources. This formula is incorrect because situation predicates support only logical operators. Your formulas cannot have mathematical operators. Note: The Situation Editor provides alternatives to math operators. Regarding the example, you can select % Memory Free attribute and avoid the need for math operators.

1. Right-click an item in the Navigation tree. 2. Select Situations in the pop-up menu. The Situation Editor window is displayed. 3. Select the situation that you want to modify. 4. Use the State pull-down menu in the lower right of the window to set the status and appearance of the Situation when it triggers. Note: The State setting is not related to severity settings in IBM Tivoli Enterprise Console.

There is no solution for this problem at this time. In the Situation Editor window, when you select the KQ7_ASP_High_Error_Rate node and click Add conditions, the Active Server Pages attribute group is displayed twice in the Select condition window. If the situation cannot be saved, then cancel the situation. Use only If you edit the situation formula for numeric data and not scientific notations to edit the situation formula. KQ7_Web_TooMany_KB_Sent and KQ7_Web_TooMany_KB_Received situations, the value for the Kilobytes Sent Rate attribute shows scientific notation such as 1.0E7. If you edit the scientific notation value or if you click in the cell and leave the value unchanged, then the situation cannot be saved. Also, the formula bar in the situation changes to red. If IIS agent V6.2 is installed on your computer with IIS agent V6.2.0.1 support , then the Process_Data_Unavailable situation is not visible for the agent node on the Tivoli Enterprise Portal client. There is no solution for this problem at this time.

Chapter 9. Troubleshooting

275

Problems with configuration of situations


Table 14 lists problems that might occur with configuring situations. This section provides information for troubleshooting for agents. Be sure to consult the IBM Tivoli Monitoring Troubleshooting Guide for more general troubleshooting information.
Table 14. Problems with configuring situations that you solve in the Situation Editor Problem Solution

Note: To get started with the solutions in this section, perform these steps: 1. Launch the Tivoli Enterprise Portal. 2. Click Edit > Situation Editor. 3. In the tree view, choose the agent whose situation you want to modify. 4. Choose the situation in the list. The Situation Editor view is displayed. The situation for a specific agent is Open the Situation Editor. Access the All managed servers view. If the situation not visible in the Tivoli Enterprise is absent, confirm that the monitoring server has been seeded for the agent. If Portal. not, seed the server, as described in the IBM Tivoli Monitoring Installation and Setup Guide. The monitoring interval is too long. The situation did not activate at startup. Access the Situation Editor view for the situation that you want to modify. Check the Sampling interval area in the Formula tab. Adjust the time interval as needed. Manually recycle the situation as follows: 1. Right-click the situation and choose Stop Situation. 2. Right-click the situation and choose Start Situation. Note: You can permanently avoid this problem by placing a check mark in the Run at Startup option of the Situation Editor view for a specific situation. The situation is not displayed. Click the Action tab and check whether the situation has an automated corrective action. This action can occur directly or through a policy. The situation might be resolving so quickly that you do not see the event or the update in the graphical user interface.

Check the logs, reports, and workspaces. An Alert event has not occurred even though the predicate has been properly specified. A situation fires on an unexpected managed object. The product did not distribute the situation to a managed system. Confirm that you have distributed and started the situation on the correct managed system. Click the Distribution tab and check the distribution settings for the situation.

276

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table 14. Problems with configuring situations that you solve in the Situation Editor (continued) Problem The situation does not fire. Solution This problem can be caused when incorrect predicates are present in the formula that defines the situation. For example, the managed object shows a state that normally triggers a monitoring event, but the situation is not true because the wrong attribute is specified in the formula. In the Formula tab, analyze predicates as follows: 1. Click the fx icon in the upper-right corner of the Formula area. The Show formula window is displayed. a. Confirm the following details in the Formula area at the top of the window: v The attributes that you intend to monitor are specified in the formula. v The situations that you intend to monitor are specified in the formula. v The logical operators in the formula match your monitoring goal. v The numerical values in the formula match your monitoring goal. b. (Optional) Click the Show detailed formula check box in the lower left of the window to see the original names of attributes in the application or operating system that you are monitoring. c. Click OK to dismiss the Show formula window. 2. (Optional) In the Formula area of the Formula tab, temporarily assign numerical values that immediately trigger a monitoring event. The triggering of the event confirms that other predicates in the formula are valid. Note: After you complete this test, you must restore the numerical values to valid levels so that you do not generate excessive monitoring data based on your temporary settings. See the IBM Tivoli Monitoring Troubleshooting Guide for additional information about situations that do not fire. Table 15. Problems with configuration of situations that you solve in the Workspace area Problem Situation events are not displayed in the Events Console view of the workspace. You do not have access to a situation. Solution Associate the situation with a Navigator item. Note: The situation does not need to be displayed in the workspace. It is sufficient that the situation be associated with any Navigator item. Note: You must have administrator privileges to perform these steps. 1. Select Edit > Administer Users to access the Administer Users window. 2. In the Users area, select the user whose privileges you want to modify. 3. In the Permissions tab, Applications tab, and Navigator Views tab, select the permissions or privileges that correspond to the user role. 4. Click OK. A managed system seems to be offline. 1. Select Physical View and highlight the Enterprise Level of the navigator tree. 2. Select View > Workspace > Managed System Status to see a list of managed systems and their status. 3. If a system is offline, check network connectivity and the status of the specific system or application.

Chapter 9. Troubleshooting

277

Take Action commands troubleshooting


Table 16 lists general problems that might occur with Take Action commands. When each Take Action command runs it generates the log file listed in Table 7 on page 259. This chapter provides agent-specific troubleshooting information. See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting information.
Table 16. Take Action commands problems and solutions Problem Take Action commands often require several minutes to complete. Situations fail to trigger Take Action commands. Solution Allow several minutes. If you do not see a pop-up message advising you of completion, try to run the command manually. Attempt to manually run the Take Action command in the Tivoli Enterprise Portal. If the Take Action command works, look for configuration problems in the situation. See Situation troubleshooting on page 275. If the Take Action command fails, see IBM Tivoli Monitoring Troubleshooting Guide for general information on troubleshooting Take Action commands. There is no solution for this problem at this time.

If you have installed the Microsoft FTP Service V7.0 with IIS 7.0, the following Take Action commands do not work: v Start FTP Site. v Stop FTP Site. v Start FTP Site by Name. v Stop FTP Site by Name. If you try to start or stop an already started or stopped Web site or FTP site, then the following message displays on the Tivoli Enterprise Portal window: For Web site: The Web site was started. OR The Web site was stopped. For FTP site: The FTP site was started. OR The FTP site was stopped. If you apply the IIS FTP Sites Detail query to a view on the Tivoli Enterprise Portal client, then the Take Action commands Start FTP Site and Stop FTP Site do not retrieve the value of the FTP Site attribute for the default argument. If you apply the IIS FTP Server Site Status query to a view on the Tivoli Enterprise Portal client, then the following Take Actions do not retrieve the value of the FTP Site Name attribute for the default argument: v Start FTP Site by Name. v Stop FTP Site by Name.

There is no solution for this problem at this time.

Perform the following Take Actions to automatically select the default argument: v Start FTP Site by Name. v Stop FTP Site by Name. Perform the following Take Actions to automatically select the value of the FTP Site attribute for the default argument: v Start FTP Site. v Stop FTP Site.

278

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table 16. Take Action commands problems and solutions (continued) Problem If you apply the IIS Web Sites Detail default query to a view on the Tivoli Enterprise Portal client, then the following Take Actions do not retrieve the value of the Web Site attribute for the default argument: v Start Website. v Stop Website. If you apply the IIS Web Server Site Status default query to a view on the Tivoli Enterprise Portal client, then the following Take Actions do not retrieve the value of the Web Site Name attribute for the default argument: v Start Website by Name. v Stop Website by Name. If you have installed IIS agent V6.2 with IIS agent There is no solution for this problem at this time. V6.2.0.1 support on your computer, then the Take Action commands for start services display an incorrect message if: v The parent service does not exist. v The parent service is disabled and stopped. Perform the following Take Actions to automatically select the value of the Web Site attribute for the default argument: v Start Website. v Stop Website. Solution Perform the following Take Actions to automatically select the value of the Web Site attribute for the default argument: v Start Website by Name. v Stop Website by Name.

Tivoli Common Reporting troubleshooting


Table 17 contains a list of problems that might occur with the Tivoli Common Reporting predefined reports for Monitoring Agent for Microsoft Internet Information Services. For information about troubleshooting for the Tivoli Common Reporting tool, see http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/ com.ibm.tivoli.tcr.doc/tcr_welcome.html.
Table 17. Tivoli Common Reporting for Monitoring Agent for Microsoft Internet Information Services problems and solutions Problem If the selected (daily or hourly) summarization table does not exist in the database for a report, then the following error message is displayed: CTGTRV014E The report cannot be successfully formatted because it completed with errors, reference ID [DESIGNID_141_OBJECTID_3d9a3d9a] If the selected summarization table does not exist in the database for a report, then no error message is displayed and report is displayed for the Daily summarization type. However, the report preview displays the selected summarization type. Solution Configure the Summarization and Pruning agent properly so that the database contains data for all summarization types.

Configure the Summarization and Pruning agent properly so that the database contains data for all summarization types. If the summarization table does not exist, then the data is fetched from the daily views depending on the report period that you select in the report.

Chapter 9. Troubleshooting

279

Table 17. Tivoli Common Reporting for Monitoring Agent for Microsoft Internet Information Services problems and solutions (continued) Problem If the data source is incorrect and you run a report, the Tivoli Common Reporting tool does not display the report in a correct format and displays the following error message: CTGTRV014E The report cannot be successfully formatted because it completed with errors, reference ID [REPORTID_5_OBJECTID_5cc65cc6]. Solution Ensure that the parameters: v Are correctly set while configuring the data source in the Edit Data Source window of the Tivoli Common Reporting tool. v Match the parameters of the Summarization and Pruning agent (for example, Database URL, Driver, User, and Password) that is connected to a particular database. Add the .jar files to the appropriate directory of the Tivoli Common Reporting. These .jar files are put in the JDBC driver while configuring the Summarization and Pruning agent. The following list gives the names of the .jar files for different databases: v The ojdbc14.jar file for the Oracle database v The sqljdbc.jar and the sqljdbc4.jar files for the SQL Server database v The db2jcc_license_cu.jar and the db2jcc.jar files for the DB2 database Add these .jar files to one of the following locations of the Tivoli Common Reporting: Location for the Tivoli Common Reporting V1.1.1.0 C:\Program Files\IBM\tcr\lib\birtruntime-2_2_1\ReportEngine\plugins\ org.eclipse.birt.report.data.oda.jdbc_ 2.2.1.r22x_v20070919\drivers Location for the Tivoli Common Reporting V1.2.0.0. and V1.2.0.1 C:\IBM\tivoli\tip\products\tcr\lib\ birt-runtime-2_2_1\ReportEngine\ plugins\ org.eclipse.birt.report.data.oda.jdbc_ 2.2.1.r22x_v20070919\drivers If you open a report in the Microsoft Excel format, then the key None. values are displayed as column headings. Data does not exist in the database for the selected parameters. Configure the Summarization and Pruning agent properly and generate data in the database for all Summarization Types. If you try to drill down to a subreport or sort a column in a There is no solution to this problem at this time. report in Microsoft Excel format, the following error is displayed: CTGTRV004E A drill-through report cannot be formatted because the drillthrough information cannot be found. The most likely cause is an expired HTTP session. The daily heat map does not show data for the month if the sixteenth record is missing in the database. If you open a report in the Adobe PostScript format, the report does not display the X and Y axis properly. There is no solution to this problem at this time. Increase the zoom percentage in Adobe PostScript to display X and Y axis.

If the .jar files are not added to the Tivoli Common Reporting tool, then the following error message is displayed: CTGTRV014E The report can not be successfully formatted because it completed with errors, reference ID [REPORTID_1049_OBJECTID_dbe0dbe].

280

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Table 17. Tivoli Common Reporting for Monitoring Agent for Microsoft Internet Information Services problems and solutions (continued) Problem If you open a report in the Adobe PostScript format, the page numbers do not display properly. If you open a report in PDF, the Web address of the Tivoli Common Reporting Server is displayed as the title instead of the report name. The snapshot report fails to open in PDF. When you open the snapshot report in the Excel or Adobe PostScript format, the following error message is displayed: Internet Explorer cannot download view from localhost Internet Explorer was not able to open this Internet site. The requested site is either unavailable or cannot be found. Please try again later. Solution None. None.

None.

If you open a report in the Adobe PostScript format, some part The default size of the report is A4. For the full of charts or data in the report is truncated. view of the report, click 11x17 from the Media menu.

Support information
If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following ways for you to obtain the support you need: Online Go to the IBM Software Support site at http://www.ibm.com/software/ support/probsub.html and follow the instructions. IBM Support Assistant The IBM Support Assistant (ISA) is a free local software serviceability workbench that helps you resolve questions and problems with IBM software products. The ISA provides quick access to support-related information and serviceability tools for problem determination. To install the ISA software, go to http://www.ibm.com/software/support/isa.

Informational, warning, and error messages


This chapter introduces message logging and explains how to gather information from those logs. Message logging refers to the text and numeric messages created by the software. These messages relay information about how the system or application is performing and can alert you to exceptional conditions when they occur. Messages are sent to an output destination, such as a file, database, or console screen. If you receive a warning or error message, you can do one of the following: v Follow the instructions listed in the Detail window of the message if this information is included there. v Consult the message details listed in this chapter to see what action you can take to correct the problem. v Consult the message log for message ID and text, time and date of the message, as well as other data you can use to diagnose the problem.

Chapter 9. Troubleshooting

281

Message format
Monitoring Agent for Microsoft Internet Information Services messages have the following format: Message ID and text Explanation Operator Response The message ID has the following format:
CCC####severity

where: CCC Prefix that indicates the component to which the message applies. The component is one of the following: KQ7 #### severity Severity of the message. There are three levels of severity: I Informational messages provide feedback about something that happened in the product or system that might be important. These messages can provide guidance when you are requesting a specific action from the product. Warning messages call your attention to an exception condition. The condition might not be an error but can cause problems if not resolved. Error messages indicate that an action cannot be completed because of a user or system error. These messages require user response. General Monitoring Agent for Microsoft Internet Information Services messages

Number of the message

The Text of the message provides a general statement regarding the problem or condition that occurred. The Explanation provides additional information about the message and what might have caused the condition. The Operator Response provides actions to take in response to the condition, particularly for error messages (messages with the E suffix). Note: Many message texts and explanations contain variables, such as the specific name of a server or application. Those variables are represented in this chapter as symbols, such as &1. Actual messages contain values for these variables. This chapter includes the messages for the following software: v Monitoring Agent for Microsoft Internet Information Services

Monitoring Agent for Microsoft Internet Information Services messages

282

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ70001I KQ70010I
KQ70001I The IIS Admin service was started.

Explanation: The IIS Admin service was started. Operator response: None. KQ70002I The IIS Admin service is already started.

Explanation: The IIS Admin service is already started. Operator response: None. KQ70003E Error starting the IIS Admin service.

Explanation: Error starting the IIS Admin service. Operator response: Check the event log for more information. KQ70004I The IIS Admin service was stopped.

Explanation: The IIS Admin service was stopped. Operator response: None. KQ70005I The IIS Admin service is already stopped.

Explanation: The IIS Admin service is already stopped. Operator response: None. KQ70006E Error stopping the IIS Admin service.

Explanation: Error stopping the IIS Admin service. Operator response: Check the event log for more information. KQ70007I The IIS Web Server was started.

Explanation: The IIS Web Server was started. Operator response: None. KQ70008I The IIS Web Server is already started.

Explanation: The IIS Web Server is already started. Operator response: None. KQ70009E Error starting the IIS Web Server.

Explanation: Error starting the IIS Web Server. Operator response: Check the event log for more information. KQ70010I The IIS Web Server was stopped.

Explanation: The IIS Web Server was stopped. Operator response: None.

Chapter 9. Troubleshooting

283

KQ70011I KQ70020I
KQ70011I The IIS Web Server is already stopped.

Explanation: The IIS Web Server is already stopped. Operator response: None. KQ70012E Error stopping the IIS Web Server.

Explanation: Error stopping the IIS Web Server. Operator response: Check the event log for more information. KQ70013I The FTP Publishing service was started.

Explanation: The FTP Publishing service was started. Operator response: None. KQ70014I The FTP Publishing service is already started.

Explanation: The FTP Publishing service is already started. Operator response: None. KQ70015E Error starting the FTP Publishing service.

Explanation: Error starting the FTP Publishing service. Operator response: Check the event log for more information. KQ70016I The FTP Publishing service was stopped.

Explanation: The FTP Publishing service was stopped. Operator response: None. KQ70017I The FTP Publishing service is already stopped.

Explanation: The FTP Publishing service is already stopped. Operator response: None. KQ70018E Error stopping the FTP Publishing service.

Explanation: Error stopping the FTP Publishing service. Operator response: Check the event log for more information. KQ70019I The Network News Transfer Protocol service was started.

Explanation: The Network News Transfer Protocol service was started. Operator response: None. KQ70020I The Network News Transfer Protocol service is already started.

Explanation: The Network News Transfer Protocol service is already started. Operator response: None.

284

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ70021E KQ70030E
KQ70021E Error starting the Network News Transfer Protocol service.

Explanation: Error starting the Network News Transfer Protocol service. Operator response: Check the event log for more information. KQ70022I The Network News Transfer Protocol service was stopped.

Explanation: The Network News Transfer Protocol service was stopped. Operator response: None. KQ70023I The Network News Transfer Protocol service is already stopped.

Explanation: The Network News Transfer Protocol service is already stopped. Operator response: None. KQ70024E Error stopping the Network News Transfer Protocol service.

Explanation: Error stopping the Network News Transfer Protocol service. Operator response: Check the event log for more information. KQ70025I The Simple Mail Transfer Protocol service was started.

Explanation: The Simple Mail Transfer Protocol service was started. Operator response: None. KQ70026I The Simple Mail Transfer Protocol service is already started.

Explanation: The Simple Mail Transfer Protocol service is already started. Operator response: None. KQ70027E Error starting the Simple Mail Transfer Protocol service.

Explanation: Error starting the Simple Mail Transfer Protocol service. Operator response: Check the event log for more information. KQ70028I The Simple Mail Transfer Protocol service was stopped.

Explanation: The Simple Mail Transfer Protocol service was stopped. Operator response: None. KQ70029I The Simple Mail Transfer Protocol service is already stopped.

Explanation: The Simple Mail Transfer Protocol service is already stopped. Operator response: None. KQ70030E Error stopping the Simple Mail Transfer Protocol service.

Explanation: Error stopping the Simple Mail Transfer Protocol service. Operator response: Check the event log for more information.

Chapter 9. Troubleshooting

285

KQ70031I KQ70040I
KQ70031I The HTTP SSL service was started.

Explanation: The HTTP SSL service was started. Operator response: None. KQ70032I The HTTP SSL service is already started.

Explanation: The HTTP SSL service is already started. Operator response: None. KQ70033E Error starting the HTTP SSL service.

Explanation: Error starting the HTTP SSL service. Operator response: Check the event log for more information. KQ70034I The HTTP SSL service was stopped.

Explanation: The HTTP SSL service was stopped. Operator response: None. KQ70035I The HTTP SSL service is already stopped.

Explanation: The HTTP SSL service is already stopped. Operator response: None. KQ70036E Error stopping the HTTP SSL service.

Explanation: Error stopping the HTTP SSL service. Operator response: Check the event log for more information. KQ70037I The Windows Process Activation service was started.

Explanation: The Windows Process Activation service was started. Operator response: None. KQ70038I The Windows Process Activation service is already started.

Explanation: The Windows Process Activation service is already started. Operator response: None. KQ70039E Error starting the Windows Process Activation service.

Explanation: Error starting the Windows Process Activation service. Operator response: Check the event log for more information. KQ70040I The Windows Process Activation service was stopped.

Explanation: The Windows Process Activation service was stopped. Operator response: None.

286

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ70041I KQ70050I
KQ70041I The Windows Process Activation service is already stopped.

Explanation: The Windows Process Activation service is already stopped. Operator response: None. KQ70042E Error stopping the Windows Process Activation service.

Explanation: Error stopping the Windows Process Activation service. Operator response: Check the event log for more information. KQ70043I The Application Host Helper service was started.

Explanation: The Application Host Helper service was started. Operator response: None. KQ70044I The Application Host Helper service is already started.

Explanation: The Application Host Helper Service is already started. Operator response: None. KQ70045E Error starting the Application Host Helper service.

Explanation: Error starting the Application Host Helper service. Operator response: Check the event log for more information. KQ70046I The Application Host Helper service was stopped.

Explanation: The Application Host Helper service was stopped. Operator response: None. KQ70047I The Application Host Helper service is already stopped.

Explanation: The Application Host Helper service is already stopped. Operator response: None. KQ70048E Error stopping the Application Host Helper service.

Explanation: Error stopping the Application Host Helper service. Operator response: Check the event log for more information. KQ70049I The Web Management service was started.

Explanation: The Web Management service was started. Operator response: None. KQ70050I The Web Management service is already started.

Explanation: The Web Management service is already started. Operator response: None.

Chapter 9. Troubleshooting

287

KQ70051E KQ70066E
KQ70051E Error starting the Web Management service.

Explanation: Error starting the Web Management service. Operator response: Check the event log for more information. KQ70052I The Web Management service was stopped.

Explanation: The Web Management service was stopped. Operator response: None. KQ70053I The Web Management service is already stopped.

Explanation: The Web Management service is already stopped. Operator response: None. KQ70054E Error stopping the Web Management service.

Explanation: Error stopping the Web Management service. Operator response: Check the event log for more information. KQ70061I The Net.Pipe Listener Adapter service was started.

Explanation: The Net.Pipe Listener Adapter service was started. Operator response: None. KQ70062I The Net.Pipe Listener Adapter service is already started.

Explanation: The Net.Pipe Listener Adapter service is already started. Operator response: None. KQ70063E Error starting the Net.Pipe Listener Adapter service.

Explanation: Error starting the Net.Pipe Listener Adapter service. Operator response: Check the event log for more information. KQ70064I The Net.Pipe Listener Adapter service was stopped.

Explanation: The Net.Pipe Listener Adapter service was stopped. Operator response: None. KQ70065I The Net.Pipe Listener Adapter service is already stopped.

Explanation: The Net.Pipe Listener Adapter service is already stopped. Operator response: None. KQ70066E Error stopping the Net.Pipe Listener Adapter service.

Explanation: Error stopping the Net.Pipe Listener Adapter service. Operator response: Check the event log for more information.

288

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ70067I KQ70076I
KQ70067I The Net.Tcp Listener Adapter service was started.

Explanation: The Net.Tcp Listener Adapter service was started. Operator response: None. KQ70068I The Net.Tcp Listener Adapter service is already started.

Explanation: The Net.Tcp Listener Adapter service is already started. Operator response: None. KQ70069E Error starting the Net.Tcp Listener Adapter service.

Explanation: Error starting the Net.Tcp Listener Adapter service. Operator response: Check the event log for more information. KQ70070I The Net.Tcp Listener Adapter service was stopped.

Explanation: The Net.Tcp Listener Adapter service was stopped. Operator response: None. KQ70071I The Net.Tcp Listener Adapter service is already stopped.

Explanation: The Net.Tcp Listener Adapter service is already stopped. Operator response: None. KQ70072E Error stopping the Net.Tcp Listener Adapter service.

Explanation: Error stopping the Net.Tcp Listener Adapter service. Operator response: Check the event log for more information. KQ70073I The Net.Msmq Listener Adapter service was started.

Explanation: The Net.Msmq Listener Adapter service was started. Operator response: None. KQ70074I The Net.Msmq Listener Adapter service is already started.

Explanation: The Net.Msmq Listener Adapter service is already started. Operator response: None. KQ70075E Error starting the Net.Msmq Listener Adapter service.

Explanation: Error starting the Net.Msmq Listener Adapter service. Operator response: Check the event log for more information. KQ70076I The Net.Msmq Listener Adapter service was stopped.

Explanation: The Net.Msmq Listener Adapter service was stopped. Operator response: None.

Chapter 9. Troubleshooting

289

KQ70077I KQ70086I
KQ70077I The Net.Msmq Listener Adapter service is already stopped.

Explanation: The Net.Msmq Listener Adapter service is already stopped. Operator response: None. KQ70078E Error stopping the Net.Msmq Listener Adapter service.

Explanation: Error stopping the Net.Msmq Listener Adapter service. Operator response: Check the event log for more information. KQ70079I The Net.Tcp Port Sharing service was started.

Explanation: The Net.Tcp Port Sharing service was started. Operator response: None. KQ70080I The Net.Tcp Port Sharing service is already started.

Explanation: The Net.Tcp Port Sharing service is already started. Operator response: None. KQ70081E Error starting the Net.Tcp Port Sharing service.

Explanation: Error starting the Net.Tcp Port Sharing service. Operator response: Check the event log for more information. KQ70082I The Net.Tcp Port Sharing service was stopped.

Explanation: The Net.Tcp Port Sharing service was stopped. Operator response: None. KQ70083I The Net.Tcp Port Sharing service is already stopped.

Explanation: The Net.Tcp Port Sharing service is already stopped. Operator response: None. KQ70084E Error stopping the Net.Tcp Port Sharing service.

Explanation: Error stopping the Net.Tcp Port Sharing service. Operator response: Check the event log for more information. KQ70085I The Microsoft FTP service was started.

Explanation: The Microsoft FTP service was started. Operator response: None. KQ70086I The Microsoft FTP service is already started.

Explanation: The Microsoft FTP service is already started. Operator response: None.

290

Monitoring Agent for Microsoft Internet Information Services: Users Guide

KQ70087E KQ70096E
KQ70087E Error starting the Microsoft FTP service.

Explanation: Error starting the Microsoft FTP service. Operator response: Check the event log for more information. KQ70088I The Microsoft FTP service was stopped.

Explanation: The Microsoft FTP service was stopped. Operator response: None. KQ70089I The Microsoft FTP service is already stopped.

Explanation: The Microsoft FTP service is already stopped. Operator response: None. KQ70090E Error stopping the Microsoft FTP service.

Explanation: Error stopping the Microsoft FTP service. Operator response: Check the event log for more information. KQ70091I The Web site was started.

Explanation: The Web site was started. Operator response: None. KQ70092E The Web site name might be invalid and cannot be started.

Explanation: The Web site name might be invalid and cannot be started. Operator response: Check the event log for more information. KQ70093I The Web site was stopped.

Explanation: The Web site was stopped. Operator response: None. KQ70094E The Web site name might be invalid and cannot be stopped.

Explanation: The Web site name might be invalid and cannot be stopped. Operator response: Check the event log for more information. KQ70095I The FTP site was started.

Explanation: The FTP site was started. Operator response: None. KQ70096E The FTP site name might be invalid and cannot be started.

Explanation: The FTP site name might be invalid and cannot be started. Operator response: None.

Chapter 9. Troubleshooting

291

KQ70097I KQ70103E
KQ70097I The FTP site was stopped.

Explanation: The FTP site was stopped. Operator response: None. KQ70098E The FTP site name might be invalid and cannot be stopped.

Explanation: The FTP site name might be invalid and cannot be stopped. Operator response: None. KQ70100W The service does not exist as an installed service.

Explanation: The service does not exist as an installed service. Operator response: None. KQ70101I The service is disabled and cannot be started.

Explanation: The service is disabled and cannot be started. Operator response: None. KQ70102E The dependency service or group failed to start.

Explanation: The dependency service or group failed to start. Operator response: None. KQ70103E The dependency service does not exist or has been marked for deletion.

Explanation: The dependency service does not exist or has been marked for deletion. Operator response: None.

292

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Appendix A. IBM Tivoli Enterprise Console event mapping


Each event class corresponds to an attribute group in the IBM Tivoli Enterprise Console. For a description of the event slots for each event class, see the lists in this appendix. For more information about mapping attribute groups to event classes, see the IBM Tivoli Monitoring Administrators Guide. Generic event mapping provides useful event class and attribute information for situations that do not have specific event mapping defined. BAROC files are found on the Tivoli Enterprise Monitoring Server in the installation directory in TECLIB (that is, install_dir/cms/TECLIB for Windows systems and install_dir/tables/ TEMS_hostname/TECLIB for UNIX systems). IBM Tivoli Enterprise Console event synchronization provides a collection of ready-to-use rule sets that you can deploy with minimal configuration. Be sure to install IBM Tivoli Enterprise Console event synchronization to access the correct Sentry.baroc, which is automatically included during base configuration of IBM Tivoli Enterprise Console rules if you indicate that you want to use an existing rulebase. See the IBM Tivoli Monitoring Installation and Setup Guide for details. Each of the event classes is a child of KQ7_Base and is defined in the kq7.baroc file. The KQ7_Base event class can be used for generic rules processing for any event from the IBM Tivoli Monitoring for Microsoft Applications: Microsoft Internet Information Services Agent. For events generated by situations in the Active Server Pages attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_ACTIVE_SERVER_PAGES class. This class contains the following slots: v v v v v v v v v v v v v v v v v v v v node: STRING timestamp: STRING errors_rate: REAL errors_during_script_runtime: INTEGER errors_from_asp_preprocessor: INTEGER errors_from_script_compilers: INTEGER request_kbytes_in_total: INTEGER request_kbytes_out_total: INTEGER request_execution_time: INTEGER request_wait_time: INTEGER request_wait_gt_execution_time: INTEGER requests_disconnected: INTEGER requests_executing: INTEGER requests_failed_total: INTEGER requests_not_authorized: INTEGER requests_not_found: INTEGER requests_queued: INTEGER requests_queued_delta: INTEGER requests_rejected: INTEGER requests_succeeded: INTEGER

v requests_timed_out: INTEGER
Copyright IBM Corp. 2008, 2009

293

v v v v v v v v v v

requests_total: INTEGER requests_rate: REAL sessions_current: INTEGER sessions_timed_out: INTEGER sessions_total: INTEGER transactions_rate: REAL transactions_aborted: INTEGER transactions_committed: INTEGER transactions_pending_count: INTEGER transactions_total: INTEGER

For events generated by situations in the ASP NET attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_ASP_NET class. This class contains the following slots: v node: STRING v timestamp: STRING v cache_percent_machine_memory_limit_used: REAL v cache_percent_process_memory_limit_used: REAL v infrastructure_error_events_raised_rate: REAL v membership_authentication_failure: INTEGER v name: STRING For events generated by situations in the Availability attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_AVAILABILITY class. This class contains the following slots: v node: STRING v timestamp: STRING v v v v v v v v v v v v v v v v v application_component: STRING name: STRING name_enum: STRING kq7_status: INTEGER kq7_status_enum: STRING full_name: STRING full_name_enum: STRING type: INTEGER type_enum: STRING virtual_size: INTEGER page_faults_per_sec: INTEGER working_set_size: INTEGER thread_count: INTEGER pid: INTEGER percent_privileged_time: INTEGER percent_user_mode_time: INTEGER percent_processor_time: INTEGER

v command_line: STRING v command_line_enum: STRING

294

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v functionality_test_status: INTEGER v functionality_test_status_enum: STRING v functionality_test_message: STRING For events generated by situations in the Event Log attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_EVENT_LOG class. This class contains the following slots: v node: STRING v log_name: STRING v event_source: STRING v v v v v v event_type: INTEGER event_type_enum: STRING event_id: INTEGER event_category: STRING message: STRING time_generated: STRING

For events generated by situations in the FTP Server Site Status attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_FTP_SERVER_SITE_STATUS class. This class contains the following slots: v node: STRING v v v v timestamp: STRING ftp_site: STRING state: INTEGER state_enum: STRING

For events generated by situations in the FTP Service attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_FTP_SERVICE class. This class contains the following slots: v node: STRING v timestamp: STRING v kbytes_sent_rate: REAL v kbytes_received_rate: REAL v kbytes_total_rate: REAL v total_files_sent: INTEGER v total_files_received: INTEGER v total_files_transferred: INTEGER v v v v v v v files_sent_rate: REAL files_received_rate: REAL files_transferred_rate: REAL current_anonymous_users: INTEGER percent_current_anonymous_users: REAL current_nonanonymous_users: INTEGER percent_current_nonanonymous_users: REAL

v total_anonymous_users: INTEGER v percent_total_anonymous_users: REAL


Appendix A. IBM Tivoli Enterprise Console event mapping

295

v v v v v v v v v v v

total_nonanonymous_users: INTEGER percent_total_nonanonymous_users: REAL maximum_anonymous_users: INTEGER maximum_nonanonymous_users: INTEGER current_connections: INTEGER maximum_connections: INTEGER total_connection_attempts_all_instances: INTEGER total_logon_attempts: INTEGER logon_attempts_rate: REAL ftp_service_uptime_in_hrs: REAL name: STRING

For events generated by situations in the FTP Version Information attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_FTP_VERSION_INFORMATION class. This class contains the following slots: v v v v v node: STRING timestamp: STRING server_name: STRING major_ftp_version_number: INTEGER minor_ftp_version_number: INTEGER

For events generated by situations in the HTTP Custom Error Messages attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_HTTP_CUSTOM_ERROR_MESSAGES class. This class contains the following slots: v node: STRING v v v v timestamp: STRING http_status: STRING error_sub_code: STRING error_code: STRING

v message_source: STRING v message_location: STRING For events generated by situations in the Http Error Log attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_HTTP_ERROR_LOG class. This class contains the following slots: v node: STRING v timestamp: STRING v v v v v v v kq7_date: STRING time: STRING client_ip_address: STRING client_port: STRING server_ip_address: STRING server_port: STRING protocol_version: STRING

v method: STRING v url: STRING

296

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v v v v

http_status: STRING protocol_sub_status: STRING error_code: STRING error_description: STRING

For events generated by situations in the IIS Application Pools Setting attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_APPLICATION_POOLS_SETTING class. This class contains the following slots: v node: STRING v timestamp: STRING v apppool_auto_start: INTEGER v apppool_auto_start_enum: STRING v v v v v v application_pool_name: STRING apppool_command: INTEGER apppool_command_enum: STRING apppool_identity_type: INTEGER apppool_identity_type_enum: STRING apppool_queue_length: INTEGER

v apppool_recycle_config_change: INTEGER v apppool_recycle_config_change_enum: STRING v apppool_recycle_isapi_unhealthy: INTEGER v v v v v v v v v v v v apppool_recycle_isapi_unhealthy_enum: STRING apppool_recycle_memory: INTEGER apppool_recycle_memory_enum: STRING apppool_recycle_ondemand: INTEGER apppool_recycle_ondemand_enum: STRING apppool_recycle_private_memory: INTEGER apppool_recycle_private_memory_enum: STRING apppool_recycle_requests: INTEGER apppool_recycle_requests_enum: STRING apppool_recycle_schedule: INTEGER apppool_recycle_schedule_enum: STRING apppool_recycle_time: INTEGER

v apppool_recycle_time_enum: STRING v apppool_state: INTEGER v v v v v v v apppool_state_enum: STRING auto_shutdown_apppool_exe: STRING auto_shutdown_apppool_params: STRING cpu_action: INTEGER cpu_action_enum: STRING cpu_limit_percent: REAL cpu_reset_interval: INTEGER

v disallow_overlapping_rotation: INTEGER v disallow_overlapping_rotation_enum: STRING v disallow_rotation_on_config_change: INTEGER


Appendix A. IBM Tivoli Enterprise Console event mapping

297

v v v v v v v v v v v v v v v v v v

disallow_rotation_on_config_change_enum: STRING idle_timeout: INTEGER load_balancer_capabilities: INTEGER load_balancer_capabilities_enum: STRING logon_method: INTEGER logon_method_enum: STRING max_processes: INTEGER orphan_action_exe: STRING orphan_action_params: STRING orphan_worker_process: INTEGER orphan_worker_process_enum: STRING periodic_restart_memory: INTEGER periodic_restart_private_memory: INTEGER periodic_restart_requests: INTEGER periodic_restart_time: INTEGER pinging_enabled: INTEGER pinging_enabled_enum: STRING ping_interval: INTEGER

v ping_response_time: INTEGER v rapid_fail_protection: INTEGER v rapid_fail_protection_enum: STRING v v v v v v v v rapid_fail_protection_interval: INTEGER rapid_fail_protection_max_crashes: INTEGER shutdown_time_limit: INTEGER smp_affinitized: INTEGER smp_affinitized_enum: STRING smp_processor_affinity_mask: INTEGER smp_processor_affinity_mask_enum: STRING startup_time_limit: INTEGER

v wam_user_name: STRING v win32_error: INTEGER For events generated by situations in the IIS Components attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_COMPONENTS class. This class contains the following slots: v node: STRING v timestamp: STRING v module_name: STRING v kq7_status: INTEGER v kq7_status_enum: STRING For events generated by situations in the IIS FTP Server Bindings attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_FTP_SERVER_BINDINGS class. This class contains the following slots: v node: STRING v timestamp: STRING

298

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v ftp_site_id: STRING v ftp_site_name: STRING v ftp_port: STRING For events generated by situations in the IIS FTP Server Status attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_FTP_SERVER_STATUS class. This class contains the following slots: v node: STRING v timestamp: STRING v server_name: STRING v v v v path_name: STRING process_id: INTEGER state: STRING kq7_status: STRING

For events generated by situations in the IIS FTP Sites Detail attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_FTP_SITES_DETAIL class. This class contains the following slots: v node: STRING v timestamp: STRING v ftp_site: STRING v state: INTEGER v state_enum: STRING v ftp_site_id: STRING v ftp_site_name: STRING v ftp_port: STRING For events generated by situations in the IIS NNTP Server Status attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_NNTP_SERVER_STATUS class. This class contains the following slots: v node: STRING v timestamp: STRING v server_name: STRING v path_name: STRING v process_id: INTEGER v state: STRING v kq7_status: STRING For events generated by situations in the IIS SMTP Server Status attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_SMTP_SERVER_STATUS class. This class contains the following slots: v node: STRING v timestamp: STRING v server_name: STRING v path_name: STRING v process_id: INTEGER
Appendix A. IBM Tivoli Enterprise Console event mapping

299

v state: STRING v kq7_status: STRING For events generated by situations in the IIS Version Information attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_VERSION_INFORMATION class. This class contains the following slots: v node: STRING v timestamp: STRING v server_name: STRING v major_iis_version_number: INTEGER v minor_iis_version_number: INTEGER For events generated by situations in the IIS Web Server Bindings attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_WEB_SERVER_BINDINGS class. This class contains the following slots: v v v v v node: STRING timestamp: STRING site_id: STRING web_site_name: STRING http_port: STRING

v ssl_port: STRING For events generated by situations in the IIS Web Server Site Status attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_WEB_SERVER_SITE_STATUS class. This class contains the following slots: v node: STRING v timestamp: STRING v web_site: STRING v state: INTEGER v state_enum: STRING For events generated by situations in the IIS Web Server Status attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_WEB_SERVER_STATUS class. This class contains the following slots: v v v v v v node: STRING timestamp: STRING server_name: STRING path_name: STRING process_id: INTEGER state: STRING

v kq7_status: STRING For events generated by situations in the IIS Web Sites Detail attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_IIS_WEB_SITES_DETAIL class. This class contains the following slots: v node: STRING

300

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v v v v v

timestamp: STRING web_site: STRING state: INTEGER state_enum: STRING site_id: STRING

v web_site_name: STRING v http_port: STRING v ssl_port: STRING For events generated by situations in the Internet Information Services Gl attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_INTERNET_INFORMATION_SERVICES_GL class. This class contains the following slots: v v v v v v node: STRING timestamp: STRING current_files_cached: INTEGER total_files_cached: INTEGER file_cache_hits: INTEGER file_cache_misses: INTEGER

v file_cache_hits_percent: REAL v file_cache_flushes: INTEGER v current_file_cache_memory_usage_in_kb: REAL v v v v v v v v maximum_file_cache_memory_usage_in_kb: REAL active_flushed_entries: INTEGER total_flushed_files: INTEGER current_blobs_cached: INTEGER total_blobs_cached: INTEGER blob_cache_hits: INTEGER blob_cache_misses: INTEGER blob_cache_hits_percent: REAL

v blob_cache_flushes: INTEGER v total_flushed_blobs: INTEGER For events generated by situations in the Microsoft FTP Service attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_MICROSOFT_FTP_SERVICE class. This class contains the following slots: v node: STRING v timestamp: STRING v v v v v v v v name: STRING kbytes_sent_rate: INTEGER kbytes_received_rate: INTEGER kbytes_total_rate: INTEGER total_files_sent: INTEGER total_files_received: INTEGER total_files_transferred: INTEGER files_sent_rate: INTEGER
Appendix A. IBM Tivoli Enterprise Console event mapping

301

v v v v v v v v v v v v v v v v v v

files_received_rate: INTEGER files_transferred_rate: INTEGER current_anonymous_users: INTEGER current_nonanonymous_users: INTEGER total_anonymous_users: INTEGER total_nonanonymous_users: INTEGER maximum_anonymous_users: INTEGER maximum_nonanonymous_users: INTEGER percent_current_anonymous_users: INTEGER percent_current_nonanonymous_users: INTEGER percent_total_anonymous_users: INTEGER percent_total_nonanonymous_users: INTEGER current_connections: INTEGER maximum_connections: INTEGER total_connection_attempts: INTEGER total_logon_attempts: INTEGER logon_attempts_rate: INTEGER microsoft_ftp_service_uptime_in_hrs: REAL

For events generated by situations in the Mime Types attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_MIME_TYPES class. This class contains the following slots: v node: STRING v timestamp: STRING v file_extension: STRING v mime_type: STRING For events generated by situations in the NNTP Server attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_NNTP_SERVER class. This class contains the following slots: v node: STRING v timestamp: STRING v nntp_virtual_server: STRING v state: INTEGER v state_enum: STRING For events generated by situations in the NNTP Version Information attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_NNTP_VERSION_INFORMATION class. This class contains the following slots: v v v v v node: STRING timestamp: STRING server_name: STRING major_nntp_version_number: INTEGER minor_nntp_version_number: INTEGER

302

Monitoring Agent for Microsoft Internet Information Services: Users Guide

For events generated by situations in the Performance Object Status attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_PERFORMANCE_OBJECT_STATUS class. This class contains the following slots: v node: STRING v timestamp: STRING v query_name: STRING v v v v v object_name: STRING object_type: INTEGER object_type_enum: STRING object_status: INTEGER object_status_enum: STRING

v error_code: INTEGER v error_code_enum: STRING v v v v v last_collection_start: STRING last_collection_start_enum: STRING last_collection_finished: STRING last_collection_finished_enum: STRING last_collection_duration: REAL

v average_collection_duration: REAL v average_collection_duration_enum: STRING v refresh_interval: INTEGER v v v v number_of_collections: INTEGER cache_hits: INTEGER cache_misses: INTEGER cache_hit_percent: REAL

v intervals_skipped: INTEGER For events generated by situations in the SMTP Server attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_SMTP_SERVER class. This class contains the following slots: v node: STRING v timestamp: STRING v smtp_virtual_server: STRING v state: INTEGER v state_enum: STRING For events generated by situations in the SMTP Version Information attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_SMTP_VERSION_INFORMATION class. This class contains the following slots: v node: STRING v v v v timestamp: STRING server_name: STRING major_smtp_version_number: INTEGER minor_smtp_version_number: INTEGER

Appendix A. IBM Tivoli Enterprise Console event mapping

303

For events generated by situations in the Thread Pool Status attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_THREAD_POOL_STATUS class. This class contains the following slots: v v v v v v v v node: STRING timestamp: STRING thread_pool_size: INTEGER thread_pool_size_enum: STRING thread_pool_max_size: INTEGER thread_pool_max_size_enum: STRING thread_pool_active_threads: INTEGER thread_pool_active_threads_enum: STRING

v thread_pool_avg_active_threads: REAL v thread_pool_avg_active_threads_enum: STRING v v v v v thread_pool_min_active_threads: INTEGER thread_pool_min_active_threads_enum: STRING thread_pool_max_active_threads: INTEGER thread_pool_max_active_threads_enum: STRING thread_pool_queue_length: INTEGER

v thread_pool_queue_length_enum: STRING v thread_pool_avg_queue_length: REAL v thread_pool_avg_queue_length_enum: STRING v v v v v v v v thread_pool_min_queue_length: INTEGER thread_pool_min_queue_length_enum: STRING thread_pool_max_queue_length: INTEGER thread_pool_max_queue_length_enum: STRING thread_pool_avg_job_wait: REAL thread_pool_avg_job_wait_enum: STRING thread_pool_total_jobs: INTEGER thread_pool_total_jobs_enum: STRING

For events generated by situations in the W3SVC W3WP attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_W3SVC_W3WP class. This class contains the following slots: v node: STRING v timestamp: STRING v name: STRING v total_http_requests_served: INTEGER v v v v v v v http_requests_served_rate: INTEGER requests_rate: INTEGER active_requests: INTEGER total_threads: INTEGER threads_rate: INTEGER active_threads_count: INTEGER current_file_cache_memory_usage_in_kb: INTEGER

v maximum_file_cache_memory_usage_in_kb: INTEGER v output_cache_current_memory_usage_in_kb: INTEGER

304

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v v v v v v v v v v v v v v v v v v

current_files_cached: INTEGER total_files_cached: INTEGER files_cached_rate: INTEGER file_cache_hits: INTEGER file_cache_misses: INTEGER file_cache_flushes: INTEGER active_flushed_entries: INTEGER total_flushed_files: INTEGER flushed_files_rate: INTEGER current_metadata_cached: INTEGER total_metadata_cached: INTEGER metadata_cached_rate: INTEGER metadata_cache_hits: INTEGER metadata_cache_misses: INTEGER metadata_cache_flushes: INTEGER total_flushed_metadata: INTEGER flushed_metadata_rate: INTEGER output_cache_current_items: INTEGER

v output_cache_total_hits: INTEGER v output_cache_total_misses: INTEGER v output_cache_total_flushes: INTEGER v v v v v v v v output_cache_flushes_rate: INTEGER output_cache_total_flushed_items: INTEGER output_cache_flushed_items_rate: INTEGER file_cache_hits_rate: INTEGER metadata_cache_hits_rate: INTEGER file_cache_misses_rate: INTEGER metadata_cache_misses_rate: INTEGER output_cache_misses_rate: INTEGER

v maximum_threads_count: INTEGER v output_cache_current_flushed_items: INTEGER v output_cache_hits_rate: INTEGER For events generated by situations in the WAS W3WP attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_WAS_W3WP class. This class contains the following slots: v node: STRING v v v v v v v timestamp: STRING name: STRING active_listener_channels: INTEGER active_protocol_handlers: INTEGER health_ping_reply_latency: INTEGER total_health_pings: INTEGER health_pings_rate: INTEGER

v total_messages_sent_to_was: INTEGER v messages_sent_to_was_rate: INTEGER


Appendix A. IBM Tivoli Enterprise Console event mapping

305

v v v v v

total_requests_served: INTEGER requests_served_rate: INTEGER total_runtime_status_queries: INTEGER runtime_status_queries_rate: INTEGER total_was_messages_received: INTEGER

v was_messages_received_rate: INTEGER For events generated by situations in the Web Service attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_WEB_SERVICE class. This class contains the following slots: v v v v v v v v node: STRING timestamp: STRING total_kbytes_sent: INTEGER kb_sent_rate: REAL total_kbytes_received: INTEGER kb_received_rate: REAL total_kbytes_transfered: INTEGER kb_total_rate: REAL

v total_files_sent: INTEGER v files_sent_rate: REAL v total_files_received: INTEGER v v v v files_received_rate: REAL total_files_transferred: INTEGER files_rate: REAL current_anonymous_users: INTEGER

v current_nonanonymous_users: INTEGER v total_anonymous_users: INTEGER v anonymous_users_rate: REAL v v v v v total_nonanonymous_users: INTEGER nonanonymous_users_rate: REAL maximum_nonanonymous_users: INTEGER maximum_anonymous_users: INTEGER percent_current_anonymous_users: REAL

v percent_current_nonanonymous_users: REAL v percent_total_anonymous_users: REAL v v v v v v v v v v v percent_total_nonanonymous_users: REAL current_connections: INTEGER maximum_connections: INTEGER total_connection_attempts: INTEGER connection_attempts_rate: REAL total_logon_attempts: INTEGER logon_attempts_rate: REAL web_service_uptime_in_hrs: REAL total_method_requests: INTEGER total_method_requests_rate: REAL total_other_request_methods: INTEGER

306

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v v v v v v v v v v v v

other_request_methods_rate: REAL total_requests_rate: REAL total_not_found_errors: INTEGER not_found_errors_rate: REAL total_locked_errors: INTEGER locked_errors_rate: REAL current_cgi_requests: INTEGER total_cgi_requests: INTEGER cgi_requests_rate: REAL maximum_cgi_requests: INTEGER current_isapi_extension_requests: INTEGER total_isapi_extension_requests: INTEGER

v isapi_extension_requests_rate: REAL v maximum_isapi_extension_requests: INTEGER v name: STRING For events generated by situations in the Web Service Cache attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_WEB_SERVICE_CACHE class. This class contains the following slots: v node: STRING v timestamp: STRING v v v v active_flushed_entries: INTEGER current_file_cache_memory_usage_in_kb: REAL current_files_cached: INTEGER total_files_cached: INTEGER

v file_cache_hits: INTEGER v file_cache_hits_percent: REAL v file_cache_misses: INTEGER v v v v v file_cache_flushes: INTEGER maximum_file_cache_memory_usage_in_kb: REAL total_flushed_files: INTEGER current_metadata_cached: INTEGER total_metadata_cached: INTEGER

v metadata_cache_hits: INTEGER v metadata_cache_misses: INTEGER v metadata_cache_hits_percent: REAL v metadata_cache_flushes: INTEGER v total_flushed_metadata: INTEGER For events generated by situations in the Web Service Extensions Restricted List attribute group, Tivoli Enterprise Console events are sent using the ITM_KQ7_WEB_SERVICE_EXTENSIONS_RESTRICTED_LIST class. This class contains the following slots: v node: STRING v timestamp: STRING v allow_deny_flag: INTEGER v allow_deny_flag_enum: STRING
Appendix A. IBM Tivoli Enterprise Console event mapping

307

v v v v v

physical_path: STRING removable: INTEGER removable_enum: STRING group_id: STRING description: STRING

308

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Appendix B. Discovery Library Adapter for the monitoring agent


This chapter contains information about the Discovery Library Adapter (DLA) for the Monitoring agent for Microsoft IIS Server

About the DLA


The Tivoli Management Services DLA discovers resources and relationships and creates a Discovery Library Book file. The Book follows the Discovery Library IdML schema and is used to populate the Configuration Management Database (CMDB) and Tivoli Business System Management products. The Tivoli Management Services DLA discovers Microsoft IIS resources. For all Microsoft IIS systems that are active and online at the Tivoli Enterprise Portal Server, information is included in the discovery book for those resources. The Tivoli Management Services DLA discovers active resources. It is run on-demand and can be run periodically to discover resources that were not active during previous discoveries. The DLA discovers IIsWebServer details, IIsWebServices details, and IIsModule details.

More information about DLAs


The following sources contain additional information about using the DLA program with all monitoring agents: v The IBM Tivoli Monitoring Administrator's Guide contains information about using the Tivoli Management Services Discovery Library Adapter. v For information about using a DLA with Tivoli Application Dependency Discovery Manager (TADDM), see the information center at http://publib.boulder.ibm.com/infocenter/tivihelp/v10r1/topic/ com.ibm.taddm.doc_7.1/cmdb_welcome.html

Microsoft IIS DLA data model class types represented in CDM


This section contains information about how the various source application data objects map to classes in the Common Data Model (CDM) for the Monitoring agent for Microsoft IIS Server. The following information is provided for each class: Relationships CDM relationships (hierarchical) between currently identified model objects CDM attributes, agent attributes, descriptions, and examples CDM and agent attributes that are required to create an instance of a resource, descriptions of the attributes, and examples of the attributes

IIsWebServer class
The IIsWebServerclass represents the instance of Microsoft IIs Server.

Copyright IBM Corp. 2008, 2009

309

CDM class name app.web.iis.IIsWebServer Relationships There are no relationships defined for this class. CDM attributes, agent attributes, descriptions, and examples v CDM attribute: Id (IdML) Agent attribute: KQ7IISWEB1.SERVER_NAM Description: The name of the IIS Web server Example: W3SVC-IIsWebServer v CDM attribute: ManagedSystemName Agent attribute: INODESTS.NODE Description: The name of the component of the IBM Tivoli Monitoring (ITM) product that corresponds to (commonly provides data for) the management of this instance Example: PS3498WIN2K3:Q7 v CDM attribute: Name Agent attribute: KQ7IISWEB1.SERVER_NAM Description: The name of the IIS Web server Example: W3SVC v CDM attribute: IISPath Agent attribute: KQ7IISWEB1.PATH_NAME Description: Displays the full path where the IIS v6 or v7 component is installed Example: D:\WINDOWS\System32\svchost.exe -k iissvcs v CDM attribute: Label Agent attribute: KQ7IISWEB1.SERVER_NAM Description: A user-specified string that is used when displaying a managed element Example: W3SVC - IIs Web Server

IISWebServices class
The IISWebServices class represents IIS Web Services in IIS Server. CDM class name app.web.iis.IIsWebService Relationships There are no relationships defined for this class. CDM attributes, agent attributes, descriptions, and examples v CDM attribute: Id (IdML) Agent attribute: KQ7AVAIL. NAME Description: The IIS service name Example: HTTPFilter-IIsWebService v CDM attribute: ManagedSystemName Agent attribute: INODESTS.NODE Description: The name of the component of the IBM Tivoli Monitoring (ITM) product that corresponds to (commonly provides data for) the management of this instance Example: PS3498WIN2K3:Q7 v CDM attribute: Name Agent attribute: KQ7AVAIL. NAME Description: The IIS service name Example: HTTPFilter

310

Monitoring Agent for Microsoft Internet Information Services: Users Guide

v CDM attribute: Label Agent attribute: KQ7AVAIL.COMPONENT Description: The descriptive name of a part of the application Example: HTTP SSL v CDM attribute: VendorName Agent attribute: Microsoft Description: The name of the vendor Example: Microsoft v CDM attribute: Status Agent attribute: KQ7AVAIL.SERVICE_STATUS Description: The status of the service Example: Running or Stopped v CDM attribute: ExecutableName Agent attribute: KQ7AVAIL.FULLNAME Description: The executable (.exe) file name Example: lsass.exe

IIsModule class
The IIsModule class represents IIS Web Services in Microsoft IIs Server. CDM class name app.web.iis.IIsModule Relationships v runsOn CDM attributes, agent attributes, descriptions, and examples v CDM attribute: Id (IdML) Agent attribute: KQ7IISCOMP. MODULE_NAME Description: The name of the IIS v7 component that is installed Example: SharedLibraries-IIsModule v CDM attribute: ManagedSystemName Agent attribute: INODESTS.NODE Description: The name of the component of the IBM Tivoli Monitoring (ITM) product that corresponds to (commonly provides data for) the management of this instance Example: PS3498WIN2K3:Q7 v CDM attribute: ModuleName Agent attribute: KQ7IISCOMP.MODULE_NAME Description: The name of the IIS v7 component that is installed Example: SharedLibraries

TMSAgent class
The TMSAgent represents Tivoli Monitoring Services Agent. CDM class name app.TMSAgent Superior CDM class AppServer Relationships v monitors v installedOn CDM attributes, agent attributes, descriptions, and examples
Appendix B. Discovery Library Adapter for the monitoring agent

311

v CDM attribute: Id (IdML) Agent attribute: INODESTS.NODE Description: The name of the component of the IBM Tivoli Monitoring (ITM) product that corresponds to (commonly provides data for) the management of this instance Example: PS3867:Q7-ITMAgent v CDM attribute: ManagedSystemName Agent attribute: INODESTS.NODE Description: The name of the component of the IBM Tivoli Monitoring (ITM) product that corresponds to (commonly provides data for) the management of this instance Example: PS3867:Q7 v CDM attribute: ManagedObjectName Agent attribute: INODESTS.NODE Description: The name of the component of the IBM Tivoli Monitoring (ITM) product that corresponds to (commonly provides data for) the management of this instance Example: p@PS3867:Q7 v CDM attribute: SoftwareVersion Agent attribute: INODESTS.VERSION Description: The version of the Microsoft IIS agent Example: 06.20.00 v CDM attribute: Product Code Agent attribute: INODESTS.PRODUCT Description: The product code of Microsoft IIS agent Example: Q7 v CDM attribute: Affinity Agent attribute: INODESTS.AFFINITIES Description: The affinity of Microsoft IIS Agent Example: IBM.IIS 000000000100004w0a7 v CDM attribute: Label Agent attribute: INODESTS.NODE Description: A user-specified string that is used when displaying a managed element Example: PS3867:Q7 -IIs Server

312

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Appendix C. Documentation library


This appendix contains information about the publications related to the Monitoring Agent for Microsoft Internet Information Services. These publications are listed in the following categories: v Monitoring Agent for Microsoft Internet Information Services library v Prerequisite publications v Related publications See the IBM Tivoli Monitoring and OMEGAMON XE products: Documentation Guide, SC23-8816, for information about accessing and using publications. You can find the Documentation Guide in the IBM Tivoli Monitoring and OMEGAMON XE Information Center at http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/ topic/com.ibm.docguide.doc/DocGuide.htm. To find a list of new and changed publications, click Whats new on the Welcome page of the IBM Tivoli Monitoring and OMEGAMON XE Information Center. To find publications from the previous version of a product, click Previous information centers on the Welcome page for the product.

Monitoring Agent for Microsoft Internet Information Services library


There is one document specific to the Monitoring Agent for Microsoft Internet Information Services: IBM Tivoli Monitoring for Microsoft Applications: Microsoft Internet Information Services Agent Users Guide. This publication provides agent-specific information for configuring, using, and troubleshooting the Monitoring Agent for Microsoft Internet Information Services Use the configuration chapter in this guide with the IBM Tivoli Monitoring Installation and Setup Guide to set up the software. Use the information in this guide with the IBM Tivoli Monitoring Users Guide to monitor Microsoft Internet Information Server resources.

Prerequisite publications
To use the information in this publication effectively, you must have some prerequisite knowledge, which you can obtain from the following IBM Tivoli Monitoring publications: v Exploring IBM Tivoli Monitoring v IBM Tivoli Monitoring Administrators Guide v IBM Tivoli Monitoring Agent Builder Users Guide v IBM Tivoli Monitoring Command Reference v IBM Tivoli Monitoring: Configuring Tivoli Enterprise Monitoring Server on z/OS v IBM Tivoli Monitoring Installation and Setup Guide v IBM Tivoli Monitoring: Messages v IBM Tivoli Monitoring Troubleshooting Guide v IBM Tivoli Monitoring: Upgrading from Tivoli Distributed Monitoring v IBM Tivoli Monitoring: Upgrading from V5.1.2
Copyright IBM Corp. 2008, 2009

313

v v v v v

IBM IBM IBM IBM IBM

Tivoli Tivoli Tivoli Tivoli Tivoli

Monitoring Users Guide Monitoring: i5/OS Agent Users Guide Monitoring: Linux OS Agent Users Guide Monitoring: UNIX Log OS Agent Users Guide Monitoring: UNIX OS Agent Users Guide

v IBM Tivoli Monitoring: Windows OS Agent Users Guide v IBM Tivoli Monitoring Universal Agent Users Guide v IBM Tivoli Monitoring Universal Agent API and Command Programming Reference Guide

Related publications
The following documents also provide useful information: v IBM Tivoli Enterprise Console Adapters Guide v IBM Tivoli Enterprise Console Event Integration Facility Users Guide v IBM Tivoli Enterprise Console Reference Manual v IBM Tivoli Enterprise Console Rule Builders Guide

Other sources of documentation


You can also obtain technical documentation about Tivoli Monitoring and OMEGAMON XE products from the following sources: v IBM Tivoli Open Process Automation Library (OPAL) http://www.ibm.com/software/tivoli/opal OPAL is an online catalog that contains integration documentation as well as other downloadable product extensions. This library is updated daily. v Redbooks http://www.redbooks.ibm.com/ IBM Redbooks, Redpapers, and Redbooks Technotes provide information about products from platform and solution perspectives. v Technotes You can find Technotes through the IBM Software Support Web site at http://www.ibm.com/software/support/probsub.html, or more directly through your product Web site, which contains a link to Technotes (under Solve a problem). Technotes provide the latest information about known product limitations and workarounds.

314

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Appendix D. Accessibility
Accessibility features help users with physical disabilities, such as restricted mobility or limited vision, to use software products successfully. The major accessibility features in this product enable users to do the following: v Use assistive technologies, such as screen-reader software and digital speech synthesizer, to hear what is displayed on the screen. Consult the product documentation of the assistive technology for details on using those technologies with this product. v Operate specific or equivalent features using only the keyboard. v Magnify what is displayed on the screen. In addition, the product documentation was modified to include the following features to aid accessibility: v All documentation is available in both HTML and convertible PDF formats to give the maximum opportunity for users to apply screen-reader software. v All images in the documentation are provided with alternative text so that users with vision impairments can understand the contents of the images.

Navigating the interface using the keyboard


Standard shortcut and accelerator keys are used by the product and are documented by the operating system. See the documentation provided by your operating system for more information.

Magnifying what is displayed on the screen


You can enlarge information on the product windows using facilities provided by the operating systems on which the product is run. For example, in a Microsoft Windows environment, you can lower the resolution of the screen to enlarge the font sizes of the text on the screen. See the documentation provided by your operating system for more information.

Copyright IBM Corp. 2008, 2009

315

316

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Appendix E. Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the users responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 3-2-12, Roppongi, Minato-ku, Tokyo 106-8711 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

Copyright IBM Corp. 2008, 2009

317

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBMs future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBMs suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to

318

Monitoring Agent for Microsoft Internet Information Services: Users Guide

IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBMs application programming interfaces. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights reserved. If you are viewing this information in softcopy form, the photographs and color illustrations might not be displayed.

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml. Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others.

Appendix E. Notices

319

320

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Index Special characters


% % % % Current Anonymous Users attribute 44, 84, 120 Current NonAnonymous Users attribute 45, 85, 120 Total Anonymous Users attribute 45, 85, 121 Total NonAnonymous Users attribute 46, 85, 121 attribute groups (continued) IIS Components 64 IIS FTP Server Bindings 65 IIS FTP Server Status 66 IIS FTP Sites Detail 67 IIS NNTP Server Status 68 IIS SMTP Server Status 69 IIS Version Information 70 IIS Web Server Bindings 71 IIS Web Server Site Status 72 IIS Web Server Status 73 IIS Web Sites Detail 74 Internet Information Services Gl 75 list of all 23 Microsoft FTP Service 80 Mime Types 87 more information 23 new 4 NNTP Server 88 NNTP Version Information 89 overview 23 Performance Object Status 90 SMTP Server 94 SMTP Version Information 95 Thread Pool Status 96 W3SVC W3WP 100 WAS W3WP 111 Web Service 115 Web Service Cache 128 Web Service Extensions Restricted List 132 attributes % Current Anonymous Users 44, 84, 120 % Current NonAnonymous Users 45, 85, 120 % Total Anonymous Users 45, 85, 121 % Total NonAnonymous Users 46, 85, 121 Active Flushed Entries 78, 104, 128 Active Listener Channels 111 Active Protocol Handlers 111 Active Requests 101 Active Server Pages 26 Active Thread Count 102 Allow/Deny Flag 133 Anonymous Users Rate (per sec) 119 Application Component 36 Application Pool Name 53 AppPool AutoStart 53 AppPool Command 53 AppPool Identity Type 53 AppPool Queue Length 54 AppPool Recycle Config Change 54 AppPool Recycle Isapi Unhealthy 54 AppPool Recycle Memory 54 AppPool Recycle OnDemand 55 AppPool Recycle Private Memory 55 AppPool Recycle Requests 55 AppPool Recycle Schedule 56 AppPool Recycle Time 56 AppPool State 56 ASP NET 34 Auto Shutdown AppPool Exe 57 Auto Shutdown AppPool Params 57

A
accessibility 315 Active Flushed Entries attribute 78, 104, 128 Active Listener Channels attribute 111 Active Protocol Handlers attribute 111 Active Requests attribute 101 Active Server Pages situations 138, 140 workspaces descriptions 14 list 12 Active Server Pages attribute group 26 Active Server Pages workspace 14 Active Thread Count attribute 102 agent trace logs 259 agents troubleshooting 266 Allow/Deny Flag attribute 133 Anonymous Users Rate (per sec) attribute 119 Application Component attribute 36 Application Pool Name attribute 53 AppPool AutoStart attribute 53 AppPool Command attribute 53 AppPool Identity Type attribute 53 AppPool Queue Length attribute 54 AppPool Recycle Config Change attribute 54 AppPool Recycle Isapi Unhealthy attribute 54 AppPool Recycle Memory attribute 54 AppPool Recycle OnDemand attribute 55 AppPool Recycle Private Memory attribute 55 AppPool Recycle Requests attribute 55 AppPool Recycle Schedule attribute 56 AppPool Recycle Time attribute 56 AppPool State attribute 56 ASP NET situations 138, 142 workspaces descriptions 15 list 12 ASP NET attribute group 34 ASP NET workspace 15 attribute groups Active Server Pages 26 ASP NET 34 Availability 35 Event Log 39 FTP Server Site Status 40 FTP Service 41 FTP Version Information 48 HTTP Custom Error Messages 49 Http Error Log 50 IIS Application Pools Setting 52 Copyright IBM Corp. 2008, 2009

321

attributes (continued) Availability 35 Average Collection Duration 93 BLOB Cache Flushes 79 BLOB Cache Hits 79 BLOB Cache Hits % 79 BLOB Cache Misses 79 Cache % Machine Memory Limit Used 34 Cache % Process Memory Limit Used 34 Cache Hit Percent 94 Cache Hits 94 Cache Misses 94 CGI Requests Rate (per sec) 126 Client IP Address 51 Client Port 51 Command Line 38 Connection Attempts Rate (per sec) 122 CPU Action 57 CPU Limit % 57 CPU Reset Interval 57 Current Anonymous Users 44, 83, 118 Current BLOBs Cached 78 Current CGI Requests 125 Current Connections 47, 85, 121 Current File Cache Memory Usage (KB) 77, 102, 128 Current Files Cached 76, 102, 128 Current ISAPI Extension Requests 126 Current Metadata Cached 105, 131 Current NonAnonymous Users 45, 83, 118 Current Sessions 32 Date 51 Description 134 Disallow Overlapping Rotation 58 Disallow Rotation On Config Change 58 Error Code 50, 52, 91 Error Description 52 Error Rate (per sec) 27 Error Sub Code 50 Errors During Script Runtime 27 Errors From ASP Preprocessor 27 Errors From Script Compilers 27 Event Category 40 Event ID 40 Event Log 39 Event Source 39 Event Type 39 File Cache Flushes 77, 104, 130 File Cache Hits 76, 103, 129 File Cache Hits % 77, 129 File Cache Hits Rate (per sec) 109 File Cache Misses 77, 104, 129 File Cache Misses Rate (per sec) 109 File Extension 87 File Sent Rate (per sec) 43, 82 Files Cached Rate (per sec) 103 Files Rate (per sec) 118 Files Received Rate (per sec) 43, 82, 117 Files Sent Rate (per sec) 117 Files Transferred Rate (per sec) 44, 83 Flushed Files Rate (per sec) 105 Flushed Metadata Rate (per sec) 107 FTP Port 65, 68 FTP Server Site Status 41 FTP Service 41 FTP Service Uptime (hrs) 48 FTP Site 41, 67 FTP Site ID 65, 68

attributes (continued) FTP Site Name 65, 68 FTP Version Information 49 Full Name 37 Functionality Test Message 39 Functionality Test Status 38 Group ID 133 Health Ping Rate (per sec) 112 Health Ping Reply Latency 112 HTTP Custom Error Messages 50 Http Error Log 51 HTTP Port 72, 75 HTTP Requests Served Rate (per sec) 100 HTTP Status 50, 52 Idle Timeout 58 IIS Application Pools Setting 52 IIS Components 64 IIS FTP Server Bindings 65 IIS FTP Server Status 66 IIS FTP Sites Detail 67 IIS NNTP Server Status 68 IIS SMTP Server Status 69 IIS Version Information 70 IIS Web Server Bindings 71 IIS Web Server Site Status 72 IIS Web Server Status 73 IIS Web Sites Detail 74 Infrastructure Error Event Raised Rate (per sec) 35 Internet Information Services Gl 76 Intervals Skipped 94 ISAPI Extension Requests Rate (per sec) 127 KB Received Rate (per sec) 42, 81, 116 KB Sent Rate (per sec) 42, 81, 115 KB Total Rate (per sec) 42, 81, 116 Last Collection Duration 93 Last Collection Finished 93 Last Collection Start 93 Load Balancer Capabilities 59 Locked Error Rate (per sec) 125 Log Name 39 Logon Attempt Rate (per sec) 48, 86 Logon Attempts Rate (per sec) 122 Logon Method 59 Major FTP Version Number 49 Major IIS Version Number 71 Major NNTP Version Number 89 Major SMTP Version Number 96 Max Processes 59 Maximum Anonymous Users 46, 84, 120 Maximum CGI Requests 126 Maximum Connections 47, 86, 121 Maximum File Cache Memory Usage (KB) 78, 102, 130 Maximum ISAPI Extension Requests 127 Maximum NonAnonymous Users 46, 84, 120 Maximum Thread Count 110 Membership Authentication Failures 35 Message 40 Message Location 50 Message Source 50 Messages Sent to WAS Rate (per sec) 113 Metadata Cache Flushes 106, 132 Metadata Cache Hits 106, 131 Metadata Cache Hits % 132 Metadata Cache Hits Rate (per sec) 109 Metadata Cache Misses 106, 131 Metadata Cache Misses Rate (per sec) 109 Metadata Cached Rate (per sec) 105

322

Monitoring Agent for Microsoft Internet Information Services: Users Guide

attributes (continued) Method 52 Microsoft FTP Service 80 Microsoft FTP Service Uptime (hrs) 87 MIME Type 87 Mime Types 87 Minor FTP Version Number 49 Minor IIS Version Number 71 Minor NNTP Version Number 89 Minor SMTP Version Number 96 Module Name 64 more information 23 Name 35, 36, 48, 80, 100, 111, 127 NNTP Server 88 NNTP Version Information 89 NNTP Virtual Server 88 Node 26, 34, 35, 39, 41, 49, 50, 51, 52, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 76, 80, 87, 88, 89, 90, 94, 95, 96, 100, 111, 115, 128, 133 NonAnonymous Users Rate (per sec) 119 Not Found Error Rate (per sec) 125 Number of Collections 93 Object Name 90 Object Status 91 Object Type 90 Orphan Action Exe 59 Orphan Action Params 59 Orphan Worker Process 59 Other Request Methods Rate (per sec) 124 Output Cache Current Flushed Items 110 Output Cache Current Items 107 Output Cache Current Memory Usage (KB) 102 Output Cache Flushed Items Rate (per sec) 108 Output Cache Flushes Rate (per sec) 108 Output Cache Hits Rate (per sec) 110 Output Cache Misses Rate (per sec) 110 Output Cache Total Flushed Items 108 Output Cache Total Flushes 108 Output Cache Total Hits 107 Output Cache Total Misses 107 overview 23 Page Faults per Sec 37 Path Name 66, 68, 70, 74 Percent Privileged Time 38 Percent Processor Time 38 Percent User Mode Time 38 Performance Object Status 90 Periodic Restart Memory 60 Periodic Restart Private Memory 60 Periodic Restart Requests 60 Periodic Restart Time 61 Physical Path 133 PID 37 Ping Interval 61 Ping Response Time 61 Pinging Enabled 61 Process ID 66, 69, 70, 74 Protocol Sub Status 52 Protocol Version 51 Query Name 90 Rapid Fail Protection 62 Rapid Fail Protection Interval 62 Rapid Fail Protection Max Crashes 62 Refresh Interval 93 Removable 133 Request Execution Time (ms) 28 Request KBytes In Total 28

attributes (continued) Request KBytes Out Total 28 Request Rate (per sec) 31, 101 Request Wait GT Execution Time (ms) 29 Request Wait Time (ms) 28 Requests Disconnected Count 29 Requests Executing Count 29 Requests Failed Total 29 Requests Not Authorized Count 30 Requests Not Found Count 30 Requests Queued Count 30 Requests Queued Delta 30 Requests Rejected Count 30 Requests Served Rate (per sec) 113 Requests Succeeded Count 31 Requests Timed Out Count 31 Requests Total 31 Runtime Status Queries Rate (per sec) 114 Server IP Address 51 Server Name 49, 66, 68, 69, 71, 73, 89, 95 Server Port 51 Shutdown Time Limit 63 Site ID 72, 75 SMP Affinitized 63 SMP Processor Affinity Mask 63 SMTP Server 94 SMTP Version Information 95 SMTP Virtual Server 95 SSL Port 72, 75 Startup Time Limit 63 State 41, 66, 67, 69, 70, 73, 74, 75, 88, 95 Status 36, 65, 67, 69, 70, 74 Thread Count 37 Thread Pool Active Threads 97 Thread Pool Avg Active Threads 97 Thread Pool Avg Job Wait 99 Thread Pool Avg Queue Length 98 Thread Pool Max Active Threads 98 Thread Pool Max Queue Length 99 Thread Pool Max Size 97 Thread Pool Min Active Threads 97 Thread Pool Min Queue Length 98 Thread Pool Queue Length 98 Thread Pool Size 97 Thread Pool Status 96 Thread Pool Total Jobs 99 Threads Rate (per sec) 101 Time 51 Time Generated 40 Timed Out Sessions 32 Timestamp 26, 34, 36, 41, 42, 49, 50, 51, 53, 64, 65, 66, 67, 68, 69, 70, 72, 73, 74, 76, 80, 87, 88, 89, 90, 94, 95, 96, 100, 111, 115, 128, 133 Total Anonymous Users 45, 83, 119 Total BLOBs Cached 78 Total CGI Requests 126 Total Connection Attempts 86 Total Connection Attempts (all instances) 47 Total Connection Attempts (all Instances) 122 Total Files Cached 76, 103, 129 Total Files Received 43, 81, 117 Total Files Sent 42, 81, 117 Total Files Transferred 43, 82, 118 Total Flushed BLOBs 80 Total Flushed Files 78, 104, 130 Total Flushed Metadata 106, 132 Total Health Pings 112 Index

323

attributes (continued) Total HTTP Requests Served 100 Total ISAPI Extension Requests 127 Total KB Received 115 Total KB Sent 115 Total KB Transferred 116 Total Locked Errors 125 Total Logon Attempts 47, 86, 122 Total Messages Sent to WAS 112 Total Metadata Cached 105, 131 Total Method Requests 123 Total Method Requests Rate (per sec) 123 Total NonAnonymous Users 46, 84, 119 Total Not Found Errors 124 Total Other Request Methods 123 Total Requests Rate (per sec) 124 Total Requests Served 113 Total Runtime Status Queries 113 Total Sessions 32 Total Threads 101 Total Transactions 33 Total WAS Messages Received 114 Transaction Rate (per sec) 32 Transactions Aborted 33 Transactions Committed 33 Transactions Pending Count 33 Type 37 URL 52 Virtual Size 37 W3SVC W3WP 100 WAM User Name 64 WAS Messages Received Rate (per sec) 114 WAS W3WP 111 Web Service 115 Web Service Cache 128 Web Service Extensions Restricted List 133 Web Service Uptime (hrs) 123 Web Site 73, 75 Web Site Name 72, 75 Win32 Error 64 Working Set Size 37 Auto Shutdown AppPool Exe attribute 57 Auto Shutdown AppPool Params attribute 57 Availability situations 138, 142 workspaces descriptions 15 list 13 Availability attribute group 35 Availability workspace 15 Average Collection Duration attribute 93

Cache Misses attribute 94 calculate historical data disk space 134 capacity planning Monitoring Agent for Microsoft Internet Information Services 134 capacity planning for historical data 134 CGI and ISAPI Extension Request Statistics workspace 20 CGI Requests Rate (per sec) attribute 126 changed situations, new 4 take actions, new 4 changes attribute groups, new 4 baroc file updated 5 Client IP Address attribute 51 Client Port attribute 51 Command Line attribute 38 commands tacmd addSystem 10 commands, Take Action 175 components 5 configuration 7 after installation 10 fields 10 remote 10 values 10 configuring the monitoring agent 10 Connection Attempts Rate (per sec) attribute 122 CPU Action attribute 57 CPU Limit % attribute 57 CPU Reset Interval attribute 57 Current Anonymous Users attribute 44, 83, 118 Current BLOBs Cached attribute 78 Current CGI Requests attribute 125 Current Connections attribute 47, 85, 121 Current File Cache Memory Usage (KB) attribute 77, 102, 128 Current Files Cached attribute 76, 102, 128 Current ISAPI Extension Requests attribute 126 Current Metadata Cached attribute 105, 131 Current NonAnonymous Users attribute 45, 83, 118 Current Sessions attribute 32

D
data trace logs 258 Data and File Traffic Statistics for Microsoft FTP v7 workspace 16 Data and File Transfer Statistics workspace 20 data logged Monitoring Agent for Microsoft Internet Information Services 134 data provider logs See agent Date attribute 51 Description attribute 134 Disallow Overlapping Rotation attribute 58 Disallow Rotation On Config Change attribute 58 disk capacity planning See capacity planning disk capacity planning for historical data 134 documentation See publications

B
BLOB Cache Flushes attribute 79 BLOB Cache Hits % attribute 79 BLOB Cache Hits attribute 79 BLOB Cache Misses attribute 79 built-in troubleshooting features 257

C
Cache Cache Cache Cache % Machine Memory Limit Used attribute 34 % Process Memory Limit Used attribute 34 Hit Percent attribute 94 Hits attribute 94

324

Monitoring Agent for Microsoft Internet Information Services: Users Guide

E
environment features 1 functions 1 Error Code attribute 50, 52, 91 Error Description attribute 52 Error Rate (per sec) attribute 27 Error Statistics workspace 21 Error Sub Code attribute 50 Errors During Script Runtime attribute 27 Errors From ASP Preprocessor attribute 27 Errors From Script Compilers attribute 27 event mapping 293 Event Category attribute 40 Event ID attribute 40 Event Log situations 138, 150 workspaces descriptions 16 list 13 Event Log attribute group 39 Event Log workspace 16 Event Source attribute 39 Event Type attribute 39

Functionality Test Status attribute 38 functions, Monitoring Agent for Microsoft Internet Information Services 1

G
gathering support information Group ID attribute 133 257

H
Health Ping Rate (per sec) attribute 112 Health Ping Reply Latency attribute 112 historical data calculate disk space 134 capacity planning Monitoring Agent for Microsoft Internet Information Services 134 disk capacity planning 134 HTTP Custom Error Messages attribute group 49 Http Error Log attribute group 50 HTTP Port attribute 72, 75 HTTP Requests Served Rate (per sec) attribute 100 HTTP Status attribute 50, 52

F
features, Monitoring Agent for Microsoft Internet Information Services 1 File Cache Flushes attribute 77, 104, 130 File Cache Hits % attribute 77, 129 File Cache Hits attribute 76, 103, 129 File Cache Hits Rate (per sec) attribute 109 File Cache Misses attribute 77, 104, 129 File Cache Misses Rate (per sec) attribute 109 File Extension attribute 87 File Sent Rate (per sec) attribute 43, 82 files agent trace 259 installation trace 259 other trace log 259 trace logs 258 Files Cached Rate (per sec) attribute 103 Files Rate (per sec) attribute 118 Files Received Rate (per sec) attribute 43, 82, 117 Files Sent Rate (per sec) attribute 117 Files Transferred Rate (per sec) attribute 44, 83 Flushed Files Rate (per sec) attribute 105 Flushed Metadata Rate (per sec) attribute 107 FTP Port attribute 65, 68 FTP Server situations 139, 169 workspaces descriptions 16 list 13 FTP Server Site Status attribute group 40 FTP Server workspace 16 FTP Service attribute group 41 FTP Service Uptime (hrs) attribute 48 FTP Site attribute 41, 67 FTP Site ID attribute 65, 68 FTP Site Name attribute 65, 68 FTP Version Information attribute group 48 Full Name attribute 37 Functionality Test Message attribute 39

I
IBM Software Support See support IBM Support Assistant 281 IBM Tivoli Enterprise Console event mapping 293 Identity and Recycling Application Pool Setting workspace 18 Idle Timeout attribute 58 IIS Application Pools Setting attribute group 52 IIS Components attribute group 64 IIS Configuration situations 139, 169 workspaces descriptions 18 list 13 IIS Configuration workspace 18 IIS FTP Server Bindings attribute group 65 IIS FTP Server Status attribute group 66 IIS FTP Sites Detail attribute group 67 IIS Global situations 139, 170 workspaces descriptions 19 list 13 IIS Global workspace 19 IIS NNTP Server Status attribute group 68 IIS SMTP Server Status attribute group 69 IIS v7 Installed Components workspace 19 IIS Version Information attribute group 70 IIS Web Server Bindings attribute group 71 IIS Web Server Site Status attribute group 72 IIS Web Server Status attribute group 73 IIS Web Sites Detail attribute group 74 information troubleshooting 257 information, additional attributes 23 policies 203 situations 137 Index

325

information, additional (continued) Take Action commands 175 workspaces 11 Infrastructure Error Event Raised Rate (per sec) attribute installation log file 259 problems 263 remote 10 silent 7 interface, user 5 Internet Information Services Gl attribute group 75 Intervals Skipped attribute 94 ISA 281 ISAPI Extension Requests Rate (per sec) attribute 127

35

KQ7_Web_TooMany_KB_Sent situation 171 KQ7_Web_TooMany_Requests situation 170 KQ7_WMSVC_Auth_Read_Conf_Err situation 157 KQ7_WMSvc_Service_Down situation 145 KQ7_WMSVC_SvcHand_Unknown_Err situation 157 KQ7_WMSVC_UNABLE_2_READ_SETGS situation 158 KQ7_WP_Memory_Leak situation 152 KQ7_WP_Module_DLL_Load_Fail situation 165 KQ7_WP_Start_Fail situation 150 KQ7_WP_Terminated situation 159 KQ7_WPHOST_Failed_Init situation 164

L
Last Collection Duration attribute 93 Last Collection Finished attribute 93 Last Collection Start attribute 93 library, Monitoring Agent for Microsoft Internet Information Services 313 list of messages 282 Load Balancer Capabilities attribute 59 Locked Error Rate (per sec) attribute 125 Log Name attribute 39 logged data Monitoring Agent for Microsoft Internet Information Services 134 logging agent trace logs 259 built-in features 257 installation log files 259 trace log files 258 Logon Attempt Rate (per sec) attribute 48, 86 Logon Attempts Rate (per sec) attribute 122 Logon Method attribute 59

K
KB Received Rate (per sec) attribute 42, 81, 116 KB Sent Rate (per sec) attribute 42, 81, 115 KB Total Rate (per sec) attribute 42, 81, 116 KQ7_App_Load_Fail situation 151 KQ7_AppHostSvc_Hist_Config_Err situation 160 KQ7_AppHostSvc_Service_Down situation 144 KQ7_AppHostSvc_SID_Config_Err situation 160 KQ7_ASP_High_Error_Rate situation 142 KQ7_ASP_Que_Size_Increased situation 140 KQ7_ASP_Req_Dispatch_Slow situation 141 KQ7_ASP_Req_Que_Size_Large situation 141 KQ7_FTP_Pasport_MB_Access_Fail situation 154 KQ7_FTP_Pasvport_Invalid_Value situation 156 KQ7_FTP_Site_Down situation 169 KQ7_FTP_System_Call_Failed situation 167 KQ7_Ftpsvc_Service_Down situation 150 KQ7_HTTP_Log_Serv_Unavailable situation 169 KQ7_HTTPFilter_Service_Down situation 147 KQ7_IIS_Web_Site_Down situation 172 KQ7_IISADMIN_Service_Down situation 143 KQ7_IISWMSVC_Login_Unknown_Err situation 156 KQ7_MSFtpsvc_Service_Down situation 145 KQ7_NetMsmqAct_Service_Down situation 149 KQ7_NetPipeAct_Service_Down situation 147 KQ7_NetTcpAct_Service_Down situation 148 KQ7_NetTcpPShr_Service_Down situation 149 KQ7_NntpSvc_Service_Down situation 146 KQ7_Process_Stop_Responding situation 159 KQ7_SMTPSVC_Service_Down situation 146 KQ7_VirtualDir_CfgLost situation 151 KQ7_W3_ETW_Tracing_Init_Failed situation 152 KQ7_W3_Fail_2_Create_FREB_Dir situation 166 KQ7_W3_Out_Of_Memory situation 163 KQ7_W3SVC_App_Pool_Cmd_Err situation 153 KQ7_W3SVC_Bind_Fail_Invald_URL situation 154 KQ7_W3SVC_Binding_Fail situation 161 KQ7_W3SVC_Fail_2_Init situation 162 KQ7_W3SVC_Fail_2_Set_Queue_Len situation 155 KQ7_W3SVC_Filters_Load_Fail situation 162 KQ7_W3SVC_Listen_2_Many_Port situation 161 KQ7_W3SVC_Perfmon_Init_Err situation 163 KQ7_WAS_Fail_2_Reg_Protocol situation 167 KQ7_WAS_Fail_To_Config_Job_Obj situation 155 KQ7_WAS_High_Load_Dynamic_Idle situation 168 KQ7_WAS_Process_Creation_Fail situation 165 KQ7_WAS_Rapid_Fail_Protection situation 166 KQ7_WAS_Service_Down situation 143 KQ7_Web_Server_Down situation 142 KQ7_Web_TooMany_Connections situation 171 KQ7_Web_TooMany_KB_Received situation 172

M
Major FTP Version Number attribute 49 Major IIS Version Number attribute 71 Major NNTP Version Number attribute 89 Major SMTP Version Number attribute 96 Max Processes attribute 59 Maximum Anonymous Users attribute 46, 84, 120 Maximum CGI Requests attribute 126 Maximum Connections attribute 47, 86, 121 Maximum File Cache Memory Usage (KB) attribute 78, 102, 130 Maximum ISAPI Extension Requests attribute 127 Maximum NonAnonymous Users attribute 46, 84, 120 Maximum Thread Count attribute 110 Membership Authentication Failures attribute 35 Message attribute 40 Message Location attribute 50 Message Source attribute 50 messages built-in features 257 for Monitoring Agent for Microsoft Internet Information Services 282 format 282 overview 281 syntax 282 Messages Sent to WAS Rate (per sec) attribute 113 Metadata Cache Flushes attribute 106, 132 Metadata Cache Hits % attribute 132 Metadata Cache Hits attribute 106, 131 Metadata Cache Hits Rate (per sec) attribute 109

326

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Metadata Cache Misses attribute 106, 131 Metadata Cache Misses Rate (per sec) attribute 109 Metadata Cached Rate (per sec) attribute 105 Method attribute 52 Microsoft FTP Service attribute group 80 Microsoft FTP Service Uptime (hrs) attribute 87 Microsoft Internet Information Services situations 138, 140 workspaces descriptions 13 list 12 Microsoft Internet Information Services workspace 13 MIME Type attribute 87 Mime Types and Extension Restriction List workspace 18 Mime Types attribute group 87 Minor FTP Version Number attribute 49 Minor IIS Version Number attribute 71 Minor NNTP Version Number attribute 89 Minor SMTP Version Number attribute 96 Module Name attribute 64 Monitoring Agent for Microsoft Internet Information Services components 5 features 1 functions 1 performance considerations 275

Output Cache Total Flushes attribute 108 Output Cache Total Hits attribute 107 Output Cache Total Misses attribute 107

P
Page Faults per Sec attribute 37 Path Name attribute 66, 68, 70, 74 Percent Privileged Time attribute 38 Percent Processor Time attribute 38 Percent User Mode Time attribute 38 Performance and Health Application Pool Setting workspace 18 performance considerations 275 Performance Object Status attribute group 90 Performance Object Status workspace 16 Periodic Restart Memory attribute 60 Periodic Restart Private Memory attribute 60 Periodic Restart Requests attribute 60 Periodic Restart Time attribute 61 Physical Path attribute 133 PID attribute 37 Ping Interval attribute 61 Ping Response Time attribute 61 Pinging Enabled attribute 61 policies more information 203 overview 203 problems and workarounds 263 Process ID attribute 66, 69, 70, 74 Protocol Sub Status attribute 52 Protocol Version attribute 51 publications Monitoring Agent for Microsoft Internet Information Services 313 OPAL 314 prerequisite 313 Redbooks 314 related 314 Technotes 314 types 313 purposes troubleshooting 257

N
Name attribute 35, 36, 48, 80, 100, 111, 127 new attribute groups 4 new situations 4 new take actions 4 NNTP Server situations 139, 170 workspaces descriptions 20 list 13 NNTP Server attribute group 88 NNTP Server workspace 20 NNTP Version Information attribute group 89 NNTP Virtual Server attribute 88 Node attribute 26, 34, 35, 39, 41, 49, 50, 51, 52, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 76, 80, 87, 88, 89, 90, 94, 95, 96, 100, 111, 115, 128, 133 NonAnonymous Users Rate (per sec) attribute 119 Not Found Error Rate (per sec) attribute 125 Number of Collections attribute 93

Q
queries, using attributes 23 Query Name attribute 90

O
Object Name attribute 90 Object Status attribute 91 Object Type attribute 90 OPAL documentation 314 Orphan Action Exe attribute 59 Orphan Action Params attribute 59 Orphan Worker Process attribute 59 Other Request Methods Rate (per sec) attribute 124 Output Cache Current Flushed Items attribute 110 Output Cache Current Items attribute 107 Output Cache Current Memory Usage (KB) attribute 102 Output Cache Flushed Items Rate (per sec) attribute 108 Output Cache Flushes Rate (per sec) attribute 108 Output Cache Hits Rate (per sec) attribute 110 Output Cache Misses Rate (per sec) attribute 110 Output Cache Total Flushed Items attribute 108

R
Rapid Fail Protection attribute 62 Rapid Fail Protection Interval attribute 62 Rapid Fail Protection Max Crashes attribute 62 Redbooks 314 Refresh Interval attribute 93 remote installation and configuration 10 remote deployment troubleshooting 266 Removable attribute 133 Request Execution Time (ms) attribute 28 Request KBytes In Total attribute 28 Request KBytes Out Total attribute 28 Request Rate (per sec) attribute 31, 101 Request Wait GT Execution Time (ms) attribute 29 Index

327

Request Wait Time (ms) attribute 28 Requests Disconnected Count attribute 29 Requests Executing Count attribute 29 Requests Failed Total attribute 29 Requests Not Authorized Count attribute 30 Requests Not Found Count attribute 30 Requests Queued Count attribute 30 Requests Queued Delta attribute 30 Requests Rejected Count attribute 30 Requests Served Rate (per sec) attribute 113 Requests Succeeded Count attribute 31 Requests Timed Out Count attribute 31 Requests Total attribute 31 requirements 7 Runtime Status Queries Rate (per sec) attribute

114

S
Server IP Address attribute 51 Server Name attribute 49, 66, 68, 69, 71, 73, 89, 95 Server Port attribute 51 Server Status workspace 19 Session and Transaction Statistics workspace 14 Shutdown Time Limit attribute 63 silent installation 7 Site ID attribute 72, 75 situations general troubleshooting 275, 276 KQ7_App_Load_Fail 151 KQ7_AppHostSvc_Hist_Config_Err 160 KQ7_AppHostSvc_Service_Down 144 KQ7_AppHostSvc_SID_Config_Err 160 KQ7_ASP_High_Error_Rate 142 KQ7_ASP_Que_Size_Increased 140 KQ7_ASP_Req_Dispatch_Slow 141 KQ7_ASP_Req_Que_Size_Large 141 KQ7_FTP_Pasport_MB_Access_Fail 154 KQ7_FTP_Pasvport_Invalid_Value 156 KQ7_FTP_Site_Down 169 KQ7_FTP_System_Call_Failed 167 KQ7_Ftpsvc_Service_Down 150 KQ7_HTTP_Log_Serv_Unavailable 169 KQ7_HTTPFilter_Service_Down 147 KQ7_IIS_Web_Site_Down 172 KQ7_IISADMIN_Service_Down 143 KQ7_IISWMSVC_Login_Unknown_Err 156 KQ7_MSFtpsvc_Service_Down 145 KQ7_NetMsmqAct_Service_Down 149 KQ7_NetPipeAct_Service_Down 147 KQ7_NetTcpAct_Service_Down 148 KQ7_NetTcpPShr_Service_Down 149 KQ7_NntpSvc_Service_Down 146 KQ7_Process_Stop_Responding 159 KQ7_SMTPSVC_Service_Down 146 KQ7_VirtualDir_CfgLost 151 KQ7_W3_ETW_Tracing_Init_Failed 152 KQ7_W3_Fail_2_Create_FREB_Dir 166 KQ7_W3_Out_Of_Memory 163 KQ7_W3SVC_App_Pool_Cmd_Err 153 KQ7_W3SVC_Bind_Fail_Invald_URL 154 KQ7_W3SVC_Binding_Fail 161 KQ7_W3SVC_Fail_2_Init 162 KQ7_W3SVC_Fail_2_Set_Queue_Len 155 KQ7_W3SVC_Filters_Load_Fail 162 KQ7_W3SVC_Listen_2_Many_Port 161 KQ7_W3SVC_Perfmon_Init_Err 163 KQ7_WAS_Fail_2_Reg_Protocol 167

situations (continued) KQ7_WAS_Fail_To_Config_Job_Obj 155 KQ7_WAS_High_Load_Dynamic_Idle 168 KQ7_WAS_Process_Creation_Fail 165 KQ7_WAS_Rapid_Fail_Protection 166 KQ7_WAS_Service_Down 143 KQ7_Web_Server_Down 142 KQ7_Web_TooMany_Connections 171 KQ7_Web_TooMany_KB_Received 172 KQ7_Web_TooMany_KB_Sent 171 KQ7_Web_TooMany_Requests 170 KQ7_WMSVC_Auth_Read_Conf_Err 157 KQ7_WMSvc_Service_Down 145 KQ7_WMSVC_SvcHand_Unknown_Err 157 KQ7_WMSVC_UNABLE_2_READ_SETGS 158 KQ7_WP_Memory_Leak 152 KQ7_WP_Module_DLL_Load_Fail 165 KQ7_WP_Start_Fail 150 KQ7_WP_Terminated 159 KQ7_WPHOST_Failed_Init 164 list of all 138, 139 more information 137 new or changed 4 overview 137 predefined 138 situations, using attributes 23 SMP Affinitized attribute 63 SMP Processor Affinity Mask attribute 63 SMTP Server situations 139, 170 workspaces descriptions 20 list 13 SMTP Server attribute group 94 SMTP Server workspace 20 SMTP Version Information attribute group 95 SMTP Virtual Server attribute 95 Software Support 281 SSL Port attribute 72, 75 Start Application Host Helper Service action 176 Start FTP Publishing Service action 177 Start FTP Site action 178 Start FTP Site by Name action 179 Start HTTP SSL Service action 180 Start IIS Admin Service action 180 Start IIS Web Server action 181 Start Microsoft FTP Service action 182 Start Net.Msmq Listener Adapter Service action 183 Start Net.Pipe Listener Adapter Service action 184 Start Net.Tcp Listener Adapter Service action 185 Start Net.Tcp Port Sharing Service action 185 Start Network News Transfer Protocol Service action 186 Start Simple Mail Transfer Protocol Service action 187 Start Web Management Service action 188 Start Website action 189 Start Website by Name action 190 Start Windows Process Activation Service action 190 Startup Time Limit attribute 63 State attribute 41, 66, 67, 69, 70, 73, 74, 75, 88, 95 Status attribute 36, 65, 67, 69, 70, 74 Stop Application Host Helper Service action 191 Stop FTP Publishing Service action 192 Stop FTP Site action 192 Stop FTP Site by Name action 193 Stop HTTP SSL Service action 194 Stop IIS Admin Service action 194 Stop IIS Web Server action 195

328

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Stop Microsoft FTP Service action 195 Stop Net.Msmq Listener Adapter Service action 196 Stop Net.Pipe Listener Adapter Service action 196 Stop Net.Tcp Listener Adapter Service action 197 Stop Net.Tcp Port Sharing Service action 198 Stop Network News Transfer Protocol Service action 198 Stop Simple Mail Transfer Protocol Service action 199 Stop Web Management Service action 199 Stop Website action 200 Stop Website by Name action 200 Stop Windows Process Activation Service action 201 support gathering information for 257 list of messages 282 messages 281 support assistant 281 syntax messages 282

T
tacmd addSystem command 10 Take Action commands list of all 175 more information 175 overview 175 predefined 175 Start Application Host Helper Service 176 Start FTP Publishing Service 177 Start FTP Site 178 Start FTP Site by Name 179 Start HTTP SSL Service 180 Start IIS Admin Service 180 Start IIS Web Server 181 Start Microsoft FTP Service 182 Start Net.Msmq Listener Adapter Service 183 Start Net.Pipe Listener Adapter Service 184 Start Net.Tcp Listener Adapter Service 185 Start Net.Tcp Port Sharing Service 185 Start Network News Transfer Protocol Service 186 Start Simple Mail Transfer Protocol Service 187 Start Web Management Service 188 Start Website 189 Start Website by Name 190 Start Windows Process Activation Service 190 Stop Application Host Helper Service 191 Stop FTP Publishing Service 192 Stop FTP Site 192 Stop FTP Site by Name 193 Stop HTTP SSL Service 194 Stop IIS Admin Service 194 Stop IIS Web Server 195 Stop Microsoft FTP Service 195 Stop Net.Msmq Listener Adapter Service 196 Stop Net.Pipe Listener Adapter Service 196 Stop Net.Tcp Listener Adapter Service 197 Stop Net.Tcp Port Sharing Service 198 Stop Network News Transfer Protocol Service 198 Stop Simple Mail Transfer Protocol Service 199 Stop Web Management Service 199 Stop Website 200 Stop Website by Name 200 Stop Windows Process Activation Service 201 troubleshooting 278 take actions new or changed 4 Technotes 314

Thread Count attribute 37 Thread Pool Active Threads attribute 97 Thread Pool Avg Active Threads attribute 97 Thread Pool Avg Job Wait attribute 99 Thread Pool Avg Queue Length attribute 98 Thread Pool Max Active Threads attribute 98 Thread Pool Max Queue Length attribute 99 Thread Pool Max Size attribute 97 Thread Pool Min Active Threads attribute 97 Thread Pool Min Queue Length attribute 98 Thread Pool Queue Length attribute 98 Thread Pool Size attribute 97 Thread Pool Status attribute group 96 Thread Pool Status workspace 16 Thread Pool Total Jobs attribute 99 Threads Rate (per sec) attribute 101 Time attribute 51 Time Generated attribute 40 Timed Out Sessions attribute 32 Timestamp attribute 26, 34, 36, 41, 42, 49, 50, 51, 53, 64, 65, 66, 67, 68, 69, 70, 72, 73, 74, 76, 80, 87, 88, 89, 90, 94, 95, 96, 100, 111, 115, 128, 133 Tivoli Common Reporting 5 troubleshooting 279 Total Anonymous Users attribute 45, 83, 119 Total BLOBs Cached attribute 78 Total CGI Requests attribute 126 Total Connection Attempts (all instances) attribute 47 Total Connection Attempts (all Instances) attribute 122 Total Connection Attempts attribute 86 Total Files Cached attribute 76, 103, 129 Total Files Received attribute 43, 81, 117 Total Files Sent attribute 42, 81, 117 Total Files Transferred attribute 43, 82, 118 Total Flushed BLOBs attribute 80 Total Flushed Files attribute 78, 104, 130 Total Flushed Metadata attribute 106, 132 Total Health Pings attribute 112 Total HTTP Requests Served attribute 100 Total ISAPI Extension Requests attribute 127 Total KB Received attribute 115 Total KB Sent attribute 115 Total KB Transferred attribute 116 Total Locked Errors attribute 125 Total Logon Attempts attribute 47, 86, 122 Total Messages Sent to WAS attribute 112 Total Metadata Cached attribute 105, 131 Total Method Requests attribute 123 Total Method Requests Rate (per sec) attribute 123 Total NonAnonymous Users attribute 46, 84, 119 Total Not Found Errors attribute 124 Total Other Request Methods attribute 123 Total Requests Rate (per sec) attribute 124 Total Requests Served attribute 113 Total Runtime Status Queries attribute 113 Total Sessions attribute 32 Total Threads attribute 101 Total Transactions attribute 33 Total WAS Messages Received attribute 114 trace logs 258 Transaction Rate (per sec) attribute 32 Transactions Aborted attribute 33 Transactions Committed attribute 33 Transactions Pending Count attribute 33 troubleshooting 257, 263 agents 266 built-in features 257 Index

329

troubleshooting (continued) installation 263 installation logs 259 messages 281 remote deployment 266 situations 275, 276 Take Action commands 278 Tivoli Common Reporting 279 uninstallation 263 uninstallation logs 259 workspaces 271 Type attribute 37

W
W3SVC W3WP attribute group 100 WAM User Name attribute 64 WAS Messages Received Rate (per sec) attribute 114 WAS W3WP attribute group 111 WAS Worker Process Statistics workspace 22 Web Server situations 139, 170 workspaces descriptions 20 list 13 Web Server Cache Statistics workspace 22 Web Server workspace 21 Web Service attribute group 115 Web Service Cache attribute group 128 Web Service Extensions Restricted List attribute group 132 Web Service Uptime (hrs) attribute 123 Web Site attribute 73, 75 Web Site Name attribute 72, 75 Win32 Error attribute 64 workarounds 263 agents 266 remote deployment 266 situations 275 Take Action commands 278 Tivoli Common Reporting 279 workspaces 271 Worker Process situations 139, 173 workspaces descriptions 22 list 13 Worker Process workspace 22 Working Set Size attribute 37 workspaces Active Server Pages 14 ASP NET 15 Availability 15 CGI and ISAPI Extension Request Statistics 20 Data and File Traffic Statistics for Microsoft FTP v7 16 Data and File Transfer Statistics 20 Error Statistics 21 Event Log 16 FTP Server 16 Identity and Recycling Application Pool Setting 18 IIS Configuration 18 IIS Global 19 IIS v7 Installed Components 19 list of all 12 Microsoft Internet Information Services 13 Mime Types and Extension Restriction List 18 more information 11 NNTP Server 20 overview 11 Performance and Health Application Pool Setting 18 Performance Object Status 16 predefined 12 Server Status 19 Session and Transaction Statistics 14 SMTP Server 20 Thread Pool Status 16 troubleshooting 271 User and Connection Statistics 17 User and Connection Statistics for Microsoft FTP v7 17 User Request Statistics 21 WAS Worker Process Statistics 22 Web Server 20, 21

U
uninstallation log file 259 problems 263 URL attribute 52 User and Connection Statistics for Microsoft FTP v7 workspace 17 User and Connection Statistics workspace 17 user interfaces options 5 User Request Statistics workspace 21

V
views Active Server Pages workspace 14 ASP NET workspace 15 Availability workspace 15 CGI and ISAPI Extension Request Statistics workspace 20 Data and File Traffic Statistics for Microsoft FTP v7 workspace 16 Data and File Transfer Statistics workspace 20 Error Statistics workspace 21 Event Log workspace 16 FTP Server workspace 16 Identity and Recycling Application Pool Setting workspace 18 IIS Configuration workspace 18 IIS Global workspace 19 IIS v7 Installed Components workspace 19 Microsoft Internet Information Services workspace 13 Mime Types and Extension Restriction List workspace 18 NNTP Server workspace 20 Performance and Health Application Pool Setting workspace 18 Performance Object Status workspace 16 Server Status workspace 19 Session and Transaction Statistics workspace 14 SMTP Server workspace 20 Thread Pool Status workspace 16 User and Connection Statistics for Microsoft FTP v7 workspace 17 User and Connection Statistics workspace 17 User Request Statistics workspace 21 WAS Worker Process Statistics workspace 22 Web Server Cache Statistics workspace 22 Web Server workspace 21 Worker Process workspace 22 Virtual Size attribute 37

330

Monitoring Agent for Microsoft Internet Information Services: Users Guide

workspaces (continued) Web Server Cache Statistics Worker Process 22

22

Index

331

332

Monitoring Agent for Microsoft Internet Information Services: Users Guide

Printed in USA

SC27-2314-01

Вам также может понравиться