- Objet prototype de règle LLD
- Prototype de règle LLD
- Filtre de prototype de règle LLD
- Chemin de macro LLD
- Prétraitement du prototype de règle LLD
- Remplacements de prototypes de règle LLD
- Filtre de surcharge du prototype de règle LLD
- Opération de remplacement du prototype de règle LLD
- Statut de l'opération de remplacement du prototype de règle LLD
- Découverte de l’opération de remplacement du prototype de règle LLD
- Période d’opération de surcharge du prototype de règle LLD
- Historique de l’opération de surcharge du prototype de règle LLD
- Tendances de l’opération de substitution du prototype de règle LLD
- Gravité de l'opération de substitution du prototype de règle LLD
- Balise d’opération de substitution de prototype de règle LLD
- Modèle d’opération de substitution de prototype de règle LLD
- Valeur du mode d’inventaire de l’opération de substitution du prototype de règle LLD
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é : - lecture seule - obligatoire pour les opérations de mise à jour |
| ruleid | ID | ID de la règle LLD/prototype de règle LLD parent. Comportement de la propriété : - lecture seule - obligatoire pour les opérations de création |
| delay | string | Intervalle de mise à jour du prototype de règle LLD. 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 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 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 de l'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 - un prototype de règle de découverte de bas niveau ; 7 - un prototype de règle de découverte de bas niveau découvert. Comportement de la propriété : - lecture seule |
| interfaceid | ID | ID de l'interface 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 - 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 - 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 - Élément dépendant ; 19 - HTTP agent ; 20 - SNMP agent ; 21 - Script ; 22 - Browser ; 23 - Imbriqué. 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 | Permet de renseigner la valeur de manière similaire à un élément trapper. Valeurs possibles : 0 - (par défaut) Ne pas autoriser l'acceptation de données entrantes ; 1 - Autoriser l'acceptation de 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"- 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 d'erreur s'il y a des problèmes lors de la mise à jour de la valeur du prototype de 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 l'atteinte du seuil de durée de vie ; 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 l'atteinte du seuil de durée de vie ; 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 un élément maître pour 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 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 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 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 du prototype de 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 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 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 du prototype de 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 exemple, 30s, 1m). Accepte également les macros utilisateur. Plage de valeurs possibles : 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 prototypes de règle 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 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 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 identifiants 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 identifiants qui référencent des conditions de filtre spécifiques par leur formulaid. Les identifiants 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 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 | 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 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 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 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 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 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 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 suivants et les 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 la présence d'une erreur dans JSON | chemin3 | 0, 1, 2, 3 | ||
| 17 | Vérifier la présence d'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 de recherche2 | remplacement2 | ||
| 27 | XML vers JSON | 0, 1, 2, 3 | |||
| 28 | Valeur SNMP walk | OID2 | Format : 0 - Inchangé 1 - UTF-8 à partir de Hex-STRING 2 - MAC à partir de Hex-STRING 3 - Entier à partir de BITS |
0, 1, 2, 3 | |
| 29 | SNMP walk vers JSON7 | Nom du champ2 | Préfixe OID2 | Format : 0 - Inchangé 1 - UTF-8 à partir de Hex-STRING 2 - MAC à partir de Hex-STRING 3 - Entier à partir de BITS |
0, 1, 2, 3 |
| 30 | Valeur SNMP get | Format : 1 - UTF-8 à partir de Hex-STRING 2 - MAC à partir de Hex-STRING 3 - Entier à partir de 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 d'étiquette, valeur d'étiquette et valeur de 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 prototypes de règle LLD
L’objet de remplacements de prototypes 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 surcharge du prototype de règle LLD
L’objet de filtre de surcharge du prototype de règle LLD définit un ensemble de conditions qui, si elles correspondent à l’objet découvert, appliquent la surcharge. Il possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Ensemble de conditions de filtre de surcharge à 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 surcharge. 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 surcharge. L’expression contient des identifiants qui référencent des conditions spécifiques du filtre de surcharge 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 surcharge avec une expression personnalisée. L’expression doit contenir des identifiants qui référencent des conditions spécifiques du filtre de surcharge par leur formulaid. Les identifiants utilisés dans l’expression doivent correspondre exactement à ceux définis dans les conditions du filtre de surcharge : 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 remplacement de prototype de règle LLD
L'objet de condition de filtre de remplacement 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 remplacement 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 remplacement du prototype de règle LLD
L’opération de remplacement du 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 remplacement. 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 remplacement 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 remplacement (tous les types d’objet). |
| opperiod | object | Objet de période (intervalle de mise à jour) de l’opération de remplacement pour l’objet prototype d’élément. |
| ophistory | object | Objet d’historique de l’opération de remplacement pour l’objet prototype d’élément. |
| optrends | object | Objet de tendances de l’opération de remplacement pour l’objet prototype d’élément. |
| opseverity | object | Objet de sévérité de l’opération de remplacement pour l’objet prototype de déclencheur. |
| optag | object/array | Objet de balise de l’opération de remplacement pour les objets prototype de déclencheur et d’hôte. |
| optemplate | object/array | Objet de modèle de l’opération de remplacement pour l’objet prototype d’hôte. |
| opinventory | object | Objet d’inventaire de l’opération de remplacement 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 remplacement du prototype de règle LLD
Statut de découverte 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 |
|---|---|---|
| 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 du prototype de règle LLD
La période d’opération de surcharge 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 :
| 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 les macros utilisateur ou les macros LLD. 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 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 du prototype de règle LLD
Valeur de l’historique de l’opération de surcharge 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 | 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 la macro utilisateur et la 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 - désastre. 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 :
| 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 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 :
| Property | 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 substitution du prototype de règle LLD
Valeur du mode d’inventaire de l’opération de substitution du prototype de règle LLD définie pour 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 |