- Objet de règle LLD
- Règle LLD
- Filtre de règle LLD
- Chemin de macro LLD
- Prétraitement de la règle LLD
- Remplacements de règles LLD
- Filtre de remplacement de règle LLD
- Opération de remplacement de règle LLD
- Statut de l'opération de remplacement de règle LLD
- Opération de substitution de règle LLD discover
- Période d'opération de surcharge de règle LLD
- Historique des opérations de remplacement de règle LLD
- Tendances de l'opération de substitution de règle LLD
- Sévérité de l'opération de remplacement de règle LLD
- Balise d'opération de remplacement de règle LLD
- Modèle d'opération de remplacement de règle LLD
- Inventaire de l'opération de remplacement de règle LLD
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 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 planifiés. 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 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 d'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 possède 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 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 ; 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 s'il y a des 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 JMX agent. 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 soit 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 soit 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 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 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 navigateur. 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 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 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 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 du 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é : - requis |
| value | string | Valeur de l'en-tête. Comportement de la propriété : - requis |
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 qui peuvent être utilisées pour filtrer les objets découverts. Il possède les propriétés suivantes :
| Property | 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é: - required |
| evaltype | integer | Méthode d'évaluation des conditions de filtre. Valeurs possibles : 0 - And/Or; 1 - And; 2 - Or; 3 - Expression personnalisée. Comportement de la propriété: - required |
| 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 via 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é: - read-only |
| 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 via 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é: - required 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 :
| Property | Type | Description |
|---|---|---|
| macro | string | Macro LLD sur laquelle effectuer la vérification. Property behavior: - required |
| value | string | Valeur à comparer. Property behavior: - required 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 depuis une expression personnalisée. Peut contenir uniquement 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 des requêtes ultérieures. Property behavior: - required si evaltype de LLD rule filter object est défini sur "custom expression" |
| operator | integer | Opérateur de condition. Valeurs possibles : 8 - (default) correspond à une expression régulière ; 9 - ne correspond pas à une 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 de la règle LLD
L'objet de prétraitement de la règle LLD possède les propriétés suivantes.
| Property | 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 l'erreur dans JSON; 17 - Vérifier l'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 de parcours SNMP; 29 - Parcours SNMP vers JSON; 30 - Valeur SNMP get. Property behavior: - required |
| 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). Property behavior: - required 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 l'erreur dans JSON" (16), "Vérifier l'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 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é. Property behavior: - required 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 l'erreur dans JSON" (16), "Vérifier l'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. Property behavior: - required 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.
| Preprocessing type | Name | Parameter 1 | Parameter 2 | Parameter 3 | Supported error handlers |
|---|---|---|---|---|---|
| 5 | Expression régulière | pattern1 | output2 | 0, 1, 2, 3 | |
| 11 | XML XPath | path3 | 0, 1, 2, 3 | ||
| 12 | JSONPath | path3 | 0, 1, 2, 3 | ||
| 14 | Correspond à l'expression régulière | pattern1 | 0, 1, 2, 3 | ||
| 15 | Ne correspond pas à l'expression régulière | pattern1 | 0, 1, 2, 3 | ||
| 16 | Vérifier l'erreur dans JSON | path3 | 0, 1, 2, 3 | ||
| 17 | Vérifier l'erreur dans XML | path3 | 0, 1, 2, 3 | ||
| 20 | Ignorer les valeurs inchangées avec heartbeat | 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 à partir de Hex-STRING 2 - MAC à partir de Hex-STRING 3 - Entier à partir de BITS |
0, 1, 2, 3 | |
| 29 | Parcours SNMP vers JSON7 | Field name2 | OID prefix2 | 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 modèle Prometheus suivant la syntaxe :
<metric name>{<label name>="<label value>", ...} == <value>. Chaque
composant du modèle Prometheus (metric, label name, label value et metric
value) 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 règles LLD
L'objet des remplacements 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 prototype. Il possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| name | string | Nom unique du remplacement. Property behavior: - required |
| step | integer | Numéro d'ordre unique du remplacement. Property behavior: - required |
| stop | integer | Arrêter le traitement des remplacements suivants si une correspondance est trouvée. Valeurs possibles : 0 - (default) 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 remplacement de règle LLD
L'objet de filtre de remplacement de règle LLD définit un ensemble de conditions qui, si elles correspondent à l'objet découvert, appliquent le remplacement. Il possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Ensemble de conditions de filtre de remplacement à 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é: - required |
| evaltype | integer | Méthode d'évaluation des conditions du filtre de remplacement. Valeurs possibles : 0 - And/Or; 1 - And; 2 - Or; 3 - Expression personnalisée. Comportement de la propriété: - required |
| eval_formula | string | Expression générée qui sera utilisée pour évaluer les conditions du filtre de remplacement. L'expression contient des ID qui font référence à des conditions spécifiques du filtre de remplacement via 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é: - read-only |
| formula | string | Expression définie par l'utilisateur à utiliser pour évaluer les conditions des filtres de remplacement avec une expression personnalisée. L'expression doit contenir des ID qui font référence à des conditions spécifiques du filtre de remplacement via leur formulaid. Les ID utilisés dans l'expression doivent correspondre exactement à ceux définis dans les conditions du filtre de remplacement : aucune condition ne peut rester inutilisée ou omise.Comportement de la propriété: - required si evaltype est défini sur "custom expression" |
Condition de filtre de remplacement de règle LLD
L'objet de condition de filtre de remplacement 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 :
| Property | Type | Description |
|---|---|---|
| macro | string | Macro LLD sur laquelle effectuer la vérification. Comportement de la propriété: - required |
| value | string | Valeur à comparer. Comportement de la propriété: - required 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 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 des requêtes ultérieures. Comportement de la propriété: - required si evaltype de l'objet de filtre de remplacement de règle LLD est défini sur "custom expression" |
| operator | integer | Opérateur de condition. Valeurs possibles : 8 - (default) 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 de règle LLD
L'opération de remplacement 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 :
| Property | 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; 4 - prototype de découverte. Comportement de la propriété: - required |
| operator | integer | Opérateur de la 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 | Modèle à 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 de l'opération de remplacement (intervalle de mise à jour) 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 gravité 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 de règle LLD
Statut de l'opération de remplacement de règle LLD défini pour l'objet découvert. Il possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| status | integer | Remplacer le statut de l'objet sélectionné. Valeurs possibles : 0 - Création activée ; 1 - Création désactivée. Comportement de la propriété : - required |
Opération de substitution de règle LLD discover
L'opération de substitution de règle LLD discover du statut défini sur l'objet découvert. Elle possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| discover | integer | Remplacer 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. Property behavior: - required |
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 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é : - required |
Historique des opérations de remplacement de règle LLD
Valeur de l'historique des opérations de remplacement de règle LLD qui est définie sur l'élément découvert. Elle possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| history | string | Remplace l'historique du prototype d'élément, qui correspond à une unité de temps indiquant pendant combien de temps les données d'historique doivent être conservées. Accepte également les macros utilisateur et les macros LLD. Property behavior: - required |
Tendances de l'opération de substitution de règle LLD
Valeur des tendances de l'opération 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 pendant laquelle les données de tendances doivent être conservées. Accepte également une macro utilisateur et une macro LLD. Comportement de la propriété : - obligatoire |
Sévérité de l'opération de remplacement de règle LLD
Valeur de sévérité de l'opération de remplacement de règle LLD qui est définie pour le déclencheur découvert. Elle possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| severity | integer | Remplace la sévérité du prototype de déclencheur. Valeurs possibles : 0 - (par défaut) non classifié; 1 - information; 2 - avertissement; 3 - moyen; 4 - élevé; 5 - catastrophe. Comportement de la propriété: - requis |
Balise d'opération de remplacement de règle LLD
L'objet de balise d'opération de remplacement de règle LLD contient le nom et la valeur de la balise qui sont définis pour 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é: - required |
| value | string | Nouvelle valeur de balise. |
Modèle d'opération de remplacement de règle LLD
Objet de modèle d'opération de remplacement de règle LLD lié à l'hôte découvert. Il possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| templateid | ID | Remplacer le modèle des modèles liés du prototype d'hôte. Property behavior: - required |
Inventaire de l'opération de remplacement de règle LLD
Valeur du mode d'inventaire de l'opération de remplacement de règle LLD qui est définie pour l'hôte découvert. Elle possède les propriétés suivantes :
| Property | 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é : - required |