IIS App Pool Reference

All parameters and configuration options for the IIS App Pool check in octoja.

Written By Erdinc Akay

Last updated About 2 months ago

IIS App Pool Reference

The IIS App Pool check monitors the status of IIS application pools and alerts when pools are stopped.

Configuration fields

FieldTypeRequiredDefaultDescription
Monitor all application poolsBooleanNoYesCheck all IIS application pools on this server
Application pools to monitorList of stringsNo—Specific application pool names to monitor (shown when Monitor all application pools is off)
Warning on stopped poolsBooleanNoYesReport a warning when an application pool is stopped
Critical on stopped poolsBooleanNoNoReport a critical error when an application pool is stopped. Overrides Warning on stopped pools when both are enabled.

Collected metrics

  • Total application pools evaluated
  • Name of each stopped application pool
  • State of each stopped application pool
  • Per-pool result severity (Success, Warning, or Critical)

Only stopped pools are reported in the result; running pools contribute to the total count but are not enumerated individually.

Result behavior

SituationResult
appcmd.exe not found on the serverWarning
Querying appcmd.exe failsFailure
No application pools found, or none of the listed pool names matchWarning
A pool is stoppedWarning or Critical, per the severity settings

If Monitor all application pools is off but the pool list is left empty, the filter is skipped and all application pools are checked.

Platform support

PlatformSupported
Windows (IIS)Yes
LinuxNo
macOSNo

Notes

  • Requires IIS with appcmd.exe available at %WINDIR%\system32\inetsrv\appcmd.exe; the check shells out to it and parses the XML output.
  • The check inspects the status at execution time. An application pool that briefly stopped for a recycle and restarted will show as started.
  • The check runs every 5 minutes on the agent. The interval is not user-configurable.

See also: Configure the IIS App Pool Check