Documentation
Table of Contents
7 D¨¦couverte des services systemd
Aper?u
Il est possible de »å¨¦³¦´Ç³Ü±¹°ù¾±°ù des unit¨¦s systemd (services, par d¨¦faut) avec Áú»¢¶Ä²©.
###?Cl¨¦ d'¨¦±ô¨¦³¾±ð²Ô³Ù
L'¨¦±ô¨¦³¾±ð²Ô³Ù ¨¤ utiliser dans la r¨¨gle de d¨¦couverte est
Cette cl¨¦ d'¨¦±ô¨¦³¾±ð²Ô³Ù n'est prise en charge que dans l'agent Áú»¢¶Ä²© 2.
Cet ¨¦±ô¨¦³¾±ð²Ô³Ù renvoie un JSON avec 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.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 »å¨¦²õ²¹³¦³Ù¾±±¹¨¦±ð²õ
Depuis Áú»¢¶Ä²© 6.0.1, il est ¨¦galement possible de »å¨¦³¦´Ç³Ü±¹°ù¾±°ù les unit¨¦s systemd »å¨¦²õ²¹³¦³Ù¾±±¹¨¦±ð²õ. Dans ce cas, trois macros sont renvoy¨¦es dans le JSON r¨¦sultant?:
- {#UNIT.PATH}
- {#UNIT.ACTIVESTATE}
- {#UNIT.UNITFILESTATE}.
Pour que des ¨¦±ô¨¦³¾±ð²Ô³Ùs et des d¨¦clencheurs soient cr¨¦¨¦s ¨¤ partir de prototypes pour les unit¨¦s systemd »å¨¦²õ²¹³¦³Ù¾±±¹¨¦±ð²õ, assurez-vous d'ajuster (ou de supprimer) les filtres LLD interdisant pour {#UNIT.ACTIVESTATE} et {#UNIT.UNITFILESTATE}.
Macros prises en charge
Les macros suivantes sont prises en charge pour une utilisation dans le filtre de r¨¨gle de d¨¦couverte et les prototypes d'¨¦±ô¨¦³¾±ð²Ô³Ùs, de d¨¦clencheurs et de graphiques :
| Macro | Description |
|---|---|
| {#UNIT.NAME} | Nom de l'unit¨¦ principale. |
| {#UNIT.DESCRIPTION} | Description lisible par l'homme. |
| {#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 fine de l'¨¦tat actif qui est sp¨¦cifique au type d'unit¨¦, ce que l'¨¦tat actif n'est pas) |
| {#UNIT.FOLLOWED} | Unit¨¦ qui est suivie dans son ¨¦tat par cette unit¨¦, s'il y en a ; sinon une cha?ne vide. |
| {#UNIT.PATH} | Chemin de l'objet unit¨¦. |
| {#UNIT.JOBID} | ID de travail num¨¦rique s'il y a un travail en file d'attente pour l'unit¨¦ de travail ; 0 sinon. |
| {#UNIT.JOBTYPE} | Type de t?che. |
| {#UNIT.JOBPATH} | Chemin de l'objet du travail. |
| {#UNIT.UNITFILESTATE} | L'¨¦tat d'installation du fichier d'unit¨¦. |
Prototypes d'¨¦±ô¨¦³¾±ð²Ô³Ù
Les prototypes d'¨¦±ô¨¦³¾±ð²Ô³Ù pouvant ¨ºtre cr¨¦¨¦s sur la base de la d¨¦couverte de service systemd incluent, par exemple?:
- Nom de l'¨¦±ô¨¦³¾±ð²Ô³Ù :
{#UNIT.DESCRIPTION}; Cl¨¦ de l'¨¦±ô¨¦³¾±ð²Ô³Ù :systemd.unit.info["{#UNIT.NAME}"] - Nom de l'¨¦±ô¨¦³¾±ð²Ô³Ù :
{#UNIT.DESCRIPTION}; Cl¨¦ de l'¨¦±ô¨¦³¾±ð²Ô³Ù :systemd.unit.info["{#UNIT.NAME}",LoadState]
Les ¨¦±ô¨¦³¾±ð²Ô³Ùs agent systemd.unit.info sont pris en charge depuis Áú»¢¶Ä²© 4.4.