systemctl-is-failed

Check for any failed units

$ systemctl is-failed

$ systemctl is-failed unit_name

$ systemctl is-failed unit1 unit2

$ systemctl is-failed -q unit_name

$ systemctl is-failed --user unit_name

systemctl is-failed [OPTIONS] [PATTERN...]

systemctl is-failed checks if one or more systemd units have failed. It returns exit code 0 if any specified unit is in a failed state, useful for scripting and monitoring.

PATTERN

Unit names or patterns to check (checks all units if omitted)

Suppress output, only return exit code

Check user units instead of system units

Exit code 0 means at least one unit is failed; non-zero means no failures or unit not found. Without arguments, checks all units and returns 0 if any are failed.

systemctl is-failed is part of systemd, providing status checking commands for scripting and automation.

systemctl(1), systemctl-is-active(1), systemctl-status(1)