Use this Knowledge Script to monitor the queue length for unprocessed Active Directory replication synchronization requests. This script helps you to determine if replication synchronization requests are processed in a timely manner. In addition, this script raises an event if the unprocessed replication request queue length exceeds the threshold you set.
Replication queue length is a corollary indicator that replication is falling behind. It is standard to see one queue entry per partition. If this standard is exceeded, you should find out why replication is falling behind. Common causes include:
The replication interval is too slow.
A WAN link is down.
A bridge is down (indicating a bridgehead server problem).
It is common for a bridgehead server to have many replication partners.
HINT:When setting a threshold value for the Maximum unprocessed requests in the queue parameter, try counting the number of partitions you have, add 2 (one for the schema partition and one for the configuration partition), then double the number and use the result as your threshold value.
This script gathers the following Windows performance counter values for use in data collection and threshold monitoring:
|
Performance Objects |
Counter |
|---|---|
|
NTDS DirectoryServices |
DRA Pending Replication Synchronizations |
Active Directory domain controller
The default interval for this script is Every hour.
Set the following parameters as needed:
|
Parameter |
How to Set It |
|---|---|
|
General Settings |
|
|
Raise event if job fails |
|
|
Event severity when job fails |
Set the severity level, from 1 to 40, to indicate the importance of an event in which the ReplQueueLen job fails. The default is 35. |
|
Monitor replication synchronization request queue |
|
|
Event Notification |
|
|
Raise event if queue length exceeds threshold? |
Select Yes to raise an event if the length of the replication queue exceeds the threshold you set. The default is Yes. |
|
Threshold -- Maximum unprocessed requests in queue |
Specify the maximum number of replication synchronization requests that can be pending in the queue before an event is raised. The default is 12 queued requests. |
|
Event severity when queue length exceeds threshold |
Set the severity level, from 1 to 40, to indicate the importance of an event in which the length of the replication queue exceeds the threshold. The default is 20. |
|
Data Collection |
|
|
Collect data for replication request queue length? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the number of pending synchronization requests. The default is unselected. |