---
title: "Host Template: Application - Active Directory - Services"
description: ""
url: "https://docs.itrsgroup.com/docs/opsview/6.11.7/opspacks/application-microsoft-active-directory-opspack/application-active-directory-services-host-template/index.html"
---## Overview

Monitor performance metrics for Active Directory services

This Host Template includes the following Service Checks:

| Service&nbsp;Check&nbsp;Name | Description | Default&nbsp;Thresholds (Metric:&nbsp;Warning,&nbsp;Critical) | UOM |
|:-----------------------------|:------------|:------------------------------------------------:|:---:|
| Active Directory - Services - DS Client Binds Rate | Shows the number of Ntdsapi.dll binds per second serviced by this domain controller. | N/A | per_second |
| Active Directory - Services - DS Directory I/O Rate | Shows the number of directory reads/writes per second. | N/A | per_second |
| Active Directory - Services - DS Directory Searches | Shows the number of directory searches per second. | N/A | per_second |
| Active Directory - Services - LDAP Bind Time | Shows the time, in milliseconds, taken for the last successful LDAP bind. | N/A | ms |
| Active Directory - Services - LDAP Client Sessions | Shows the number of currently connected LDAP client sessions. | N/A | N/A |
| Active Directory - Services - LDAP Searches | Shows the percentage of directory searches coming from LDAP. | N/A | % |
| Active Directory - Services - LDAP Searches Rate | Shows the rate at which LDAP clients perform search operations | N/A | per_second |
| Active Directory - Services - LDAP Successful Binds Rate | Shows the number of LDAP binds per second. | N/A | per_second |
| Active Directory - Services - LDAP Writes | Shows the percentage of directory writes coming from LDAP. | N/A | % |
| Active Directory - Services - LDAP Writes Rate | Shows the rate at which LDAP clients perform write operations. | N/A | per_second |
| Active Directory - Services - Knowledge Consistency | Shows the percentage of reads performed by the Knowledge Consistency Checker (KCC) on the directory. | N/A | % |
| Active Directory - Services - Local Security Authority | Shows the percentage of reads performed by the Local Security Authority (LSA) on the directory. | N/A | % |
| Active Directory - Services - Name Service Provider Interface | Shows the percentage of reads performed by the Name Service Provider Interface (NSPI) on the directory. | N/A | % |
| Active Directory - Services - AD Services Status | Shows the status of the services running on the AD server. | N/A | N/A |


**Note**


See details about [Monitoring Plugin thresholds here](https://www.monitoring-plugins.org/doc/guidelines.html#THRESHOLDFORMAT).



## Usage Instructions

Please review the overall [Application - Microsoft Active Directory Opspack](https://docs.itrsgroup.com/docs/opsview/6.11.7/opspacks/application-microsoft-active-directory-opspack/application-microsoft-active-directory-opspack/index.html) documentation for details on prerequisites, known issues, and other necessary configurations that apply to all Host Templates in the Opspack.

### Add this Host Template

Add the **Application - Active Directory - Services** Host Template to your Opsview Monitor host.
If the resource you're monitoring has no hostname or public IP, then open the **Advanced** settings pane and change **Host Check Command** to **Always assumed to be UP**.


**Note**


For more information, refer to the documentation on [Adding Host Templates to Hosts](https://docs.itrsgroup.com/docs/opsview/6.11.7/host/index.html#host-templates).



### Add and configure Variables

The Service Checks in this Host Template use the following variables, and they will be added to your Opsview Monitor instance alongside the Host Template:

- [**AD_CREDENTIALS**](#ad_credentials)


**Note**


For more information, refer to the documentation on [Adding Variables to Hosts](https://docs.itrsgroup.com/docs/opsview/6.11.7/adding-a-new-variable/index.html#adding-a-variable-to-a-host).



### Apply Changes

Apply Changes and the system will now be monitored:

![View Output](https://docscdn.itrsgroup.com/opsview/images/opspacks-application-microsoft-active-directory-output-application-active-directory-services.png)

## Available Variables

### KERBEROS_REALM

Only required if authenticating using Kerberos. If Kerberos authentication is not working add a **default_realm** value in the krb5.conf file located in '/opt/opsview/krb5/etc/'

| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| N/A | Value | Kerberos Realm | Kerberos realm. This value is not used by the plugin, it is used to automatically configure your 'krb5.conf' configuration file |
| N/A | Arg1 | KDC 1 | Kerberos realm. This value is not used by the plugin, it is used to automatically configure your 'krb5.conf' configuration file |
| N/A | Arg2 | KDC 2 | Kerberos realm. This value is not used by the plugin, it is used to automatically configure your 'krb5.conf' configuration file |
| N/A | Arg3 | KDC 3 | Kerberos realm. This value is not used by the plugin, it is used to automatically configure your 'krb5.conf' configuration file |
| N/A | Arg4 | KDC 4 | Kerberos realm. This value is not used by the plugin, it is used to automatically configure your 'krb5.conf' configuration file |

### AD_CREDENTIALS

| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| `-Username` | Arg1 | Username | Username for remote windows host e.g user@DOMAIN.COM |
| `-Password` | Arg2 | Password | Password for remote windows host |
| `-Authentication` | Arg3 | Authentication Type | Authentication type to use |

## Plugin help

Plugin: `check_active_directory`


**Secure Args**


This plugin uses the [Secure Args](https://docs.itrsgroup.com/docs/opsview/6.11.7/configuration/secure-arguments/index.html) feature for argument passing.



For mode-specific help, run the plugin with the `-h -m <mode>` flags. This will list the required and optional Variable Arguments for that mode.
The appropriate mode for each Service Check is listed here:

| Service&nbsp;Check&nbsp;Name | Mode |
|:-----------------------------|:-----|
| Active Directory - Services - DS Client Binds Rate | `AD.Services.ClientBindsRate` |
| Active Directory - Services - DS Directory I/O Rate | `AD.Services.DirectoryIORate` |
| Active Directory - Services - DS Directory Searches | `AD.Services.DirectorySearches` |
| Active Directory - Services - LDAP Bind Time | `AD.Services.LDAPBindTime` |
| Active Directory - Services - LDAP Client Sessions | `AD.Services.LDAPClientSessions` |
| Active Directory - Services - LDAP Searches | `AD.Services.LDAPSearches` |
| Active Directory - Services - LDAP Searches Rate | `AD.Services.LDAPSearchesRate` |
| Active Directory - Services - LDAP Successful Binds Rate | `AD.Services.LDAPSuccessfulBindsRate` |
| Active Directory - Services - LDAP Writes | `AD.Services.LDAPWrites` |
| Active Directory - Services - LDAP Writes Rate | `AD.Services.LDAPWritesRate` |
| Active Directory - Services - Knowledge Consistency | `AD.Services.KC.IO` |
| Active Directory - Services - Local Security Authority | `AD.Services.LSA.IO` |
| Active Directory - Services - Name Service Provider Interface | `AD.Services.NSPI.IO` |
| Active Directory - Services - AD Services Status | `AD.Services.ADWS` |


