[comment]: # translation:outdated

[comment]: # ({7ddf901c-7bc79a95})
# 4 Exemple de configuration de la supervision VMware

[comment]: # ({/7ddf901c-7bc79a95})

[comment]: # ({3c9549aa-4948cb9c})
#### Vue d’ensemble

L’exemple suivant décrit comment configurer Zabbix pour surveiller des machines virtuelles VMware. Cela implique :

- la création d’un hôte représentant votre environnement VMware ;
- la création d’une règle de découverte de bas niveau qui découvre les machines virtuelles dans votre environnement VMware ;
- la création d’un prototype d’hôte, sur la base duquel Zabbix générera de véritables hôtes pour les machines virtuelles découvertes par la règle de découverte de bas niveau.

[comment]: # ({/3c9549aa-4948cb9c})

[comment]: # ({8d40aabd-5d265fdc})
#### Prérequis

::: noteclassic
Cet exemple ne couvre pas la configuration de VMware. Il est supposé que VMware est déjà configuré.
:::

Avant de continuer, définissez le paramètre [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) dans le fichier de configuration du serveur Zabbix à `2` [ou plus](/manual/vm_monitoring#configuration) (la valeur par défaut est `0`).

[comment]: # ({/8d40aabd-5d265fdc})

[comment]: # ({ae84527f-05232a19})
#### Créer un hôte

1\. Accédez à *Collecte de données* → [*Hôtes*](/manual/web_interface/frontend_sections/data_collection/hosts).

2\. [Créez](/manual/config/hosts/host) un hôte :

- Dans le champ *Nom de l’hôte*, saisissez un nom d’hôte (par exemple, « VMware VMs »).
- Dans le champ *Groupes d’hôtes*, saisissez ou sélectionnez un groupe d’hôtes (par exemple, « Virtual machines »).

![](../../../assets/en/manual/vm_monitoring/vmware_host.png){width="600"}

- Dans l’onglet *Macros*, définissez les macros d’hôte suivantes :
    - {$VMWARE.URL} - URL du SDK du service VMware (hyperviseur ESXi) (https://servername/sdk)
    - {$VMWARE.USERNAME} - nom d’utilisateur du service VMware
    - {$VMWARE.PASSWORD} - mot de passe de l’utilisateur {$VMWARE.USERNAME} du service VMware

![](../../../assets/en/manual/vm_monitoring/vmware_host_macros.png){width="600"}

3\. Cliquez sur le bouton *Ajouter* pour créer l’hôte. Cet hôte représentera votre environnement VMware.

[comment]: # ({/ae84527f-05232a19})

[comment]: # ({665f7b96-967b85cf})
#### Créer une règle de découverte de bas niveau

1\. Cliquez sur *Découverte* pour l’hôte créé afin d’accéder à la liste des règles de découverte de bas niveau pour cet hôte.

2\. [Créez](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery) une règle de découverte de bas niveau :

- Dans le champ *Nom*, saisissez un nom de règle de découverte de bas niveau (par exemple, « Découvrir les VM VMware »).
- Dans le champ *Type*, sélectionnez « [Simple check](/manual/config/items/itemtypes/simple_checks) ».
- Dans le champ *Clé*, saisissez la clé d’élément intégrée pour découvrir les machines virtuelles VMware : [`vmware.vm.discovery[{$VMWARE.URL}]`](/manual/vm_monitoring/vmware_keys#vmware.vm.discovery)
- Dans les champs *Nom d’utilisateur* et *Mot de passe*, saisissez les macros correspondantes précédemment configurées sur l’hôte.

![](../../../assets/en/manual/vm_monitoring/vmware_host_discovery.png){width="600"}

3\. Cliquez sur le bouton *Ajouter* pour créer la règle de découverte de bas niveau.
Cette règle de découverte détectera les machines virtuelles dans votre environnement VMware.

[comment]: # ({/665f7b96-967b85cf})

[comment]: # ({3c0bd2af-4202131d})
#### Créer un prototype d'hôte

1\. Dans la liste des règles de découverte de bas niveau, cliquez sur *Prototypes d'hôte* pour la règle de découverte de bas niveau créée précédemment.

2\. [Créez](/manual/discovery/low_level_discovery/host_prototypes#configuration) un prototype d'hôte.
Comme les prototypes d'hôte servent de modèles pour créer des hôtes via des règles de découverte de bas niveau, la plupart des champs contiendront des [macros de découverte de bas niveau](/manual/config/macros/lld_macros).
Cela garantit que les hôtes sont créés avec des propriétés basées sur le [contenu récupéré](/manual/vm_monitoring/discovery_fields) par la règle de découverte de bas niveau créée précédemment.

- Dans le champ *Nom d'hôte*, saisissez la macro {#VM.UUID}.
- Dans le champ *Nom visible*, saisissez la macro {#VM.NAME}.
- Dans le champ *Modèles*, saisissez ou sélectionnez le modèle "VMware Guest".
Ce modèle contient des [éléments VMware](/manual/vm_monitoring/vmware_keys) et des règles de découverte pour surveiller l'état d'alimentation d'une machine virtuelle, l'utilisation du processeur, l'utilisation de la mémoire, les périphériques réseau, etc.
- Dans le champ *Groupes d'hôtes*, saisissez ou sélectionnez un groupe d'hôtes (par exemple, "Discovered hosts").
- Dans le champ *Interfaces*, ajoutez une [interface d'hôte](/manual/discovery/low_level_discovery/host_prototypes#host-interfaces) personnalisée.
Ensuite, saisissez la macro {#VM.DNS} dans le champ *Nom DNS*, ou saisissez la macro {#VM.IP} dans le champ *Adresse IP*.
Sinon, si les machines virtuelles de votre environnement VMware possèdent plusieurs interfaces, passez à la section [*Configuration avancée de l'interface d'hôte*](#advanced-host-interface-configuration).
La configuration d'une interface d'hôte personnalisée est nécessaire au bon fonctionnement du modèle *VMware Guest*.

![](../../../assets/en/manual/vm_monitoring/vmware_host_prototype.png){width="600"}

- Dans l'onglet *Macros*, définissez la macro {$VMWARE.VM.UUID} avec la valeur {#VM.UUID}.
Cela est nécessaire au bon fonctionnement du modèle *VMware Guest*, qui utilise cette macro comme macro utilisateur au niveau de l'hôte dans les paramètres des éléments
(par exemple, *vmware.vm.net.if.discovery\[{$VMWARE.URL}, {$VMWARE.VM.UUID}\]*).

![](../../../assets/en/manual/vm_monitoring/vmware_host_prototype_macros.png){width="600"}

3\. Cliquez sur le bouton *Ajouter* pour créer le prototype d'hôte.
Ce prototype d'hôte sera utilisé pour créer des hôtes pour les machines virtuelles découvertes par la règle de découverte de bas niveau créée précédemment.

[comment]: # ({/3c0bd2af-4202131d})

[comment]: # ({3e8fd594-92a7e887})
#### Voir les hôtes et les métriques

Une fois le prototype d’hôte créé, la règle de découverte de bas niveau créera des hôtes pour les machines virtuelles VMware découvertes, et Zabbix commencera à les surveiller.
Notez que la découverte et la création des hôtes peuvent également être [exécutées manuellement](/manual/config/items/check_now), si nécessaire.

Pour afficher les hôtes créés, accédez à la section de menu [*Collecte de données* → *Hôtes*](/manual/web_interface/frontend_sections/data_collection/hosts).

![](../../../assets/en/manual/vm_monitoring/vmware_discovered_hosts.png){width="600"}

Pour afficher les métriques collectées, accédez à la section de menu [*Surveillance* → *Hôtes*](/manual/web_interface/frontend_sections/monitoring/hosts) et cliquez sur *Dernières données* pour l’un des hôtes.

![](../../../assets/en/manual/vm_monitoring/vmware_monitored_hosts.png){width="600"}

[comment]: # ({/3e8fd594-92a7e887})

[comment]: # ({2e5060fa-2c1d07a4})
#### Configuration avancée de l’interface d’hôte

La clé d’élément `vmware.vm.discovery[{$VMWARE.URL}]`, configurée dans la section [*Créer une règle de découverte de bas niveau*](#create-a-low-level-discovery-rule), renvoie les données des interfaces réseau dans le [champ "net_if"](/manual/vm_monitoring/discovery_fields) :

```json
"net_if": [
      {
        "ifname": "5000",
        "ifdesc": "Network adapter 1",
        "ifmac": "00:11:22:33:44:55",
        "ifconnected": true,
        "iftype": "VirtualVmxnet3",
        "ifbackingdevice": "VLAN(myLab)",
        "ifdvswitch_uuid": "",
        "ifdvswitch_portgroup": "",
        "ifdvswitch_port": "",
        "ifip": [
          "127.0.0.1",
          "::1"
        ]
      },
      {
        "ifname": "5001",
        "ifdesc": "Network adapter 2",
        "ifmac": "00:11:22:33:44:55",
        "ifconnected": false,
        "iftype": "VirtualVmxnet3",
        "ifbackingdevice": "VLAN(myLab2)",
        "ifdvswitch_uuid": "",
        "ifdvswitch_portgroup": "",
        "ifdvswitch_port": "",
        "ifip": []
      }
    ]
```

Ces données peuvent être utilisées pour configurer une interface d’hôte personnalisée.

1\. Lors de la [création d’une règle de découverte de bas niveau](#create-a-low-level-discovery-rule), configurez également une [macro de découverte de bas niveau](/manual/config/macros/lld_macros).
Dans l’onglet *Macros LLD*, créez une macro LLD personnalisée avec une valeur [JSONPath](/manual/config/items/preprocessing/jsonpath_functionality). Par exemple :

- {#MYLAB.NET.IF} - `$.net_if[?(@.ifbackingdevice=="VLAN(myLab)")].ifip[0].first()`

![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro.png){width="600"}

2\. Lors de la [création d’un prototype d’hôte](#create-a-host-prototype), ajoutez une interface d’hôte personnalisée et saisissez la macro LLD dans le champ *Nom DNS* ou *Adresse IP*.

![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro_host_prototype.png){width="600"}

[comment]: # ({/2e5060fa-2c1d07a4})