Docker Container Check Reference

Configuration options for the Docker Container Check

Written By Erdinc Akay

Last updated About 1 month ago

Docker Container Check Reference

The Docker Container Check monitors Docker containers on the target device and alerts on stopped containers, unhealthy status, and excessive restarts.

Configuration fields

FieldTypeRequiredDefaultDescription
Monitor all containersBooleanNoYesMonitor every container on the host. When enabled, the Excluded containers list is applied as a blacklist filter.
Container namesList of stringsNo—Specific container names to monitor (matched by name only, not by container ID). Supports wildcards: * matches any characters, ? matches a single character (e.g. web-*). Only shown when Monitor all containers is off.
Excluded containersList of stringsNo—Container names to exclude from monitoring when Monitor all containers is enabled. Supports the same wildcards (*, ?). Only shown when Monitor all containers is on.
Warn on stopped containersBooleanNoYesWarning when a container is not running
Critical on stopped containersBooleanNoNoCritical when a container is not running
Warn on unhealthy containersBooleanNoYesWarning when a container's health check fails
Max restart countIntegerNo5Warning when a container's restart count exceeds this value

Collected metrics

  • Container name
  • Image
  • Container status (the raw Docker state, e.g. running, paused, restarting, exited)
  • Health status (healthy / unhealthy — only shown for containers with a health check)
  • Restart count
  • Total container count

Platform support

PlatformSupported
WindowsYes
LinuxYes
macOSYes (Docker Desktop)

Notes

  • The check invokes the docker CLI. The docker executable must be on the agent's PATH and the agent's account must be allowed to run it (on Linux this typically means membership in the docker group; on Windows it means Docker Desktop CLI access).
  • Containers without a configured health check do not show a health status in the result view.
  • The restart count is cumulative since the container was created, not since the last check run.
  • If no containers match (empty Docker host, or the filter excludes everything), the check returns Warning with a total container count of 0.
  • If the docker command itself fails (not installed, not reachable), the check returns Warning.
  • The check runs on a fixed interval of 5 minutes; the interval is not a configurable field in the check editor.

See also: Configure a Docker Container Check