Systemd units state monitoring with Netdata

Systemd is a suite of basic building blocks for a Linux system.

This module monitors Systemd units state.

Requirements

• Works only on Linux systems.
• Disabled by default. Should be explicitly enabled in the go.d.conf:

modules:
  systemdunits: yes

Metrics

The unit types and states description can be found in the official documentation.

All metrics have "systemd." prefix.

Labels per scope:

• unit: unit_name.

Metric	Scope	Dimensions	Units
service_unit_state	unit	active, inactive, activating, deactivating, failed	state
socket_unit_state	unit	active, inactive, activating, deactivating, failed	state
target_unit_state	unit	active, inactive, activating, deactivating, failed	state
path_unit_state	unit	active, inactive, activating, deactivating, failed	state
device_unit_state	unit	active, inactive, activating, deactivating, failed	state
mount_unit_state	unit	active, inactive, activating, deactivating, failed	state
automount_unit_state	unit	active, inactive, activating, deactivating, failed	state
swap_unit_state	unit	active, inactive, activating, deactivating, failed	state
timer_unit_state	unit	active, inactive, activating, deactivating, failed	state
scope_unit_state	unit	active, inactive, activating, deactivating, failed	state
slice_unit_state	unit	active, inactive, activating, deactivating, failed	state

Configuration

Edit the go.d/systemdunits.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/systemdunits.conf

Needs only include option. Syntax is the shell file name pattern.

Here are some examples:

jobs:
  - name: my-specific-service-unit
    include:
      - 'my-specific.service'

  - name: service-units
    include:
      - '*.service'

  - name: socket-units
    include:
      - '*.socket'

For all available options, see the Systemdunits collector's configuration file.

Troubleshooting

To troubleshoot issues with the systemdunits collector, run the go.d.plugin with the debug option enabled. The output should give you clues as to why the collector isn't working.

• Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on your system, open netdata.conf and look for the plugins setting under [directories].

  cd /usr/libexec/netdata/plugins.d/

• Switch to the netdata user.

  sudo -u netdata -s

• Run the go.d.plugin to debug the collector:

  ./go.d.plugin -d -m systemdunits

Was this page helpful?

Let us know how we can do better:

Don't fill this out if you're human:

Contribute

• Join our community forum
• Learn how to contribute to Netdata's open-source project
• Submit a feature request