4 Hôtes

Vue d'ensemble

Les hôtes sont exportés avec de nombreux objets liés et relations entre objets.

L'export d'hôte contient :

  • Les groupes d'hôtes liés
  • Les données de l'hôte
  • La liaison au modèle
  • La liaison au groupe d'hôtes
  • Les interfaces de l'hôte
  • Les éléments directement liés
  • Les déclencheurs directement liés
  • Les règles de découverte directement liées avec tous les prototypes
  • Les scénarios web directement liés
  • Les macros d'hôte
  • Les données d'inventaire de l'hôte
  • Les correspondances de valeurs
  • Les graphiques liés

Exportation

Pour exporter des hôtes, procédez comme suit :

  1. Accédez à Collecte de données → Hôtes.
  2. Cochez les cases des hôtes à exporter.
  3. Cliquez sur Exporter sous la liste.

Selon le format sélectionné, les hôtes sont exportés vers un fichier local portant un nom par défaut :

  • zabbix_export_hosts.yaml - pour l’exportation au format YAML (option par défaut pour l’exportation) ;
  • zabbix_export_hosts.xml - pour l’exportation au format XML ;
  • zabbix_export_hosts.json - pour l’exportation au format JSON.

Importation

Pour importer des hôtes, procédez comme suit :

  1. Accédez à Collecte de données → Hôtes.
  2. Cliquez sur Importer dans le coin supérieur droit.
  3. Sélectionnez le fichier d'importation.
  4. Cliquez sur Importer dans le coin inférieur droit du formulaire de configuration.

Si vous cochez la case Options avancées, une liste détaillée de tous les éléments importables s'affichera - cochez ou décochez chaque règle d'importation selon les besoins.

Si vous cliquez sur la case à cocher de la ligne Tous, tous les éléments situés en dessous seront cochés/décochés.

Règles d'importation :

Rule Description
Update existing Les éléments existants seront mis à jour à l'aide des données du fichier d'importation. Sinon, ils ne seront pas mis à jour.
Create new De nouveaux éléments seront créés à l'aide des données du fichier d'importation. Sinon, ils ne seront pas créés.
Delete missing Les éléments existants absents du fichier d'importation seront supprimés. Sinon, ils ne seront pas supprimés.
Si Delete missing est activé pour Template linkage, le lien de modèle actuel absent du fichier d'importation sera dissocié. Les entités (éléments, déclencheurs, graphiques, etc.) héritées des modèles dissociés ne seront pas supprimées (sauf si l'option Delete missing est également sélectionnée pour chaque entité).

Un message de réussite ou d'échec de l'importation s'affichera dans l'interface.

Format d'export

Format d'export en YAML :

zabbix_export:
  version: '7.0'
  host_groups:
    - uuid: f2481361f99448eea617b7b1d4765566
      name: 'Hôtes découverts'
    - uuid: 6f6799aa69e844b4b3918f779f2abf08
      name: 'Serveurs Zabbix'
  hosts:
    - host: 'Zabbix server 1'
      name: 'Serveur Zabbix principal'
      monitored_by: 'SERVER'
      templates:
        - name: 'Linux by Zabbix agent'
        - name: 'État de santé du serveur Zabbix'
      groups:
        - name: 'Hôtes découverts'
        - name: 'Serveurs Zabbix'
      interfaces:
        - ip: 192.168.1.1
          interface_ref: if1
      items:
        - name: 'Zabbix trap'
          type: TRAP
          key: trap
          delay: '0'
          history: 1w
          preprocessing:
            - type: MULTIPLIER
              parameters:
                - '8'
          tags:
            - tag: component
              value: 'raw'
          triggers:
            - expression: 'last(/Zabbix server 1/trap)=0'
              name: 'La dernière valeur est zéro'
              priority: WARNING
              tags:
                - tag: scope
                  value: 'availability'
      tags:
        - tag: service
          value: zabbix-server
      macros:
        - macro: '{$HOST.MACRO}'
          value: '123'
        - macro: '{$PASSWORD1}'
          type: SECRET_TEXT
      inventory:
        type: 'Serveur Zabbix'
        name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC
        os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64'
      inventory_mode: AUTOMATIC
  graphs:
    - name: 'Utilisation CPU du serveur'
      show_work_period: 'NO'
      show_triggers: 'NO'
      graph_items:
        - drawtype: FILLED_REGION
          color: FF5555
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,steal]'
        - sortorder: '1'
          drawtype: FILLED_REGION
          color: 55FF55
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,softirq]'
        - sortorder: '2'
          drawtype: FILLED_REGION
          color: '009999'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,interrupt]'
        - sortorder: '3'
          drawtype: FILLED_REGION
          color: '990099'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,nice]'
        - sortorder: '4'
          drawtype: FILLED_REGION
          color: '999900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,iowait]'
        - sortorder: '5'
          drawtype: FILLED_REGION
          color: '990000'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,system]'
        - sortorder: '6'
          drawtype: FILLED_REGION
          color: '000099'
          calc_fnc: MIN
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,user]'
        - sortorder: '7'
          drawtype: FILLED_REGION
          color: '009900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,idle]'

Éléments exportés

Les éléments exportés sont expliqués dans les tableaux ci-dessous.

Element Type Description
version string (required) Version de Zabbix.
host_groups (required) Élément racine pour les groupes d'hôtes.
uuid string (required) Identifiant unique pour ce groupe d'hôtes.
name string (required) Nom du groupe d'hôtes.
hosts Élément racine pour les hôtes.

Hôtes

Element Type Description
host string (required) Nom unique de l'hôte.
name string Nom visible de l'hôte.
description text Description de l'hôte.
monitored_by string L'hôte est surveillé par : SERVER, PROXY ou PROXY_GROUP.
proxy Élément racine pour le proxy.
name string (required) Nom du proxy (le cas échéant) qui surveille l'hôte.
proxy_group Élément racine pour le groupe de proxy.
name string (required) Nom du groupe de proxy (le cas échéant) utilisé pour surveiller l'hôte.
status string Statut de l'hôte.
Valeurs possibles :1 ENABLED (0, par défaut), DISABLED (1).
ipmi_authtype string Type d'authentification de session IPMI.
Valeurs possibles :1 DEFAULT (-1, par défaut), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP_PLUS (6).
ipmi_privilege string Niveau de privilège de session IPMI.
Valeurs possibles :1 CALLBACK (1), USER (2, par défaut), OPERATOR (3), ADMIN (4), OEM (5).
ipmi_username string Nom d'utilisateur pour les vérifications IPMI.
ipmi_password string Mot de passe pour les vérifications IPMI.
templates Élément racine pour les modèles liés.
name string (required) Nom du modèle.
groups Élément racine pour les groupes d'hôtes auxquels l'hôte appartient.
name string (required) Nom du groupe d'hôtes.
interfaces Élément racine pour les interfaces d'hôte.
items Élément racine pour les éléments de l'hôte.
discovery_rules Élément racine pour les règles de découverte de bas niveau de l'hôte.
http_tests Élément racine pour les scénarios web de l'hôte.
tags Élément racine pour les tags de l'hôte.
tag string (required) Nom du tag.
value string Valeur du tag.
macros Élément racine pour les macros de l'hôte.
macro string (required) Nom de la macro utilisateur.
type string Type de macro utilisateur.
Valeurs possibles :1 TEXT (0, par défaut), SECRET_TEXT (1), VAULT (2).
value string Valeur de la macro utilisateur.
description string Description de la macro utilisateur.
inventory Élément racine pour l'inventaire de l'hôte.
<inventory_property> string Propriété d'inventaire. Toutes les propriétés ont leur propre élément (type, name, os, etc. ; par exemple, voir Format d'export).
inventory_mode string Mode d'inventaire.
Valeurs possibles :1 DISABLED (-1), MANUAL (0, par défaut), AUTOMATIC (1).
valuemaps Élément racine pour les cartes de valeurs de l'hôte.

Voir aussi : Objet Host (reportez-vous à la propriété correspondante portant le même nom).

Interfaces de l'hôte

Element Type Description
default string Indique s'il s'agit de l'interface principale de l'hôte. Notez qu'il ne peut y avoir qu'une seule interface principale d'un même type sur un hôte.
Valeurs possibles:1 NO (0), YES (1, default).
type string Type d'interface.
Valeurs possibles:1 ZABBIX (1, default), SNMP (2), IPMI (3), JMX (4).
useip string Indique s'il faut utiliser l'adresse IP comme interface pour se connecter à l'hôte (sinon, le DNS sera utilisé).
Valeurs possibles:1 NO (0), YES (1, default).
ip string (required for IP connections) Adresse IP (IPv4 ou IPv6).
dns string (required for DNS connections) Nom DNS.
port string Numéro de port.
details Élément racine pour les détails de l'interface.
version string Utiliser cette version SNMP.
Valeurs possibles:1 SNMPV1 (1), SNMP_V2C (2, default), SNMP_V3 (3).
community string (required for SNMPv1 and SNMPv2 items) Communauté SNMP.
max_repetitions string Valeur maximale de répétition pour les requêtes SNMP bulk natives (GetBulkRequest-PDUs).
Pris en charge pour les éléments SNMPv2 et SNMPv3 (discovery[] et walk[]).
Par défaut: 10.
contextname string Nom de contexte SNMPv3.
Pris en charge pour les éléments SNMPv3.
securityname string Nom de sécurité SNMPv3.
Pris en charge pour les éléments SNMPv3.
securitylevel string Niveau de sécurité SNMPv3.
Pris en charge pour les éléments SNMPv3.
Valeurs possibles:1 NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).
authprotocol string Protocole d'authentification SNMPv3.
Pris en charge pour les éléments SNMPv3.
Valeurs possibles:1 MD5 (0, default), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).
authpassphrase string Phrase secrète d'authentification SNMPv3.
Pris en charge pour les éléments SNMPv3.
privprotocol string Protocole de confidentialité SNMPv3.
Pris en charge pour les éléments SNMPv3.
Valeurs possibles:1 DES (0, default), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).
privpassphrase string Phrase secrète de confidentialité SNMPv3.
Pris en charge pour les éléments SNMPv3.
bulk string Utiliser des requêtes bulk pour SNMP.
Valeurs possibles:1 NO (0), YES (1, default).
interface_ref string Nom de référence d'interface à utiliser dans les éléments (format: if<N>).

Voir aussi: Objet interface de l'hôte (se référer à la propriété correspondante portant le même nom).

Éléments de l'hôte

Element Type Description
name string (required) Nom de l'élément.
type string Type d'élément.
Valeurs possibles :1 ZABBIX_PASSIVE (0, par défaut), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP_TRAP (17), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
snmp_oid string (required for SNMP_AGENT items) ID d'objet SNMP.
key string (required) Clé de l'élément.
delay string Intervalle de mise à jour de l'élément.
Par défaut : 1m. La valeur sera toujours 0 pour les éléments TRAP.
history string Période de temps (en utilisant un suffixe de temps, une macro utilisateur ou une macro LLD) pendant laquelle les données d'historique doivent être conservées.
Par défaut : 31d.
trends string Période de temps (en utilisant un suffixe de temps, une macro utilisateur ou une macro LLD) pendant laquelle les données de tendances doivent être conservées.
Par défaut : 365d.
status string Statut de l'élément.
Valeurs possibles :1 ENABLED (0, par défaut), DISABLED (1).
value_type string Type de valeur reçue.
Valeurs possibles :1 FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, par défaut), TEXT (4), BINARY (5).
allowed_hosts string Liste d'adresses IP d'hôtes, séparées par des virgules, autorisées à envoyer des données pour l'élément.
Pris en charge pour les éléments TRAP et HTTP_AGENT.
units string Unités de la valeur reçue (bps, B, etc.).
params text Paramètres supplémentaires selon le type de l'élément (script exécuté pour les éléments SSH et TELNET ; requête SQL pour les éléments ODBC ; formule pour les éléments CALCULATED ; script pour les éléments ITEM_TYPE_SCRIPT et ITEM_TYPE_BROWSER).
ipmi_sensor string Capteur IPMI.
Pris en charge pour les éléments IPMI.
authtype string Type d'authentification.
Pris en charge pour les éléments SSH et HTTP_AGENT.
Valeurs possibles pour les éléments SSH :1 PASSWORD (0, par défaut), PUBLIC_KEY (1).
Valeurs possibles pour les éléments HTTP_AGENT :1 NONE (0, par défaut), BASIC (1), NTLM (2), Kerberos (3) ou Digest (4).
username string (required for SSH and TELNET items) Nom d'utilisateur pour l'authentification.
Pris en charge pour les éléments SIMPLE, ODBC, JMX et HTTP_AGENT.
Lorsqu'il est utilisé pour les éléments JMX, password (voir ci-dessous) doit également être spécifié, ou bien les deux éléments doivent être laissés vides.
password string (required for SSH and TELNET items) Mot de passe pour l'authentification.
Pris en charge pour les éléments SIMPLE, ODBC, JMX et HTTP_AGENT.
Lorsqu'il est utilisé pour les éléments JMX, username (voir ci-dessus) doit également être spécifié, ou bien les deux éléments doivent être laissés vides.
publickey string (required for SSH items) Nom du fichier de clé publique.
privatekey string (required for SSH items) Nom du fichier de clé privée.
description text Description de l'élément.
inventory_link string Champ d'inventaire de l'hôte renseigné par l'élément.
Valeurs possibles :1 NONE (0), ALIAS (4), etc. (voir Inventaire de l'hôte pour les champs pris en charge).
valuemap Élément racine pour les mappages de valeurs de l'élément.
name string (required) Nom du mappage de valeurs à utiliser pour l'élément.
logtimefmt string Format de l'heure dans les entrées de journal.
Pris en charge pour les éléments de type de valeur LOG.
preprocessing Élément racine pour le prétraitement des valeurs de l'élément.
step Élément racine pour les étapes de prétraitement des valeurs des éléments de l'hôte.
interface_ref string Référence à l'interface de l'hôte (format : if<N>).
jmx_endpoint string Point de terminaison JMX.
Pris en charge pour les éléments JMX.
master_item (required for DEPENDENT items) Élément racine pour l'élément maître de l'élément dépendant.
key string (required) Clé de l'élément maître de l'élément dépendant.
timeout string Délai d'attente de la requête de sondage des données de l'élément.
Pris en charge pour la liste des types d'éléments Timeouts.
url string (required for HTTP_AGENT items) Chaîne d'URL.
query_fields Élément racine pour les paramètres de requête.
Pris en charge pour les éléments HTTP_AGENT.
name string (required for HTTP_AGENT items) Nom du paramètre de requête.
value string Valeur du paramètre de requête.
Pris en charge pour les éléments HTTP_AGENT.
parameters Élément racine pour les paramètres définis par l'utilisateur.
Pris en charge pour les éléments ITEM_TYPE_SCRIPT et ITEM_TYPE_BROWSER.
name string (required for ITEM_TYPE_SCRIPT and ITEM_TYPE_BROWSER items) Nom du paramètre défini par l'utilisateur.
value string Valeur du paramètre défini par l'utilisateur.
Pris en charge pour les éléments ITEM_TYPE_SCRIPT et ITEM_TYPE_BROWSER.
posts string Données du corps de la requête HTTP(S).
Pris en charge pour les éléments HTTP_AGENT.
status_codes string Plages de codes d'état HTTP requis, séparées par des virgules.
Pris en charge pour les éléments HTTP_AGENT.
follow_redirects string Suivre les redirections de réponse lors du sondage des données.
Pris en charge pour les éléments HTTP_AGENT.
Valeurs possibles :1 NO (0), YES (1, par défaut).
post_type string Type du corps des données publiées.
Pris en charge pour les éléments HTTP_AGENT.
Valeurs possibles :1 RAW (0, par défaut), JSON (2), XML (3).
http_proxy string Chaîne de connexion du proxy HTTP(S).
Pris en charge pour les éléments HTTP_AGENT.
headers Élément racine pour les en-têtes de requête HTTP(S).
Pris en charge pour les éléments HTTP_AGENT.
name string (required for HTTP_AGENT items) Nom de l'en-tête.
value string (required for HTTP_AGENT items) Valeur de l'en-tête.
retrieve_mode string Quelle partie de la réponse doit être stockée.
Pris en charge pour les éléments HTTP_AGENT.
Valeurs possibles :1 BODY (0, par défaut), HEADERS (1), BOTH (2).
request_method string Type de méthode de requête.
Pris en charge pour les éléments HTTP_AGENT.
Valeurs possibles :1 GET (0, par défaut), POST (1), PUT (2), HEAD (3).
output_format string Mode de traitement de la réponse.
Pris en charge pour les éléments HTTP_AGENT.
Valeurs possibles :1 RAW (0, par défaut), JSON (1).
allow_traps string Autoriser le remplissage de la valeur de manière similaire à l'élément trapper.
Pris en charge pour les éléments HTTP_AGENT.
Valeurs possibles :1 NO (0, par défaut), YES (1).
ssl_cert_file string Chemin du fichier de clé SSL publique.
Pris en charge pour les éléments HTTP_AGENT.
ssl_key_file string Chemin du fichier de clé SSL privée.
Pris en charge pour les éléments HTTP_AGENT.
ssl_key_password string Mot de passe du fichier de clé SSL.
Pris en charge pour les éléments HTTP_AGENT.
verify_peer string Indique s'il faut valider que le certificat de l'hôte est authentique.
Pris en charge pour les éléments HTTP_AGENT.
Valeurs possibles :1 NO (0, par défaut), YES (1).
verify_host string Indique s'il faut valider que le nom d'hôte de la connexion correspond à celui du certificat de l'hôte.
Pris en charge pour les éléments HTTP_AGENT.
Valeurs possibles :1 NO (0, par défaut), YES (1).
tags Élément racine pour les balises de l'élément.
tag string (required) Nom de la balise.
value string Valeur de la balise.
triggers Élément racine pour les déclencheurs des éléments de l'hôte.

Voir aussi : Objet Item (reportez-vous à la propriété correspondante portant le même nom).

Étapes de prétraitement de la valeur de l'élément de l'hôte
Element Type Description
type string (obligatoire) Type de l'étape de prétraitement de la valeur de l'élément.
Valeurs possibles :1 MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, calculé : valeur reçue - valeur précédente), CHANGE_PER_SECOND (10, calculé : (valeur reçue - valeur précédente)/(heure actuelle - heure du dernier contrôle)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30).
parameters (obligatoire) Élément racine pour les paramètres de l'étape de prétraitement de la valeur de l'élément.
parameter string Paramètre individuel de l'étape de prétraitement de la valeur de l'élément.
error_handler string Type d'action utilisé en cas d'échec de l'étape de prétraitement.
Valeurs possibles :1 ORIGINAL_ERROR (0, par défaut), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params string Paramètres du gestionnaire d'erreurs.

Voir aussi : Objet de prétraitement de l'élément (se référer à la propriété correspondante portant le même nom).

Déclencheurs d'élément d'hôte
Element Type Description
uuid string (required) Identifiant unique de ce déclencheur.
expression string (required) Expression du déclencheur.
recovery_mode string Base de génération des événements OK.
Valeurs possibles :1 EXPRESSION (0, par défaut), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression string Expression de récupération du déclencheur.
correlation_mode string Mode de corrélation (aucune corrélation d'événements ou corrélation d'événements par tag).
Valeurs possibles :1 DISABLED (0, par défaut), TAG_VALUE (1).
correlation_tag string Nom du tag à utiliser pour la corrélation des événements.
name string (required) Nom du déclencheur.
event_name string Nom de l'événement.
opdata string Données opérationnelles.
url_name string Libellé de l'URL associée au déclencheur.
url string URL associée au déclencheur.
status string État du déclencheur.
Valeurs possibles :1 ENABLED (0, par défaut), DISABLED (1).
priority string Niveau de gravité du déclencheur.
Valeurs possibles :1 NOT_CLASSIFIED (0, par défaut), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description text Description du déclencheur.
type string Type de génération d'événements (un seul événement de problème ou plusieurs événements de problème).
Valeurs possibles :1 SINGLE (0, par défaut), MULTIPLE (1).
manual_close string Fermeture manuelle des événements de problème.
Valeurs possibles :1 NO (0, par défaut), YES (1).
dependencies Élément racine pour les dépendances.
name string (required) Nom du déclencheur dépendant.
expression string (required) Expression du déclencheur dépendant.
recovery_expression string Expression de récupération du déclencheur dépendant.
tags Élément racine pour les tags du déclencheur.
tag string (required) Nom du tag.
value string Valeur du tag.

Voir aussi : Objet Trigger (reportez-vous à la propriété correspondante portant le même nom).

Règles de découverte de bas niveau de l'hôte

La plupart des éléments des règles de découverte de bas niveau de l'hôte sont les mêmes que pour les éléments de l'hôte. Le tableau ci-dessous décrit les éléments qui diffèrent des éléments de l'hôte.

Element Type Description
type string Type d'élément.
Valeurs possibles :1 ZABBIX_PASSIVE (0, par défaut), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
key string (obligatoire) La clé de la règle de découverte de bas niveau.
filter Élément racine pour les filtres des règles de découverte de bas niveau de l'hôte.
lifetime string Période de temps (en secondes, suffixe de temps, ou macro utilisateur), après laquelle les ressources découvertes qui n'existent plus seront supprimées.
Par défaut : 7d.
lifetime_type string Scénario de suppression des ressources LLD perdues.
Valeurs possibles : DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER.
enabled_lifetime string Période de temps (en secondes, suffixe de temps, ou macro utilisateur), après laquelle les ressources découvertes qui n'existent plus seront désactivées.
enabled_lifetime_type string Scénario de désactivation des ressources LLD perdues.
Valeurs possibles : DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER.
item_prototypes Élément racine pour les prototypes d'élément de l'hôte, qui sont les mêmes que pour les éléments de l'hôte.
trigger_prototypes Élément racine pour les prototypes de déclencheur de l'hôte, qui sont les mêmes que pour les déclencheurs des éléments de l'hôte.
graph_prototypes Élément racine pour les prototypes de graphique de l'hôte, qui sont les mêmes que pour les graphiques de l'hôte.
host_prototypes Élément racine pour les prototypes d'hôte, qui sont les mêmes que pour les hôtes.
master_item string (obligatoire pour les règles DEPENDENT) Élément racine pour l'élément maître de la règle dépendante.
lld_macro_paths Élément racine pour les chemins de macro de la règle de découverte de bas niveau.
lld_macro string (obligatoire) Nom de la macro de la règle de découverte de bas niveau.
path string (obligatoire) Sélecteur de valeur, qui sera attribuée à la macro correspondante.
preprocessing Élément racine pour le prétraitement de la valeur de la règle de découverte de bas niveau.
step Élément racine pour les étapes de prétraitement de la valeur de la règle de découverte de bas niveau, qui sont les mêmes que pour les étapes de prétraitement de la valeur de l'élément de l'hôte, mais avec moins de valeurs possibles. Voir aussi : objet de prétraitement de la règle LLD.
overrides Élément racine pour les règles de remplacement de la règle de découverte de bas niveau.
name string (obligatoire) Nom unique du remplacement.
step string (obligatoire) Numéro d'ordre unique du remplacement.
stop string Arrêter le traitement des remplacements suivants si correspondance.
filter Élément racine pour les éléments de filtre des règles de remplacement de la règle de découverte de bas niveau, qui sont les mêmes que pour les filtres des règles de découverte de bas niveau de l'hôte.
operations Élément racine pour les opérations de remplacement des règles de découverte de bas niveau de l'hôte.

Voir aussi : objet de règle LLD (reportez-vous à la propriété correspondante portant le même nom).

Filtres de la règle de découverte bas niveau de l'hôte
Element Type Description
evaltype string Méthode de calcul de l'évaluation de la condition du filtre à remplacer.
Valeurs possibles :1 AND_OR (0, par défaut), AND (1), OR (2), FORMULA (3).
formula string Formule de calcul personnalisée pour les conditions du filtre.
conditions Élément racine pour les conditions du filtre.
macro string (obligatoire) Nom de la macro de découverte bas niveau sur laquelle effectuer la vérification.
value string Valeur à comparer.
operator string Opérateur de condition.
Valeurs possibles :1 MATCHES_REGEX (8, par défaut), NOT_MATCHES_REGEX (9).
formulaid string (obligatoire) ID unique arbitraire utilisé pour référencer une condition dans l'expression personnalisée. Peut contenir uniquement des lettres majuscules. L'ID doit être défini par l'utilisateur lors de la modification des conditions du filtre, mais sera généré à nouveau lors d'une requête ultérieure.

Voir aussi : Objet de filtre de règle LLD (reportez-vous à la propriété correspondante portant le même nom).

Opérations de remplacement de la règle de découverte bas niveau de l'hôte
Element Type Description
operationobject string Objet auquel l'opération est appliquée.
Valeurs possibles :1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator string Opérateur de condition de remplacement.
Valeurs possibles :1 EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value string Une expression régulière ou une chaîne pour l'opérateur de condition de remplacement.
status string Statut de l'objet après l'opération de remplacement.
discover string Indique si l'objet est ajouté à la suite de la découverte.
delay string Intervalle de mise à jour défini pour le prototype d'élément après l'opération de remplacement.
history string Période de conservation de l'historique définie pour le prototype d'élément après l'opération de remplacement.
trends string Période de conservation des tendances définie pour le prototype d'élément après l'opération de remplacement.
severity string Niveau de gravité du prototype de déclencheur défini après l'opération de remplacement.
tags Élément racine pour les tags définis pour l'objet après l'opération de remplacement.
tag string (obligatoire) Nom du tag.
value string Valeur du tag.
templates Élément racine pour les modèles liés au prototype d'hôte après l'opération de remplacement.
name string (obligatoire) Nom du modèle.
inventory_mode string Mode d'inventaire du prototype d'hôte défini après l'opération de remplacement.

Voir aussi : Objet d'opération de remplacement de la règle LLD (reportez-vous à la propriété correspondante portant le même nom).

Scénarios web d'hôte

Élément Type Description
uuid string (obligatoire) Identifiant unique de ce scénario web.
name string (obligatoire) Nom du scénario web.
delay string Fréquence d'exécution du scénario web (en utilisant des secondes, un suffixe temporel ou une macro utilisateur).
Par défaut : 1m.
attempts integer Nombre de tentatives pour exécuter les étapes du scénario web.
Valeurs possibles : 1-10 (par défaut : 1).
agent string Agent client. Zabbix se fera passer pour le navigateur sélectionné.
Cela est utile lorsqu'un site web renvoie un contenu différent selon le navigateur.
Par défaut : Zabbix.
http_proxy string Proxy qui sera utilisé par le scénario web, indiqué sous la forme : http://[username[:password]@]proxy.example.com[:port]
variables Élément racine des variables du scénario web pouvant être utilisées dans les étapes du scénario.
name string (obligatoire) Nom de la variable.
value text (obligatoire) Valeur de la variable.
headers Élément racine des en-têtes HTTP à envoyer lors de l'exécution d'une requête.
Les en-têtes doivent être listés en utilisant la même syntaxe que celle du protocole HTTP.
name string (obligatoire) Nom de l'en-tête.
value text (obligatoire) Valeur de l'en-tête.
status string Statut du scénario web.
Valeurs possibles :1 ENABLED (0, par défaut), DISABLED (1).
authentication string Méthode d'authentification.
Valeurs possibles :1 NONE (0, par défaut), BASIC (1), NTLM (2), Kerberos (3) ou Digest (4).
http_user string Nom d'utilisateur utilisé pour l'authentification BASIC (HTTP), NTLM, Kerberos ou Digest.
http_password string Mot de passe utilisé pour l'authentification BASIC (HTTP), NTLM, Kerberos ou Digest.
verify_peer string Vérifier le certificat SSL du serveur web.
Valeurs possibles :1 NO (0, par défaut), YES (1).
verify_host string Vérifier que le champ Common Name ou le champ Subject Alternate Name du certificat du serveur web correspond.
Valeurs possibles :1 NO (0, par défaut), YES (1).
ssl_cert_file string Nom du fichier de certificat SSL utilisé pour l'authentification du client (doit être au format PEM).
ssl_key_file string Nom du fichier de clé privée SSL utilisé pour l'authentification du client (doit être au format PEM).
ssl_key_password string Mot de passe du fichier de clé privée SSL.
steps (obligatoire) Élément racine des étapes du scénario web d'hôte.
tags Élément racine des tags du scénario web.
tag string (obligatoire) Nom du tag.
value string Valeur du tag.

Voir aussi : Web scenario object (reportez-vous à la propriété correspondante portant le même nom).

Étapes du scénario web
Élément Type Description
name string (obligatoire) Nom de l'étape du scénario web.
url string (obligatoire) URL à surveiller.
query_fields Élément racine pour les paramètres de requête (un tableau de champs HTTP à ajouter à l'URL lors de l'exécution d'une requête).
name string (obligatoire) Nom du paramètre de requête.
value string Valeur du paramètre de requête.
posts Élément racine pour les variables HTTP POST (une chaîne de caractères (données POST brutes) ou un tableau de champs HTTP (données de champs de formulaire)).
name string (obligatoire) Nom du champ POST.
value string (obligatoire) Valeur du champ POST.
variables Élément racine des variables au niveau de l'étape (macros) qui doivent être appliquées après cette étape.
Si la valeur de la variable comporte le préfixe 'regex:', sa valeur est alors extraite des données renvoyées par cette étape conformément au motif d'expression régulière suivant le préfixe 'regex:'
name string (obligatoire) Nom de la variable.
value text (obligatoire) Valeur de la variable.
headers Élément racine pour les en-têtes HTTP à envoyer lors de l'exécution d'une requête.
name string (obligatoire) Nom de l'en-tête.
value text (obligatoire) Valeur de l'en-tête.
follow_redirects string Suivre les redirections HTTP.
Valeurs possibles :1 NO (0), YES (1, par défaut).
retrieve_mode string Mode de récupération de la réponse HTTP.
Valeurs possibles :1 BODY (0, par défaut), HEADERS (1), BOTH (2).
timeout string Délai d'expiration (en secondes, suffixe temporel, ou macro utilisateur) de l'exécution de l'étape.
Par défaut : 15s.
required string Texte qui doit être présent dans la réponse (ignoré si vide).
status_codes string Liste des codes d'état HTTP acceptés, séparés par des virgules (par exemple, 200-201,210-299 ; ignoré si vide).

Voir aussi : Objet d'étape de scénario web (reportez-vous à la propriété correspondante portant le même nom).

Graphiques d'hôte

Element Type Description
uuid string Identifiant unique du graphique.
name string (obligatoire) Nom du graphique.
width integer Largeur du graphique, en pixels.
Utilisé pour l'aperçu et pour les graphiques en camembert/explosés.
Valeurs possibles:1 20-65535 (par défaut: 900).
height integer Hauteur du graphique, en pixels.
Utilisé pour l'aperçu et pour les graphiques en camembert/explosés.
Valeurs possibles:1 20-65535 (par défaut: 900).
yaxismin double Valeur minimale de l'axe Y.
Pris en charge pour la valeur minimale FIXED de l'axe Y.
Par défaut: 0.
yaxismax double Valeur maximale de l'axe Y.
Pris en charge pour la valeur minimale FIXED de l'axe X.
Par défaut: 0.
show_work_period string Mettre en évidence les heures non ouvrées.
Pris en charge pour les graphiques NORMAL et STACKED.
Valeurs possibles:1 NO (0), YES (1, par défaut).
show_triggers string Afficher les valeurs simples des déclencheurs sous forme de ligne.
Pris en charge pour les graphiques NORMAL et STACKED.
Valeurs possibles:1 NO (0), YES (1, par défaut).
type string Type de graphique.
Valeurs possibles:1 NORMAL (0, par défaut), STACKED (1), PIE (2), EXPLODED (3).
show_legend string Afficher la légende du graphique.
Valeurs possibles:1 NO (0), YES (1, par défaut).
show_3d string Activer le style 3D.
Pris en charge pour les graphiques NORMAL et STACKED.
Valeurs possibles:1 NO (0, par défaut), YES (1).
percent_left double Afficher la ligne de percentile pour l'axe gauche.
Pris en charge pour les graphiques NORMAL.
Par défaut: 0.
percent_right double Afficher la ligne de percentile pour l'axe droit.
Pris en charge pour les graphiques NORMAL.
Par défaut: 0.
ymin_type_1 string Valeur minimale de l'axe Y.
Pris en charge pour les graphiques NORMAL et STACKED.
Valeurs possibles:1 CALCULATED (0, par défaut), FIXED (1), ITEM (2).
ymin_item_1 (obligatoire si ymin_type_1 est défini sur ITEM) Élément racine pour les détails de chaque élément.
host string (obligatoire) Hôte de l'élément.
key string (obligatoire) Clé de l'élément.
ymax_type_1 string Valeur maximale de l'axe Y.
Pris en charge pour les graphiques NORMAL et STACKED.
Valeurs possibles:1 CALCULATED (0, par défaut), FIXED (1), ITEM (2).
ymax_item_1 (obligatoire si ymax_type_1 est défini sur ITEM) Élément racine pour les détails de chaque élément.
host string (obligatoire) Hôte de l'élément.
key string (obligatoire) Clé de l'élément.
graph_items (obligatoire) Élément racine pour les éléments de graphique d'hôte.

Voir aussi: Objet Graph (reportez-vous à la propriété correspondante portant le même nom).

Éléments du graphique de l'hôte
Element < Type Description
sortorder < integer Ordre de dessin. La valeur la plus petite est dessinée en premier. Peut être utilisé pour dessiner des lignes ou des régions derrière (ou devant) une autre.
drawtype < string Style de dessin de l'élément du graphique.
Pris en charge pour les graphiques NORMAL.
Valeurs possibles :1 SINGLE_LINE (0, par défaut), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5).
color < string Couleur de l'élément (6 symboles, hexadécimal).
yaxisside < string Côté du graphique où l'échelle Y de l'élément du graphique sera dessinée.
Pris en charge pour les graphiques NORMAL et STACKED.
Valeurs possibles :1 LEFT (0, par défaut), RIGHT (1).
calc_fnc < string Données à dessiner si plus d'une valeur existe pour un élément.
Valeurs possibles :1 MIN (1), AVG (2, par défaut), MAX (4), ALL (7 ; minimum, moyenne et maximum ; pris en charge pour les graphiques simples), LAST (9, pris en charge pour les graphiques en camembert/explosés).
type < string Type d'élément du graphique.
Valeurs possibles :1 SIMPLE (0, par défaut), GRAPH_SUM (2 ; la valeur de l'élément représente le camembert entier ; pris en charge pour les graphiques en camembert/explosés).
item < (obligatoire) Élément individuel.
< host string (obligatoire) Hôte de l'élément.
^ key string (obligatoire) Clé de l'élément.

Voir aussi : Objet Graph item (reportez-vous à la propriété correspondante portant le même nom).

Cartes de valeurs de l'hôte

Element Type Description
uuid string (obligatoire) Identifiant unique de cette carte de valeurs.
name string (obligatoire) Nom de la carte de valeurs.
mapping Élément racine pour les mappages.
type string Type de correspondance du mappage.
Valeurs possibles:1 EQUAL (0, par défaut), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
value string Valeur d'origine.
newvalue string (obligatoire) Valeur vers laquelle la valeur d'origine est mappée.

Voir aussi: Objet carte de valeurs (se référer à la propriété correspondante portant le même nom).

Notes de bas de page

1 Les valeurs entières de l’API entre parenthèses, par exemple ENABLED (0), sont mentionnées uniquement à titre de référence. Pour plus d’informations, consultez la page de l’objet API liée dans l’entrée du tableau ou à la fin de chaque section.