117
systemctl

Returns a list of the units, whether they are loaded, active, their sub and description.

systemctl is-failed

Returns a list of status only.

What is the syntax to return the details of the failed units?

Tai Paul
  • 1,281
  • 2
  • 8
  • 7

2 Answers2

189

You can use systemctl list-units --state=failed to list all failed units.

The parameters for systemctl are documented in the man page systemctl(1).

Patrick Mevzek
  • 3,130
  • 2
  • 20
  • 30
cg909
  • 6,908
  • 1
  • 27
  • 30
  • 42
    `--failed` is an alias for `--state=failed` – sshow Aug 02 '17 at 14:57
  • 6
    Yes thats right, but until 2017-02-02 `--failed` wasn't documented and marked as deprecated in the codebase ([#5198](https://github.com/systemd/systemd/pull/5198)) – cg909 Aug 02 '17 at 19:08
  • 13
    I see. And from the PR discussion I learned that we can drop `list-units` and go with `systemctl --failed` by itself :) – sshow Aug 02 '17 at 20:22
  • 11
    I find it very irritating that `systemctl status` tells me the one+ things are failed, but wont tell me what. I need to run another command, not under the `status` subcommand to find out. Shame. – Nathan Lilienthal Jun 22 '18 at 03:02
  • @NathanLilienthal request a change from the systemd folks. They are quite opinionated on "the one right way of doing things", though. – vonbrand Feb 25 '20 at 15:12
29

This is more simple:

systemctl --failed

Player1
  • 403
  • 4
  • 5