Skip to main content
Databases & applications

DHCP Scope Utilization

Get warned before an IPv4 scope on your Windows DHCP server runs out of free addresses.

The DHCP Scope Utilization check monitors how full the address pools of the IPv4 scopes on a Windows DHCP server are. It warns before a scope runs out of free addresses and new clients can no longer get an IP address. The check runs on Windows only (x64 and Arm64), on the agent of the DHCP server itself, every 30 minutes by default. The interval is not user-configurable.

Prerequisites

  • The device is a Windows server with the DHCP Server role installed and a connected octoja agent.

Steps

  1. Open the DHCP server's device page.
  2. On the Checks tab, click Add Check → DHCP Scope Utilization.

To roll the check out to several servers, use a config package: Assign checks with config packages.

Settings

FieldTypeRequiredDefaultDescription
Warning utilization (%)NumberNo85Address pool utilization at or above which a scope is Warning
Error utilization (%)NumberNo95Address pool utilization at or above which a scope is Critical

If Warning utilization (%) is greater than Error utilization (%), the check swaps the two values before evaluation.

The check evaluates IPv4 scopes only, and always every scope on the server. Individual scopes cannot be excluded.

Results

Each IPv4 scope is graded on its own, using the utilization the DHCP server reports (rounded to one decimal place). The overall result is the worst result across all scopes.

Result per scopeCondition
OKUtilization below Warning utilization (%)
WarningUtilization at or above Warning utilization (%)
CriticalUtilization at or above Error utilization (%)

If the check cannot grade any scopes, it reports one of these instead:

MessageResultMeaning
No IPv4 scopes foundWarningThe DHCP server reported no IPv4 scopes.
DHCP Server role / cmdlets not availableWarningThe DHCP Server role or its PowerShell commands are missing on the device.
DHCP query failedWarningQuerying the scope statistics stopped with an error. The error message from Windows is shown with it.
Only runs on WindowsWarningThe check was assigned to a device that does not run Windows.

If an unexpected error occurs, the check reports Failure.

Collected values

  • Scope ID (the scope's network address)
  • Utilization in percent
  • Addresses in use and free

Was this helpful?

Still need help? Ask the team