Skip to content

Check podman-info

Overview

Displays system-wide Podman information including container counts, image count, storage driver, runtime version, available CPUs, and total memory. For Docker, use the docker-info check instead.

Important Notes:

  • Podman runs rootless by default. Without sudo, the check only sees containers of the executing user. To monitor containers across all users, run the check via sudo (the Icinga Director basket and sudoers file are pre-configured for this).

Data Collection:

  • Executes podman info --format json to collect system-wide Podman information
  • Parses container counts (running, paused, stopped), image count, storage driver, logging driver, registries, Podman version, CPU count, and total memory

Fact Sheet

Fact Value
Check Plugin Download https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/podman-info
Nagios/Icinga Check Name check_podman_info
Check Interval Recommendation Every day
Can be called without parameters Yes
Runs on Cross-platform
Compiled for Windows No

Help

usage: podman-info [-h] [-V] [--always-ok] [--ignore IGNORE] [--test TEST]

Displays system-wide Podman information including container counts, image
count, storage driver, runtime version, available CPUs, and total memory. Also
monitors the Podman daemon stderr for warnings and errors. Individual stderr
lines can be filtered out with --ignore (e.g. benign cgroup warnings on
rootless hosts). For Docker, use the docker-info check instead. Requires root
or sudo.

options:
  -h, --help       show this help message and exit
  -V, --version    show program's version number and exit
  --always-ok      Always returns OK.
  --ignore IGNORE  Ignore stderr lines matching this Python regular
                   expression. Case-sensitive by default; use `(?i)` for case-
                   insensitive matching. Can be specified multiple times.
                   Example: `--ignore="cgroup v1"` to suppress a benign
                   cgroup-version warning on hosts that have not yet migrated
                   to cgroup v2. Example: `--ignore="(?i)rootless"` (case-
                   insensitive) to suppress any rootless-related informational
                   warning. Default: None
  --test TEST      For unit tests. Needs "path-to-stdout-file,path-to-stderr-
                   file,expected-retc".

Usage Examples

./podman-info

Output:

2 Containers (1 running, 0 paused, 1 stopped), 1055 Images, Storage Driver: overlay, Logging Driver: journald, 3 Registries, Podman v5.8.1, 8 CPUs, 30.9GiB Memory

States

  • OK if podman info completes without warnings or errors.
  • WARN on podman info warnings in stderr.
  • CRIT on podman info errors in stderr or return codes != 0.
  • --always-ok suppresses all alerts and always returns OK.

Perfdata / Metrics

Name Type Description
containers Number Number of containers.
containers_paused Number Number of paused containers.
containers_running Number Number of running containers.
containers_stopped Number Number of stopped containers.
cpu Number Number of host CPUs.
images Number Number of images.
ram Bytes Total host memory.

Credits, License