For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/aspdotnet.md. A documentation index is available at /llms.txt.

ASP.NET

Supported OS Windows

Integration version4.6.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

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

Installation

The ASP.NET check is included in the Datadog Agent package, so you don’t need to install anything else on your servers.

Configuration

  1. Edit the aspdotnet.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your ASP.NET performance data. See the sample aspdotnet.d/conf.yaml for all available configuration options.

  2. 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.

Log collection

ASP.NET uses IIS logging. Follow the setup instructions for IIS 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

Run the Agent’s status subcommand and look for aspdotnet under the Checks section.

Data Collected

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

The ASP.NET check does not include any events.

Service Checks

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

Troubleshooting

Need help? Contact Datadog support.