[comment]: # translation:outdated

[comment]: # ({1825d7ea-ec525f2f})
# 8 systemdサービスの検出

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

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

Zabbixを使用してsystemdユニット（デフォルトではサービス）を[検出](/manual/discovery/low_level_discovery)することができます。

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

[comment]: # ({1f2028b1-e655c9cf})
### アイテムキー

[ディスカバリルール](/manual/discovery/low_level_discovery#discovery_rule)で使用するアイテムは

    systemd.unit.discovery

::: noteimportant
この[アイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)キーは、Zabbixエージェント2でのみサポートされています。
:::

このアイテムはsystemdユニットに関する情報を含むJSONを返します。次に例を示します。

    [{
        "{#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.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"
    }]

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

[comment]: # ({cbc19e2b-2d3b32d7})
##### 無効化された systemd ユニットのディスカバリ

**無効化された** systemd ユニットをディスカバリすることも可能です。この場合、結果の JSON では次の3つのマクロが返されます。 

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

::: noteimportant
無効化された systemd ユニット用のプロトタイプからアイテムとトリガーを作成するには、{#UNIT.ACTIVESTATE} および {#UNIT.UNITFILESTATE} に対する禁止 LLD フィルターを必ず調整（または削除）してください。
:::

[comment]: # ({/cbc19e2b-2d3b32d7})

[comment]: # ({85c44d09-0272b801})
### サポートされているマクロ

次のマクロはディスカバリルール[フィルター](/manual/discovery/low_level_discovery#discovery_rule_filter)およびアイテム、トリガー、グラフのプロトタイプでの使用がサポートされています。

|マクロ|説明|
|-----|-----------|
|{\#UNIT.NAME}|プライマリユニット名|
|{\#UNIT.DESCRIPTION}|人間が読みやすい形式の説明。|
|{\#UNIT.LOADSTATE}|ロードステータス（ユニットファイルが正常にロードされたかどうか）|
|{\#UNIT.ACTIVESTATE}|アクティブステータス（ユニットが現在起動しているかどうか）|
|{\#UNIT.SUBSTATE}|サブステータス（アクティブ状態ではない。ユニットタイプに固有のアクティブ状態のより詳細な情報）|
|{\#UNIT.FOLLOWED}|このユニットが存在する場合、このユニットがフォローしているユニット。 それ以外の場合は空の文字列|
|{\#UNIT.PATH}|ユニットのオブジェクトパス|
|{\#UNIT.JOBID}|ジョブ単位のキューに入れられたジョブがある場合はジョブIDの数値。 それ以外の場合は0|
|{\#UNIT.JOBTYPE}|ジョブタイプ|
|{\#UNIT.JOBPATH}|ジョブのオブジェクトパス|
|{\#UNIT.UNITFILESTATE}|ユニットファイルのインストール状態|

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

[comment]: # ({93b3d9f5-c8363d40})
### アイテムのプロトタイプ

systemdサービスディスカバリに基づいて作成できるアイテムのプロトタイプには、例えば次のものがあります。

-   アイテム名: `{#UNIT.DESCRIPTION} active state info`; アイテムキー:
    `systemd.unit.info["{#UNIT.NAME}"]`
-   アイテム名: `{#UNIT.DESCRIPTION} load state info`; アイテムキー:
    `systemd.unit.info["{#UNIT.NAME}",LoadState]`

[comment]: # ({/93b3d9f5-c8363d40})