Skip to main content
Version: NG-2.14

IIS

Introduction

Internet Information Services, also known as IIS, is a Microsoft web server that runs on Windows operating system and is used to exchange static and dynamic web content with internet users.

Getting Started

Compatibility

The IIS O11ySource is compatible with all version greater than or equal to Microsoft IIS 10.0. vuSmartMaps supports the monitoring of your IIS Application Pools, IIS Website and IIS Webserver statistics and traffic trends.

Data Collection Method

vuSmartMaps collects health and performance data for IIS server using VuNet's Healthbeat agent. This agent collects data based on the source configuration. IIS logs are collected using VuNet's Logbeat agent.

Prerequisites

Inputs for Configuring Data Source

  • IIS Server: The IP Address/FQDN of the Apache server. This field is the key to identify each server you add here.
  • Period [in seconds]: How frequently data is gathered. The period should be between 60 seconds – 3000 seconds.
  • IIS Log Path: Enter the IIS logfile's entire path

Firewall Requirement

To collect data from this O11ySource, ensure the following ports are opened:

Source IPDestination IPDestination PortProtocolDirection
IP address of the IIS ServervuSmartMaps Data Collector End Point9092*TCPInbound

*Before providing the firewall requirements, please update the port based on the customer environment.

Configuring the Target

In order to gather your IIS Performance metrics and logs, ensure that the default website is enabled in IIS web server. Configure Application Pools in IIS, if not already done. Setup the IIS Logging format to collect additional telemetry from logs.

Configure Logs Collection from IIS Server

The Logbeat agent is used to collect logs from IIS Web Server for log analysis. The log path for the IIS Web Server should be configured in the Logbeat agent configuration for the agent to start collecting the logs. For example, if the log path for the IIS Web Server is "-C:\inetpub\logs\LogFiles\W3SVC1\", this path must be configured in the logbeat agent configuration. This path will contain both access logs and Error Logs. IIS Web Server should be configured to generate logs in W3C format. This format centralizes all URL logs for a session in a single log file and logs each field with a space. In Logging section windows ,select "W3C Extended Log File Format" as the log file format. Click OK.

Configuration Steps

  • Enable the IIS O11ySource.
  • Select the Sources tab and press the + button to add a new IIS host to be monitored.
  • Add the required details to configure metrics and logs. Then click on Next.
  • The following packages will be available for download:Download Windows Healthbeat Installation Binary - Downloads the full Healthbeat package with required configurations for a fresh installationDownload Windows Healthbeat Update Configuration Binary - Downloads the agent configuration package to update an existing Healthbeat installationDownload Windows Logbeat Installation Binary - Downloads the full Logbeat package with required configurations for a fresh installationDownload Windows Logbeat Update Configuration Binary - Downloads the agent configuration package to update an existing Logbeat installation
  • Download the agent installation or update package, then click Finish to close the data source window.

Metrics Collected

NameDescriptionData Type
@timestampThe timestamp in string format, likely when the event was logged.String
timestampThe timestamp in DateTime64 format for precise time logging.DateTime64
iis_webserver_process_cpu_usage_percPercentage of CPU usage by the IIS webserver process.Float64
iis_application_pool_process_cpu_usage_percPercentage of CPU usage by the IIS application pool process.Float64
iis_webserver_network_current_anonymous_usersThe current number of anonymous users accessing the webserver.UInt32
iis_webserver_network_current_non_anonymous_usersThe current number of authenticated (non-anonymous) users accessing the webserver.UInt32
iis_webserver_asp_net_application_restartsTotal number of ASP.NET application restarts.UInt32
iis_webserver_asp_net_request_wait_timeThe wait time for ASP.NET requests in the queue.UInt32
iis_webserver_asp_net_application_pipeline_instance_countNumber of ASP.NET pipeline instances for the application.Float64
iis_webserver_asp_net_application_errors_total_pecTotal number of errors in the ASP.NET application.Float64
iis_webserver_asp_net_application_requests_in_application_queueNumber of requests waiting in the ASP.NET application queue.Float64
iis_website_network_current_connectionsNumber of current connections to the website.UInt32
iis_website_network_maximum_connectionsMaximum number of connections to the website.UInt32
iis_website_network_bytes_received_per_secNumber of bytes received per second by the website.Float64
iis_website_network_bytes_sent_per_secNumber of bytes sent per second by the website.Float64
iis_website_nameThe name of the IIS website.String
beat_hostnameThe hostname of the machine sending the metric data.String
iis_application_pool_nameThe name of the IIS application pool.String
iis_application_pool_stateThe current state of the application pool (e.g., running, stopped).UInt32
iis_website_network_total_connection_attemptsTotal number of connection attempts made to the website.UInt32
iis_application_pool_worker_processesNumber of worker processes in the application pool.Float64
iis_webserver_network_get_requests_per_secNumber of GET requests received per second by the webserver.Float64
iis_application_pool_total_startup_failed_worker_processesTotal number of worker processes that failed to start in the application pool.Float64
iis_application_pool_total_ping_failed_worker_processesTotal number of worker processes that failed ping checks.Float64
iis_application_pool_total_failed_worker_processesTotal number of failed worker processes in the application pool.Float64
iis_application_pool_total_shutdown_failed_worker_processesTotal number of worker processes that failed during shutdown.Float64
iis_application_pool_total_application_pool_recyclesTotal number of application pool recycles (restarts).Float64
iis_application_pool_total_startup_failed_worker_processes_diffDifference in failed worker processes during startup since last check.Float64
iis_application_pool_total_ping_failed_worker_processes_diffDifference in failed worker processes due to ping failure since last check.Float64
iis_application_pool_total_failed_worker_processes_diffDifference in total failed worker processes since last check.Float64
iis_application_pool_total_shutdown_failed_worker_processes_diffDifference in failed worker processes during shutdown since last check.Float64
iis_application_pool_total_application_pool_recycles_diffDifference in the number of application pool recycles since last check.Float64
iis_application_pool_rejected_requestsTotal number of rejected requests in the application pool.Float64
iis_application_pool_current_queue_sizeThe current size of the application pool request queue.Float64
hostThe host from which the data is collected.String
targetThe target system or environment for the metric data.String
iis_webserver_network_post_requests_per_secNumber of POST requests received per second by the webserver.Float64
iis_webserver_network_put_requests_per_secNumber of PUT requests received per second by the webserver.Float64
iis_application_pool_uptimeThe uptime of the IIS application pool in seconds.Float64
iis_website_network_post_requests_per_secNumber of POST requests received per second by the website.UInt64
iis_website_network_put_requests_per_secNumber of PUT requests received per second by the website.UInt64
iis_website_network_get_requests_per_secNumber of GET requests received per second by the website.Float64
iis_website_network_service_uptimeThe uptime of the IIS website service in seconds.Float64
topic_nameThe topic or category associated with the metric data.String
metricset_nameThe name of the metric set being collected.String
iis_webserver_cache_current_file_cache_memory_usageThe amount of memory used by the current file cache in the webserver.UInt32
iis_webserver_cache_output_cache_current_memory_usageThe amount of memory used by the output cache in the webserver.UInt32
iis_webserver_network_total_non_anonymous_usersThe total number of non-anonymous users accessing the webserver.UInt32
iis_webserver_network_service_uptimeThe uptime of the webserver network service in seconds.Float64
iis_webserver_process_page_faults_per_secThe number of page faults per second in the IIS webserver process.Float64
iis_webserver_process_virtual_bytesThe amount of virtual memory used by the IIS webserver process.Float64
iis_webserver_process_handle_countThe number of handles used by the IIS webserver process.Float64
iis_webserver_process_working_setThe amount of physical memory used by the IIS webserver process.Float64
iis_webserver_process_io_write_operations_per_secThe number of I/O write operations per second in the IIS webserver process.Float64
iis_webserver_process_io_read_operations_per_secThe number of I/O read operations per second in the IIS webserver process.Float64
iis_webserver_asp_net_application_requests_executingThe number of ASP.NET application requests currently being executed.Float64
iis_webserver_asp_net_application_errors_total_per_secThe total number of ASP.NET application errors per second.Float64
iis_webserver_network_total_post_requestsThe total number of POST requests received by the webserver.Float64
iis_webserver_network_total_bytes_receivedThe total number of bytes received by the webserver.Float64
iis_webserver_network_total_anonymous_usersThe total number of anonymous users accessing the webserver.Float64
messageThe logged message or event details.String
timestampThe exact time when the event occurred, with high precision.DateTime64
hostThe hostname of the server where the event was logged.String
time_takenThe time taken to process the request, in milliseconds.UInt32
sc_statusThe HTTP status code returned by the server (e.g., 200, 404, 500).UInt16
cs_RefererThe URL of the referring web page that linked to the requested page.String
cs_methodThe HTTP method used for the request (e.g., GET, POST).String
cs_uri_stemThe URI of the requested resource on the server.String
c_ipThe IP address of the client making the request.String
cs_usernameThe username of the client (if authenticated) making the request.String
http-responseThe content of the HTTP response sent back to the client.String
hostnameThe specific server or machine where the event originated.String
targetThe target environment or application for the logged event.String
geo_city_nameThe name of the city from which the request originated.String
geo_country_nameThe name of the country from which the request originated.String
geo_timezoneThe timezone of the client's geographical location.String
s_ipThe server’s IP address responding to the request.String
s_portThe port on the server used for the response.String
sc_substatusThe substatus code for the HTTP response, providing more detailed status.UInt16
sc_win32_statusThe Win32 status code, which is specific to Windows systems.UInt16
EventTimeThe event timestamp for tracking when the event was recorded.DateTime64
doc_typeThe document or content type associated with the request (e.g., HTML, JSON).String
@timestampThe timestamp in string format, likely when the event was logged.String