systemd_units

Systemd-Units Input Plugin

This plugin gathers the status of systemd-units on Linux, using systemd's DBus interface.

Please note: At least systemd v230 is required!

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# Gather information about systemd-unit states
# This plugin ONLY supports Linux
[[inputs.systemd_units]]
  ## Pattern of units to collect
  ## A space-separated list of unit-patterns including wildcards determining
  ## the units to collect.
  ##  ex: pattern = "telegraf* influxdb* user@*"
  # pattern = "*"

  ## Filter for a specific unit type
  ## Available settings are: service, socket, target, device, mount,
  ## automount, swap, timer, path, slice and scope
  # unittype = "service"

  ## Collect also units not loaded by systemd, i.e. disabled or static units
  ## Enabling this feature might introduce significant load when used with
  ## unspecific patterns (such as '*') as systemd will need to load all
  ## matching unit files.
  # collect_disabled_units = false

  ## Collect detailed information for the units
  # details = false

  ## Timeout for state-collection
  # timeout = "5s"

This plugin supports two modes of operation:

Non-detailed mode

This is the default mode, collecting data on the unit's status only without further details on the unit.

Detailed mode

This mode can be enabled by setting the configuration option details to true. In this mode the plugin collects all information of the non-detailed mode but provides additional unit information such as memory usage, restart-counts, PID, etc. See the metrics section below for a list of all properties collected.

Metrics

These metrics are available in both modes:

• systemd_units:
  • tags:
    • name (string, unit name)
    • load (string, load state)
    • active (string, active state)
    • sub (string, sub state)
  • fields:
    • load_code (int, see below)
    • active_code (int, see below)
    • sub_code (int, see below)

The following additional metrics are available with details = true:

• systemd_units:
  • tags:
    • state (string, unit file state)
    • preset (string, unit file preset state)
  • fields:
    • status_errno (int, last error)
    • restarts (int, number of restarts)
    • pid (int, pid of the main process)
    • mem_current (uint, current memory usage)
    • mem_peak (uint, peak memory usage)
    • swap_current (uint, current swap usage)
    • swap_peak (uint, peak swap usage)
    • mem_avail (uint, available memory for this unit)

Load

Enumeration of unit_load_state_table

Active

Enumeration of unit_active_state_table

Sub

enumeration of sub states, see various unittype_state_tables; duplicates were removed, tables are hex aligned to keep some space for future values

Example Output

Output in non-detailed mode

systemd_units,host=host1.example.com,name=dbus.service,load=loaded,active=active,sub=running load_code=0i,active_code=0i,sub_code=0i 1533730725000000000
systemd_units,host=host1.example.com,name=networking.service,load=loaded,active=failed,sub=failed load_code=0i,active_code=3i,sub_code=12i 1533730725000000000
systemd_units,host=host1.example.com,name=ssh.service,load=loaded,active=active,sub=running load_code=0i,active_code=0i,sub_code=0i 1533730725000000000

Output in detailed mode

systemd_units,active=active,host=host1.example.com,load=loaded,name=dbus.service,sub=running,preset=disabled,state=static active_code=0i,load_code=0i,mem_avail=6470856704i,mem_current=2691072i,mem_peak=3895296i,pid=481i,restarts=0i,status_errno=0i,sub_code=0i,swap_current=794624i,swap_peak=884736i 1533730725000000000
systemd_units,active=inactive,host=host1.example.com,load=not-found,name=networking.service,sub=dead active_code=2i,load_code=2i,pid=0i,restarts=0i,status_errno=0i,sub_code=1i 1533730725000000000
systemd_units,active=active,host=host1.example.com,load=loaded,name=pcscd.service,sub=running,preset=disabled,state=indirect active_code=0i,load_code=0i,mem_avail=6370541568i,mem_current=512000i,mem_peak=4399104i,pid=1673i,restarts=0i,status_errno=0i,sub_code=0i,swap_current=3149824i,swap_peak=3149824i 1533730725000000000