Active Directory Integration

Overview

Get metrics and logs from Microsoft Active Directory to visualize and monitor its performances.

Setup

Installation

The Agent's Active Directory check is included in the Datadog Agent package, so you don't need to install anything else on your servers.

If installing the Datadog Agent on a domain environment, see the installation requirements for the Agent

Configuration

Metric collection

1. Edit the active_directory.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory to start collecting your Active Directory performance data. The default setup should already collect metrics for the localhost. See the sample active_directory.d/conf.yaml for all available configuration options.

2. Restart the Agent

Log collection

Available for Agent versions >6.0

1. Collecting logs is disabled by default in the Datadog Agent, you need to enable it in datadog.yaml:

   logs_enabled: true

2. Add this configuration block to your active_directory.d/conf.yaml file to start collecting your Active Directory Logs:

   logs:
     - type: file
       path: /path/to/my/directory/file.log
       source: ruby
       service: "<MY_SERVICE>"

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

3. This integration is intended for the Active Directory Module for Ruby. If you are not using the Ruby module, change the below source value to active_directory and configure the path for your environment.

4. Restart the Agent.

Validation

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

Data Collected

Metrics

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

Events

The Active Directory check does not include any events.

Service Checks

The Active Directory check does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.