IIS

Microsoft IIS collector

Configuration¶

Preconditions¶

Operating system requirements::

Windows Vista and above (excluding Windows Vista)
Windows Server 2008 R2 and above

Collector Configuration¶

Go to the conf.d/samples directory under the DataKit installation directory, copy iis.conf.sample and name it iis.conf. Examples are as follows:

[[inputs.iis]]
  ## (optional) collect interval, default is 15 seconds
  interval = '15s'
  ##

  [inputs.iis.log]
    files = []
    ## grok pipeline script path
    pipeline = "iis.p"

  [inputs.iis.tags]
    ## tag1 = "v1"
    ## tag2 = "v2"

After configuration, restart DataKit.

For all of the following data collections, a global tag named host is appended by default (the tag value is the host name of the DataKit), or other tags can be specified in the configuration by [inputs.iis.tags]:

  [inputs.iis.tags]
    # some_tag = "some_value"
    # more_tag = "some_other_value"
    # ...

Metric¶

`iis_app_pool_was`¶

Tags & Fields	Description
app_pool (`tag`)	IIS app pool
host (`tag`)	Host name
current_app_pool_state	The current status of the application pool (1 - Uninitialized, 2 - Initialized, 3 - Running, 4 - Disabling, 5 - Disabled, 6 - Shutdown Pending, 7 - Delete Pending). Type: float \| (gauge) Unit: -
current_app_pool_uptime	The uptime of the application pool since it was started. Type: float \| (gauge) Unit: time,s
total_app_pool_recycles	The number of times that the application pool has been recycled since Windows Process Activation Service (WAS) started. Type: float \| (gauge) Unit: -

`iis_web_service`¶

Tags & Fields	Description
host (`tag`)	Host name
website (`tag`)	IIS web site
anonymous_users	Rate at which users are making anonymous connections using the web service. Type: float \| (gauge) Unit: -
bytes_received	Rate at which bytes are received by the web service. Type: float \| (gauge) Unit: traffic,B/S
bytes_sent	Rate at which bytes are sent by the web service. Type: float \| (gauge) Unit: traffic,B/S
bytes_total	Sum of bytes_sent and bytes_received. This is the total rate of bytes transferred by the web service. Type: float \| (gauge) Unit: traffic,B/S
connection_attempts	Rate at which connections using the web service are attempted. Type: float \| (gauge) Unit: -
current_connections	Current number of connections established with the web service. Type: float \| (gauge) Unit: -
error_locked	Rate of errors due to requests that cannot be satisfied by the server because the requested document was locked. These are generally reported as an HTTP 423 error code to the client. Type: float \| (gauge) Unit: count
error_not_found	Rate of errors due to requests that cannot be satisfied by the server because the requested document could not be found. These errors are generally reported as an HTTP 404 error code to the client. Type: float \| (gauge) Unit: count
files_received	Rate at which files are received by the web service. Type: float \| (gauge) Unit: -
files_sent	Rate at which files are sent by the web service. Type: float \| (gauge) Unit: -
http_requests_delete	Rate at which HTTP requests using the DELETE method are made. Type: float \| (gauge) Unit: throughput,reqps
http_requests_get	Rate at which HTTP requests using the GET method are made. Type: float \| (gauge) Unit: throughput,reqps
http_requests_head	Rate at which HTTP requests using the HEAD method are made. Type: float \| (gauge) Unit: throughput,reqps
http_requests_options	Rate at which HTTP requests using the OPTIONS method are made. Type: float \| (gauge) Unit: throughput,reqps
http_requests_post	Rate at which HTTP requests using the POST method are made. Type: float \| (gauge) Unit: throughput,reqps
http_requests_put	Rate at which HTTP requests using the PUT method are made. Type: float \| (gauge) Unit: throughput,reqps
http_requests_trace	Rate at which HTTP requests using the TRACE method are made. Type: float \| (gauge) Unit: throughput,reqps
non_anonymous_users	Rate at which users are making non-anonymous connections using the web service. Type: float \| (gauge) Unit: -
requests_cgi	Rate of CGI requests that are simultaneously processed by the web service. Type: float \| (gauge) Unit: throughput,reqps
requests_isapi_extension	Rate of ISAPI extension requests that are simultaneously processed by the web service. Type: float \| (gauge) Unit: throughput,reqps
service_uptime	Service uptime. Type: float \| (gauge) Unit: time,s
total_connection_attempts	Number of connections that have been attempted using the web service (counted after service startup) Type: float \| (gauge) Unit: count

Log¶

If you need to collect IIS logs, open the log-related configuration in the configuration, such as:

[inputs.iis.log]
    # Fill in the absolute path
    files = ["C:/inetpub/logs/LogFiles/W3SVC1/*"]

IIS