Objet de règle LLD

Les objets suivants sont directement liés à l’API discoveryrule.

Règle LLD

L'objet de règle de découverte de bas niveau possède les propriétés suivantes.

Propriété Type Description
itemid ID ID de la règle LLD.

Comportement de la propriété :
- lecture seule
- obligatoire pour les opérations de mise à jour
delay string Intervalle de mise à jour de la règle LLD.

Accepte des secondes ou une unité de temps avec suffixe (par ex. 30s, 1m, 2h, 1d) et, éventuellement, un ou plusieurs intervalles personnalisés, tous séparés par des points-virgules. Les intervalles personnalisés peuvent être un mélange d'intervalles flexibles et d'intervalles de planification.

Accepte les macros utilisateur. Si elles sont utilisées, la valeur doit être une macro unique. Plusieurs macros ou des macros mélangées avec du texte ne sont pas prises en charge. Les intervalles flexibles peuvent être écrits sous la forme de deux macros séparées par une barre oblique (par ex. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Exemple :
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Comportement de la propriété :
- obligatoire si type est défini sur "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), ou si type est défini sur "Zabbix agent (active)" (7) et que key_ ne contient pas "mqtt.get"
hostid ID ID de l'hôte auquel appartient la règle LLD.

Comportement de la propriété :
- constant
- obligatoire pour les opérations de création
flags integer Origine de la règle de découverte.

Valeurs possibles :
1 - une règle de découverte de bas niveau ;
5 - une règle de découverte de bas niveau convertie à partir d'un prototype.

Comportement de la propriété :
- lecture seule
interfaceid ID ID de l'interface hôte de la règle LLD.

Comportement de la propriété :
- obligatoire si la règle LLD appartient à un hôte et que type est défini sur "Zabbix agent", "IPMI agent", "JMX agent" ou "SNMP agent"
- pris en charge si la règle LLD appartient à un hôte et que type est défini sur "Simple check", "External check", "SSH agent", "TELNET agent" ou "HTTP agent"
key_ string Clé de la règle LLD.

Comportement de la propriété :
- obligatoire pour les opérations de création
- lecture seule pour les objets hérités
name string Nom de la règle LLD.

Comportement de la propriété :
- obligatoire pour les opérations de création
- lecture seule pour les objets hérités
type integer Type de la règle LLD.

Valeurs possibles :
0 - Zabbix agent ;
2 - Zabbix trapper ;
3 - Simple check ;
5 - Zabbix internal ;
7 - Zabbix agent (active) ;
10 - External check ;
11 - Database monitor ;
12 - IPMI agent ;
13 - SSH agent ;
14 - TELNET agent ;
16 - JMX agent ;
18 - Élément dépendant ;
19 - HTTP agent ;
20 - SNMP agent ;
21 - Script ;
22 - Browser ;
23 - Imbriqué. Ce type n'est autorisé que si le parent de la règle est un modèle (supposé être lié à un prototype d'hôte lors de la découverte) ou un hôte découvert (qui a une règle LLD à sa racine).

Comportement de la propriété :
- obligatoire pour les opérations de création
- lecture seule pour les objets hérités
url string Chaîne URL.
Prend en charge les macros utilisateur, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.

Comportement de la propriété :
- obligatoire si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
allow_traps integer Autorise le remplissage de la valeur de manière similaire à l'élément trapper.

Valeurs possibles :
0 - (par défaut) Ne pas autoriser l'acceptation des données entrantes ;
1 - Autoriser l'acceptation des données entrantes.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
authtype integer Méthode d'authentification.

Valeurs possibles si type est défini sur "SSH agent" :
0 - (par défaut) mot de passe ;
1 - clé publique.

Valeurs possibles si type est défini sur "HTTP agent" :
0 - (par défaut) aucune ;
1 - basic ;
2 - NTLM ;
3 - Kerberos ;
4 - Digest.

Comportement de la propriété :
- pris en charge si type est défini sur "SSH agent" ou "HTTP agent"
- lecture seule pour les objets hérités (si type est défini sur "HTTP agent")
description string Description de la règle LLD.
error string Texte d'erreur en cas de problèmes lors de la mise à jour de la valeur de la règle LLD.

Comportement de la propriété :
- lecture seule
follow_redirects integer Suivre les redirections de réponse lors de l'interrogation des données.

Valeurs possibles :
0 - Ne pas suivre les redirections ;
1 - (par défaut) Suivre les redirections.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
headers array Tableau des en-têtes qui seront envoyés lors de l'exécution d'une requête HTTP.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
http_proxy string Chaîne de connexion du proxy HTTP(S).

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
ipmi_sensor string Capteur IPMI.

Comportement de la propriété :
- obligatoire si type est défini sur "IPMI agent" et que key_ n'est pas défini sur "ipmi.get"
- pris en charge si type est défini sur "IPMI agent"
- lecture seule pour les objets hérités
jmx_endpoint string Chaîne de connexion personnalisée de l'agent JMX.

Par défaut : service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Comportement de la propriété :
- pris en charge si type est défini sur "JMX agent"
lifetime string Période après laquelle les éléments qui ne sont plus découverts seront supprimés. Accepte des secondes, une unité de temps avec suffixe ou une macro utilisateur.

Par défaut : 7d.
lifetime_type integer Scénario de suppression des ressources LLD perdues.

Valeurs possibles :
0 - (par défaut) Supprimer après que le seuil de durée de vie est atteint ;
1 - Ne pas supprimer ;
2 - Supprimer immédiatement.
enabled_lifetime string Période après laquelle les éléments qui ne sont plus découverts seront désactivés. Accepte des secondes, une unité de temps avec suffixe ou une macro utilisateur.

Par défaut : 0.
enabled_lifetime_type integer Scénario de désactivation des ressources LLD perdues.

Valeurs possibles :
0 - Désactiver après que le seuil de durée de vie est atteint ;
1 - Ne pas désactiver ;
2 - (par défaut) Désactiver immédiatement.
master_itemid ID ID de l'élément maître.
Une règle de découverte ne peut pas être l'élément maître d'une autre règle de découverte.

Comportement de la propriété :
- obligatoire si type est défini sur "Dependent item"
- lecture seule pour les objets hérités
output_format integer Indique si la réponse doit être convertie en JSON.

Valeurs possibles :
0 - (par défaut) Stocker brut ;
1 - Convertir en JSON.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
params string Paramètres supplémentaires selon le type de la règle LLD :
- script exécuté pour les règles LLD SSH et Telnet ;
- requête SQL pour les règles LLD de surveillance de base de données ;
- formule pour les règles LLD calculées ;
- le script pour les règles LLD de type script et browser.

Comportement de la propriété :
- obligatoire si type est défini sur "Database monitor", "SSH agent", "TELNET agent", "Script" ou "Browser"
- lecture seule pour les objets hérités (si type est défini sur "Script" ou "Browser")
parameters object/array Paramètres supplémentaires si type est défini sur "Script" ou "Browser".
Tableau d'objets avec les propriétés name et value, où name doit être unique.

Comportement de la propriété :
- pris en charge si type est défini sur "Script" ou "Browser"
- lecture seule pour les objets hérités
password string Mot de passe pour l'authentification.

Comportement de la propriété :
- obligatoire si type est défini sur "JMX agent" et que username est défini
- pris en charge si type est défini sur "Simple check", "Database monitor", "SSH agent", "TELNET agent" ou "HTTP agent"
- lecture seule pour les objets hérités (si type est défini sur "HTTP agent")
post_type integer Type du corps des données POST stocké dans la propriété posts.

Valeurs possibles :
0 - (par défaut) Données brutes ;
2 - Données JSON ;
3 - Données XML.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
posts string Données du corps de la requête HTTP(S).

Comportement de la propriété :
- obligatoire si type est défini sur "HTTP agent" et que post_type est défini sur "JSON data" ou "XML data"
- pris en charge si type est défini sur "HTTP agent" et que post_type est défini sur "Raw data"
- lecture seule pour les objets hérités
privatekey string Nom du fichier de clé privée.

Comportement de la propriété :
- obligatoire si type est défini sur "SSH agent" et que authtype est défini sur "public key"
publickey string Nom du fichier de clé publique.

Comportement de la propriété :
- obligatoire si type est défini sur "SSH agent" et que authtype est défini sur "public key"
query_fields array Tableau des champs de requête qui seront envoyés lors de l'exécution d'une requête HTTP.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
request_method integer Type de méthode de requête.

Valeurs possibles :
0 - (par défaut) GET ;
1 - POST ;
2 - PUT ;
3 - HEAD.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
retrieve_mode integer Quelle partie de la réponse doit être stockée.

Valeurs possibles si request_method est défini sur "GET", "POST" ou "PUT" :
0 - (par défaut) Corps ;
1 - En-têtes ;
2 - Le corps et les en-têtes seront tous deux stockés.

Valeurs possibles si request_method est défini sur "HEAD" :
1 - En-têtes.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
snmp_oid string OID SNMP.

Comportement de la propriété :
- obligatoire si type est défini sur "SNMP agent"
- lecture seule pour les objets hérités
ssl_cert_file string Chemin du fichier de clé SSL publique.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
ssl_key_file string Chemin du fichier de clé SSL privée.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
ssl_key_password string Mot de passe du fichier de clé SSL.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
state integer État de la règle LLD.

Valeurs possibles :
0 - (par défaut) normal ;
1 - non pris en charge.

Comportement de la propriété :
- lecture seule
status integer Statut de la règle LLD.

Valeurs possibles :
0 - (par défaut) règle LLD activée ;
1 - règle LLD désactivée.
status_codes string Plages des codes d'état HTTP requis, séparées par des virgules. Prend également en charge les macros utilisateur comme partie d'une liste séparée par des virgules.

Exemple : 200,200-{$M},{$M},200-400

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
templateid ID ID de la règle LLD du modèle parent.

Comportement de la propriété :
- lecture seule
timeout string Délai d'expiration de la requête d'interrogation des données de l'élément.
Accepte des secondes ou une unité de temps avec suffixe (par ex. 30s, 1m). Accepte également les macros utilisateur.

Plage de valeurs possible : 1-600s.

Par défaut : "" - utiliser les paramètres proxy/globaux.

Comportement de la propriété :
- pris en charge si type est défini sur "Zabbix agent" (0), "Simple check" (3) et que key_ ne commence pas par "vmware." ni "icmpping", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) et que snmp_oid commence par "walk[" ou "get[", "Script" (21), "Browser" (22)
- lecture seule pour les objets hérités
trapper_hosts string Hôtes autorisés.

Comportement de la propriété :
- pris en charge si type est défini sur "Zabbix trapper", ou si type est défini sur "HTTP agent" et que allow_traps est défini sur "Allow to accept incoming data"
username string Nom d'utilisateur pour l'authentification.

Comportement de la propriété :
- obligatoire si type est défini sur "SSH agent", "TELNET agent", ou si type est défini sur "JMX agent" et que password est défini
- pris en charge si type est défini sur "Simple check", "Database monitor" ou "HTTP agent"
- lecture seule pour les objets hérités (si type est défini sur "HTTP agent")
uuid string Identifiant universel unique, utilisé pour lier les règles LLD importées à celles qui existent déjà. Généré automatiquement s'il n'est pas fourni.

Comportement de la propriété :
- pris en charge si la règle LLD appartient à un modèle
verify_host integer Indique s'il faut valider que le nom d'hôte de la connexion correspond à celui figurant dans le certificat de l'hôte.

Valeurs possibles :
0 - (par défaut) Ne pas valider ;
1 - Valider.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités
verify_peer integer Indique s'il faut valider que le certificat de l'hôte est authentique.

Valeurs possibles :
0 - (par défaut) Ne pas valider ;
1 - Valider.

Comportement de la propriété :
- pris en charge si type est défini sur "HTTP agent"
- lecture seule pour les objets hérités

En-tête HTTP

L'objet d'en-tête possède les propriétés suivantes :

Propriété Type Description
name string Nom de l'en-tête HTTP.

Comportement de la propriété :
- obligatoire
value string Valeur de l'en-tête.

Comportement de la propriété :
- obligatoire

Champ de requête HTTP

L'objet de champ de requête définit un nom et une valeur utilisés pour spécifier un paramètre d'URL. Il possède les propriétés suivantes :

Propriété Type Description
name string Nom du paramètre.

Comportement de la propriété :
- obligatoire
value string Valeur du paramètre.

Comportement de la propriété :
- obligatoire

Filtre de règle LLD

L'objet de filtre de règle LLD définit un ensemble de conditions pouvant être utilisées pour filtrer les objets découverts. Il possède les propriétés suivantes :

Propriété Type Description
conditions object/array Ensemble de conditions de filtre à utiliser pour filtrer les résultats. Les conditions seront triées dans l'ordre de leur placement dans la formule.

Comportement de la propriété :
- obligatoire
evaltype integer Méthode d'évaluation des conditions de filtre.

Valeurs possibles :
0 - Et/Ou ;
1 - Et ;
2 - Ou ;
3 - Expression personnalisée.

Comportement de la propriété :
- obligatoire
eval_formula string Expression générée qui sera utilisée pour évaluer les conditions de filtre. L'expression contient des ID qui font référence à des conditions de filtre spécifiques par leur formulaid. La valeur de eval_formula est égale à la valeur de formula pour les filtres avec une expression personnalisée.

Comportement de la propriété :
- lecture seule
formula string Expression définie par l'utilisateur à utiliser pour évaluer les conditions des filtres avec une expression personnalisée. L'expression doit contenir des ID qui font référence à des conditions de filtre spécifiques par leur formulaid. Les ID utilisés dans l'expression doivent correspondre exactement à ceux définis dans les conditions de filtre : aucune condition ne peut rester inutilisée ou omise.

Comportement de la propriété :
- obligatoire si evaltype est défini sur « custom expression »

Condition de filtre de règle LLD

L'objet de condition de filtre de règle LLD définit une vérification distincte à effectuer sur la valeur d'une macro LLD. Il possède les propriétés suivantes :

Propriété Type Description
macro string Macro LLD sur laquelle effectuer la vérification.

Comportement de la propriété :
- obligatoire
value string Valeur à comparer.

Comportement de la propriété :
- obligatoire si operator est défini sur « matches regular expression » ou « does not match regular expression »
formulaid string ID unique arbitraire utilisé pour référencer la condition à partir d'une expression personnalisée. Ne peut contenir que des lettres majuscules. L'ID doit être défini par l'utilisateur lors de la modification des conditions de filtre, mais sera généré à nouveau lors de leur demande ultérieure.

Comportement de la propriété :
- obligatoire si evaltype de l'objet de filtre de règle LLD est défini sur « custom expression »
operator integer Opérateur de condition.

Valeurs possibles :
8 - (par défaut) correspond à l'expression régulière ;
9 - ne correspond pas à l'expression régulière ;
12 - existe ;
13 - n'existe pas.

Pour mieux comprendre comment utiliser les filtres avec différents types d'expressions, consultez les exemples sur les pages des méthodes discoveryrule.get et discoveryrule.create.

Chemin de macro LLD

Le chemin de macro LLD possède les propriétés suivantes :

Propriété Type Description
lld_macro string Macro LLD.

Comportement de la propriété :
- obligatoire
path string Sélecteur de la valeur qui sera attribuée à la macro correspondante.

Comportement de la propriété :
- obligatoire

Prétraitement des règles LLD

L'objet de prétraitement des règles LLD possède les propriétés suivantes.

Propriété Type Description
type integer Le type d'option de prétraitement.

Valeurs possibles :
5 - Expression régulière ;
11 - XML XPath ;
12 - JSONPath ;
14 - Correspond à l'expression régulière ;
15 - Ne correspond pas à l'expression régulière ;
16 - Vérifier une erreur dans JSON ;
17 - Vérifier une erreur dans XML ;
20 - Ignorer les valeurs inchangées avec heartbeat ;
21 - JavaScript ;
23 - Prometheus vers JSON ;
24 - CSV vers JSON ;
25 - Remplacer ;
27 - XML vers JSON ;
28 - Valeur SNMP walk ;
29 - SNMP walk vers JSON ;
30 - Valeur SNMP get.

Comportement de la propriété :
- obligatoire
params string Paramètres supplémentaires utilisés par l'option de prétraitement. Plusieurs paramètres sont séparés par le caractère de nouvelle ligne (\n).

Comportement de la propriété :
- obligatoire si type est défini sur "Expression régulière" (5), "XML XPath" (11), "JSONPath" (12), "Correspond à l'expression régulière" (14), "Ne correspond pas à l'expression régulière" (15), "Vérifier une erreur dans JSON" (16), "Vérifier une erreur dans XML" (17), "Ignorer les valeurs inchangées avec heartbeat" (20), "JavaScript" (21), "Prometheus vers JSON" (23), "CSV vers JSON" (24), "Remplacer" (25), "Valeur SNMP walk" (28), "SNMP walk vers JSON" (29) ou "Valeur SNMP get" (30)
error_handler integer Type d'action utilisé en cas d'échec de l'étape de prétraitement.

Valeurs possibles :
0 - Le message d'erreur est défini par le serveur Zabbix ;
1 - Ignorer la valeur ;
2 - Définir une valeur personnalisée ;
3 - Définir un message d'erreur personnalisé.

Comportement de la propriété :
- obligatoire si type est défini sur "Expression régulière" (5), "XML XPath" (11), "JSONPath" (12), "Correspond à l'expression régulière" (14), "Ne correspond pas à l'expression régulière" (15), "Vérifier une erreur dans JSON" (16), "Vérifier une erreur dans XML" (17), "Prometheus vers JSON" (23), "CSV vers JSON" (24), "XML vers JSON" (27), "Valeur SNMP walk" (28), "SNMP walk vers JSON" (29) ou "Valeur SNMP get" (30)
error_handler_params string Paramètres du gestionnaire d'erreurs.

Comportement de la propriété :
- obligatoire si error_handler est défini sur "Définir une valeur personnalisée" ou "Définir un message d'erreur personnalisé"

Les paramètres et gestionnaires d'erreurs suivants sont pris en charge pour chaque type de prétraitement.

Type de prétraitement Nom Paramètre 1 Paramètre 2 Paramètre 3 Gestionnaires d'erreurs pris en charge
5 Expression régulière motif1 sortie2 0, 1, 2, 3
11 XML XPath chemin3 0, 1, 2, 3
12 JSONPath chemin3 0, 1, 2, 3
14 Correspond à l'expression régulière motif1 0, 1, 2, 3
15 Ne correspond pas à l'expression régulière motif1 0, 1, 2, 3
16 Vérifier une erreur dans JSON chemin3 0, 1, 2, 3
17 Vérifier une erreur dans XML chemin3 0, 1, 2, 3
20 Ignorer les valeurs inchangées avec heartbeat secondes4,\ 5
21 JavaScript script2
23 Prometheus vers JSON motif5,\ 6 0, 1, 2, 3
24 CSV vers JSON caractère2 caractère2 0,1 0, 1, 2, 3
25 Remplacer chaîne recherchée2 remplacement2
27 XML vers JSON 0, 1, 2, 3
28 Valeur SNMP walk OID2 Format :
0 - Inchangé
1 - UTF-8 depuis Hex-STRING
2 - MAC depuis Hex-STRING
3 - Entier depuis BITS		 0, 1, 2, 3
29 SNMP walk vers JSON7 Nom du champ2 Préfixe OID2 Format :
0 - Inchangé
1 - UTF-8 depuis Hex-STRING
2 - MAC depuis Hex-STRING
3 - Entier depuis BITS		 0, 1, 2, 3
30 Valeur SNMP get Format :
1 - UTF-8 depuis Hex-STRING
2 - MAC depuis Hex-STRING
3 - Entier depuis BITS		 0, 1, 2, 3

1 expression régulière
2 chaîne
3 JSONPath ou XML XPath
4 entier positif (avec prise en charge des suffixes de temps, par ex. 30s, 1m, 2h, 1d)
5 macro utilisateur
6 motif Prometheus suivant la syntaxe : <metric name>{<label name>="<label value>", ...} == <value>. Chaque composant du motif Prometheus (métrique, nom du label, valeur du label et valeur de la métrique) peut être une macro utilisateur.
7 Prend en charge plusieurs enregistrements "Nom du champ,Préfixe OID,Format" délimités par un caractère de nouvelle ligne.

Remplacements de règle LLD

L’objet de remplacements de règle LLD définit un ensemble de règles (filtres, conditions et opérations) utilisées pour remplacer les propriétés de différents objets prototypes. Il possède les propriétés suivantes :

Propriété Type Description
name string Nom de remplacement unique.

Comportement de la propriété :
- obligatoire
step integer Numéro d’ordre unique du remplacement.

Comportement de la propriété :
- obligatoire
stop integer Arrêter le traitement des remplacements suivants en cas de correspondance.

Valeurs possibles :
0 - (par défaut) ne pas arrêter le traitement des remplacements ;
1 - arrêter le traitement des remplacements si le filtre correspond.
filter object Filtre de remplacement.
operations object/array Opérations de remplacement.

Filtre de substitution de règle LLD

L’objet de filtre de substitution de règle LLD définit un ensemble de conditions qui, si elles correspondent à l’objet découvert, appliquent la substitution. Il possède les propriétés suivantes :

Propriété Type Description
conditions object/array Ensemble de conditions de filtre de substitution à utiliser pour faire correspondre les objets découverts. Les conditions seront triées dans l’ordre de leur placement dans la formule.

Comportement de la propriété :
- obligatoire
evaltype integer Méthode d’évaluation des conditions du filtre de substitution.

Valeurs possibles :
0 - Et/Ou ;
1 - Et ;
2 - Ou ;
3 - Expression personnalisée.

Comportement de la propriété :
- obligatoire
eval_formula string Expression générée qui sera utilisée pour évaluer les conditions du filtre de substitution. L’expression contient des identifiants qui référencent des conditions spécifiques du filtre de substitution par leur formulaid. La valeur de eval_formula est égale à la valeur de formula pour les filtres avec une expression personnalisée.

Comportement de la propriété :
- lecture seule
formula string Expression définie par l’utilisateur à utiliser pour évaluer les conditions des filtres de substitution avec une expression personnalisée. L’expression doit contenir des identifiants qui référencent des conditions spécifiques du filtre de substitution par leur formulaid. Les identifiants utilisés dans l’expression doivent correspondre exactement à ceux définis dans les conditions du filtre de substitution : aucune condition ne peut rester inutilisée ou omise.

Comportement de la propriété :
- obligatoire si evaltype est défini sur « custom expression »
Condition de filtre de substitution de règle LLD

L'objet de condition de filtre de substitution de règle LLD définit une vérification distincte à effectuer sur la valeur d'une macro LLD. Il possède les propriétés suivantes :

Propriété Type Description
macro string Macro LLD sur laquelle effectuer la vérification.

Comportement de la propriété :
- obligatoire
value string Valeur à comparer.

Comportement de la propriété :
- obligatoire si operator est défini sur « correspond à l'expression régulière » ou « ne correspond pas à l'expression régulière »
formulaid string ID unique arbitraire utilisé pour référencer la condition depuis une expression personnalisée. Ne peut contenir que des lettres majuscules. L'ID doit être défini par l'utilisateur lors de la modification des conditions de filtre, mais sera généré à nouveau lors de leur demande ultérieure.

Comportement de la propriété :
- obligatoire si evaltype de l'objet de filtre de substitution de règle LLD est défini sur « expression personnalisée »
operator integer Opérateur de condition.

Valeurs possibles :
8 - (par défaut) correspond à l'expression régulière ;
9 - ne correspond pas à l'expression régulière ;
12 - existe ;
13 - n'existe pas.

Opération de substitution de règle LLD

L'opération de substitution de règle LLD est une combinaison de conditions et d'actions à exécuter sur l'objet prototype. Elle possède les propriétés suivantes :

Propriété Type Description
operationobject integer Type d'objet découvert sur lequel exécuter l'action.

Valeurs possibles :
0 - Prototype d'élément ;
1 - Prototype de déclencheur ;
2 - Prototype de graphique ;
3 - Prototype d'hôte ;
4 - Prototype de découverte.

Comportement de la propriété :
- obligatoire
operator integer Opérateur de condition de substitution.

Valeurs possibles :
0 - (par défaut) égal à ;
1 - différent de ;
2 - contient ;
3 - ne contient pas ;
8 - correspond ;
9 - ne correspond pas.
value string Motif à faire correspondre au nom du prototype d'élément, de déclencheur, de graphique ou d'hôte selon l'objet sélectionné.
opstatus object Objet d'état de l'opération de substitution pour les objets prototype d'élément, de déclencheur et d'hôte.
opdiscover object Objet d'état de découverte de l'opération de substitution (tous les types d'objet).
opperiod object Objet de période (intervalle de mise à jour) de l'opération de substitution pour l'objet prototype d'élément.
ophistory object Objet d'historique de l'opération de substitution pour l'objet prototype d'élément.
optrends object Objet de tendances de l'opération de substitution pour l'objet prototype d'élément.
opseverity object Objet de gravité de l'opération de substitution pour l'objet prototype de déclencheur.
optag object/array Objet d'étiquette de l'opération de substitution pour les objets prototype de déclencheur et d'hôte.
optemplate object/array Objet de modèle de l'opération de substitution pour l'objet prototype d'hôte.
opinventory object Objet d'inventaire de l'opération de substitution pour l'objet prototype d'hôte.
Statut de l'opération de substitution de règle LLD

Statut de l'opération de substitution de règle LLD défini pour l'objet découvert. Il possède les propriétés suivantes :

Propriété Type Description
status integer Remplace le statut de l'objet sélectionné.

Valeurs possibles :
0 - Créer activé ;
1 - Créer désactivé.

Comportement de la propriété :
- obligatoire
Opération de découverte de substitution de règle LLD

Statut de découverte de l’opération de substitution de règle LLD défini pour l’objet découvert. Elle possède les propriétés suivantes :

Propriété Type Description
discover integer Remplace le statut de découverte pour l’objet sélectionné.

Valeurs possibles :
0 - Oui, continuer à découvrir les objets ;
1 - Non, les nouveaux objets ne seront pas découverts et les objets existants seront marqués comme perdus.

Comportement de la propriété :
- obligatoire
Période d’opération de surcharge de règle LLD

La période d’opération de surcharge de règle LLD est une valeur d’intervalle de mise à jour définie pour l’élément découvert. Elle possède les propriétés suivantes :

Propriété Type Description
delay string Remplace l’intervalle de mise à jour du prototype d’élément.

Accepte des secondes ou une unité de temps avec suffixe (par exemple, 30s, 1m, 2h, 1d) et, éventuellement, un ou plusieurs intervalles personnalisés, tous séparés par des points-virgules. Les intervalles personnalisés peuvent être un mélange d’intervalles flexibles et d’intervalles planifiés.

Accepte des macros utilisateur ou des macros LLD. Si elles sont utilisées, la valeur doit être une seule macro. Plusieurs macros ou des macros mélangées avec du texte ne sont pas prises en charge. Les intervalles flexibles peuvent être écrits sous forme de deux macros séparées par une barre oblique (par exemple, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Exemple :
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Comportement de la propriété :
- obligatoire
Historique de l’opération de surcharge de règle LLD

Valeur de l’historique de l’opération de surcharge de règle LLD définie pour l’élément découvert. Elle possède les propriétés suivantes :

Propriété Type Description
history string Surcharge l’historique du prototype d’élément, qui est une unité de temps indiquant combien de temps les données d’historique doivent être conservées. Accepte également les macros utilisateur et les macros LLD.

Comportement de la propriété :
- obligatoire
Tendances des opérations de substitution de règle LLD

Valeur des tendances des opérations de substitution de règle LLD définie pour l’élément découvert. Elle possède les propriétés suivantes :

Propriété Type Description
trends string Remplace les tendances du prototype d’élément, c’est-à-dire l’unité de temps indiquant combien de temps les données de tendances doivent être conservées. Accepte également une macro utilisateur et une macro LLD.

Comportement de la propriété :
- obligatoire
Gravité de l’opération de remplacement de règle LLD

Valeur de gravité de l’opération de remplacement de règle LLD définie pour le déclencheur découvert. Elle possède les propriétés suivantes :

Propriété Type Description
severity integer Remplace la gravité du prototype de déclencheur.

Valeurs possibles :
0 - (par défaut) non classé ;
1 - information ;
2 - avertissement ;
3 - moyen ;
4 - élevé ;
5 - désastre.

Comportement de la propriété :
- obligatoire
Balise d’opération de substitution de règle LLD

L’objet de balise d’opération de substitution de règle LLD contient le nom et la valeur de la balise qui sont définis sur l’objet découvert. Il possède les propriétés suivantes :

Propriété Type Description
tag string Nouveau nom de balise.

Comportement de la propriété :
- obligatoire
value string Nouvelle valeur de balise.
Modèle d’opération de substitution de règle LLD

Objet de modèle d’opération de substitution de règle LLD lié à l’hôte découvert.
Il possède les propriétés suivantes :

Propriété Type Description
templateid ID Remplace le modèle des modèles liés du prototype d’hôte.

Comportement de la propriété :
- obligatoire
Valeur du mode d'inventaire de l'opération de surcharge de règle LLD

Valeur du mode d'inventaire de l'opération de surcharge de règle LLD définie sur l'hôte découvert. Elle possède les propriétés suivantes :

Propriété Type Description
inventory_mode integer Remplace le mode d'inventaire du prototype d'hôte.

Valeurs possibles :
-1 - désactivé ;
0 - (par défaut) manuel ;
1 - automatique.

Comportement de la propriété :
- obligatoire