Découverte des services systemd

Aperçu

Il est possible de découvrir des unités systemd (services, par défaut) avec Zabbix.

Clé d'élément

Pour configurer la règle de découverte, utilisez la clé d'élément de l'agent Zabbix systemd.unit.discovery.

Cette clé d'élément n'est prise en charge que par Zabbix agent 2.

Cette clé d'élément renvoie un JSON contenant des informations sur les unités systemd, par exemple :

[{
    "{#UNIT.NAME}": "mysqld.service",
    "{#UNIT.DESCRIPTION}": "MySQL Server",
    "{#UNIT.LOADSTATE}": "loaded",
    "{#UNIT.ACTIVESTATE}": "active",
    "{#UNIT.SUBSTATE}": "running",
    "{#UNIT.FOLLOWED}": "",
    "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice",
    "{#UNIT.JOBID}": 0,
    "{#UNIT.JOBTYPE}": "",
    "{#UNIT.JOBPATH}": "/",
    "{#UNIT.UNITFILESTATE}": "enabled"
    "{#UNIT.SERVICETYPE}": "simple"
}, {
    "{#UNIT.NAME}": "systemd-journald.socket",
    "{#UNIT.DESCRIPTION}": "Journal Socket",
    "{#UNIT.LOADSTATE}": "loaded",
    "{#UNIT.ACTIVESTATE}": "active",
    "{#UNIT.SUBSTATE}": "running",
    "{#UNIT.FOLLOWED}": "",
    "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket",
    "{#UNIT.JOBID}": 0,
    "{#UNIT.JOBTYPE}": "",
    "{#UNIT.JOBPATH}": "/",
    "{#UNIT.UNITFILESTATE}": "enabled"
}]
Découverte des unités systemd désactivées

Il est également possible de découvrir les unités systemd désactivées. Dans ce cas, trois macros sont renvoyées dans le JSON résultant :

  • {#UNIT.PATH}
  • {#UNIT.ACTIVESTATE}
  • {#UNIT.UNITFILESTATE}

Pour que des éléments et des déclencheurs soient créés à partir des prototypes pour les unités systemd désactivées, veillez à ajuster (ou à supprimer) les filtres LLD interdits pour {#UNIT.ACTIVESTATE} et {#UNIT.UNITFILESTATE}.

Macros prises en charge

Les macros suivantes sont prises en charge pour une utilisation dans le filtre de la règle de découverte et dans les prototypes d'éléments, de déclencheurs et de graphiques :

Macro Description
{#UNIT.NAME} Nom de l'unité principale.
{#UNIT.DESCRIPTION} Description lisible par l'utilisateur.
{#UNIT.LOADSTATE} État de chargement (c'est-à-dire si le fichier d'unité a été chargé avec succès)
{#UNIT.ACTIVESTATE} État actif (c'est-à-dire si l'unité est actuellement démarrée ou non)
{#UNIT.SUBSTATE} Sous-état (une version plus détaillée de l'état actif, spécifique au type d'unité, contrairement à l'état actif)
{#UNIT.FOLLOWED} Unité dont l'état est suivi par cette unité, s'il y en a une ; sinon, une chaîne vide.
{#UNIT.PATH} Chemin de l'objet unité.
{#UNIT.JOBID} ID numérique du job s'il existe un job en file d'attente pour l'unité de job ; 0 sinon.
{#UNIT.JOBTYPE} Type de job.
{#UNIT.JOBPATH} Chemin de l'objet job.
{#UNIT.UNITFILESTATE} État d'installation du fichier d'unité.
{#UNIT.SERVICETYPE} Type de l'unité de service (par exemple, simple, forking, oneshot, idle, etc.). Cette macro n'est renvoyée que si l'unité est un service.

Prototypes d'éléments

Les prototypes d'éléments pouvant être créés sur la base de la découverte des services systemd incluent, par exemple :

  • Nom de l'élément : {#UNIT.DESCRIPTION} active state info ; clé de l'élément : systemd.unit.info["{#UNIT.NAME}"]
  • Nom de l'élément : {#UNIT.DESCRIPTION} load state info ; clé de l'élément : systemd.unit.info["{#UNIT.NAME}",LoadState]