---
title: "Host Template: Application - Active Directory - Security Accounts Manager"
description: ""
url: "https://docs.itrsgroup.com/docs/opsview/current/opspacks/application-microsoft-active-directory-opspack/application-active-directory-security-accounts-manager-host-template/index.html"
---## Overview

Monitor an Active Directory Security Accounts Manager

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 - SAM - Reads/Writes | Shows the percentage of reads performed by the Security Authentication Server (SAM) on the directory. | N/A | % |
| Active Directory - SAM - Successful Computer Creations | Shows the number of successful computer accounts created per second. | N/A | per_second |
| Active Directory - SAM - Machine Creation Attempts Rate | Shows the number of attempts per second to create computer accounts. | N/A | per_second |
| Active Directory - SAM - Password Changes Rate | Shows the number of Security Authentication Manager (SAM) password changes per second. | N/A | per_second |
| Active Directory - SAM - Successful User Creations Rate | Shows the number of user accounts successfully created per second. | N/A | per_second |
| Active Directory - SAM - Global Catalog Evaluations Rate | Shows the number of universal group membership evaluations per second on a global catalog domain controller from non-global catalog domain controllers | N/A | per_second |
| Active Directory - SAM - User Creation Attempts Rate | Shows the number of attempts per second to create user accounts. | N/A | per_second |


**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/current/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 - Security Accounts Manager** 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/current/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/current/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-security-accounts-manager.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/current/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 - SAM - Reads/Writes | `AD.SAM.ReadsWrites` |
| Active Directory - SAM - Successful Computer Creations | `AD.SAM.ComputerCreationsRate` |
| Active Directory - SAM - Machine Creation Attempts Rate | `AD.SAM.MachineCreationAttemptsRate` |
| Active Directory - SAM - Password Changes Rate | `AD.SAM.PasswordChangesRate` |
| Active Directory - SAM - Successful User Creations Rate | `AD.SAM.UserCreationsRate` |
| Active Directory - SAM - Global Catalog Evaluations Rate | `AD.SAM.GlobalCatalogEvaluationsRate` |
| Active Directory - SAM - User Creation Attempts Rate | `AD.SAM.UserCreationAttemptsRate` |


