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

Monitor performance metrics for an Active Directory Database

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 - Database - Disk Usage | Shows the database disk usage where the Active Directory Database is stored | database_disk_usage: &#8203;`70`,`90` | % |
| Active Directory - Database - Disk Operational Status | Shows the operational status of the storage device where the Active Directory Database is stored | N/A | N/A |
| Active Directory - Database - Disk Health Status | Shows the health status of the storage device where the Active Directory Database is stored | N/A | N/A |
| Active Directory - Database - File Size | Shows the size of the Active Directory database file in bytes | N/A | B |


**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 - Database** 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-database.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 - Database - Disk Usage | `AD.Database.DiskUsage` |
| Active Directory - Database - Disk Operational Status | `AD.Database.OperationalStatus` |
| Active Directory - Database - Disk Health Status | `AD.Database.HealthStatus` |
| Active Directory - Database - File Size | `AD.Database.FileSize` |


