systemd

Reference for the `systemd` collector.

systemd · collector · run nanook doc systemd for the same content in your terminal.

Tracks systemd unit ActiveState and SubState via the system DBus.

Options

Option	Type	Default	Description
`units`	string	required	list of unit names to monitor (e.g. `["nginx.service", "sshd.service"]`)

Metrics

Metric	Kind	Unit	Description
`systemd.active`	bool	—	true when the unit's ActiveState is `active`. Labels: `unit`.
`systemd.state`	enum	—	ActiveState as a labelled enum. Labels: `unit`.
`systemd.sub_state`	enum	—	SubState as a labelled enum. Labels: `unit`.

Examples

Watch a single unit

[[collectors]]
name = "nginx"
kind = "systemd"
interval = 30
[collectors.opts]
units = ["nginx.service"]

Alert when a service stops being active

[[alerts]]
expr = 'nginx::systemd.active == 0'
count = 1
channel = "ops"

Multiple units in one collector

[[collectors]]
name = "core"
kind = "systemd"
[collectors.opts]
units = ["sshd.service", "nginx.service", "postgresql.service"]

[[alerts]]
expr = 'core::systemd.state is "failed"'
count = 1
channel = "ops"