IIS Integration

Overview

Collect IIS metrics aggregated across all of your sites, or on a per-site basis. The IIS Agent check collects metrics for active connections, bytes sent and received, request count by HTTP method, and more. It also sends a service check for each site, letting you know whether it's up or down.

Setup

Installation

The IIS check is packaged with the Agent. To start gathering your IIS metrics and logs, install the Agent on your IIS servers.

Host

To configure this check for an Agent running on a host:

Metric collection

1. Edit the iis.d/conf.yaml file in the Agent's conf.d directory at the root of your Agent's configuration directory to start collecting your IIS site data. See the sample iis.d/conf.yaml for all available configuration options.

2. Restart the Agent to begin sending IIS metrics to Datadog.

Note: Versions 2.14.0 or later of this check use a new implementation for metric collection, which requires Python 3. For hosts that are unable to use Python 3, or if you would like to use a legacy version of this check, refer to the following config.

Log collection

1. Collecting logs is disabled by default in the Datadog Agent, enable it in your datadog.yaml file:

   logs_enabled: true

2. Add this configuration block to your iis.d/conf.yaml file to start collecting your IIS Logs:

   logs:
     - type: file
       path: C:\inetpub\logs\LogFiles\W3SVC1\u_ex*
       service: myservice
       source: iis

   Change the path and service parameter values and configure them for your environment. See the sample iis.d/conf.yaml for all available configuration options.

3. Restart the Agent.

Note: Ensure the datadog-agent user has read access to tail the log files you want to collect from. See Permission issues tailing log files for more information.

Validation

Run the Agent's status subcommand and look for iis under the Checks section.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

Events

The IIS check does not include any events.

Service Checks

See service_checks.json for a list of service checks provided by this integration.

Troubleshooting

Need help? Contact Datadog support.