﻿---
title: IIS module
description: IIS (Internet Information Services) is a secure, reliable, and scalable Web server that provides an easy to manage platform for developing and hosting...
url: https://www.elastic.co/elastic/docs-builder/docs/2967/reference/beats/metricbeat/metricbeat-module-iis
products:
  - Beats
  - Metricbeat
applies_to:
  - Elastic Cloud Serverless: Generally available
  - Elastic Stack: Generally available
---

# IIS module
<admonition title="Prefer to use Elastic Agent for this use case?">
  Refer to the [Elastic Integrations documentation](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2967/reference/iis).
  <dropdown title="Learn more">
    Elastic Agent is a single, unified way to add monitoring for logs, metrics, and other types of data to a host. It can also protect hosts from security threats, query data from operating systems, forward data from remote services or hardware, and more. Refer to the documentation for a detailed [comparison of Beats and Elastic Agent](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2967/reference/fleet).
  </dropdown>
</admonition>

IIS (Internet Information Services) is a secure, reliable, and scalable Web server that provides an easy to manage platform for developing and hosting Web applications and services.
The `iis` module will periodically retrieve IIS related metrics using performance counters such as:
- System/Process counters like the the overall server and CPU usage for the IIS Worker Process and memory (currently used and available memory for the IIS Worker Process).
- IIS performance counters like Web Service: Bytes Received/Sec, Web Service: Bytes Sent/Sec, etc, which are helpful to track to identify potential spikes in traffic.
- Web Service Cache counters in order to monitor user mode cache and output cache.

The `iis` module metricsets are `webserver`, `website` and `application_pool`.
```yaml
- module: iis
  metricsets:
    - webserver
    - website
    - application_pool
  enabled: true
  period: 10s

 # filter on application pool names
 # application_pool.name: []
```


## Metricsets


### `webserver`

A light metricset using the windows perfmon metricset as the base metricset. This metricset allows users to retrieve aggregated metrics for the entire webserver,

### `website`

A light metricset using the windows perfmon metricset as the base metricset. This metricset will collect metrics of specific sites, users can configure which websites they want to monitor, else, all are considered.

### `application_pool`

This metricset will collect metrics of specific application pools, users can configure which websites they want to monitor, else, all are considered.

### Module-specific configuration notes

<definitions>
  <definition term="application_pool.name">
    []string, users can specify the application pools they would like to monitor.
  </definition>
</definitions>


## Example configuration

The IIS module supports the standard configuration options that are described in [Modules](https://www.elastic.co/elastic/docs-builder/docs/2967/reference/beats/metricbeat/configuration-metricbeat). Here is an example configuration:
```yaml
metricbeat.modules:
- module: iis
  metricsets:
    - webserver
    - website
    - application_pool
  enabled: true
  period: 10s

 # filter on application pool names
 # application_pool.name: []
```


## Metricsets

The following metricsets are available:
- [application_pool](https://www.elastic.co/elastic/docs-builder/docs/2967/reference/beats/metricbeat/metricbeat-metricset-iis-application_pool)
- [webserver](https://www.elastic.co/elastic/docs-builder/docs/2967/reference/beats/metricbeat/metricbeat-metricset-iis-webserver)
- [website](https://www.elastic.co/elastic/docs-builder/docs/2967/reference/beats/metricbeat/metricbeat-metricset-iis-website)