[comment]: # ({ec525f2f-ec525f2f})
# 7 Descubrimiento de los servicios systemd

[comment]: # ({/ec525f2f-ec525f2f})

[comment]: # ({f72274ad-6e5dadb8})
### Descripción general

Es posible [descubrir](/manual/discovery/low_level_discovery)
unidades systemd (servicios, por defecto) con Zabbix.

[comment]: # ({/f72274ad-6e5dadb8})

[comment]: # ({1f2028b1-e655c9cf})
### Clave de artículo

El elemento a utilizar en el [descubrimiento
regla](/manual/discovery/low_level_discovery#discovery_rule) es la

    descubrimiento.de.unidad.systemd

::: nota importante
Este
La clave [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) es
solo es compatible con el agente 2 de Zabbix.
:::

Este elemento devuelve un JSON con información sobre las unidades systemd, por ejemplo
ejemplo:

    [{
        "{#UNIT.NAME}": "mysqld.service",
        "{#UNIT.DESCRIPTION}": "Servidor MySQL",
        "{#UNIT.LOADSTATE}": "cargado",
        "{#UNIT.ACTIVESTATE}": "activo",
        "{#UNIT.SUBSTATE}": "en ejecución",
        "{#UNIT.FOLLOWED}": "",
        "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice",
        "{#UNIT.JOBID}": 0,
        "{#UNIT.JOBTYPE}": "",
        "{#UNIT.JOBPATH}": "/",
        "{#UNIT.UNITFILESTATE}": "habilitado"
    }, {
        "{#UNIT.NAME}": "systemd-journald.socket",
        "{#UNIT.DESCRIPTION}": "Toma de diario",
        "{#UNIT.LOADSTATE}": "cargado",
        "{#UNIT.ACTIVESTATE}": "activo",
        "{#UNIT.SUBSTATE}": "en ejecución",
        "{#UNIT.FOLLOWED}": "",
        "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket",
        "{#UNIT.JOBID}": 0,
        "{#UNIT.JOBTYPE}": "",
        "{#UNIT.JOBPATH}": "/",
        "{#UNIT.UNITFILESTATE}": "habilitado"
    }]

[comment]: # ({/1f2028b1-e655c9cf})

[comment]: # ({86dfc2a0-06ebf923})

##### Descubrimiento de unidades systemd deshabilitadas

Desde Zabbix 6.0.1 también es posible descubrir unidades systemd **deshabilitadas**. En este caso
se devuelven tres macros en el JSON resultante:

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

::: noteimportant
Para crear métricas e iniciadores a partir de prototipos para unidades systemd deshabilitadas, asegúrese de
ajustar (o eliminar) la prohibición de filtros LLD para {#UNIT.ACTIVESTATE} y {#UNIT.UNITFILESTATE}.
:::

[comment]: # ({/86dfc2a0-06ebf923})

[comment]: # ({85c44d09-0272b801})
### Macros compatibles

Las siguientes macros son compatibles para su uso en el
[filtro](/manual/discovery/low_level_discovery#discovery_rule_filter) de la regla de descubrimiento
y prototipos de métricas, iniciadores y gráficos:

|Macro|Descripción|
|-----|-----------|
|{\#UNIT.NAME}|Nombre de la unidad principal.|
|{\#UNIT.DESCRIPTION}|Descripción legible por humanos.|
|{\#UNIT.LOADSTATE}|Estado de carga (es decir, si el archivo de unidad se ha cargado correctamente)|
|{\#UNIT.ACTIVESTATE}|Estado activo (es decir, si la unidad está actualmente iniciada o no)|
|{\#UNIT.SUBSTATE}|Subestado (una versión más detallada del estado activo que es específica del tipo de unidad, que el estado activo no es)|
|{\#UNIT.FOLLOWED}|Unidad que está siendo seguida en su estado por esta unidad, si la hay; de lo contrario, una cadena vacía.|
|{\#UNIT.PATH}|Ruta del objeto unitario.|
|{\#UNIT.JOBID}|ID de trabajo numérico si hay un trabajo en cola para la unidad de trabajo; 0 en caso contrario.|
|{\#UNIT.JOBTYPE}|Tipo de trabajo.|
|{\#UNIT.JOBPATH}|Ruta del objeto de trabajo.|
|{\#UNIT.UNITFILESTATE}|El estado de instalación del archivo de unidad.|

[comment]: # ({/85c44d09-0272b801})

[comment]: # ({7dcfb593-c8363d40})
### Prototipos de métricas

Los prototipos de métricas que se pueden crear basándose en el descubrimiento de servicios systemd
incluyen, por ejemplo:

- Nombre de la métrica: `{#UNIT.DESCRIPTION} información de estado activo`; clave de la métrica:
    `systemd.unit.info["{#UNIT.NAME}"]`
- Nombre de la métrica: `{#UNIT.DESCRIPTION} información del estado de carga`; clave de la métrica:
    `systemd.unit.info["{#UNIT.NAME}",LoadState]`

Las [métricas
de agente](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) `systemd.unit.info`
están soportadas desde Zabbix 4.4.

[comment]: # ({/7dcfb593-c8363d40})
