---
title: ASP.NET
description: Track your ASP.NET service metrics in real time
breadcrumbs: Docs > Integrations > ASP.NET
---

# ASP.NET
Supported OS Integration version4.6.0
## Overview{% #overview %}

Get metrics from ASP.NET in real time to:

- Visualize and monitor ASP.NET states.
- Be notified about ASP.NET failovers and events.

**Minimum Agent version:** 6.6.0

## Setup{% #setup %}

### Installation{% #installation %}

The ASP.NET check is included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package, so you don't need to install anything else on your servers.

### Configuration{% #configuration %}

1. Edit the `aspdotnet.d/conf.yaml` file, in the `conf.d/` folder at the root of your [Agent's configuration directory](https://docs.datadoghq.com/agent/guide/agent-configuration-files/#agent-configuration-directory) to start collecting your ASP.NET performance data. See the [sample aspdotnet.d/conf.yaml](https://github.com/DataDog/integrations-core/blob/master/aspdotnet/datadog_checks/aspdotnet/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands/#start-stop-and-restart-the-agent)

**Note**: Versions 1.9.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](https://github.com/DataDog/integrations-core/blob/7.33.x/aspdotnet/datadog_checks/aspdotnet/data/conf.yaml.example).

#### Log collection{% #log-collection %}

ASP.NET uses IIS logging. Follow the [setup instructions for IIS](https://docs.datadoghq.com/integrations/iis/?tab=host#setup) in order to view logs related to ASP.NET requests and failures.

Unhandled 500 level exceptions and events related to your ASP.NET application can be viewed with the Windows Application EventLog.

### Validation{% #validation %}

[Run the Agent's `status` subcommand](https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) and look for `aspdotnet` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **aspdotnet.application\_restarts**(gauge)                        | Shows the number of times the application has been restarted during the Web server's lifetime. |
| **aspdotnet.applications.forms\_authentication.failure**(gauge)   | Number of failed access requests made*Shown as request*                                        |
| **aspdotnet.applications.forms\_authentication.successes**(gauge) | Number of successful access requests made*Shown as request*                                    |
| **aspdotnet.applications.requests.executing**(gauge)              | Shows the number of requests currently executing.*Shown as request*                            |
| **aspdotnet.applications.requests.in\_queue**(gauge)              | Shows the number of requests in the application request queue.*Shown as request*               |
| **aspdotnet.applications.requests.persec**(gauge)                 | Shows the number of requests executed per second.*Shown as request*                            |
| **aspdotnet.request.wait\_time**(gauge)                           | Shows the number of ms the most recent request was waiting in the queue.*Shown as millisecond* |
| **aspdotnet.worker\_process\_restarts**(gauge)                    | Shows the number of times a worker process has restarted on the computer.                      |

### Events{% #events %}

The ASP.NET check does not include any events.

### Service Checks{% #service-checks %}

The ASP.NET check does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).