---
title: .NET CLR
description: Visualize and monitor Dotnetclr states
breadcrumbs: Docs > Integrations > .NET CLR
---

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

Get metrics from the .NET CLR service in real time to:

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

**Minimum Agent version:** 6.2.0

## Setup{% #setup %}

### Installation{% #installation %}

The .NET CLR check is included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package. No additional installation is needed on your server.

### Configuration{% #configuration %}

1. Edit the `dotnetclr.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.md#agent-configuration-directory) to start collecting your .NET CLR performance data. See the [sample dotnetclr.d/conf.yaml](https://github.com/DataDog/integrations-core/blob/master/dotnetclr/datadog_checks/dotnetclr/data/conf.yaml.example) for all available configuration options.
1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent).

**Note**: Versions 1.10.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/dotnetclr/datadog_checks/dotnetclr/data/conf.yaml.example).

## Validation{% #validation %}

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

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

### Metrics{% #metrics %}

|  |
|  |
| **dotnetclr.exceptions.thrown\_persec**(gauge)    | The number of exceptions thrown per second.*Shown as occurrence* |
| **dotnetclr.memory.committed.heap\_bytes**(gauge) | The number of total committed bytes.*Shown as byte*              |
| **dotnetclr.memory.reserved.heap\_bytes**(gauge)  | The number of total reserved bytes.*Shown as byte*               |
| **dotnetclr.memory.time\_in\_gc**(gauge)          | The percent of time in garbage collection.*Shown as percent*     |

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

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

### Events{% #events %}

The .NET CLR check does not include any events.

## Troubleshooting{% #troubleshooting %}

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