Systemd

systemd is a software suite that provides an array of system components for Linux operating systems. Its main aim is to unify service configuration and behavior across Linux distributions.

Available solutions

Zabbix version 7.4 7.2 7.0 6.4 6.2 6.0 5.4 5.0
Source: templates/app/systemd

Systemd by Zabbix agent 2

Overview

This template is designed for the effortless deployment of Systemd monitoring by Zabbix via Zabbix agent 2 and doesn't require any external scripts.

Requirements

Zabbix version: 7.4 and higher.

Tested versions

This template has been tested on:

  • Systemd 252

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

  1. Setup and configure zabbix-agent2 compiled with the Systemd monitoring plugin.
  2. Set filters with macros if you want to override default filter parameters.

Macros used

Name Description Default
{$SYSTEMD.NAME.SOCKET.MATCHES}

Filter of systemd socket units by name.

 .+
{$SYSTEMD.NAME.SOCKET.NOT_MATCHES}

Filter of systemd socket units by name.

 CHANGE_IF_NEEDED
{$SYSTEMD.ACTIVESTATE.SOCKET.MATCHES}

Filter of systemd socket units by active state.

 .+
{$SYSTEMD.ACTIVESTATE.SOCKET.NOT_MATCHES}

Filter of systemd socket units by active state.

 ^inactive$
{$SYSTEMD.UNITFILESTATE.SOCKET.MATCHES}

Filter of systemd socket units by unit file state.

 ^enabled$
{$SYSTEMD.UNITFILESTATE.SOCKET.NOT_MATCHES}

Filter of systemd socket units by unit file state.

 CHANGE_IF_NEEDED
{$SYSTEMD.NAME.SERVICE.MATCHES}

Filter of systemd service units by name.

 .+
{$SYSTEMD.NAME.SERVICE.NOT_MATCHES}

Filter of systemd service units by name.

 CHANGE_IF_NEEDED
{$SYSTEMD.ACTIVESTATE.SERVICE.MATCHES}

Filter of systemd service units by active state.

 .+
{$SYSTEMD.ACTIVESTATE.SERVICE.NOT_MATCHES}

Filter of systemd service units by active state.

 ^inactive$
{$SYSTEMD.UNITFILESTATE.SERVICE.MATCHES}

Filter of systemd service units by unit file state.

 ^enabled$
{$SYSTEMD.UNITFILESTATE.SERVICE.NOT_MATCHES}

Filter of systemd service units by unit file state.

 CHANGE_IF_NEEDED
{$SYSTEMD.SERVICETYPE.SERVICE.MATCHES}

Filter of systemd service units by service type.

 .+
{$SYSTEMD.SERVICETYPE.SERVICE.NOT_MATCHES}

Filter of systemd service units by service type.

 CHANGE_IF_NEEDED

LLD rule Service units discovery

Name Description Type Key and additional info
Service units discovery

Discover systemd service units and their details.

 Zabbix agent systemd.unit.discovery[service]

Item prototypes for Service units discovery

Name Description Type Key and additional info
{#UNIT.NAME}: Get unit info

Returns all properties of a systemd service unit.

Unit description: {#UNIT.DESCRIPTION}.

 Zabbix agent systemd.unit.get["{#UNIT.NAME}"]
{#UNIT.NAME}: Active state

State value that reflects whether the unit is currently active or not. The following states are currently defined: "active", "reloading", "inactive", "failed", "activating", and "deactivating".

 Dependent item systemd.service.active_state["{#UNIT.NAME}"]

Preprocessing

  • JSON Path: $.ActiveState.state

  • Discard unchanged with heartbeat: 30m
{#UNIT.NAME}: Load state

State value that reflects whether the configuration file of this unit has been loaded. The following states are currently defined: "loaded", "error", and "masked".

 Dependent item systemd.service.load_state["{#UNIT.NAME}"]

Preprocessing

  • JSON Path: $.LoadState.state

  • Discard unchanged with heartbeat: 30m
{#UNIT.NAME}: Unit file state

Encodes the install state of the unit file of FragmentPath. It currently knows the following states: "enabled", "enabled-runtime", "linked", "linked-runtime", "masked", "masked-runtime", "static", "disabled", and "invalid".

 Dependent item systemd.service.unitfile_state["{#UNIT.NAME}"]

Preprocessing

  • JSON Path: $.UnitFileState.state

  • Discard unchanged with heartbeat: 30m
{#UNIT.NAME}: Active time

Number of seconds since unit entered the active state.

 Dependent item systemd.service.uptime["{#UNIT.NAME}"]

Preprocessing

  • JavaScript: The text is too long. Please see the template.

Trigger prototypes for Service units discovery

Name Description Expression Severity Dependencies and additional info
Systemd: {#UNIT.NAME}: Service is not running last(/Systemd by Zabbix agent 2/systemd.service.active_state["{#UNIT.NAME}"])<>1 Warning Manual close: Yes
Systemd: {#UNIT.NAME} has been restarted

Uptime is less than 10 minutes.

 last(/Systemd by Zabbix agent 2/systemd.service.uptime["{#UNIT.NAME}"])<10m Info Manual close: Yes

LLD rule Socket units discovery

Name Description Type Key and additional info
Socket units discovery

Discover systemd socket units and their details.

 Zabbix agent systemd.unit.discovery[socket]

Item prototypes for Socket units discovery

Name Description Type Key and additional info
{#UNIT.NAME}: Get unit info

Returns all properties of a systemd socket unit.

Unit description: {#UNIT.DESCRIPTION}.

 Zabbix agent systemd.unit.get["{#UNIT.NAME}",Socket]
{#UNIT.NAME}: Connections accepted per sec

The number of accepted socket connections (NAccepted) per second.

 Dependent item systemd.socket.conn_accepted.rate["{#UNIT.NAME}"]

Preprocessing

  • JSON Path: $.NAccepted

  • Change per second
{#UNIT.NAME}: Connections connected

The current number of socket connections (NConnections).

 Dependent item systemd.socket.conn_count["{#UNIT.NAME}"]

Preprocessing

  • JSON Path: $.NConnections

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums

Articles and documentation

+ Propose new article

Didn't find what you are looking for?

Request custom integration

Zabbix integration team will develop custom integration based on your requirements and Zabbix best practices.

Request

Propose integration

Have you already developed high quality integration and want to submit to Zabbix integration repository?

Propose