Objet prototype de règle LLD

Les objets suivants sont directement liés à l'API discoveryruleprototype.

Prototype de règle LLD

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

Property Type Description
itemid ID ID du prototype de règle LLD.

Comportement de la propriété :
- en lecture seule
- obligatoire pour les opérations de mise à jour
ruleid ID ID de la règle LLD parente ou du prototype de règle LLD parent.

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

Accepte un nombre de secondes (par exemple, 1, 60, 300), une valeur avec un suffixe temporel (par exemple, 30s, 1m, 2h, 1d) ou, éventuellement, un ou plusieurs intervalles personnalisés, séparés par des points-virgules. Les intervalles personnalisés peuvent combiner des intervalles flexibles et des intervalles de planification.

Accepte les macros utilisateur. Si elle est utilisée, la valeur doit être une macro unique. Les macros multiples ou les macros combinées à 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 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 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 du hôte auquel appartient le prototype de règle LLD.

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

Valeurs possibles :
3 - prototype de règle de découverte de bas niveau ;
7 - prototype de règle de découverte de bas niveau découvert.

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

Comportement de la propriété :
- obligatoire si le prototype de 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 le prototype de 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é du prototype de règle LLD. Au moins une macro LLD est requise.

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

Comportement de la propriété :
- obligatoire pour les opérations de création
- en lecture seule pour les objets hérités
type integer Type du prototype de 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 - Dependent item ;
19 - HTTP agent ;
20 - SNMP agent ;
21 - Script ;
22 - Browser ;
23 - Nested.

Comportement de la propriété :
- obligatoire pour les opérations de création
- en lecture seule pour les objets hérités
url string Chaîne d’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 »
- en lecture seule pour les objets hérités
allow_traps integer Autoriser le remplissage de la valeur comme pour 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.

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

Comportement de la propriété :
- en lecture seule
follow_redirects integer Suivre les redirections de la 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 »
- en lecture seule pour les objets hérités
headers array Tableau d’en-têtes 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 »
- en 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 »
- en 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 »
- en lecture seule pour les objets hérités
jmx_endpoint string Chaîne de connexion personnalisée de l’agent JMX.

Valeur 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 un nombre de secondes (par exemple, 1, 60, 300), une valeur avec un suffixe temporel (par exemple, 30s, 1m, 2h, 1d) ou une macro utilisateur.

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

Valeurs possibles :
0 - (par défaut) Supprimer une fois le seuil de durée de vie 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 un nombre de secondes (par exemple, 1, 60, 300), une valeur avec un suffixe temporel (par exemple, 30s, 1m, 2h, 1d) ou une macro utilisateur.

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

Valeurs possibles :
0 - Désactiver une fois le seuil de durée de vie atteint ;
1 - Ne pas désactiver ;
2 - (par défaut) Désactiver immédiatement.
master_itemid ID ID de l’élément maître.
La 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 »
- en 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 les données brutes ;
1 - Convertir en JSON.

Comportement de la propriété :
- pris en charge si type est défini sur « HTTP agent »
- en lecture seule pour les objets hérités
params string Paramètres supplémentaires selon le type du prototype de 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 ;
- script pour les règles LLD de type script et navigateur.

Comportement de la propriété :
- obligatoire si type est défini sur « Database monitor », « SSH agent », « TELNET agent », « Script » ou « Browser »
- en 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 possédant 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 »
- en lecture seule pour les objets hérités
password string Mot de passe d’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 »
- en 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 »
- en 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 « Données JSON » ou « Données XML »
- pris en charge si type est défini sur « HTTP agent » et que post_type est défini sur « Données brutes »
- en 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 « clé publique »
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 « clé publique »
query_fields array Tableau de champs de requête 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 »
- en 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 »
- en lecture seule pour les objets hérités
retrieve_mode integer Partie de la réponse à stocker.

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 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 »
- en 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 »
- en 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 »
- en 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 »
- en 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 »
- en lecture seule pour les objets hérités
state integer État du prototype de règle LLD.

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

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

Valeurs possibles :
0 - (par défaut) prototype de règle LLD activé ;
1 - prototype de règle LLD désactivé.
status_codes string Plages de codes d’état HTTP requis, séparées par des virgules. Prend également en charge les macros utilisateur dans 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 »
- en lecture seule pour les objets hérités
templateid ID ID du prototype de règle LLD parent du modèle.

Comportement de la propriété :
- en lecture seule
timeout string Délai d’expiration de la requête d’interrogation des données de l’élément.
Accepte un nombre de secondes (par exemple, 1, 60, 300) ou une valeur avec un suffixe temporel (par exemple, 30s, 1m). Accepte également les macros utilisateur.

Plage de valeurs possibles : 1-600s.

Valeur par défaut : "" - utiliser les paramètres du proxy ou les paramètres 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)
- en 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 « Autoriser l’acceptation des données entrantes ».
Si la propriété est omise, elle est automatiquement définie sur la macro utilisateur {$TRAPPER.ALLOWED_HOSTS} (valeur par défaut). Par défaut, {$TRAPPER.ALLOWED_HOSTS} vaut 127.0.0.1,::1.
Si la propriété est définie sur une chaîne vide, les connexions entrantes seront refusées pour tous les hôtes.
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 »
- en lecture seule pour les objets hérités (si type est défini sur « HTTP agent »)
uuid string Identifiant unique universel, utilisé pour associer les prototypes de règles LLD importés à ceux qui existent déjà. Généré automatiquement s’il n’est pas fourni.

Comportement de la propriété :
- pris en charge si le prototype de règle LLD appartient à un modèle
verify_host integer Indique s’il faut vérifier que le nom du hôte de la connexion correspond à celui indiqué dans le certificat du hôte.

Valeurs possibles :
0 - (par défaut) Ne pas vérifier ;
1 - Vérifier.

Comportement de la propriété :
- pris en charge si type est défini sur « HTTP agent »
- en lecture seule pour les objets hérités
verify_peer integer Indique s’il faut vérifier que le certificat du hôte est authentique.

Valeurs possibles :
0 - (par défaut) Ne pas vérifier ;
1 - Vérifier.

Comportement de la propriété :
- pris en charge si type est défini sur « HTTP agent »
- en 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 prototype de règle LLD

L'objet de filtre de prototype 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 référencent 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 référencent 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 "expression personnalisée"

Condition de filtre du prototype de règle LLD

L'objet de condition de filtre du prototype 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 du prototype 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.

Pour mieux comprendre comment utiliser les filtres avec différents types d'expressions, consultez les exemples dans les pages des méthodes discoveryruleprototype.get et discoveryruleprototype.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 du prototype de règle LLD

L’objet de prétraitement du prototype de règle LLD possède les propriétés suivantes.

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

Valeurs possibles :
5 - Expression régulière ;
11 - XPath XML ;
12 - JSONPath ;
14 - Correspond à une expression régulière ;
15 - Ne correspond pas à une expression régulière ;
16 - Vérifier la présence d’une erreur dans JSON ;
17 - Vérifier la présence d’une erreur dans XML ;
20 - Ignorer les valeurs inchangées avec intervalle de contrôle ;
21 - JavaScript ;
23 - Prometheus vers JSON ;
24 - CSV vers JSON ;
25 - Remplacer ;
27 - XML vers JSON ;
28 - Valeur de parcours SNMP ;
29 - Parcours SNMP 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), « XPath XML » (11), « JSONPath » (12), « Correspond à une expression régulière » (14), « Ne correspond pas à une expression régulière » (15), « Vérifier la présence d’une erreur dans JSON » (16), « Vérifier la présence d’une erreur dans XML » (17), « Ignorer les valeurs inchangées avec intervalle de contrôle » (20), « JavaScript » (21), « Prometheus vers JSON » (23), « CSV vers JSON » (24), « Remplacer » (25), « Valeur de parcours SNMP » (28), « Parcours SNMP 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), « XPath XML » (11), « JSONPath » (12), « Correspond à une expression régulière » (14), « Ne correspond pas à une expression régulière » (15), « Vérifier la présence d’une erreur dans JSON » (16), « Vérifier la présence d’une erreur dans XML » (17), « Prometheus vers JSON » (23), « CSV vers JSON » (24), « XML vers JSON » (27), « Valeur de parcours SNMP » (28), « Parcours SNMP 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 pattern1 output2 0, 1, 2, 3
11 XPath XML path3 0, 1, 2, 3
12 JSONPath path3 0, 1, 2, 3
14 Correspond à une expression régulière pattern1 0, 1, 2, 3
15 Ne correspond pas à une expression régulière pattern1 0, 1, 2, 3
16 Vérifier la présence d’une erreur dans JSON path3 0, 1, 2, 3
17 Vérifier la présence d’une erreur dans XML path3 0, 1, 2, 3
20 Ignorer les valeurs inchangées avec intervalle de contrôle seconds4, 5
21 JavaScript script2
23 Prometheus vers JSON pattern5, 6 0, 1, 2, 3
24 CSV vers JSON character2 character2 0,1 0, 1, 2, 3
25 Remplacer search string2 replacement2
27 XML vers JSON 0, 1, 2, 3
28 Valeur de parcours SNMP OID2 Format :
0 - Inchangé
1 - UTF-8 depuis Hex-STRING
2 - MAC depuis Hex-STRING
3 - Entier depuis BITS		 0, 1, 2, 3
29 Parcours SNMP vers JSON7 Field name2 OID prefix2 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 XPath XML
4 entier positif (avec prise en charge des suffixes de temps, par exemple 30s, 1m, 2h, 1d)
5 macro utilisateur
6 modèle Prometheus suivant la syntaxe : <metric name>{<label name>="<label value>", ...} == <value>. Chaque composant du modèle Prometheus (métrique, nom du libellé, valeur du libellé et valeur de la métrique) peut être une macro utilisateur.
7 Prend en charge plusieurs enregistrements « Field name,OID prefix,Format » délimités par un caractère de nouvelle ligne.

Remplacements de prototypes de règles LLD

L'objet de remplacements de prototypes de règles 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 du prototype de règle LLD

L'objet de filtre de substitution du prototype 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 ID 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 ID qui référencent des conditions spécifiques du filtre de substitution par leur formulaid. Les ID 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 "expression personnalisée"
Condition de filtre de substitution de prototype de règle LLD

L'objet de condition de filtre de substitution de prototype 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 prototype 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 surcharge de prototype de règle LLD

L'opération de surcharge de prototype de règle LLD est une combinaison de conditions et d'actions à effectuer 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 effectuer l'action.

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

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

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 d'opération de surcharge pour les objets prototype d'élément, de déclencheur et d'hôte.
opdiscover object Objet d'état de découverte d'opération de surcharge (tous les types d'objet).
opperiod object Objet de période d'opération de surcharge (intervalle de mise à jour) pour l'objet prototype d'élément.
ophistory object Objet d'historique d'opération de surcharge pour l'objet prototype d'élément.
optrends object Objet de tendances d'opération de surcharge pour l'objet prototype d'élément.
opseverity object Objet de gravité d'opération de surcharge pour l'objet prototype de déclencheur.
optag object/array Objet d'étiquette d'opération de surcharge pour les objets prototype de déclencheur et d'hôte.
optemplate object/array Objet de modèle d'opération de surcharge pour l'objet prototype d'hôte.
opinventory object Objet d'inventaire d'opération de surcharge pour l'objet prototype d'hôte.
Statut de l'opération de remplacement du prototype de règle LLD

Statut de l'opération de remplacement du prototype 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
Découverte de l'opération de substitution du prototype de règle LLD

Statut de découverte de l'opération de substitution du prototype de règle LLD défini sur l'objet découvert. Il 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 de fonctionnement de la substitution du prototype de règle LLD

La période de fonctionnement de la substitution du prototype 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 :

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

Accepte un nombre de secondes (par exemple, 1, 60, 300), une valeur avec un suffixe temporel (par exemple, 30s, 1m, 2h, 1d) ou, éventuellement, un ou plusieurs intervalles personnalisés, tous séparés par des points-virgules. Les intervalles personnalisés peuvent être une combinaison d’intervalles flexibles et d’intervalles de planification.

Accepte les macros utilisateur ou les macros LLD. Si elle est utilisée, la valeur doit être une macro unique. Plusieurs macros ou des macros combinées à du texte ne sont pas pris en charge. Les intervalles flexibles peuvent être écrits sous la 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é :
- required
Historique de l'opération de substitution du prototype de règle LLD

Valeur de l'historique de l'opération de substitution du prototype 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 Remplace l’historique du prototype d’élément, qui est une unité de temps définissant la durée de conservation des données d’historique. Accepte également une macro utilisateur et une macro LLD.

Comportement de la propriété :
- obligatoire
Tendances de l'opération de substitution du prototype de règle LLD

Valeur des tendances de l'opération de substitution du prototype 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 une 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 substitution du prototype de règle LLD

Valeur de gravité de l'opération de substitution du prototype 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 - moyenne ;
4 - élevée ;
5 - sinistre.

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

L'objet de balise d'opération de substitution de prototype 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 :

Property 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 prototype de règle LLD

Objet de modèle d'opération de substitution de prototype 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 remplacement du prototype de règle LLD

Valeur du mode d'inventaire de l'opération de remplacement du prototype 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 des propriétés :
- obligatoire