> ## Documentation Index
> Fetch the complete documentation index at: https://otel.fyi/llms.txt
> Use this file to discover all available pages before exploring further.

# Activedirectoryds

> OpenTelemetry receiver for Activedirectoryds

# Activedirectoryds Receiver

![Status](https://img.shields.io/badge/status-beta-yellow)

**Available in:** `contrib`

**Maintainers:** [@pjanotti](https://github.com/pjanotti)

**Source:** [opentelemetry-collector-contrib](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/activedirectorydsreceiver)

## Supported Telemetry

![Metrics](https://img.shields.io/badge/metrics-beta-green)

## Overview

## Configuration

The following settings are optional:

* `metrics` (default: see [`DefaultMetricsSettings`](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/activedirectorydsreceiver/internal/metadata/generated_metrics.go)): Allows enabling and disabling specific metrics from being collected in this receiver.
* `collection_interval` (default = `10s`): The interval at which metrics are emitted by this receiver.
* `initial_delay` (default = `1s`): defines how long this receiver waits before starting.

Example:

```yaml theme={null}
receivers:
  active_directory_ds:
    collection_interval: 10s
    metrics:
      # Disable the active_directory.ds.replication.network.io metric from being emitted
      active_directory.ds.replication.network.io:
        enabled: false
```

The full list of settings exposed for this receiver is documented in [config.go](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/activedirectorydsreceiver/config.go), along with detailed sample configurations [here](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/activedirectorydsreceiver/testdata/config.yaml).

## Metrics

Details about the metrics produced by this receiver can be found in [metadata.yaml](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/activedirectorydsreceiver/metadata.yaml)

## Metrics

| Metric Name                                                           | Description                                                                                                              | Unit               | Type          | Attributes                     |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------ | ------------- | ------------------------------ |
| ✅ `active_directory.ds.bind.rate`                                     | The number of binds per second serviced by this domain controller.                                                       | \{binds}/s         | UpDownCounter | bind\_type                     |
| ✅ `active_directory.ds.ldap.bind.last_successful.time`                | The amount of time taken for the last successful LDAP bind.                                                              | ms                 | Gauge         |                                |
| ✅ `active_directory.ds.ldap.bind.rate`                                | The number of successful LDAP binds per second.                                                                          | \{binds}/s         | UpDownCounter |                                |
| ✅ `active_directory.ds.ldap.client.session.count`                     | The number of connected LDAP client sessions.                                                                            | \{sessions}        | UpDownCounter |                                |
| ✅ `active_directory.ds.ldap.search.rate`                              | The number of LDAP searches per second.                                                                                  | \{searches}/s      | UpDownCounter |                                |
| ✅ `active_directory.ds.name_cache.hit_rate`                           | The percentage of directory object name component lookups that are satisfied by the Directory System Agent's name cache. | %                  | Gauge         |                                |
| ✅ `active_directory.ds.notification.queued`                           | The number of pending update notifications that have been queued to push to clients.                                     | \{notifications}   | UpDownCounter |                                |
| ✅ `active_directory.ds.operation.rate`                                | The number of operations performed per second.                                                                           | \{operations}/s    | UpDownCounter | operation\_type                |
| ✅ `active_directory.ds.replication.network.io`                        | The amount of network data transmitted by the Directory Replication Agent.                                               | By                 | Counter       | direction, network\_data\_type |
| ✅ `active_directory.ds.replication.object.rate`                       | The number of objects transmitted by the Directory Replication Agent per second.                                         | \{objects}/s       | UpDownCounter | direction                      |
| ✅ `active_directory.ds.replication.operation.pending`                 | The number of pending replication operations for the Directory Replication Agent.                                        | \{operations}      | UpDownCounter |                                |
| ✅ `active_directory.ds.replication.property.rate`                     | The number of properties transmitted by the Directory Replication Agent per second.                                      | \{properties}/s    | UpDownCounter | direction                      |
| ✅ `active_directory.ds.replication.sync.object.pending`               | The number of objects remaining until the full sync completes for the Directory Replication Agent.                       | \{objects}         | UpDownCounter |                                |
| ✅ `active_directory.ds.replication.sync.request.count`                | The number of sync requests made by the Directory Replication Agent.                                                     | \{requests}        | Counter       | sync\_result                   |
| ✅ `active_directory.ds.replication.value.rate`                        | The number of values transmitted by the Directory Replication Agent per second.                                          | \{values}/s        | UpDownCounter | direction, value\_type         |
| ✅ `active_directory.ds.security_descriptor_propagations_event.queued` | The number of security descriptor propagation events that are queued for processing.                                     | \{events}          | UpDownCounter |                                |
| ✅ `active_directory.ds.suboperation.rate`                             | The rate of sub-operations performed.                                                                                    | \{suboperations}/s | UpDownCounter | suboperation\_type             |
| ✅ `active_directory.ds.thread.count`                                  | The number of threads in use by the directory service.                                                                   | \{threads}         | UpDownCounter |                                |

## Attributes

| Attribute Name | Description                            | Type   | Values                                             |
| -------------- | -------------------------------------- | ------ | -------------------------------------------------- |
| `type`         | The type of bind to the domain server. | string | `server`, `client`                                 |
| `direction`    | The direction of data flow.            | string | `sent`, `received`                                 |
| `type`         | The type of network data sent.         | string | `compressed`, `uncompressed`                       |
| `type`         | The type of operation.                 | string | `read`, `write`, `search`                          |
| `type`         | The type of suboperation.              | string | `security_descriptor_propagations_event`, `search` |
| `result`       | The result status of the sync request. | string | `success`, `schema_mismatch`, `other`              |
| `type`         | The type of value sent.                | string | `distinguished_names`, `other`                     |

## Configuration

### Example Configuration

```yaml theme={null}
active_directory_ds:
  collection_interval: 2m
  metrics:
    active_directory.ds.replication.object.rate:
      enabled: false
active_directory_ds/defaults:
```

***

*Last generated: 2026-07-06*