en-us	### Description  `object template.massupdate(object parameters)`  This method allows to simultaneously replace or remove related objects and update properties on multiple templates.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object template.massupdate(object parameters)`  Cette méthode permet de remplacer ou de supprimer simultanément des objets associés et de mettre à jour les propriétés de plusieurs modèles.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object template.update(object/array templates)`  This method allows to update existing templates.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object template.update(object/array templates)`  Cette méthode permet de mettre à jour les modèles existants.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object trigger.adddependencies(object/array triggerDependencies)`  This method allows to create new trigger dependencies.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object trigger.adddependencies(object/array triggerDependencies)`  Cette méthode permet de créer de nouvelles dépendances de déclencheur.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object trigger.create(object/array triggers)`  This method allows to create new triggers.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object trigger.create(object/array triggers)`  Cette méthode permet de créer de nouveaux déclencheurs.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object trigger.delete(array triggerIds)`  This method allows to delete triggers.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  
fr	### Description  `object trigger.delete(array triggerIds)`  Cette méthode permet de supprimer des déclencheurs.  ::: noteclassic Cette méthode est disponible uniquement pour les utilisateurs de type *Admin* et *Super admin*. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  

en-us	### Description  `object trigger.deletedependencies(string/array triggers)`  This method allows to delete all trigger dependencies from the given triggers.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  
fr	### Description  `object trigger.deletedependencies(string/array triggers)`  Cette méthode permet de supprimer toutes les dépendances des déclencheurs donnés.  ::: noteclassic Cette méthode est disponible uniquement pour les utilisateurs de type *Admin* et *Super admin*. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  

en-us	### Description  `object triggerprototype.create(object/array triggerPrototypes)`  This method allows to create new trigger prototypes.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object triggerprototype.create(object/array triggerPrototypes)`  Cette méthode permet de créer de nouveaux prototypes de trigger.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object triggerprototype.delete(array triggerPrototypeIds)`  This method allows to delete trigger prototypes.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  
fr	### Description  `object triggerprototype.delete(array triggerPrototypeIds)`  Cette méthode permet de supprimer des prototypes de déclencheur.  ::: noteclassic Cette méthode est disponible uniquement pour les utilisateurs de type *Admin* et *Super admin*. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  

en-us	### Description  `object triggerprototype.update(object/array triggerPrototypes)`  This method allows to update existing trigger prototypes.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object triggerprototype.update(object/array triggerPrototypes)`  Cette méthode permet de mettre à jour les prototypes de déclencheurs existants.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object trigger.update(object/array triggers)`  This method allows to update existing triggers.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object trigger.update(object/array triggers)`  Cette méthode permet de mettre à jour les déclencheurs existants.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object user.checkAuthentication`  This method checks and prolongs user session.  ::: noteimportant Calling **user.checkAuthentication** method prolongs user session by default. :::
fr	### Description  `object user.checkAuthentication`  Cette méthode vérifie et prolonge la session utilisateur.  ::: noteimportant L'appel de la méthode **user.checkAuthentication** prolonge la session utilisateur par défaut. :::

en-us	### Description  `object user.create(object/array users)`  This method allows to create new users.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  ::: noteclassic The strength of user password is validated according the password policy rules defined by Authentication API. See [Authentication API](/manual/api/reference/authentication) for more information. :::
fr	### Description  `object user.create(object/array users)`  Cette méthode permet de créer de nouveaux utilisateurs.  ::: noteclassic Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  ::: noteclassic La force du mot de passe de l'utilisateur est validée selon les règles de politique de mot de passe définies par l'API d'authentification. Voir l'[API d'authentification](/manual/api/reference/authentication) pour plus d'informations. :::

en-us	### Description  `object user.delete(array users)`  This method allows to delete users.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  
fr	### Description  `object user.delete(array users)`  Cette méthode permet de supprimer des utilisateurs.  ::: noteclassic Cette méthode est disponible uniquement pour les utilisateurs de type *Super admin*. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  

en-us	### Description  `object usergroup.create(object/array userGroups)`  This method allows to create new user groups.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object usergroup.create(object/array userGroups)`  Cette méthode permet de créer de nouveaux groupes d'utilisateurs.  ::: noteclassic Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object usergroup.delete(array userGroupIds)`  This method allows to delete user groups.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  
fr	### Description  `object usergroup.delete(array userGroupIds)`  Cette méthode permet de supprimer des groupes d'utilisateurs.  ::: noteclassic Cette méthode est disponible uniquement pour les utilisateurs de type *Super admin*. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  

en-us	### Description  `object usergroup.update(object/array userGroups)`  This method allows to update existing user groups.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object usergroup.update(object/array userGroups)`  Cette méthode permet de mettre à jour les groupes d'utilisateurs existants.  ::: noteclassic Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object usermacro.createglobal(object/array globalMacros)`  This method allows to create new global macros.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object usermacro.createglobal(object/array globalMacros)`  Cette méthode permet de créer de nouvelles macros globales.  ::: noteclassic Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object usermacro.create(object/array hostMacros)`  This method allows to create new host macros.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object usermacro.create(object/array hostMacros)`  Cette méthode permet de créer de nouvelles macros hôtes.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object usermacro.delete(array hostMacroIds)`  This method allows to delete host macros.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  
fr	### Description  `object usermacro.delete(array hostMacroIds)`  Cette méthode permet de supprimer les macros d'hôtes.  ::: noteclassic Cette méthode est disponible uniquement pour les utilisateurs de type *Admin* et *Super admin*. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  

en-us	### Description  `object usermacro.deleteglobal(array globalMacroIds)`  This method allows to delete global macros.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  
fr	### Description  `object usermacro.deleteglobal(array globalMacroIds)`  Cette méthode permet de supprimer les macros globales.  ::: noteclassic Cette méthode est disponible uniquement pour les utilisateurs de type *Super admin*. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  

en-us	### Description  `object usermacro.updateglobal(object/array globalMacros)`  This method allows to update existing global macros.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object usermacro.updateglobal(object/array globalMacros)`  Cette méthode permet de mettre à jour les macros globales existantes.  ::: noteclassic Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object usermacro.update(object/array hostMacros)`  This method allows to update existing host macros.  ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object usermacro.update(object/array hostMacros)`  Cette méthode permet de mettre à jour les macros hôtes existantes.  ::: noteclassic Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object user.unblock(array userids)`  This method allows to unblock users.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object user.unblock(array userids)`  Cette méthode permet de débloquer les utilisateurs.  ::: noteclassic Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object user.update(object/array users)`  This method allows to update existing users.  ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  ::: noteclassic The strength of user password is validated according the password policy rules defined by Authentication API. See [Authentication API](/manual/api/reference/authentication) for more information. :::
fr	### Description  `object user.update(object/array users)`  Cette méthode permet de mettre à jour les utilisateurs existants.  ::: noteclassic Cette méthode est disponible à tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  ::: noteclassic La force du mot de passe de l'utilisateur est validée selon les règles de politique de mot de passe définies par l'API d'authentification. Voir l'[API d'authentification](/manual/api/reference/authentication) pour plus d'informations. :::

en-us	### Description  `object valuemap.create(object/array valuemaps)`  This method allows to create new value maps.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object valuemap.create(object/array valuemaps)`  Cette méthode permet de créer de nouvelles correspondances de valeurs.  ::: noteclassic Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `object valuemap.delete(array valuemapids)`  This method allows to delete value maps.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::  
fr	### Description  `object valuemap.delete(array valuemapids)`  Cette méthode permet de supprimer des tables de correspondance.  ::: noteclassic Cette méthode est disponible uniquement pour les utilisateurs de type *Super admin*. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::  

en-us	### Description  `object valuemap.update(object/array valuemaps)`  This method allows to update existing value maps.  ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `object valuemap.update(object/array valuemaps)`  Cette méthode permet de mettre à jour les correspondances de valeurs existantes.  ::: noteclassic Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `string apiinfo.version(array)`  This method allows to retrieve the version of the Zabbix API.  ::: noteimportant This method is only available to unauthenticated users and must be called without the `auth` parameter in the JSON-RPC request. :::  
fr	### Description  `string apiinfo.version(array)`  Cette méthode permet de récupérer la version de l'API Zabbix.  ::: noteimportant Cette méthode n'est disponible que pour les utilisateurs non authentifiés et doit être appelée sans le paramètre "auth" dans la requête JSON-RPC. :::  

en-us	### Description  `string configuration.export(object parameters)`  This method allows to export configuration data as a serialized string.  ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `string configuration.export(paramètres d'objet)`  Cette méthode permet d'exporter les données de configuration sous forme de chaîne sérialisée.  ::: noteclassic Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	### Description  `string/object user.login(object parameters)`  This method allows to log in to the API and generate an authentication token.  ::: notewarning When using this method, you also need to do [user.logout](/manual/api/reference/user/logout) to prevent the generation of a large number of open session records. :::  ::: noteimportant This method is only available to unauthenticated users and must be called without the `auth` parameter in the JSON-RPC request. :::
fr	### Description  `string/object user.login(object parameters)`  Cette méthode permet de se connecter à l'API et de générer un jeton d'authentification.  ::: notewarning Lorsque vous utilisez cette méthode, vous devez également faire [user.logout](/manual/api/reference/user/logout) pour empêcher la génération d'un grand nombre d'enregistrements de session ouverts. :::  ::: noteimportant Cette méthode n'est disponible que pour les utilisateurs non authentifiés et doit être appelée sans le paramètre "auth" dans la requête JSON-RPC. :::

en-us	### Description  `string/object user.logout(array)`  This method allows to log out of the API and invalidates the current authentication token.  ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. :::
fr	### Description  `string/object user.logout(array)`  Cette méthode permet de se déconnecter de l'API et invalide le jeton d'authentification actuel.  ::: noteclassic Cette méthode est disponible à tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations. :::

en-us	## DESCRIPTION  **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE}
fr	## DESCRIPTION  **zabbix\_agent2** est une application de surveillance des paramètres de divers services.\ \ [ ]{#lbAE}

en-us	## DESCRIPTION  **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE}
fr	## DESCRIPTION  **zabbix\_agentd** est un démon pour la surveillance de divers paramètres du serveur. [ ]{#lbAE}

en-us	## DESCRIPTION  **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE}
fr	## DESCRIPTION  **zabbix\_get** est un utilitaire de ligne de commande pour obtenir des données de l'agent Zabbix.[ ]{#lbAE}

en-us	## DESCRIPTION  **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE}
fr	## DESCRIPTION  **zabbix\_js** est un utilitaire de ligne de commande qui peut être utilisé pour tester des scripts intégrés. [ ]{#lbAE}

en-us	## DESCRIPTION  **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE}
fr	## DESCRIPTION  **zabbix\_proxy** est un démon qui collecte les données de surveillance des appareils et les envoie au serveur Zabbix. [ ]{#lbAE}

en-us	## DESCRIPTION  **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE}
fr	## DESCRIPTION  **zabbix\_sender** est un utilitaire de ligne de commande pour envoyer des données de surveillance au serveur ou au proxy Zabbix. Sur le serveur Zabbix, un élément de type **trappeur Zabbix** doit être créé avec la clé correspondante. Notez que les valeurs entrantes ne seront acceptées qu'à partir des hôtes spécifiés dans le champ **Hôtes autorisés** pour cet élément. [ ]{#lbAE}

en-us	## DESCRIPTION  **zabbix\_server** is the core daemon of Zabbix software. [ ]{#lbAE}
fr	## DESCRIPTION  **zabbix\_server** est le démon principal du logiciel Zabbix. [ ]{#lbAE}

en-us	## DESCRIPTION  **zabbix\_web\_service** is an application for providing web services to Zabbix components. [ ]{#lbAE}
fr	## DESCRIPTION  **zabbix\_web\_service** est une application permettant de fournir des services Web aux composants Zabbix. [ ]{#lbAE}

en-us	#### Details about export  -   All supported elements are exported in one file. -   Host and template entities (items, triggers, graphs, discovery     rules) that are inherited from linked templates are not exported.     Any changes made to those entities on a host level (such as changed     item interval, modified regular expression or added prototypes to     the low-level discovery rule) will be lost when exporting; when     importing, all entities from linked templates are re-created as on     the original linked template. -   Entities created by low-level discovery and any entities depending     on them are not exported. For example, a trigger created for an     LLD-rule generated item will not be exported.
fr	#### Détails sur l'exportation  -   Tous les éléments pris en charge sont exportés dans un fichier. -   Les entités d'hôte et de modèle (éléments, déclencheurs, graphiques, règles de découverte) héritées de modèles liés ne sont pas exportées. Toutes les modifications apportées à ces entités au niveau de l'hôte (telles que la modification de l'intervalle de l'élément, la modification de l''expression régulière ou les prototypes ajoutés à la règle de découverte de bas niveau) seront perdues lors de l'exportation. Lors de l'importation, toutes les entités des modèles liés sont recréées comme sur le modèle lié d'origine. -   Les entités créées par la découverte de bas niveau et les entités qui en dépendent ne sont pas exportées. Par exemple, un déclencheur créé pour un élément généré par une règle LLD ne sera pas exporté.

en-us	### Details tag  The details object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - (default) - use bulk requests.| |community|string|SNMP community (required). Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.|
fr	### Tag de détails  L'objet détails a les propriétés suivantes.  |Propriété|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(obligatoire)|integer|Version de l'interface SNMP.<br><br>Les valeurs possibles sont :<br>1 - SNMPv1 ;<br>2 - SNMPv2c ;<br>3 - SNMPv3| |bulk|integer|Utiliser ou non les requêtes SNMP en masse.<br><br>Les valeurs possibles sont :<br>0 - ne pas utiliser les requêtes en masse ;<br>1 - (par défaut) - utiliser les requêtes en masse.| |community|string|Communauté SNMP (obligatoire). Utilisé uniquement par les interfaces SNMPv1 et SNMPv2.| |securityname|string|Nom de sécurité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.| |securitylevel|integer|Niveau de sécurité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.<br><br>Les valeurs possibles sont :<br>0 - (par défaut) - noAuthNoPriv ;<br>1 - authNoPriv ;<br>2 - authPriv.| |authpassphrase|string|Phrase secrète d'authentification SNMPv3. Utilisé uniquement par les interfaces SNMPv3.| |privpassphrase|string|Phrase secrète de confidentialité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.| |authprotocol|integer|Protocole d'authentification SNMPv3. Utilisé uniquement par les interfaces SNMPv3.<br><br>Les valeurs possibles sont :<br>0 - (par défaut) - MD5 ;<br>1 - SHA1 ;<br>2 - SHA224 ;<br>3 - SHA256 ;<br >4 - SHA384 ;<br>5 - SHA512.| |privprotocol|integer|Protocole de confidentialité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.<br><br>Les valeurs possibles sont :<br>0 - (par défaut) - DES ;<br>1 - AES128 ;<br>2 - AES192 ;<br>3 - AES256 ;<br >4 - AES192C ;<br>5 - AES256C.| |contextname|string|nom de contexte SNMPv3. Utilisé uniquement par les interfaces SNMPv3.|

en-us	#### Details  The virtual machine monitoring is done in two steps. First, virtual machine data is gathered by *vmware collector* Zabbix processes. Those processes obtain necessary information from VMware web services over the SOAP protocol, pre-process it and store into Zabbix server shared memory. Then, this data is retrieved by pollers using Zabbix simple check [VMware keys](/manual/config/items/itemtypes/simple_checks/vmware_keys).  Starting with Zabbix version 2.4.4 the collected data is divided into 2 types: VMware configuration data and VMware performance counter data. Both types are collected independently by *vmware collectors*. Because of this it is recommended to enable more collectors than the monitored VMware services. Otherwise retrieval of VMware performance counter statistics might be delayed by the retrieval of VMware configuration data (which takes a while for large installations).  Currently only datastore, network interface and disk device statistics and custom performance counter items are based on the VMware performance counter information.
fr	#### Détails  La supervision de la machine virtuelle s'effectue en deux étapes. Premièrement, les données de la machine virtuelle sont collectées par les processus Zabbix *vmware collector*. Ces processus obtiennent les informations nécessaires auprès des services Web VMware via le protocole SOAP, les traitent préalablement et les stockent dans la mémoire partagée du serveur Zabbix. Ces informations sont ensuite récupérées par les pollers à l'aide des [clés VMware](/manual/config/items/itemtypes/simple_checks/vmware_keys) des vérifications simples de Zabbix.  À partir de la version 2.4.4 de Zabbix, les données collectées sont divisées en 2 types : les données de configuration VMware et les données de compteurs de performance VMware. Les deux types sont collectés indépendamment par les *collecteurs vmware*. Pour cette raison, il est recommandé d'activer plus de collecteurs que les services VMware surveillés. Sinon, la récupération des statistiques de compteurs de performance VMware pourrait être retardée par la récupération des données de configuration VMware (ce qui prend un certain temps pour les installations de grande taille).  Actuellement, seules les statistiques de banque de données, d'interface réseau et de périphérique de disque, ainsi que les éléments de compteur de performance personnalisés sont basés sur les informations du compteur de performance VMware.

en-us	#### - Details  To avoid calculations with huge numbers we consider the timestamp of the first value in specified period plus 1 ns as a new zero-time (current epoch time is of order 10^9^, epoch squared is 10^18^, double precision is about 10^-16^). 1 ns is added to provide all positive time values for *logarithmic* and *power* fits which involve calculating log(t). Time shift does not affect *linear*, *polynomial*, *exponential* (apart from easier and more precise calculations) but changes the shape of *logarithmic* and *power* functions.
fr	#### - Détails  Pour éviter les calculs avec de grands nombres, considérons l'horodatage de la première valeur de la période spécifiée plus 1 ns comme une nouvelle heure nulle (l'heure actuelle est de l'ordre de 10^9^, l'époque au carré est de 10^18^, la double précision est d'environ 10^-16^). 1 ns est ajoutée pour fournir toutes les valeurs de temps positives pour les ajustements *logarithmiques* et les ajustements de *puissance* impliquant le calcul de log(t). Le décalage temporel n'affecte pas les calculs *linéaires*, *polynomiaux*, *exponentiels* (à l'exception des calculs plus faciles et plus précis), mais modifie la forme des fonctions *logarithmiques* et de *puissance*.

en-us	#### Developing modules  Modules are written in PHP language. Model-view-controller (MVC) software pattern design is preferred, as it is also used in Zabbix frontend and will ease the development. PHP strict typing is also welcome but not mandatory.  Please note that with modules you can easily add new menu items and respective views and actions to Zabbix frontend. Currently it is not possible to register new API or create new database tables through modules.
fr	#### Développer des modules  Les modules sont écrits en langage PHP. La conception de modèles logiciels modèle-vue-contrôleur (MVC) est préférée, car elle est également utilisée dans l'interface Zabbix et facilitera le développement. Le typage PHP strict est également le bienvenu mais pas obligatoire.  Veuillez noter qu'avec les modules, vous pouvez facilement ajouter de nouveaux éléments de menu et des vues et actions respectives à l'interface Zabbix. Actuellement, il n'est pas possible d'enregistrer une nouvelle API ou de créer de nouvelles tables de base de données via des modules.

en-us	# dhost.get
fr	# dhost.get

en-us	### 'Diagnostic information' request object  The diagnostic information task request object has the following properties. Statistic request object for all types of properties is [described in detail below](/manual/api/reference/task/object#statistic_request_object).  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |historycache|object|History cache statistic request. Available on server and proxy.| |valuecache|object|Items cache statistic request. Available on server.| |preprocessing|object|Preprocessing manager statistic request. Available on server and proxy.| |alerting|object|Alert manager statistic request. Available on server.| |lld|object|LLD manager statistic request. Available on server.|
fr	### Objet de requête 'Informations de diagnostic'  L'objet de demande de tâche d'informations de diagnostic a les propriétés suivantes. L'objet de requête statistique pour tous les types de propriétés est [décrit en détail ci-dessous](/manual/api/reference/task/object#statistic_request_object).  |Propriété|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |historycache|object|Demande de statistiques de cache d'historique. Disponible sur serveur et proxy.| |valuecache|object|Requête de statistiques de cache d'éléments. Disponible sur serveur.| |preprocessing|object|Requête de statistiques du gestionnaire de prétraitement. Disponible sur serveur et proxy.| |alerting|object|Demande de statistiques du gestionnaire d'alertes. Disponible sur serveur.| |lld|object|Requête de statistiques du gestionnaire LLD. Disponible sur serveur.|

en-us	#### Disable action  Disable action, that is, set its status to "1".  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "action.update",     "params": {         "actionid": "2",         "status": "1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "actionids": [             "2"         ]     },     "id": 1 } ```
fr	#### Désactiver l'action  Désactive l'action, c'est-à-dire définir son statut sur "1".  Requête :  ``` {.java} {     "jsonrpc": "2.0",     "method": "action.update",     "params": {         "actionid": "2",         "status": "1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Réponse :  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "actionids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Disable correlation  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "correlation.update",     "params": {         "correlationid": "1",         "status": "1"     },     "auth": "343baad4f88b4106b9b5961e77437688",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "correlationids": [             "1"         ]     },     "id": 1 } ```
fr	#### Désactivation d'une corrélation  Requête :  ``` {.java} {  "jsonrpc": "2.0",  "method": "correlation.update",  "params": {  "correlationid": "1",  "status": "1"  },  "auth": "343baad4f88b4106b9b5961e77437688",  "id": 1 } ```  Réponse :  ``` {.java} {  "jsonrpc": "2.0",  "result": {  "correlationids": [  "1"  ]  },  "id": 1 } ```

en-us	#### Disable trapping  Disable LLD trapping for discovery rule.  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "28336",         "allow_traps": "0"     },     "id": 36,     "auth": "d678e0b85688ce578ff061bd29a20d3b" } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28336"         ]     },     "id": 36 } ```
fr	#### Désactivation des traps  Désactiver les traps d'une règle  Requête :  ``` {.java} {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "28336",         "allow_traps": "0"     },     "id": 36,     "auth": "d678e0b85688ce578ff061bd29a20d3b" } ```  Réponse :  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28336"         ]     },     "id": 36 } ```

en-us	#### Disabling ability to execute scripts  Update role with ID "5", disable ability to execute scripts.  Request:  ```json {     "jsonrpc": "2.0",     "method": "role.update",     "params": [         {             "roleid": "5",             "rules": {                 "actions": [                     {                         "name": "execute_scripts",                         "status": "0"                     }                 ]             }         }     ],     "auth": "3a57200802b24cda67c4e4010b50c065",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "roleids": [             "5"         ]     },     "id": 1 } ```
fr	#### Désactivation de la possibilité d'exécuter des scripts  Mettre à jour le rôle avec l'ID "5", désactiver la possibilité d'exécuter des scripts.  Requête :  ```json {     "jsonrpc": "2.0",     "method": "role.update",     "params": [         {             "roleid": "5",             "rules": {                 "actions": [                     {                         "name": "execute_scripts",                         "status": "0"                     }                 ]             }         }     ],     "auth": "3a57200802b24cda67c4e4010b50c065",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "roleids": [             "5"         ]     },     "id": 1 } ```

en-us	#### Disabling a host prototype  Disable a host prototype, that is, set its status to 1.  Request:  ```json {     "jsonrpc": "2.0",     "method": "hostprototype.update",     "params": {         "hostid": "10092",         "status": 1     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10092"         ]     },     "id": 1 } ```
fr	#### Désactivation d'un prototype d'hôte  Désactivez un prototype d'hôte, c'est-à-dire définissez son statut sur 1.  Requête :  ```json {     "jsonrpc": "2.0",     "method": "hostprototype.update",     "params": {         "hostid": "10092",         "status": 1     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10092"         ]     },     "id": 1 } ```

en-us	#### Disabling a user group  Disable a user group.  Request:  ```json {     "jsonrpc": "2.0",     "method": "usergroup.update",     "params": {         "usrgrpid": "17",         "users_status": "1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "usrgrpids": [             "17"         ]     },     "id": 1 } ```
fr	#### Désactivation d'un groupe d'utilisateurs  Désactiver un groupe d'utilisateurs.  Requête :  ```json {     "jsonrpc": "2.0",     "method": "usergroup.update",     "params": {         "usrgrpid": "17",         "users_status": "1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "usrgrpids": [             "17"         ]     },     "id": 1 } ```

en-us	#### Disabling default web server error pages  It is recommended to disable default error pages to avoid information exposure. Web server is using built-in error pages by default:  ![](../../../../assets/en/manual/installation/requirements/error_page_text.png)  Default error pages should be replaced/removed as part of the web server hardening process. The "ErrorDocument" directive can be used to define a custom error page/text for Apache web server (used as an example).  Please refer to documentation of your web server to find help on how to replace/remove default error pages.
fr	#### Désactivation des pages d'erreur du serveur Web par défaut  Il est recommandé de désactiver les pages d'erreur par défaut pour éviter l'exposition d'informations. Le serveur Web utilise par défaut les pages d'erreur intégrées :  ![](../../../../assets/en/manual/installation/requirements/error_page_text.png)  Les pages d'erreur par défaut doivent être remplacées/supprimées dans le cadre du processus de renforcement du serveur Web. La directive "ErrorDocument" peut être utilisée pour définir une page/un texte d'erreur personnalisé pour le serveur Web Apache (utilisé comme exemple).  Veuillez vous référer à la documentation de votre serveur Web pour trouver de l'aide sur la façon de remplacer/supprimer les pages d'erreur par défaut.

en-us	 ### Disabling high availability  To disable a high availability cluster:  -   make backup copies of configuration files -   stop standby nodes -   remove the HANodeName parameter from the active primary server -   restart the primary server (it will start in standalone mode)
fr	 ### Désactivation de la haute disponibilité  Pour désactiver un cluster haute disponibilité :  -   faire des copies de sauvegarde des fichiers de configuration -   arrêter les nœuds de secours -   supprimer le paramètre HANodeName du serveur principal actif -   redémarrer le serveur principal (il démarrera en mode autonome)

en-us	#### Disabling scheduled report  Request:  ```json {     "jsonrpc": "2.0",     "method": "report.update",     "params": {         "reportid": "1",         "status": "0"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "reportids": [             "1"         ]     },     "id": 1 } ```
fr	#### Désactivation du rapport programmé  Requête :  ```json {     "jsonrpc": "2.0",     "method": "report.update",     "params": {         "reportid": "1",         "status": "0"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "reportids": [             "1"         ]     },     "id": 1 } ```

en-us	### Discovered entities  The screenshots below illustrate how discovered items, triggers, and graphs look like in the host's configuration. Discovered entities are prefixed with an orange link to a discovery rule they come from.  ![](../../../assets/en/manual/discovery/low_level_discovery/discovered_items1.png)  Note that discovered entities will not be created in case there are already existing entities with the same uniqueness criteria, for example, an item with the same key or graph with the same name. An error message is displayed in this case in the frontend that the low-level discovery rule could not create certain entities. The discovery rule itself, however, will not turn unsupported because some entity could not be created and had to be skipped. The discovery rule will go on creating/updating other entities.  Items (similarly, triggers and graphs) created by a low-level discovery rule will be deleted automatically if a discovered entity (file system, interface, etc) stops being discovered (or does not pass the filter anymore). In this case the items, triggers and graphs will be deleted after the days defined in the *Keep lost resources period* field pass.  When discovered entities become 'Not discovered anymore', a lifetime indicator is displayed in the item list. Move your mouse pointer over it and a message will be displayed indicating how many days are left until the item is deleted.  ![](../../../assets/en/manual/discovery/low_level_discovery/not_discovered_message.png)  If entities were marked for deletion, but were not deleted at the expected time (disabled discovery rule or item host), they will be deleted the next time the discovery rule is processed.  Entities containing other entities, which are marked for deletion, will not update if changed on the discovery rule level. For example, LLD-based triggers will not update if they contain items that are marked for deletion.  ![](../../../assets/en/manual/discovery/low_level_discovery/discovered_triggers1.png)  ![](../../../assets/en/manual/discovery/low_level_discovery/discovered_graphs1.png)
fr	 ### Entités découvertes  Les captures d'écran ci-dessous illustrent à quoi ressemblent les éléments, les déclencheurs et les graphiques découverts dans la configuration de l'hôte. Les entités découvertes sont précédées d'un lien orange vers une règle de découverte dont elles proviennent.  ![](../../../assets/en/manual/discovery/low_level_discovery/discovered_items1.png)  Notez que les entités découvertes ne seront pas créées s'il existe déjà des entités existantes avec les mêmes critères d'unicité, par exemple, un élément avec la même clé ou un graphique avec le même nom. Un message d'erreur s'affiche dans ce cas dans le frontend indiquant que la règle de découverte de bas niveau n'a pas pu créer certaines entités. La règle de découverte elle-même, cependant, ne deviendra pas non prise en charge car certaines entités n'ont pas pu être créées et ont dû être ignorées. La règle de découverte continuera à créer/mettre à jour d'autres entités.  Les éléments (de même que les déclencheurs et les graphiques) créés par une règle de découverte de bas niveau seront automatiquement supprimés si une entité découverte (système de fichiers, interface, etc.) cesse d'être découverte (ou ne passe plus le filtre). Dans ce cas, les éléments, les déclencheurs et les graphiques seront supprimés après les jours définis dans le champ *Période de conservation des ressources perdues* passés.  Lorsque les entités découvertes deviennent 'Plus découvertes', un indicateur de durée de vie s'affiche dans la liste des éléments. Déplacez le pointeur de votre souris dessus et un message s'affichera indiquant combien de jours il reste jusqu'à ce que l'élément soit supprimé.  ![](../../../assets/en/manual/discovery/low_level_discovery/not_discovered_message.png)  Si des entités ont été marquées pour suppression, mais n'ont pas été supprimées au moment prévu (règle de découverte ou hôte d'élément désactivé), elles seront supprimées lors du prochain traitement de la règle de découverte.  Les entités contenant d'autres entités, qui sont marquées pour suppression, ne seront pas mises à jour si elles sont modifiées au niveau de la règle de découverte. Par exemple, les déclencheurs basés sur LLD ne seront pas mis à jour s'ils contiennent des éléments marqués pour suppression.  ![](../../../assets/en/manual/discovery/low_level_discovery/discovered_triggers1.png)  ![](../../../assets/en/manual/discovery/low_level_discovery/discovered_graphs1.png)

en-us	#### Discovered entities  When server runs, it will create real items, triggers and graphs based on the values the SNMP discovery rule returns. In the host configuration they are prefixed with an orange link to a discovery rule they come from.  ![](../../../../../assets/en/manual/discovery/low_level_discovery/discovered_items_snmp.png){width="600"}  ![](../../../../../assets/en/manual/discovery/low_level_discovery/discovered_triggers_snmp.png){width="600"}  ![](../../../../../assets/en/manual/discovery/low_level_discovery/discovered_graphs_snmp.png){width="600"}
fr	#### Entités découvertes  Lorsque le serveur s'exécute, il crée des éléments réels, des déclencheurs et des graphiques en fonction des valeurs renvoyées par la règle de découverte SNMP. Dans la configuration de l'hôte, ils sont précédés d'un lien orange vers une règle de découverte d'origine.  ![](../../../../../assets/en/manual/discovery/low_level_discovery/discovered_items_snmp.png){width="600"}  ![](../../../../../assets/en/manual/discovery/low_level_discovery/discovered_triggers_snmp.png){width="600"}  ![](../../../../../assets/en/manual/discovery/low_level_discovery/discovered_graphs_snmp.png){width="600"}

en-us	### Discovered host  ::: noteclassic Discovered host are created by the Zabbix server and cannot be modified via the API. :::  The discovered host object contains information about a host discovered by a network discovery rule. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |dhostid|string|ID of the discovered host.| |druleid|string|ID of the discovery rule that detected the host.| |lastdown|timestamp|Time when the discovered host last went down.| |lastup|timestamp|Time when the discovered host last went up.| |status|integer|Whether the discovered host is up or down. A host is up if it has at least one active discovered service.<br><br>Possible values:<br>0 - host up;<br>1 - host down.|
fr	### Hôte découvert  ::: noteclassic Les hôtes découverts sont créés par le serveur Zabbix et ne peuvent pas être modifiés via l'API. :::  L'objet hôte découvert contient des informations sur un hôte découvert par une règle de découverte du réseau. Il a les propriétés suivantes.  | Propriété | [Type](/manual/api/reference_commentary#data_types)| Description | | --- | --- | --- | | dhostid | string | ID l'hôte découvert. | | druleid | string | ID de la règle de découverte qui a détecté l'hôte. | | lastdown | timestamp | Heure à laquelle l'hôte découvert a été injoignable pour la dernière fois. | | lastup | timestamp | Heure à laquelle l'hôte découvert a été joignable pour la dernière fois. | | status | integer | Indique si l'hôte découvert est actif ou non. Un hôte est actif s'il possède au moins un service découvert actif.<br><br>Valeurs possibles :<br>0 - hôte joignable ;<br>1 - hôte injoignable. |

en-us	# > Discovered host object  The following objects are directly related to the `dhost` API.
fr	# > Objet Hôte découvert  Les objets suivants sont directement liés à l'API `dhost`.

en-us	# Discovered host  This class is designed to work with discovered hosts.  Object references:\  -   [Discovered     host](/manual/api/reference/dhost/object#discovered_host)  Available methods:\  -   [dhost.get](/manual/api/reference/dhost/get) - retrieve discovered     hosts  
fr	# Hôte découvert  Cette classe est conçue pour travailler avec les hôtes découverts.  Référentiel des objets :\  -   [Hôte découvert](/manual/api/reference/dhost/object#discovered_host)  Méthodes disponibles :\  -   [dhost.get](/manual/api/reference/dhost/get) - récupérer les hôtes découverts  

en-us	### Discovered service  ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. :::  The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.|
fr	### Service découvert  ::: noteclassic Les services découverts sont créés par le serveur Zabbix et ne peuvent pas être modifiés via l'API. :::  L'objet service découvert contient des informations sur un service découvert par une règle de découverte de réseau sur un hôte. Il a les propriétés suivantes.  |Propriété|Type|Description| --|--|------| |dserviceid|string|ID du service découvert.| |dcheckid|string|ID du test de découverte utilisé pour détecter le service.| |dhostid|string|ID de l'hôte découvert exécutant le service.| |dns|string|Nom DNS de l'hôte exécutant le service.| |ip|string|Adresse IP de l'hôte exécutant le service.| |lastdown|timestamp|Heure à laquelle le service découvert était inactif la dernière fois.| |lastup|timestamp|Heure à laquelle le service découvert était actif la dernière fois.| |port|integer|Numéro de port du service.| |status|integer|Statut du service.<br><br>Valeurs possibles :<br>0 - service actif ;<br>1 - service inactif.| |value|string|Valeur renvoyée par le service lors d'un test de découverte agent Zabbix, SNMPv1, SNMPv2 ou SNMPv3.|

en-us	# > Discovered service object  The following objects are directly related to the `dservice` API.
fr	# > Objet Service découvert  Les objets suivants sont directement liés à l'API `dservice`.

en-us	# Discovered service  This class is designed to work with discovered services.  Object references:\  -   [Discovered     service](/manual/api/reference/dservice/object#discovered_service)  Available methods:\  -   [dservice.get](/manual/api/reference/dservice/get) - retrieve     discovered services  
fr	# Service découvert  Cette classe est conçue pour travailler avec les services découverts.  Référentiel des objets :\  -   [Service découvert](/manual/api/reference/dservice/object#discovered_service)  Méthodes disponibles :\  -   [dservice.get](/manual/api/reference/dservice/get) - récupérer des services découverts  

en-us	##### Discovering MBean attributes  Discovery item: `jmx.get[attributes,"com.example:type=*,*"]`  Response:  ``` {.json} [     {         "object": "com.example:type=*",         "domain": "com.example",         "properties": {             "type": "Simple"         }     },     {         "object": "com.zabbix:type=yes,domain=zabbix.com,data-source=/dev/rand,ключ=значение,obj=true",         "domain": "com.zabbix",         "properties": {             "type": "Hello",             "domain": "com.example",             "data-source": "/dev/rand",             "ключ": "значение",             "obj": true         }     } ] ```
fr	 ##### Découvrir les attributs MBean  Elément de découverte : `jmx.get[attributes,"com.example:type=*,*"]`  Réponse :  ``` {.json} [     {         "object": "com.example:type=*",         "domain": "com.example",         "properties": {             "type": "Simple"         }     },     {         "object": "com.zabbix:type=yes,domain=zabbix.com,data-source=/dev/rand,ключ=значение,obj=true",         "domain": "com.zabbix",         "properties": {             "type": "Hello",             "domain": "com.example",             "data-source": "/dev/rand",             "ключ": "значение",             "obj": true         }     } ] ```

en-us	##### Discovering MBeans  Discovery item: `jmx.get[beans,"com.example:type=*,*"]`  Response:  ``` {.json} [     {         "object": "com.example:type=Hello,data-src=data-base,ключ=значение",         "domain": "com.example",         "properties": {             "data-src": "data-base",             "ключ": "значение",             "type": "Hello"         }     },     {         "object": "com.example:type=Atomic",         "domain": "com.example",         "properties": {             "type": "Atomic"         }     } ] ```
fr	 ##### Découvrir les MBeans  Elément de découverte : `jmx.get[beans,"com.example:type=*,*"]`  Réponse :  ``` {.json} [     {         "object": "com.example:type=Hello,data-src=data-base,ключ=значение",         "domain": "com.example",         "properties": {             "data-src": "data-base",             "ключ": "значение",             "type": "Hello"         }     },     {         "object": "com.example:type=Atomic",         "domain": "com.example",         "properties": {             "type": "Atomic"         }     } ] ```

en-us	#### Discovery actions  The following conditions can be used in discovery-based events:  |Condition type|Supported operators|Description| |--|--|------| |*Host IP*|equals<br>does not equal|Specify an IP address range or a range to exclude for a discovered host.<br>**equals** - host IP is in the range.<br>**does not equal** - host IP is not in the range.<br>It may have the following formats:<br>Single IP: 192.168.1.33<br>Range of IP addresses: 192.168.1-10.1-254<br>IP mask: 192.168.4.0/24<br>List: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>Support for spaces in the list format is provided since Zabbix 3.0.0.| |*Service type*|equals<br>does not equal|Specify a service type of a discovered service or a service type to exclude.<br>**equals** - matches the discovered service.<br>**does not equal** - does not match the discovered service.<br>Available service types: SSH, LDAP, SMTP, FTP, HTTP, HTTPS *(available since Zabbix 2.2 version)*, POP, NNTP, IMAP, TCP, Zabbix agent, SNMPv1 agent, SNMPv2 agent, SNMPv3 agent, ICMP ping, telnet *(available since Zabbix 2.2 version)*.| |*Service port*|equals<br>does not equal|Specify a TCP port range of a discovered service or a range to exclude.<br>**equals** - service port is in the range.<br>**does not equal** - service port is not in the range.| |*Discovery rule*|equals<br>does not equal|Specify a discovery rule or a discovery rule to exclude.<br>**equals** - using this discovery rule.<br>**does not equal** - using any other discovery rule, except this one.| |*Discovery check*|equals<br>does not equal|Specify a discovery check or a discovery check to exclude.<br>**equals** - using this discovery check.<br>**does not equal** - using any other discovery check, except this one.| |*Discovery object*|equals|Specify the discovered object.<br>**equals** - equal to discovered object (a device or a service).| |*Discovery status*|equals|**Up** - matches 'Host Up' and 'Service Up' events<br>**Down** - matches 'Host Down' and 'Service Down' events<br>**Discovered** - matches 'Host Discovered' and 'Service Discovered' events<br>**Lost** - matches 'Host Lost' and 'Service Lost' events| |*Uptime/Downtime*|is greater than or equals<br>is less than or equals|Uptime for 'Host Up' and 'Service Up' events. Downtime for 'Host Down' and 'Service Down' events.<br>**is greater than or equals** - is more or equal to. Parameter is given in seconds.<br>**is less than or equals** - is less or equal to. Parameter is given in seconds.| |*Received value*|equals<br>does not equal<br>is greater than or equals<br>is less than or equals<br>contains<br>does not contain|Specify the value received from an agent (Zabbix, SNMP) check in a discovery rule. String comparison. If several Zabbix agent or SNMP checks are configured for a rule, received values for each of them are checked (each check generates a new event which is matched against all conditions).<br>**equals** - equal to the value.<br>**does not equal** - not equal to the value.<br>**is greater than or equals** - more or equal to the value.<br>**is less than or equals** - less or equal to the value.<br>**contains** - contains the substring. Parameter is given as a string.<br>**does not contain** - does not contain the substring. Parameter is given as a string.| |*Proxy*|equals<br>does not equal|Specify a proxy or a proxy to exclude.<br>**equals** - using this proxy.<br>**does not equal** - using any other proxy except this one.|  ::: noteclassic Service checks in a discovery rule, which result in discovery events, do not take place simultaneously. Therefore, if **multiple** values are configured for `Service type`, `Service port` or `Received value` conditions in the action, they will be compared to one discovery event at a time, but **not** to several events simultaneously. As a result, actions with multiple values for the same check types may not be executed correctly. :::
fr	 #### Actions de découverte  Les conditions suivantes peuvent être utilisées dans les événements basés sur la découverte :  |Type de condition|Opérateurs pris en charge|Description| |--|--|------| |*IP hôte*|égal<br>n'est pas égal|Spécifiez une plage d'adresses IP ou une plage à exclure pour un hôte découvert.<br>**égal** - l'adresse IP de l'hôte est dans la plage.<br>** n'est pas égal** - l'IP de l'hôte n'est pas dans la plage.<br>Il peut avoir les formats suivants :<br>IP unique : 192.168.1.33<br>Plage d'adresses IP : 192.168.1-10.1-254<br >Masque IP : 192.168.4.0/24<br>Liste : 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>La prise en charge des espaces dans le format de liste est fournie depuis Zabbix 3.0 .0.| |*Type de service*|égal<br>n'est pas égal|Spécifiez un type de service d'un service découvert ou un type de service à exclure.<br>**égal** - correspond au service découvert.<br>**n'est pas égal** - ne correspond pas au service découvert.<br>Types de services disponibles : SSH, LDAP, SMTP, FTP, HTTP, HTTPS *(disponible depuis la version Zabbix 2.2)*, POP, NNTP, IMAP, TCP, agent Zabbix, Agent SNMPv1, agent SNMPv2, agent SNMPv3, ping ICMP, telnet *(disponible depuis la version Zabbix 2.2)*.| |*Port de service*|égal<br>n'est pas égal|Spécifiez une plage de ports TCP d'un service découvert ou une plage à exclure.<br>**égal** - le port de service est dans la plage.<br>**n'est pas égal** - le port de service n'est pas dans la plage.| |*Règle de découverte*|égal<br>n'est pas égal|Spécifiez une règle de découverte ou une règle de découverte à exclure.<br>**égal** - en utilisant cette règle de découverte.<br>**n'est pas égal** - en utilisant n'importe quelle autre règle de découverte, sauf celle-ci.| |*Test de découverte*|égal<br>n'est pas égal|Spécifiez une vérification de découverte ou une vérification de découverte à exclure.<br>**égal** - en utilisant cette vérification de découverte.<br>**n'est pas égal** - en utilisant n'importe quel autre contrôle de découverte, sauf celui-ci.| |*Objet de découverte*|égal|Spécifiez l'objet découvert.<br>**égal** - égal à l'objet découvert (un appareil ou un service).| |*État de la découverte*|égal|**Fonctionne** - correspond aux événements 'Hôte fonctionne' et 'Service fonctionne'<br>**Arrête** - correspond aux événements 'Hôte arrêté' et 'Service arrêté'<br>** Découvert** - correspond aux événements 'Hôte découvert' et 'Service découvert'<br>**Perdu** - correspond aux événements 'Hôte perdu' et 'Service perdu'| |*Fonctionnement/Arrêt*|est supérieur ou égal<br>est inférieur ou égal|Uptime pour les événements 'Hôte fonctionne' et 'Service fonctionne'. Temps d'arrêt pour les événements 'Host Down' et 'Service Down'.<br>**est supérieur ou égal à** - est supérieur ou égal à. Le paramètre est donné en secondes.<br>**est inférieur ou égal à** - est inférieur ou égal à. Le paramètre est donné en secondes.| |*Valeur reçue*|égal<br>n'est pas égal<br>est supérieur ou égal à<br>est inférieur ou égal à<br>contient<br>ne contient pas|Spécifiez la valeur reçue d'un agent (Zabbix, SNMP) vérifient une règle de découverte. Comparaison de chaînes. Si plusieurs agents Zabbix ou contrôles SNMP sont configurés pour une règle, les valeurs reçues pour chacun d'eux sont vérifiées (chaque contrôle génère un nouvel événement qui correspond à toutes les conditions).<br>**égal** - égal à la valeur. <br>**n'est pas égal** - n'est pas égal à la valeur.<br>**est supérieur ou égal à** - supérieur ou égal à la valeur.<br>**est inférieur ou égal à** - inférieur ou égal à la valeur.<br>**contient** - contient la sous-chaîne. Le paramètre est donné sous forme de chaîne.<br>**ne contient pas** - ne contient pas la sous-chaîne. Le paramètre est donné sous forme de chaîne.| |*Proxy*|égal<br>n'est pas égal|Spécifiez un proxy ou un proxy à exclure.<br>**égal** - en utilisant ce proxy.<br>**n'est pas égal** - en utilisant un autre proxy sauf celui-ci.|  ::: noteclassic Les vérifications de service dans une règle de découverte, qui entraînent des événements de découverte, n'ont pas lieu simultanément. Par conséquent, si **plusieurs** valeurs sont configurées pour les conditions `Type de service`, `Port de service` ou `Valeur reçue` dans l'action, elles seront comparées à un événement de découverte à la fois, mais **pas** à plusieurs événements simultanément. Par conséquent, les actions avec plusieurs valeurs pour les mêmes types de contrôle peuvent ne pas être exécutées correctement. :::

en-us	# > Discovery check object  The following objects are directly related to the `dcheck` API.
fr	# > Objet Test de découverte  Les objets suivants sont directement liés à l'API `dcheck`.

en-us	### Discovery check  The discovery check object defines a specific check performed by a network discovery rule. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dcheckid|string|*(readonly)* ID of the discovery check.| |druleid|string|*(readonly)* ID of the discovery rule that the check belongs to.| |key\_|string|The value of this property differs depending on the type of the check:<br>- key to query for Zabbix agent checks, required;<br>- SNMP OID for SNMPv1, SNMPv2 and SNMPv3 checks, required.| |ports|string|One or several port ranges to check separated by commas. Used for all checks except for ICMP.<br><br>Default: 0.| |snmp\_community|string|SNMP community.<br><br>Required for SNMPv1 and SNMPv2 agent checks.| |snmpv3\_authpassphrase|string|Authentication passphrase used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.| |snmpv3\_authprotocol|integer|Authentication protocol used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.<br><br>Possible values:<br>0 - *(default)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |snmpv3\_contextname|string|SNMPv3 context name. Used only by SNMPv3 checks.| |snmpv3\_privpassphrase|string|Privacy passphrase used for SNMPv3 agent checks with security level set to *authPriv*.| |snmpv3\_privprotocol|integer|Privacy protocol used for SNMPv3 agent checks with security level set to *authPriv*.<br><br>Possible values:<br>0 - *(default)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|string|Security level used for SNMPv3 agent checks.<br><br>Possible values:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|string|Security name used for SNMPv3 agent checks.| |**type**<br>(required)|integer|Type of check.<br><br>Possible values:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;<br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix agent;<br>10 - SNMPv1 agent;<br>11 - SNMPv2 agent;<br>12 - ICMP ping;<br>13 - SNMPv3 agent;<br>14 - HTTPS;<br>15 - Telnet.| |uniq|integer|Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule. Used for Zabbix agent, SNMPv1, SNMPv2 and SNMPv3 agent checks.<br><br>Possible values:<br>0 - *(default)* do not use this check as a uniqueness criteria;<br>1 - use this check as a uniqueness criteria.| |host\_source|integer|Source for host name.<br><br>Possible values:<br>1 - *(default)* DNS;<br>2 - IP;<br>3 - discovery value of this check.| |name\_source|integer|Source for visible name.<br><br>Possible values:<br>0 - *(default)* not specified;<br>1 - DNS;<br>2 - IP;<br>3 - discovery value of this check.|
fr	### Test de découverte  L'objet test de découverte définit une vérification spécifique effectuée par une règle de découverte du réseau. Il a les propriétés suivantes.  | Propriété | [Type](/manual/api/reference_commentary#data_types)| Description | |--------|---------------------------------------------------|-----------| | dcheckid | string | *(lecture seule)* ID du test de découverte. | | druleid | string | *(lecture seule)* ID de la règle de découverte à laquelle le test appartient. | | key_ | string | La valeur de cette propriété diffère selon le type de test :<br>- clé pour interroger les tests d'agent Zabbix, obligatoire ;<br>- SNMP OID pour les tests SNMPv1, SNMPv2 et SNMPv3, obligatoire. | | ports | string | Une ou plusieurs plages de ports à vérifier, séparées par des virgules. Utilisé pour toutes les vérifications sauf ICMP.<br><br>Par défaut : 0. | | snmp_community | string | Communauté SNMP.<br><br>Obligatoire pour les vérifications d'agent SNMPv1 et SNMPv2. | | snmpv3_authpassphrase | string | Phrase secrète Auth utilisée pour les vérifications d'agent SNMPv3 avec un niveau de sécurité défini sur *authNoPriv* ou *authPriv*. | | snmpv3_authprotocol | integer | Protocole d'authentification utilisé pour les vérifications d'agent SNMPv3 avec un niveau de sécurité défini sur *authNoPriv* ou *authPriv*.<br><br>Valeurs possibles :<br>0 - *(par défaut)* MD5 ;1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512. | | snmpv3_contextname | string | Nom du contexte SNMPv3. Utilisé uniquement par les vérifications SNMPv3. | | snmpv3_privpassphrase | string | Phrase secrète Priv utilisée pour les vérifications d'agent SNMPv3 avec un niveau de sécurité défini sur *authPriv*. | | snmpv3_privprotocol | integer | Protocole de confidentialité utilisé pour les vérifications d'agent SNMPv3 avec un niveau de sécurité défini sur *authPriv*.<br><br>Valeurs possibles :<br>0 - *(par défaut)* DES ;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C. | | snmpv3_securitylevel | string | Niveau de sécurité utilisé pour les vérifications d'agent SNMPv3.<br><br>Valeurs possibles :<br>0 - noAuthNoPriv ;<br>1 - authNoPriv ;<br>2 - authPriv. | | snmpv3_securityname | string | Nom de sécurité utilisé pour les vérifications d'agent SNMPv3. | | **type**<br>(obligatoire) | integer | Type de vérifications.<br><br>Valeurs possibles :<br>0 - SSH ;<br>1 - LDAP ;<br>2 - SMTP ;<br>3 - FTP ;<br>4 - HTTP ;<br>5 - POP ;<br>6 - NNTP ;<br>7 - IMAP ;<br>8 - TCP ;<br>9 - agent Zabbix ;<br>10 - agent SNMPv1 ;<br>11 - agent SNMPv2 ;<br>12 - ping ICMP ;<br>13 - agent SNMPv3 ;<br>14 - HTTPS ;<br>15 - Telnet. | | uniq | integer | Indique s'il faut utiliser cette vérification comme critère d'unicité du périphérique. Une seule vérification unique peut être configurée par règle de découverte. Utilisé pour les vérifications d'agent Zabbix, SNMPv1, SNMPv2 et SNMPv3.<br><br>Valeurs possibles :<br>0 - *(par défaut)* ne pas utiliser cette vérification comme critère d'unicité ;<br>1 - utiliser cette vérification comme critère d'unicité. | | host_source | integer | Source for host name.<br><br>Possible values:<br>1 - *(default)* DNS;<br>2 - IP;<br>3 - discovery value of this check. | | name_source | integer | Source for visible name.<br><br>Possible values:<br>0 - *(default)* not specified;<br>1 - DNS;<br>2 - IP;<br>3 - discovery value of this check. |

en-us	# Discovery check  This class is designed to work with discovery checks.  Object references:\  -   [Discovery     check](/manual/api/reference/dcheck/object#discovery_check)  Available methods:\  -   [dcheck.get](/manual/api/reference/dcheck/get) - retrieve discovery     checks  
fr	# Test de découverte  Cette classe est conçue pour travailler avec les tests de découverte.  Référentiel des objets :\  -   [Test de découverte](/manual/api/reference/dcheck/object#discovery_check)  Méthodes disponibles :\  -   [dcheck.get](/manual/api/reference/dcheck/get) - récupérer les tests de découverte  

en-us	#### Discovery events  Zabbix periodically scans the IP ranges defined in network discovery rules. Frequency of the check is configurable for each rule individually. Once a host or a service is discovered, a discovery event (or several events) are generated.  Zabbix generates the following events:  |Event|When generated| |--|--------| |Service Up|Every time Zabbix detects active service.| |Service Down|Every time Zabbix cannot detect service.| |Host Up|If at least one of the services is UP for the IP.| |Host Down|If all services are not responding.| |Service Discovered|If the service is back after downtime or discovered for the first time.| |Service Lost|If the service is lost after being up.| |Host Discovered|If host is back after downtime or discovered for the first time.| |Host Lost|If host is lost after being up.|
fr	#### Événements de découverte  Zabbix analyse périodiquement les plages IP définies dans les règles de découverte du réseau. La fréquence de la vérification est configurable pour chaque règle individuellement. Une fois qu'un hôte ou un service est découvert, un événement de découverte (ou plusieurs événements) est généré.  Zabbix génère les événements suivants :  |Événement|Généré quand| |--|--------| |Service Up|Chaque fois que Zabbix détecte un service actif.| |Service Down|Chaque fois que Zabbix ne peut pas détecter le service.| |Hôte Up|Si au moins un des services est UP pour l'IP.| |Hôte Down|Si tous les services ne répondent pas.| |Service découvert|Si le service est de retour après un temps d'arrêt ou découvert pour la première fois.| |Service perdu|Si le service est perdu après avoir été activé.| |Hôte découvert|Si l'hôte est de retour après un temps d'arrêt ou découvert pour la première fois.| |Hôte perdu|Si l'hôte est perdu après avoir été activé.|

en-us	### Discovery of disabled systemd units  It is now also possible to discover **disabled** systemd units using the *systemd.unit.discovery* item key,  supported by Zabbix agent 2. Note that to have items and triggers created from prototypes for disabled systemd units,  it may be necessary to adjust (or remove) prohibiting LLD filters for the {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE} macros.   For more details, see [Discovery of systemd services](/manual/discovery/low_level_discovery/examples/systemd).
fr	### Découverte des unités systemd désactivées  Il est désormais également possible de découvrir les unités systemd **désactivées** à l'aide de la clé d'élément *systemd.unit.discovery*, pris en charge par l'agent Zabbix 2. Notez que pour avoir des éléments et des déclencheurs créés à partir de prototypes pour les unités systemd désactivées, il peut être nécessaire d'ajuster (ou de supprimer) les filtres LLD d'interdiction pour les macros {#UNIT.ACTIVESTATE} et {#UNIT.UNITFILESTATE}.  Pour plus de détails, voir [Découverte des services systemd](/manual/discovery/low_level_discovery/examples/systemd).

en-us	##### Discovery of disabled systemd units  Since Zabbix 6.0.1 it is also possible to discover **disabled** systemd units. In this case  three macros are returned in the resulting JSON:   -    {#UNIT.PATH} -    {#UNIT.ACTIVESTATE} -    {#UNIT.UNITFILESTATE}.   ::: noteimportant To have items and triggers created from prototypes for disabled systemd units, make sure to  adjust (or remove) prohibiting LLD filters for {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE}. :::
fr	##### Découverte des unités systemd désactivées  Depuis Zabbix 6.0.1, il est également possible de découvrir les unités systemd **désactivées**. Dans ce cas, trois macros sont renvoyées dans le JSON résultant :  - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}.  ::: noteimportant Pour que des éléments et des déclencheurs soient créés à partir de prototypes pour les unités systemd désactivées, assurez-vous d'ajuster (ou de supprimer) les filtres LLD interdisant pour {#UNIT.ACTIVESTATE} et {#UNIT.UNITFILESTATE}. :::

en-us	#### discoveryrule  Bug fixes:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `discoveryrule.create`, `discoveryrule.update`: property `interfaceid` is no longer required to create/update a HTTP agent type LLD rule.\
fr	#### règle de découverte  Corrections de bogues :\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `discoveryrule.create`, `discoveryrule.update` : la propriété `interfaceid` n'est plus nécessaire pour créer/mettre à jour une règle LLD de type HTTP agent.\

en-us	#### discoveryrule  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `discoveryrule.update`: the parameter `uuid` can now be updated.\
fr	#### règle de découverte  Changements :\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `discoveryrule.update`: le paramètre `uuid` peut maintenant être mis à jour.\

en-us	# discoveryrule.copy
fr	# discoveryrule.copy

en-us	# discoveryrule.create
fr	# discoveryrule.create

en-us	# discoveryrule.delete
fr	# discoveryrule.delete

en-us	# discoveryrule.get
fr	# discoveryrule.get

en-us	# > Discovery rule object  The following objects are directly related to the `drule` API.
fr	# > Objet Règle de découverte  Les objets suivants sont directement liés à l'API `drule`.

en-us	### Discovery rule  The discovery rule object defines a network discovery rule. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |druleid|string|*(readonly)* ID of the discovery rule.| |**iprange**<br>(required)|string|One or several IP ranges to check separated by commas.<br><br>Refer to the [network discovery configuration](/manual/discovery/network_discovery/rule) section for more information on supported formats of IP ranges.| |**name**<br>(required)|string|Name of the discovery rule.| |delay|string|Execution interval of the discovery rule. Accepts seconds, time unit with suffix and user macro.<br><br>Default: 1h.| |nextcheck|timestamp|*(readonly)* Time when the discovery rule will be executed next.| |proxy\_hostid|string|ID of the proxy used for discovery.| |status|integer|Whether the discovery rule is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
fr	### Règle de découverte  L'objet de règle de découverte définit une règle de découverte du réseau. Il a les propriétés suivantes.  |Proptiété|Type|Description| |--|--|------| |druleid|string|*(lecture seule)* ID de la règle de découverte.| |**iprange**<br>(obligatoire)|string|Une ou plusieurs plages IP à vérifier, séparées par des virgules.<br><br>Se référer à la section de [configuration d'une règle de découverte du réseau](/manual/discovery/network_discovery/rule) pour plus d'informations sur les formats de plages IP supportés.| |**name**<br>(obligatoire)|string|Nom de la règle de découverte.| |delay|string|Intervalle d'exécution de la règle de découverte. Accepte les secondes, les unités de temps avec suffixe et les macros utilisateur.<br><br>Par défaut : 1h.| |nextcheck|timestamp|*(lecture seule)* Heure à laquelle la règle de découverte sera exécutée la prochaine fois.| |proxy\_hostid|string|ID du proxy utilisé pour la découverte.| |status|integer|Indique si la règle de découverte est activée.<br><br>Valeurs possibles :<br>0 - *(par défaut)* activée ;<br>1 - désactivée.|  Notez que pour certaines méthodes (mise à jour, suppression) la combinaison de paramètres requise/optionnelle est différente.

en-us	# Discovery rule  This class is designed to work with network discovery rules.  ::: notetip This API is meant to work with network discovery rules. For the low-level discovery rules see the [LLD rule API](discoveryrule). :::  Object references:\  -   [Discovery rule](/manual/api/reference/drule/object#discovery_rule)  Available methods:\  -   [drule.create](/manual/api/reference/drule/create) - create new     discovery rules -   [drule.delete](/manual/api/reference/drule/delete) - delete     discovery rules -   [drule.get](/manual/api/reference/drule/get) - retrieve discovery     rules -   [drule.update](/manual/api/reference/drule/update) - update     discovery rules  
fr	# Règle de découverte  Cette classe est conçue pour travailler avec les règles de découverte réseau.  ::: notetip Cette API est conçue pour fonctionner avec les règles de découverte du réseau. Pour les règles de découverte de bas niveau, voir l'[API Règle de découverte bas niveau](discoveryrule). :::  Référentiel des objets :\  -   [Règle de découverte](/manual/api/reference/drule/object#discovery_rule)  Méthodes disponibles :\  -   [drule.create](/manual/api/reference/drule/create) - créer de nouvelles règles de découverte -   [drule.delete](/manual/api/reference/drule/delete) - supprimer des règles de découverte -   [drule.get](/manual/api/reference/drule/get) - récupérer des règles de découverte -   [drule.update](/manual/api/reference/drule/update) - mettre à jour des règles de découverte  

en-us	# discoveryrule.update
fr	# discoveryrule.update

en-us	#### Discovery  Zabbix can use a low-level discovery rule to automatically discover VMware hypervisors and virtual machines.  ![](../../assets/en/manual/vm_monitoring/vm_hypervisor_lld.png)  All mandatory input fields are marked with a red asterisk.  The discovery rule key in the above screenshot is *vmware.hv.discovery\[{$VMWARE.URL}\]*.
fr	#### Découverte  Zabbix peut utiliser une règle de découverte de bas niveau pour découvrir automatiquement les hyperviseurs VMware et les machines virtuelles.  ![](../../assets/en/manual/vm_monitoring/vm_hypervisor_lld.png)  Tous les champs obligatoires sont marqués par un astérisque rouge.  La clé de la règle de découverte dans la capture d'écran ci-dessus est *vmware.hv.discovery\[{$VMWARE.URL}\]*

en-us	#### Discovery  Zabbix periodically scans the IP ranges defined in [network discovery rules](/manual/discovery/network_discovery/rule). The frequency of the check is configurable for each rule individually.  Note that one discovery rule will always be processed by a single discoverer process. The IP range will not be split between multiple discoverer processes.  Each rule has a set of service checks defined to be performed for the IP range.  ::: noteclassic Discovery checks are processed independently from the other checks. If any checks do not find a service (or fail), other checks will still be processed. :::  Every check of a service and a host (IP) performed by the network discovery module generates a discovery event.  |Event|Check of service result| |--|--------| |*Service Discovered*|The service is 'up' after it was 'down' or when discovered for the first time.| |*Service Up*|The service is 'up', after it was already 'up'.| |*Service Lost*|The service is 'down' after it was 'up'.| |*Service Down*|The service is 'down', after it was already 'down'.| |*Host Discovered*|At least one service of a host is 'up' after all services of that host were 'down' or a service is discovered which belongs to a not registered host.| |*Host Up*|At least one service of a host is 'up', after at least one service was already 'up'.| |*Host Lost*|All services of a host are 'down' after at least one was 'up'.| |*Host Down*|All services of a host are 'down', after they were already 'down'.|
fr	#### Découverte  Zabbix analyse périodiquement les plages IP définies dans les [règles de découverte du réseau](/manual/discovery/network_discovery/rule). La fréquence du contrôle est configurable pour chaque règle individuellement.  Notez qu'une règle de découverte sera toujours traitée par un processus de découverte unique. La plage d'adresses IP ne sera pas divisée entre plusieurs processus de découverte.  Chaque règle comporte un ensemble de vérifications de service à exécuter pour la plage IP.  ::: noteclassic Les vérifications de découverte sont traités indépendamment des autres vérifications. Si des vérifications ne trouvent pas de service (ou échouent), les autres vérifications seront toujours traitées. :::  Chaque vérification d'un service et d'un hôte (IP) effectuée par le module de découverte du réseau génère un événement de découverte.  | Événement |Vérification du résultat du service | | --- | --- | | *Service Discovered* | Le service est 'démarré' après avoir été 'arrêté' ou lorsqu'il est découvert la première fois. | | *Service Up* | Le service est 'démarré'. | | *Service Lost* | Le service est 'arrêté' après avoir été 'démarré'. | | *Service Down* | Le service est 'arrêté'. | | *Host Discovered* | Au moins un des services d'un hôte est "démarré" après que tous les services de cet hôte aient été "arrêtés" ou un service est découvert qui appartient à un hôte non-enregistré. | | *Host Up* | Au moins un service d'un hôte est 'démarré'. | | *Host Lost* | Tous les services d'un hôte sont 'arrêtés' après qu'au moins un des services ait été 'arrêté'. | | *Host Down* | Tous les services d'un hôte sont 'arrêtés'. |

en-us	#### Display
fr	#### Affichage

en-us	#### Display  Based on acknowledgment information it is possible to configure how the problem count is displayed in the dashboard or maps. To do that, you have to make selections in the *Problem display* option, available in both [map configuration](/manual/config/visualization/maps/map#creating_a_map) and the *Problems by severity* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard##adding_widgets). It is possible to display all problem count, unacknowledged problem count as separated from the total or unacknowledged problem count only.  Based on problem update information (acknowledgment, etc.), it is possible to configure update operations - send a message or execute remote commands.
fr	#### Affichage  En fonction des informations d'acquittement, il est possible de configurer l'affichage du nombre de problèmes dans le tableau de bord ou les cartes. Pour ce faire, vous devez effectuer des sélections dans l'option *Affichage des problèmes*, disponible à la fois dans la [configuration de la carte](/manual/config/visualization/maps/map#creating_a_map) et dans le [widget de tableau de bord](/manual/web_interface/frontend_sections/monitoring/dashboard##adding_widgets) *Problèmes par gravité*. Il est possible d'afficher tous les problèmes répertoriés, tous problèmes non acquittés séparés du nombre de problèmes total ou non acquittés uniquement.  En fonction des informations de mise à jour du problème (acquittement, etc.), il est possible de configurer les opérations de mise à jour - envoi de message ou exécution de commandes à distance.

en-us	##### Displaying hosts in maintenance  An orange wrench icon ![](../../assets/en/manual/web_interface/frontend_sections/configuration/maintenance_wrench_icon.png) next to the host name indicates that this host is in maintenance in:  -   *Monitoring → Dashboard* -   *Monitoring → Problems* -   *Inventory → Hosts → Host inventory details* -   *Configuration → Hosts* (See 'Status' column)  ![](../../assets/en/manual/maintenance/maintenance_icon.png)  Maintenance details are displayed when the mouse pointer is positioned over the icon.  Additionally, hosts in maintenance get an orange background in *Monitoring → Maps*.
fr	##### Affichage des hôtes en maintenance  Une icône de clé orange ![](../../assets/en/manual/web_interface/frontend_sections/configuration/maintenance_wrench_icon.png) à côté du nom de l'hôte indique que cet hôte est en maintenance dans :  -   *Surveillance → Tableau de bord* -   *Surveillance → Problèmes* -   *Inventaire → Hôtes → Détails de l'inventaire de l'hôte* -   *Configuration → Hôtes* (Voir la colonne 'Statut')  ![](../../assets/en/manual/maintenance/maintenance_icon.png)  Les détails de la maintenance s'affichent lorsque le pointeur de la souris est positionné sur l'icône.  De plus, les hôtes en maintenance obtiennent un fond orange dans *Surveillance → Cartes*.

en-us	##### Displaying suppressed problems  Normally problems for hosts in maintenance are suppressed, i.e. not displayed in the frontend. However, it is also possible to configure that suppressed problems are shown, by selecting the *Show suppressed problems* option in these locations:  -   *Monitoring* → *Dashboard* (in *Problem hosts*, *Problems*,     *Problems by severity*, *Trigger overview* widget configuration) -   *Monitoring* → *Problems* (in the filter) -   *Monitoring* → *Maps* (in map configuration) -   Global     [notifications](/manual/web_interface/user_profile/global_notifications)     (in user profile configuration)  When suppressed problems are displayed, the following icon is displayed: ![](../../assets/en/manual/web_interface/icon_suppressed.png). Rolling a mouse over the icon displays more details:  ![](../../assets/en/manual/web_interface/info_suppressed2.png)
fr	 ##### Affichage des problèmes supprimés  Normalement, les problèmes des hôtes en maintenance sont supprimés, c'est-à-dire qu'ils ne sont pas affichés dans l'interface. Cependant, il est également possible de configurer l'affichage des problèmes supprimés en sélectionnant l'option *Afficher les problèmes supprimés* à ces emplacements :  - *Surveillance* → *Tableau de bord* (dans la configuration des widgets *Hôtes problématiques*, *Problèmes*, *Problèmes par sévérité*, *Aperçu des déclencheurs* ) - *Surveillance* → *Problèmes* (dans le filtre) - *Surveillance* → *Cartes* (dans la configuration de la carte) - [Notifications](/manual/web_interface/user_profile/global_notifications) globales (dans la configuration du profil utilisateur)  Lorsque des problèmes supprimés sont affichés, l'icône suivante s'affiche : ![](../../assets/en/manual/web_interface/icon_suppressed.png). Passez la souris sur l'icône pour afficher plus de détails :  ![](../../assets/en/manual/web_interface/info_suppressed2.png)

en-us	#### Displaying trigger status  With a trigger defined, you might be interested to see its status.  If the CPU load has exceeded the threshold level you defined in the trigger, the problem will be displayed in *Monitoring → Problems*.  ![](../../../assets/en/manual/quickstart/trigger_status0.png){width="600"}  The flashing in the status column indicates a recent change of trigger status, one that has taken place in the last 30 minutes.
fr	#### Affichage du statut des déclencheurs  Avec un déclencheur défini, vous serez interessé de voir son statut.  Si la charge CPU a dépassé le seuil que vous avez défini pour le déclencheur, le problème sera affiché dans *Surveillance → Problèmes*.  ![](../../../assets/en/manual/quickstart/trigger_status0.png){width="600"}  Le clignotement indique un changement récent de l'état du déclencheur, celui qui a eu lieu au cours des 30 dernières minutes.

en-us	#### Display  In *Monitoring → Maps* the respective color will be displayed on the link if the trigger goes into a problem state.  ![](../../../../../assets/en/manual/config/visualization/map_problem.png)  ::: noteclassic If multiple triggers go into a problem state, the problem with the highest severity will determine the link style and color. If multiple triggers with the same severity are assigned to the same map link, the one with the lowest ID takes precedence. Note also that:\ \ 1. *Minimum trigger severity* and *Show suppressed problem* settings from map configuration affect which problems are taken into account.\ 2. In the case of triggers with multiple problems (multiple problem generation), each problem may have a severity that differs from trigger severity (changed manually), may have different tags (due to macros), and may be suppressed. :::
fr	 ####  Affichage  Dans *Surveillance → Cartes*, la couleur correspondante sera affichée sur le lien si le déclencheur passe à un état problématique.  ![](../../../../../assets/en/manual/config/visualization/map_problem.png)  ::: noteclassic Si plusieurs déclencheurs entrent dans un état problématique, le problème avec la sévérité la plus élevée déterminera le style et la couleur du lien. Si plusieurs déclencheurs avec la même sévérité sont affectés au même lien de carte, celui avec l'ID le plus bas est prioritaire. Notez également que\ \ 1. Les paramètres *Sévérité minimale du déclencheur* et *Afficher le problème supprimé* de la configuration de la carte affectent les problèmes pris en compte.\ 2. Dans le cas de déclencheurs avec plusieurs problèmes (génération de problèmes multiples), chaque problème peut avoir une sévérité différente de la sévérité du déclencheur (modifié manuellement), peut avoir des tags différents (en raison de macros) et peut être supprimé. :::

en-us	##### Display  In the item list dependent items are displayed with their master item name as prefix.  ![](../../../../../assets/en/manual/config/items/itemtypes/dependent_items.png){width="600"}  If a master item is deleted, so are all its dependent items.
fr	##### Affichage  Dans la liste d'éléments, les éléments dépendants sont affichés avec leur nom d'élément principal comme préfixe.  ![](../../../../../assets/en/manual/config/items/itemtypes/dependent_items.png){width="600"}  Si un élément principal est supprimé, tous ses éléments dépendants le sont également.

en-us	#### Display  The following screen will be displayed when trying to access the Zabbix frontend while in maintenance mode. The screen is refreshed every 30 seconds in order to return to a normal state without user intervention when the maintenance is over.  ![](../../../assets/en/manual/web_interface/frontend_maintenance.png)  IP addresses defined in ZBX\_GUI\_ACCESS\_IP\_RANGE will be able to access the frontend as always.
fr	#### Affichage  L’écran suivant s’affiche lorsque vous tentez d’accéder à l’interface Zabbix en mode maintenance. L'écran est actualisé toutes les 30 secondes afin de revenir à un état normal sans intervention de l'utilisateur une fois la maintenance terminée.  ![](../../../assets/en/manual/web_interface/frontend_maintenance.png)  Les adresses IP définies dans ZBX\_GUI\_ACCESS\_IP\_RANGE pourront accéder à l'interface comme à d'habitude.

en-us	##### Display  This is the result in *Monitoring → Latest data*:  ![](../../../../../assets/en/manual/config/items/itemtypes/trapped_data.png){width="600"}  Note that if a single numeric value is sent in, the data graph will show a horizontal line to the left and to the right of the time point of the value.
fr	##### Affichage  Voici le résultat dans *Surveillance → Dernières données* :  ![](../../../../../assets/en/manual/config/items/itemtypes/trapped_data.png){width="600"}  Notez que si une seule valeur numérique est envoyée, le graphique de données affichera une ligne horizontale à gauche et à droite du point temporel de la valeur.

en-us	#### Display  To view web scenarios configured for a host, go to *Monitoring → Hosts*, locate the host in the list and click on the *Web* hyperlink in the last column. Click on the scenario name to get detailed information.  ![](../../assets/en/manual/web_monitoring/scenario_details2.png){width="600"}  An overview of web scenarios can also be displayed in *Monitoring → Dashboard* by a Web monitoring widget.  Recent results of the web scenario execution are available in the *Monitoring → Latest data* section.
fr	#### Affichage  Pour afficher les scénarios Web configurés pour un hôte, accédez à *Surveillance → Hôtes*, localisez l'hôte dans la liste et cliquez sur l'hyperlien *Web* dans la dernière colonne. Cliquez sur le nom du scénario pour obtenir des informations détaillées.  ![](../../assets/en/manual/web_monitoring/scenario_details2.png){width="600"}  Un aperçu des scénarios Web peut également être affiché dans *Surveillance → Tableau de bord* par un widget de surveillance Web.  Les résultats récents de l'exécution du scénario Web sont disponibles dans la section *Surveillance → Dernières données*.

en-us	#### Docker base images  Zabbix components are provided on Ubuntu, Alpine Linux and CentOS base images:  |Image|Version| |---|---| |[alpine](https://hub.docker.com/_/alpine/)|3.12| |[ubuntu](https://hub.docker.com/_/ubuntu/)|20.04 (focal)| |[centos](https://hub.docker.com/_/centos/)|8|  All images are configured to rebuild latest images if base images are updated.
fr	#### Images de base Docker  Les composants Zabbix sont fournis sur les images de base Ubuntu, Alpine Linux et CentOS :   |Image|Version| |---|---| |[alpine](https://hub.docker.com/_/alpine/)|3.12| |[ubuntu](https://hub.docker.com/_/ubuntu/)|20.04 (focal)| |[centos](https://hub.docker.com/_/centos/)|8|  Toutes les images sont configurées pour reconstruire les dernières images si les images de base sont mises à jour.

en-us	### Docker Compose  Zabbix provides compose files also for defining and running multi-container Zabbix components in Docker. These compose files are available in Zabbix docker official repository on github.com: <https://github.com/zabbix/zabbix-docker>. These compose files are added as examples, they are overloaded. For example, they contain proxies with MySQL and SQLite3 support.  There are a few different versions of compose files:   |File name|Description| |--|--------| |`docker-compose_v3_alpine_mysql_latest.yaml`|The compose file runs the latest version of Zabbix 6.0 components on Alpine Linux with MySQL database support.| |`docker-compose_v3_alpine_mysql_local.yaml`|The compose file locally builds the latest version of Zabbix 6.0 and runs Zabbix components on Alpine Linux with MySQL database support.| |`docker-compose_v3_alpine_pgsql_latest.yaml`|The compose file runs the latest version of Zabbix 6.0 components on Alpine Linux with PostgreSQL database support.| |`docker-compose_v3_alpine_pgsql_local.yaml`|The compose file locally builds the latest version of Zabbix 6.0 and runs Zabbix components on Alpine Linux with PostgreSQL database support.| |`docker-compose_v3_centos_mysql_latest.yaml`|The compose file runs the latest version of Zabbix 6.0 components on CentOS 8 with MySQL database support.| |`docker-compose_v3_centos_mysql_local.yaml`|The compose file locally builds the latest version of Zabbix 6.0 and runs Zabbix components on CentOS 8 with MySQL database support.| |`docker-compose_v3_centos_pgsql_latest.yaml`|The compose file runs the latest version of Zabbix 6.0 components on CentOS 8 with PostgreSQL database support.| |`docker-compose_v3_centos_pgsql_local.yaml`|The compose file locally builds the latest version of Zabbix 6.0 and runs Zabbix components on CentOS 8 with PostgreSQL database support.| |`docker-compose_v3_ubuntu_mysql_latest.yaml`|The compose file runs the latest version of Zabbix 6.0 components on Ubuntu 20.04 with MySQL database support.| |`docker-compose_v3_ubuntu_mysql_local.yaml`|The compose file locally builds the latest version of Zabbix 6.0 and runs Zabbix components on Ubuntu 20.04 with MySQL database support.| |`docker-compose_v3_ubuntu_pgsql_latest.yaml`|The compose file runs the latest version of Zabbix 6.0 components on Ubuntu 20.04 with PostgreSQL database support.| |`docker-compose_v3_ubuntu_pgsql_local.yaml`|The compose file locally builds the latest version of Zabbix 6.0 and runs Zabbix components on Ubuntu 20.04 with PostgreSQL database support.|  ::: noteimportant Available Docker compose files support version 3 of Docker Compose. :::
fr	 ### Composition Docker  Zabbix fournit également des fichiers de composition pour définir et exécuter des composants Zabbix multi-conteneurs dans Docker. Ces fichiers de composition sont disponibles dans le référentiel officiel Zabbix docker sur github.com : <https://github.com/zabbix/zabbix-docker>. Ces fichiers de composition sont ajoutés à titre d'exemples, ils sont surchargés. Par exemple, ils contiennent des proxies prenant en charge MySQL et SQLite3.  Il existe plusieurs versions différentes des fichiers de composition :   |Nom du fichier|Description| |--|--------| |`docker-compose_v3_alpine_mysql_latest.yaml`|Le fichier de composition exécute la dernière version des composants Zabbix 5.4 sur Alpine Linux avec prise en charge de la base de données MySQL.| |`docker-compose_v3_alpine_mysql_local.yaml`|Le fichier de composition construit localement la dernière version de Zabbix 5.4 et exécute les composants Zabbix sur Alpine Linux avec prise en charge de la base de données MySQL.| |`docker-compose_v3_alpine_pgsql_latest.yaml`|Le fichier de composition exécute la dernière version des composants Zabbix 5.4 sur Alpine Linux avec prise en charge de la base de données PostgreSQL.| |`docker-compose_v3_alpine_pgsql_local.yaml`|Le fichier de composition construit localement la dernière version de Zabbix 5.4 et exécute les composants Zabbix sur Alpine Linux avec prise en charge de la base de données PostgreSQL.| |`docker-compose_v3_centos_mysql_latest.yaml`|Le fichier de composition exécute la dernière version des composants Zabbix 5.4 sur CentOS 8 avec prise en charge de la base de données MySQL.| |`docker-compose_v3_centos_mysql_local.yaml`|Le fichier de composition construit localement la dernière version de Zabbix 5.4 et exécute les composants Zabbix sur CentOS 8 avec la prise en charge de la base de données MySQL.| |`docker-compose_v3_centos_pgsql_latest.yaml`|Le fichier de composition exécute la dernière version des composants Zabbix 5.4 sur CentOS 8 avec prise en charge de la base de données PostgreSQL.| |`docker-compose_v3_centos_pgsql_local.yaml`|Le fichier de composition construit localement la dernière version de Zabbix 5.4 et exécute les composants Zabbix sur CentOS 8 avec la prise en charge de la base de données PostgreSQL.| |`docker-compose_v3_ubuntu_mysql_latest.yaml`|Le fichier de composition exécute la dernière version des composants Zabbix 5.4 sur Ubuntu 20.04 avec prise en charge de la base de données MySQL.| |`docker-compose_v3_ubuntu_mysql_local.yaml`|Le fichier de composition construit localement la dernière version de Zabbix 5.4 et exécute les composants Zabbix sur Ubuntu 20.04 avec la prise en charge de la base de données MySQL.| |`docker-compose_v3_ubuntu_pgsql_latest.yaml`|Le fichier de composition exécute la dernière version des composants Zabbix 5.4 sur Ubuntu 20.04 avec prise en charge de la base de données PostgreSQL.| |`docker-compose_v3_ubuntu_pgsql_local.yaml`|Le fichier de composition construit localement la dernière version de Zabbix 5.4 et exécute les composants Zabbix sur Ubuntu 20.04 avec la prise en charge de la base de données PostgreSQL.|  ::: noteimportant Les fichiers Docker Compose disponibles prennent en charge la version 3 de Docker Compose. :::

en-us	#### Docker file sources  Everyone can follow Docker file changes using the Zabbix [official repository](https://github.com/zabbix/zabbix-docker) on [github.com](https://github.com/). You can fork the project or make your own images based on official Docker files.
fr	#### Sources des fichiers Docker  Tout le monde peut suivre les modifications du fichier Docker en utilisant le [dépôt officiel](https://github.com/zabbix/zabbix-docker) de Zabbix sur [github.com](https://github.com/). Vous pouvez faire un fork du projet ou créer vos propres images basées sur les fichiers Docker officiels.

en-us	 ### Docker  |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |docker.container\_info\[<ID>,<info>\]|<|<|<| |Low-level information about a container.|An output of the [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API call serialized as JSON|**ID** - ID or name of the container.<br>**info** - the amount of information returned. Supported values: *short* (default) or *full*.|The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.container\_stats\[<ID>\]|<|<|<| |Container resource usage statistics.|An output of the [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API call and CPU usage percentage serialized as JSON|**ID** - ID or name of the container.| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.containers|<|<|<| |A list of containers.|An output of the [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API call serialized as JSON|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.containers.discovery\[<options>\]|<|<|<| |A list of containers. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object |**options** - specifies whether all or only running containers should be discovered. Supported values:<br>*true* - return all containers;<br>*false* - return only running containers (default).| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.data\_usage|<|<|<| |Information about current data usage.|An output of the [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API call serialized as JSON|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.images|<|<|<| |A list of images.|An output of the [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API call serialized as JSON|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.images.discovery|<|<|<| |A list of images. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object |\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.info|<|<|<| |System information.|An output of the [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API call serialized as JSON|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.ping|<|<|<| |Test if a Docker daemon is alive or not.|1 - connection is alive<br><br>0 - connection is broken|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.|
fr	   ### Docker  |Clé|<|<|<| |--|--|------|------| |**Description**|**Valeur de retour**|**Paramètres**|**Commentaires**| |docker.container\_info \[\<ID\>,\<info\>\]|<|<|<| |Informations de bas niveau sur un conteneur.|Une sortie de l'appel d'API [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) sérialisé au format JSON|**ID** - ID ou nom du conteneur.<br>**info** - la quantité d'informations renvoyées. Valeurs prises en charge : *short* (par défaut) ou *full*.|L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.| |docker.container\_stats \[\<ID\>\]|<|<|<| |Statistiques d'utilisation des ressources du conteneur.|Une sortie de l'appel d'API [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) et du pourcentage d'utilisation du processeur sérialisés en tant que JSON|**ID** - ID ou nom du conteneur| L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.| |docker.containers|<|<|<| |Une liste de conteneurs.|Une sortie de l'appel d'API [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) sérialisée au format JSON|\-| L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.| |docker.containers.discovery\[\<options\>\]|<|<|<| |Une liste de conteneurs. Utilisé pour [découverte de bas niveau](/manual/discovery/low_level_discovery/).|Objet JSON |**options** - spécifie si tous les conteneurs ou uniquement ceux en cours d'exécution doivent être découverts. Valeurs prises en charge :<br>*true* - renvoie tous les conteneurs ;<br>*false* - renvoie uniquement les conteneurs en cours d'exécution (par défaut).| L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.| |docker.data\_usage|<|<|<| |Informations sur l'utilisation actuelle des données.|Une sortie de l'appel d'API [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) sérialisée au format JSON|\-| L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.| |docker.images|<|<|<| |Une liste d'images.|Une sortie de l'appel d'API [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) sérialisée au format JSON|\-| L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.| |docker.images.discovery|<|<|<| |Une liste d'images. Utilisé pour la [découverte de bas niveau](/manual/discovery/low_level_discovery/).|Objet JSON|\-| L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.| |docker.info|<|<|<| |Informations système.||Informations système.|Une sortie de l'appel d'API [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) sérialisée au format JSON|\-| L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.| |docker.ping|<|<|<| |Teste si un démon Docker est actif ou non.|1 - la connexion est active<br><br>0 - la connexion est interrompue|\-| L'utilisateur Agent2 ('zabbix') doit être ajouté au [groupe](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' pour des privilèges suffisants. Sinon, la vérification échouera.|

en-us	### Docker  Zabbix provides [Docker](https://www.docker.com) images for each Zabbix component as portable and self-sufficient containers to speed up deployment and update procedure.  Zabbix components come with MySQL and PostgreSQL database support, Apache2 and Nginx web server support. These images are separated into different images.
fr	### Docker  Zabbix fourni des images [Docker](https://www.docker.com) pour chaque composant Zabbix en tant que conteneurs portables et auto-suffisants pour accélérer le déploiement et mettre à jour la procédure.  Les composants Zabbix sont fournis avec la prise en charge de base de données MySQL et PostgreSQL, le support des serveurs web Apache2 et Nginx. Ces images sont séparées en différentes images.

en-us	# drule.create
fr	# drule.create

en-us	# drule.delete  
fr	# drule.delete  

en-us	# drule.get
fr	# drule.get

en-us	# drule.update
fr	# drule.update

en-us	# dservice.get
fr	# dservice.get

en-us	#### Dynamic widgets  When [configuring](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) some of the widgets:  -   Classic graph -   Graph prototype -   Item value -   Plain text -   URL  there is an extra option called *Dynamic item*. You can check this box to make the widget dynamic - i.e. capable of displaying different content based on the selected host.  Now, when saving the dashboard, you will notice that a new host selection field has appeared atop the dashboard for selecting the host (while the *Select* button allows selecting the host group in a popup):  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dynamic_selection.png)  Thus you have a widget, which can display content that is based on the data from the host that is selected. The benefit of this is that you do not need to create extra widgets just because, for example, you want to see the same graphs containing data from various hosts.
fr	 #### Widgets dynamiques  Lors de la [configuration](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) de certains widgets   -   Graphique classique -   Prototype de graphique -   Valeur d'élément -   Texte brut -   URL  il existe une option supplémentaire appelée *Elément dynamique*. Vous pouvez cocher cette case pour rendre le widget dynamique - c'est-à-dire capable d'afficher un contenu différent en fonction de l'hôte sélectionné.  Désormais, lors de l'enregistrement du tableau de bord, vous remarquerez qu'un nouveau champ de sélection d'hôte est apparu en haut du tableau de bord pour sélectionner l'hôte (tandis que le bouton *Sélectionner* permet de sélectionner le groupe d'hôtes dans une fenêtre contextuelle) :  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dynamic_selection.png)  Ainsi, vous avez un widget, qui peut afficher du contenu basé sur les données de l'hôte sélectionné. L'avantage de ceci est que vous n'avez pas besoin de créer des widgets supplémentaires simplement parce que, par exemple, vous voulez voir les mêmes graphiques contenant des données provenant de différents hôtes.

en-us	#### Easy Connect  Easy Connect uses the following parameters to connect to the database:  -   *Host* - the host name or IP address of the database server computer     (DBHost parameter in the configuration file). -   *Port* - the listening port on the database server (DBPort parameter     in the configuration file; if not set the default 1521 port will be     used). -   <service\_name> - the service name of the database you want to     access (DBName parameter in the configuration file).  **Example:**  Database parameters set in the server or proxy configuration file (zabbix\_server.conf and zabbix\_proxy.conf):      DBHost=localhost     DBPort=1521     DBUser=myusername     DBName=ORCL     DBPassword=mypassword  Connection string used by Zabbix to establish connection:      DBUser/DBPassword@DBHost:DBPort/DBName  During Zabbix frontend installation, set the corresponding parameters in the *Configure DB connection* step of the setup wizard:  -   Database host: localhost -   Database port: 1521 -   Database name: ORCL -   User: myusername -   Password: mypassword  ![](../../../../assets/en/manual/appendix/install/oracle_easy_connect.png){width="600"}  Alternatively, these parameters can be set in the frontend configuration file (zabbix.conf.php):      $DB["TYPE"]                     = 'ORACLE';     $DB["SERVER"]                   = 'localhost';     $DB["PORT"]             = '1521';     $DB["DATABASE"]                 = 'ORCL';     $DB["USER"]                     = 'myusername';     $DB["PASSWORD"]                 = 'mypassword';
fr	 #### Easy Connect  Easy Connect utilise les paramètres suivants pour se connecter à la base de données :  -   *Host* - le nom d'hôte ou l'adresse IP du serveur de la base de données (paramètre DBHost dans le fichier de configuration). -   *Port* - le port d'écoute sur le serveur de base de données (paramètre DBPort dans le fichier de configuration ; s'il n'est pas défini, le port 1521 sera utilisé par défaut). -   <service\_name> - le nom de service de la base de données à laquelle vous souhaitez accéder (paramètre DBName dans le fichier de configuration).  **Exemple:**  Paramètres de base de données définis dans le fichier de configuration du serveur ou du proxy (zabbix\_server.conf et zabbix\_proxy.conf):      DBHost=localhost     DBPort=1521     DBUser=myusername     DBName=ORCL     DBPassword=mypassword  Chaîne de connexion utilisée par Zabbix pour établir la connexion :      DBUser/DBPassword@DBHost:DBPort/DBName  Lors de l'installation de l'interface Zabbix, définissez les paramètres correspondants à l'étape *Configurer la connexion à la base de données* de l'assistant d'installation :  -   Database host: localhost -   Database port: 1521 -   Database name: ORCL -   User: myusername -   Password: mypassword  ![](../../../../assets/en/manual/appendix/install/oracle_easy_connect.png){width="600"}  Alternativement, ces paramètres peuvent être définis dans le fichier de configuration frontal (zabbix.conf.php):      $DB["TYPE"]                     = 'ORACLE';     $DB["SERVER"]                   = 'localhost';     $DB["PORT"]             = '1521';     $DB["DATABASE"]                 = 'ORCL';     $DB["USER"]                     = 'myusername';     $DB["PASSWORD"]                 = 'mypassword';

en-us	##### Editing linked entities  If you try to edit an item or trigger that was linked from the template, you may realize that many key options are disabled for editing. This makes sense as the idea of templates is that things are edited in one-touch manner on the template level. However, you still can, for example, enable/disable an item on the individual host and set the update interval, history length and some other parameters.  ::: noteimportant Any customizations to the entities implemented on a template-level will override the previous customizations of the entities on a host-level. :::  If you want to edit the entity fully, you have to edit it on the template level (template level shortcut is displayed in the form name), keeping in mind that these changes will affect all hosts that have this template linked to them.
fr	##### Modification des entités liées  Si vous essayez de modifier un élément ou un déclencheur lié à partir du modèle, vous vous rendrez peut-être compte que de nombreuses options clés sont désactivées pour la modification. Cela a du sens car l'idée des modèles est que les choses sont modifiées en une seule fois au niveau du modèle. Cependant, vous pouvez toujours, par exemple, activer/désactiver un élément sur l'hôte individuel et définir l'intervalle de mise à jour, la durée de l'historique et certains autres paramètres.  ::: noteimportant Toute personnalisation des entités implémentée au niveau du modèle remplacera les personnalisations précédentes des entités au niveau de l'hôte. :::  Si vous souhaitez modifier entièrement l'entité, vous devez la modifier au niveau du modèle (le raccourci au niveau du modèle est affiché dans le nom du formulaire), en gardant à l'esprit que ces modifications affecteront tous les hôtes auxquels ce modèle est lié.

en-us	### Editing services  Click on the *Edit* button to access the edit mode. When in edit mode, the listing  is complemented with checkboxes before the entries and also these additional options:  -   ![](../../../../../assets/en/manual/web_interface/add_service.png) -     add a child service to this service -   ![](../../../../../assets/en/manual/web_interface/edit_service.png) -     edit this service -   ![](../../../../../assets/en/manual/web_interface/delete_service.png) -     delete this service  ![](../../../../../assets/en/manual/web_interface/services_edit.png){width="600"}  To [configure](/manual/it_services/service) a new service, click on the *Create service* button in the top right-hand corner.
fr	### Edition des services  Cliquez sur le bouton *Modifier* pour accéder au mode édition. En mode édition, la liste est complétée par des cases à cocher avant les entrées et également ces options supplémentaires :  -   ![](../../../../../assets/en/manual/web_interface/add_service.png) -     ajouter un service enfant à ce service -   ![](../../../../../assets/en/manual/web_interface/edit_service.png) -     modifier ce service -   ![](../../../../../assets/en/manual/web_interface/delete_service.png) -     supprimer ce service  ![](../../../../../assets/en/manual/web_interface/services_edit.png){width="600"}  Pour [configurer](/manual/it_services/service) un nouveau service, cliquez sur le bouton *Créer un service* dans le coin supérieur droit.

en-us	### Editing services  Click on the *Edit* button to access the edit mode. When in edit mode, the listing  is complemented with checkboxes before the entries and also these additional options:  -   ![](../../../../../assets/en/manual/web_interface/add_service.png) -     add a child service to this service -   ![](../../../../../assets/en/manual/web_interface/edit_service.png) -     edit this service -   ![](../../../../../assets/en/manual/web_interface/delete_service.png) -     delete this service  ![](../../../../../assets/en/manual/web_interface/services_edit.png){width="600"}  To [configure](#service_configuration) a new service, click on the *Create service* button in the top right-hand corner.  Two buttons below the list offer some mass-editing options:  -   *Mass update* - mass update service properties -   *Delete* - delete the services  To use these options, mark the checkboxes before the respective services, then click on the required button.
fr	 ### Édition des services  Cliquez sur le bouton *Modifier* pour accéder au mode édition. En mode édition, la liste est complétée par des cases à cocher avant les entrées et également ces options supplémentaires :  -   ![](../../../../../assets/en/manual/web_interface/add_service.png) -     ajouter un service enfant à ce service -   ![](../../../../../assets/en/manual/web_interface/edit_service.png) -     modifier ce service -   ![](../../../../../assets/en/manual/web_interface/delete_service.png) -     supprimer ce service  ![](../../../../../assets/en/manual/web_interface/services_edit.png){width="600"}  Pour [configurer](#service_configuration) un nouveau service, cliquez sur le bouton *Créer un service* en haut à droite.  Deux boutons sous la liste offrent des options d'édition en masse : -   *Mise à jour en masse* - mise à jour en masse des propriétés du service  -   *Supprimer* - supprimer les services  Pour utiliser ces options, cochez les cases devant les services respectifs, puis cliquez sur le bouton requis.

en-us	#### Element tags  Element tag values are explained in the table below.
fr	#### Tags d'éléments  Les valeurs de tag d'éléments sont expliquées dans le tableau ci-dessous.

en-us	#### Enabling a host  Enable host monitoring, i.e. set its status to 0.  Request:  ```json {     "jsonrpc": "2.0",     "method": "host.update",     "params": {         "hostid": "10126",         "status": 0     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10126"         ]     },     "id": 1 } ```
fr	#### Activation d'un hôte  Activez la surveillance de l'hôte, c'est-à-dire définissez son statut sur 0.  Requête :  ```json {     "jsonrpc": "2.0",     "method": "host.update",     "params": {         "hostid": "10126",         "status": 0     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10126"         ]     },     "id": 1 } ```

en-us	#### Enabling a media type  Enable a media type, that is, set its status to "0".  Request:  ```json {     "jsonrpc": "2.0",     "method": "mediatype.update",     "params": {         "mediatypeid": "6",         "status": "0"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "6"         ]     },     "id": 1 } ```
fr	#### Activation d'un type de média  Activez un type de média, c'est-à-dire définissez son état sur "0".  Requête :  ```json {     "jsonrpc": "2.0",     "method": "mediatype.update",     "params": {         "mediatypeid": "6",         "status": "0"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "6"         ]     },     "id": 1 } ```

en-us	#### Enabling an item  Enable an item, that is, set its status to "0".  Request:  ```json {     "jsonrpc": "2.0",     "method": "item.update",     "params": {         "itemid": "10092",         "status": 0     },     "auth": "700ca65537074ec963db7efabda78259",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "10092"         ]     },     "id": 1 } ```
fr	#### Activation d'un élément  Activez un élément, c'est-à-dire définissez son état sur "0".  Requête :  ```json {     "jsonrpc": "2.0",     "method": "item.update",     "params": {         "itemid": "10092",         "status": 0     },     "auth": "700ca65537074ec963db7efabda78259",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "10092"         ]     },     "id": 1 } ```

en-us	#### Enabling a trigger  Enable a trigger, that is, set its status to 0.  Request:  ```json {     "jsonrpc": "2.0",     "method": "trigger.update",     "params": {         "triggerid": "13938",         "status": 0     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "13938"         ]     },     "id": 1 } ```
fr	#### Activer un déclencheur  Activer un déclencheur, c’est-à-dire définir son statut à 0.  Requête :  ```json {  "jsonrpc": "2.0",  "method": "trigger.update",  "params": {  "triggerid": "13938",  "status": 0  },  "auth": "038e1d7b1735c6a5436ee9eae095879e",  "id": 1 } ```  Réponse :  ```json {  "jsonrpc": "2.0",  "result": {  "triggerids": [  "13938"  ]  },  "id": 1 } ```

en-us	#### Enabling a trigger prototype  Enable a trigger prototype, that is, set its status to 0.  Request:  ```json {     "jsonrpc": "2.0",     "method": "triggerprototype.update",     "params": {         "triggerid": "13938",         "status": 0     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "13938"         ]     },     "id": 1 } ```
fr	#### Activation d'un prototype de déclencheur  Activer un prototype de déclencheur, c’est-à-dire définir son statut à 0.  Requête :  ```json {     "jsonrpc": "2.0",     "method": "triggerprototype.update",     "params": {         "triggerid": "13938",         "status": 0     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "13938"         ]     },     "id": 1 } ```

en-us	#### Enabling a web scenario  Enable a web scenario, that is, set its status to "0".  Request:  ```json {     "jsonrpc": "2.0",     "method": "httptest.update",     "params": {         "httptestid": "5",         "status": 0     },     "auth": "700ca65537074ec963db7efabda78259",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "httptestids": [             "5"         ]     },     "id": 1 } ```
fr	#### Activer un scénario Web  Activer un scénario Web, c’est-à-dire définir son statut à "0".  Requête :  ```json {     "jsonrpc": "2.0",     "method": "httptest.update",     "params": {         "httptestid": "5",         "status": 0     },     "auth": "700ca65537074ec963db7efabda78259",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "httptestids": [             "5"         ]     },     "id": 1 } ```

en-us	### Enabling high availability
fr	### Activation du cluster HA

en-us	#### Enabling MIB files  On RedHat-based systems the mib files should be enabled by default. On Debian-based systems you have to edit file `/etc/snmp/snmp.conf` and comment out the line that says `mibs :`      # As the snmp packages come without MIB files due to license reasons, loading     # of MIBs is disabled by default. If you added the MIBs you can re-enable     # loading them by commenting out the following line.     #mibs :
fr	#### Activation fichiers MIB  Sur les systèmes basés sur RedHat les fichiers mib doivent être activés par défaut. Sur les systèmes basés sur Debian, vous devez éditer le fichier `/etc/snmp/snmp.conf` et décommenter la ligne qui dit `mibs :`      # As the snmp packages come without fichiers MIB due to license reasons, loading     # of MIBs is disabled by default. If you added the MIBs you can reenable     # loading them by commenting out the following line.     #mibs :

en-us	#### Enabling multiple hosts  Enable monitoring of two hosts, i.e., set their status to 0.  Request:  ```json {     "jsonrpc": "2.0",     "method": "host.massupdate",     "params": {         "hosts": [             {                 "hostid": "69665"             },             {                 "hostid": "69666"             }         ],         "status": 0     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "69665",             "69666"         ]     },     "id": 1 } ```
fr	#### Activation de plusieurs hôtes  Activer la surveillance de deux hôtes, c’est-à-dire, définir leur statut à 0.  Requête :  ```json {     "jsonrpc": "2.0",     "method": "host.massupdate",     "params": {         "hosts": [             {                 "hostid": "69665"             },             {                 "hostid": "69666"             }         ],         "status": 0     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Réponse :  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "69665",             "69666"         ]     },     "id": 1 } ```

en-us	#### Encoding settings  To make sure that the acquired data are not corrupted you may specify the correct encoding for processing the check (e.g. 'vfs.file.contents') in the `encoding` parameter. The list of supported encodings (code page identifiers) may be found in documentation for [libiconv](http://www.gnu.org/software/libiconv/) (GNU Project) or in Microsoft Windows SDK documentation for "Code Page Identifiers".  If no encoding is specified in the `encoding` parameter the following resolution strategies are applied:  -   If encoding is not specified (or is an empty string) it is assumed to be UTF-8, the data is processed "as-is"; -   BOM analysis - applicable for items 'vfs.file.contents',     'vfs.file.regexp', 'vfs.file.regmatch'. An attempt is made to     determine the correct encoding by using the byte order mark (BOM) at     the beginning of the file. If BOM is not present - standard     resolution (see above) is applied instead.
fr	#### Paramètres d'encodage  Pour vous assurer que les données acquises ne sont pas corrompues, vous pouvez spécifier l'encodage correct pour le traitement de la vérification (par exemple, 'vfs.file.contents') dans le paramètre `encoding`. La liste des encodages pris en charge (identifiants de page de code) peut être trouvée dans la documentation de [libiconv](http://www.gnu.org/software/libiconv/) (Projet GNU) ou dans la documentation du SDK Microsoft Windows pour "Code Page Identifiers ".  Si aucun encodage n'est spécifié dans le paramètre "encoding", les stratégies de résolution suivantes sont appliquées :  - Si l'encodage n'est pas spécifié (ou s'il s'agit d'une chaîne vide), il est supposé être UTF-8, les données sont traitées "telles quelles" ; - Analyse BOM - applicable pour les éléments 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. Une tentative est faite pour déterminer le codage correct en utilisant la marque d'ordre d'octet (BOM) au début du fichier. Si la nomenclature n'est pas présente, la résolution standard (voir ci-dessus) est appliquée à la place.

en-us	##### Encryption  The **Encryption** tab allows you to require [encrypted](/manual/encryption) connections with the host.  |Parameter|Description| |--|--------| |*Connections to host*|How Zabbix server or proxy connects to Zabbix agent on a host: no encryption (default), using PSK (pre-shared key) or certificate.| |*Connections from host*|Select what type of connections are allowed from the host (i.e. from Zabbix agent and Zabbix sender). Several connection types can be selected at the same time (useful for testing and switching to other connection type). Default is "No encryption".| |*Issuer*|Allowed issuer of certificate. Certificate is first validated with CA (certificate authority). If it is valid, signed by the CA, then the *Issuer* field can be used to further restrict allowed CA. This field is intended to be used if your Zabbix installation uses certificates from multiple CAs. If this field is empty then any CA is accepted.| |*Subject*|Allowed subject of certificate. Certificate is first validated with CA. If it is valid, signed by the CA, then the *Subject* field can be used to allow only one value of *Subject* string. If this field is empty then any valid certificate signed by the configured CA is accepted.| |*PSK identity*|Pre-shared key identity string.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |*PSK*|Pre-shared key (hex-string). Maximum length: 512 hex-digits (256-byte PSK) if Zabbix uses GnuTLS or OpenSSL library, 64 hex-digits (32-byte PSK) if Zabbix uses mbed TLS (PolarSSL) library. Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952|
fr	##### Chiffrement  L'onglet **Chiffrement** vous permet d'exiger des connexions [cryptées](/manual/encryption) avec l'hôte.  |Paramètre|Description| |--|--------| |*Connexions à l'hôte*|Comment le serveur ou le proxy Zabbix se connecte à l'agent Zabbix sur un hôte : pas de cryptage (par défaut), en utilisant PSK (clé pré-partagée) ou un certificat.| |*Connexions depuis l'hôte*|Sélectionnez le type de connexions autorisées depuis l'hôte (c'est-à-dire depuis l'agent Zabbix et le sender Zabbix). Plusieurs types de connexion peuvent être sélectionnés en même temps (utile pour tester et passer à un autre type de connexion). La valeur par défaut est "Aucun cryptage".| |*Émetteur*|Émetteur autorisé du certificat. Le certificat est d'abord validé auprès de l'AC (autorité de certification). S'il est valide, signé par l'AC, le champ *Émetteur* peut être utilisé pour restreindre davantage l'AC autorisée. Ce champ est destiné à être utilisé si votre installation Zabbix utilise des certificats de plusieurs autorités de certification. Si ce champ est vide, toute autorité de certification est acceptée.| |*Sujet*|Sujet autorisé du certificat. Le certificat est d'abord validé avec CA. S'il est valide, signé par l'autorité de certification, le champ *Sujet* peut être utilisé pour n'autoriser qu'une seule valeur de chaîne *Sujet*. Si ce champ est vide, tout certificat valide signé par l'autorité de certification configurée est accepté.| |*Identité PSK*|Chaîne d'identité de clé pré-partagée.<br>Ne mettez pas d'informations sensibles dans l'identité PSK, elle est transmise sans chiffrement sur le réseau pour informer un récepteur quel PSK utiliser.| |*PSK*|Clé pré-partagée (chaîne hexadécimale). Longueur maximale : 512 chiffres hexadécimaux (PSK de 256 octets) si Zabbix utilise la bibliothèque GnuTLS ou OpenSSL, 64 chiffres hexadécimaux (PSK de 32 octets) si Zabbix utilise la bibliothèque mbed TLS (PolarSSL). Exemple : 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952|

en-us	##### Entity uniqueness criteria  When adding entities (items, triggers, graphs etc.) from a template it is important to know what of those entities already exist on the host and need to be updated and what entities differ. The uniqueness criteria for deciding upon the sameness/difference are:  -   for items - the item key -   for triggers - trigger name and expression -   for custom graphs - graph name and its items
fr	##### Critère d'unicité de l'entité  Lors de l'ajout d'entités (éléments, déclencheurs, graphiques, etc.) à partir d'un modèle, il est important de savoir quelles entités existent déjà sur l'hôte et doivent être mises à jour, ainsi que les entités qui diffèrent. Les critères d’unicité pour décider de la similitude/différence sont les suivants :  -   pour les éléments - la clé de l'élément -   pour les déclencheurs - nom et expression du déclencheur -   pour les graphiques personnalisés - nom du graphique et ses éléments

en-us	#### Environment files  In the same directory with compose files on github.com you can find files with default environment variables for each component in compose file. These environment files are named like `.env_<type of component>`.
fr	#### Fichiers d'environnement  Dans le même répertoire avec les fichiers compose sur github.com, vous pouvez trouver des fichiers avec des variables d'environnement par défaut pour chaque composant dans le fichier compose. Ces fichiers d'environnement sont nommés comme ceci :`.env_<type de composant>`.

en-us	#### Error handling  Up to that point everything we've tried has worked fine. But what happens if we try to make an incorrect call to the API? Let's try to create another host by calling [host.create](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter.  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Linux server",         "interfaces": [             {                 "type": 1,                 "main": 1,                 "useip": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050"             }         ]     },     "id": 7,     "auth": "0424bd59b807674191e7d77572075f33" } ```  The response will then contain an error message:  ```json {     "jsonrpc": "2.0",     "error": {         "code": -32602,         "message": "Invalid params.",         "data": "No groups for host \"Linux server\"."     },     "id": 7 } ```  If an error occurred, instead of the `result` property, the response object will contain an `error` property with the following data:  -   `code` - an error code; -   `message` - a short error summary; -   `data` - a more detailed error message.  Errors can occur in different cases, such as, using incorrect input values, a session timeout or trying to access unexisting objects. Your application should be able to gracefully handle these kinds of errors.
fr	#### Gestion des erreurs  Jusque là, tout ce que nous avons essayé a bien fonctionné. Mais que se passe-t-il si nous essayons de faire un appel incorrect à l'API ? Essayons de créer un autre hôte en appelant la méthode [host.create](/manual/api/reference/host/create) mais en omettant le paramètre obligatoire `groups`.  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Linux server",         "interfaces": [             {                 "type": 1,                 "main": 1,                 "useip": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050"             }         ]     },     "id": 7,     "auth": "0424bd59b807674191e7d77572075f33" } ```  La réponse contiendra alors un message d'erreur :  ```json {     "jsonrpc": "2.0",     "error": {         "code": -32602,         "message": "Invalid params.",         "data": "No groups for host \"Linux server\"."     },     "id": 7 } ```  Si une erreur survient, au lieu de la propriété `result`, l'objet de réponse contiendra une propriété `error` avec les données suivantes :  -   `code` - un code d'erreur ; -   `message` - un résumé succinct de l'erreur ; -   `data` - un message d'erreur plus détaillé.  Des erreurs peuvent survenir dans différents cas, tels que l'utilisation de valeurs d'entrée incorrectes, l'expiration du délai d'une session ou la tentative d'accès à des objets non existants. Votre application doit pouvoir gérer ce type d’erreurs.

en-us	#### Error messages  ODBC error messages are structured into fields to provide detailed information. For example:      Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query]     └───────────┬───────────┘  └────┬────┘ └──┬──┘└┬┘└─────────────────────────────┬─────────────────────────────────────┘                 │                   │         │    └─ Native error code            └─ Native error message                 │                   │         └─ SQLState                 └─ Zabbix message   └─ ODBC return code  Note that the error message length is limited to 2048 bytes, so the message can be truncated. If there is more than one ODBC diagnostic record Zabbix tries to concatenate them (separated with `|`) as far as the length limit allows.
fr	#### Messages d'erreur  Les messages d'erreur ODBC sont structurés en champs pour fournir des informations détaillées. Par exemple:      Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query]     └───────────┬───────────┘  └────┬────┘ └──┬──┘└┬┘└─────────────────────────────┬─────────────────────────────────────┘                 │                   │         │    └─ Native error code            └─ Native error message                 │                   │         └─ SQLState                 └─ Zabbix message   └─ ODBC return code  Notez que la longueur du message d'erreur est limitée à 2048 octets, le message peut donc être tronqué. S'il existe plusieurs enregistrements de diagnostic ODBC, Zabbix essaie de les concaténer (séparés par `|`) dans la mesure où la limite de longueur le permet.

en-us	#### Escalation examples
fr	#### Exemples d'escalade

en-us	#### Evaluation period  An evaluation period is used in functions referencing the item history. It allows to specify the interval we are interested in. It can be specified as time period (30s, 10m, 1h) or as a value range (\#5 - for five latest values).  The evaluation period is measured up to "now" - where "now" is the latest recalculation time of the trigger (see [Calculation time](#calculation_time) above); "now" is not the "now" time of the server.  The evaluation period specifies either:  -   To consider all values between "now-time period" and "now" (or, with     time shift, between "now-time shift-time period" and     "now-time\_shift") -   To consider no more than the num count of values from the past, up     to "now"     -   If there are 0 available values for the time period or num count         specified - then the trigger or calculated item that uses this         function becomes unsupported  Note that:  -   If only a single function (referencing data history) is used in the     trigger, "now" is always the latest received value. For example, if     the last value was received an hour ago, the evaluation period will     be regarded as up to the latest value an hour ago. -   A new trigger is calculated as soon as the first value is received     (history functions); it will be calculated within 30 seconds for     time-based functions. Thus the trigger will be calculated even     though perhaps the set evaluation period (for example, one hour) has     not yet passed since the trigger was created. The trigger will also     be calculated after the first value, even though the evaluation     range was set, for example, to ten latest values.
fr	 #### Période d'évaluation  Une période d'évaluation est utilisée dans les fonctions faisant référence à l'historique de l'élément. Il permet de spécifier l'intervalle qui nous intéresse. Il peut être spécifié comme une période de temps (30s, 10m, 1h) ou comme une plage de valeurs (\#5 - pour les cinq dernières valeurs).  La période d'évaluation est mesurée jusqu'à "maintenant" - où "maintenant" est la dernière heure de recalcul du déclencheur (voir [Temps de Calcul](#calculation_time) ci-dessus) ; "maintenant" n'est pas l'heure "actuelle" du serveur.  La période d'évaluation précise soit :  -   Pour considérer toutes les valeurs entre "maintenant-période de temps" et "maintenant" (ou, avec décalage temporel, entre "maintenant-décalage dans le temps-période de temps" et "maintenant-décalage dans le temps") -   Ne pas considérer plus que le nombre de valeurs du passé, jusqu'à "maintenant"     -   S'il n'y a aucune valeur disponible pour la période ou le nombre spécifié, le déclencheur ou l'élément calculé qui utilise cette fonction n'est plus pris en charge  Notez que:  -   Si une seule fonction (référençant l'historique des données) est utilisée dans le déclencheur, "maintenant" est toujours la dernière valeur reçue. Par exemple, si la dernière valeur a été reçue il y a une heure, la période d'évaluation sera considérée comme allant jusqu'à la dernière valeur il y a une heure. -   Un nouveau déclencheur est calculé dès réception de la première valeur (fonctions d'historique) ; il sera calculé dans les 30 secondes pour les fonctions basées sur le temps. Ainsi, le déclencheur sera calculé même si la période d'évaluation définie (par exemple, une heure) ne s'est pas encore écoulée depuis la création du déclencheur. Le déclencheur sera également calculé après la première valeur, même si la plage d'évaluation a été définie, par exemple, sur les dix dernières valeurs.

en-us	# event.acknowledge
fr	# event.acknowledge

en-us	#### Event correlation  Create custom event correlation rules.  [Correlation API](/manual/api/reference/correlation)  
fr	#### Corrélation d'événements  Créez des règles de corrélation d'événements personnalisées.  [API Correlation](/manual/api/reference/correlation)  

en-us	##### Event correlation  Event correlation (also called global event correlation) is a way to set up custom event closing (resulting in OK event generation) rules.  The rules define how the new problem events are paired with existing problem events and allow to close the new event or the matched events by generating corresponding OK events.  However, event correlation must be configured very carefully, as it can negatively affect event processing performance or, if misconfigured, close more events than intended (in the worst case even all problem events could be closed). A few configuration tips:  1.  always reduce the correlation scope by setting a unique tag for the     control event (the event that is paired with old events) and use the     'new event tag' correlation condition 2.  don't forget to add a condition based on the old event when using     'close old event' operation, or all existing problems could be     closed 3.  avoid using common tag names used by different correlation     configurations
fr	##### Corrélation d'événements  La corrélation d'événements (également appelée corrélation d'événements globale) permet de configurer des règles personnalisées de fermeture d'événement (entraînant la création d'événements OK).  Les règles définissent la manière dont les nouveaux événements problèmes sont associés à des événements problèmes existants et permettent de fermer le nouvel événement ou les événements correspondants en générant des événements OK correspondants.  Cependant, la corrélation d'événements doit être configurée très soigneusement, car elle peut affecter négativement les performances de traitement des événements ou, si elle est mal configurée, fermer plus d'événements que prévu (dans le pire des cas, tous les problèmes peuvent être fermés). Quelques conseils de configuration :  1.  toujours réduire la portée de la corrélation en définissant un tag unique pour la vérification de l'événement (l'événement associé à des événements anciens) et en utilisant la condition de corrélation 'nouveau tag d'événement' 2.  ne pas oublier d'ajouter une condition basée sur l'ancien événement lors de l'utilisation de l'opération 'fermer l'ancien événement', ou tous les problèmes existants pourraient être fermés 3.  évitez d'utiliser des noms de tag identiques utilisés par différentes configurations de corrélation

en-us	# event.get
fr	# event.get

en-us	#### Event menu  Clicking on the problem name brings up the event menu:  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/event_menu.png)  The event menu allows to:  -   filter the problems of the trigger -   access the trigger configuration -   access a simple graph/item history of the underlying item(s) -   access an external ticket of the problem (if configured, see the     *Include event menu entry* option when configuring     [webhooks](/manual/config/notifications/media/webhook)) -   execute global     [scripts](/manual/web_interface/frontend_sections/administration/scripts)     (these scripts need to have their scope defined as 'Manual event     action'). This feature may be handy for running scripts used for     managing problem tickets in external systems.
fr	#### Menu de l'événement  Cliquer sur le nom du problème fait apparaître le menu des événements :  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/event_menu.png)  Le menu événement permet de :  -   filtrer les problèmes du déclencheur -   accéder à la configuration du déclencheur -   accéder à un simple graphique/historique des éléments du ou des éléments sous-jacents -   accéder à un ticket externe du problème (si configuré, voir l'option *Inclure l'entrée du menu de l'événement* lors de la configuration des [webhooks](/manual/config/notifications/media/webhook)) -   executer des [scripts globaux](/manual/web_interface/frontend_sections/administration/scripts) (ces scripts doivent avoir leur portée définie comme 'Action manuelle d'événemen'). Cette fonctionnalité peut être pratique pour exécuter des scripts utilisés pour gérer les tickets de problème dans des systèmes externes.

en-us	# > Event object  The following objects are directly related to the `event` API.
fr	# > Objet Événement  Les objets suivants sont directement liés à l'API `event`.

en-us	#### Events  Retrieve events generated by triggers, network discovery and other Zabbix systems for more flexible situation management or third-party tool integration.  [Event API](/manual/api/reference/event)  
fr	#### Evénements  Récupérez les événements générés par les déclencheurs, la découverte du réseau et les autres systèmes Zabbix pour une gestion plus flexible des situations ou une intégration à des outils tiers.  [API Evénement](/manual/api/reference/event)  

en-us	### Event tag  The event tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.|
fr	### Tag d'événement  L'objet tag d'événement a les propriétés suivantes.  |Propriété|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Nom du tag d'événement.| |valeur|chaîne|Valeur du tag d'événement.|

en-us	# Event  This class is designed to work with events.  Object references:\  -   [Event](/manual/api/reference/event/object#host)  Available methods:\  -   [event.get](/manual/api/reference/event/get) - retrieving events -   [event.acknowledge](/manual/api/reference/event/acknowledge) -     acknowledging events  
fr	# Evénement  Cette classe est conçue pour travailler avec les événements.  Référentiel des objets :\  -   [Événement](/manual/api/reference/event/object#host)  Méthodes disponibles :\  -   [event.get](/manual/api/reference/event/get) - récupérer des événements -   [event.acknowledge](/manual/api/reference/event/acknowledge) - acquitter des événements  

en-us	### Example
fr	### Exemple

en-us	##### Example 11  Check if client local time is in sync with Zabbix server time.  Use of function fuzzytime():      fuzzytime(/MySQL_DB/system.localtime,10s)=0  The trigger will change to the problem state in case when local time on server MySQL\_DB and Zabbix server differs by more than 10 seconds. Note that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive_checks).
fr	##### Exemple 11  Vérifiez si l'heure locale du client est synchronisée avec l'heure du serveur Zabbix.  Utilisation de la fonction fuzzytime() :      fuzzytime(/MySQL_DB/system.localtime,10s)=0  Le déclencheur passera à l'état problème si l'heure locale sur le serveur MySQL\_DB et le serveur Zabbix diffère de plus de 10 secondes. Notez que 'system.localtime' doit être configuré en tant que [contrôle passif](/manual/appendix/items/activepassive#passive_checks).

en-us	##### Example 13  Using the value of another item to get a trigger threshold:      last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1  The trigger will fire if the free storage drops below 10 percent.
fr	##### Exemple 13  Utiliser la valeur d'un autre élément pour obtenir un seuil de déclenchement :      last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1  Le déclencheur se déclenchera si l'espace libre tombe en dessous de 10 %.

en-us	##### Example 15  Comparing string values of two items - operands here are functions that return strings.  Problem: create an alert if Ubuntu version is different on different hosts      last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release])
fr	##### Exemple 15  Comparaison des valeurs de chaîne de deux éléments - les opérandes sont ici des fonctions qui renvoient des chaînes.  Problème : créer une alerte si la version d'Ubuntu est différente sur différents hôtes      last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release])

en-us	##### Example 16  Comparing two string values - operands are:  -   a function that returns a string -   a combination of macros and strings  Problem: detect changes in the DNS query  The item key is:      net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1]  with macros defined as      {$WEBSITE_NAME} = example.com     {$DNS_RESOURCE_RECORD_TYPE} = MX  and normally returns:      example.com           MX       0 mail.example.com  So our trigger expression to detect if the DNS query result deviated from the expected result is:      last(/Zabbix server/net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1])<>"{$WEBSITE_NAME}           {$DNS_RESOURCE_RECORD_TYPE}       0 mail.{$WEBSITE_NAME}"  Notice the quotes around the second operand.
fr	##### Exemple 16  Comparaison de deux valeurs de chaîne - les opérandes sont :  - une fonction qui renvoie une chaîne - une combinaison de macros et de chaînes  Problème : détecter les changements dans la requête DNS  La clé de l'élément est :      net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1]  avec des macros définies comme      {$WEBSITE_NAME} = example.com     {$DNS_RESOURCE_RECORD_TYPE} = MX  et renvoie normalement :      example.com           MX       0 mail.example.com  Donc, notre expression de déclenchement pour détecter si le résultat de la requête DNS s'écarte du résultat attendu est :      last(/Zabbix server/net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1])<>"{$WEBSITE_NAME}           {$DNS_RESOURCE_RECORD_TYPE}       0 mail.{$WEBSITE_NAME}"  Remarquez les guillemets autour du deuxième opérande.

en-us	##### Example 17  Comparing two string values - operands are:  -   a function that returns a string -   a string constant with special characters \\ and "  Problem: detect if the `/tmp/hello` file content is equal to:      \" //hello ?\"  Option 1) write the string directly      last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hello ?\\\""  Notice how \\ and " characters are escaped when the string gets compared directly.  Option 2) use a macro      {$HELLO_MACRO} = \" //hello ?\"  in the expression:      last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO}
fr	##### Exemple 17  Comparaison de deux valeurs de chaîne - les opérandes sont :  - une fonction qui renvoie une chaîne - une chaîne constante avec des caractères spéciaux \\ et "  Problème : détecter si le contenu du fichier `/tmp/hello` est égal à :      \" //hello ?\"  Option 1) écrire la chaîne directement      last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hello ?\\\""  Remarquez comment les caractères \\ et " sont échappés lorsque la chaîne est comparée directement.  Option 2) utiliser une macro      {$HELLO_MACRO} = \" //hello ?\"  dans l'expression :      last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO}

en-us	##### Example 18  Comparing long-term periods.  Problem: Load of Exchange server increased by more than 10% last month      trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M)  You may also use the [Event name](/manual/config/triggers/trigger#configuration) field in trigger configuration to build a meaningful alert message, for example to receive something like  `"Load of Exchange server increased by 24% in July (0.69) comparing to June (0.56)"`  the event name must be defined as:      Load of {HOST.HOST} server increased by {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(0)}% in {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)}) comparing to {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)})  It is also useful to allow manual closing in trigger configuration for this kind of problem.
fr	##### Exemple 18  Comparer de longues périodes de temps.  Problème : la charge du serveur Exchange a augmenté de plus de 10 % le mois dernier      trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M)  Vous pouvez également utiliser le champ [Nom de l'événement](/manual/config/triggers/trigger#configuration) dans la configuration du déclencheur pour créer un message d'alerte significatif, par exemple pour recevoir quelque chose comme  `"Load of Exchange server increased by 24% in July (0.69) comparing to June (0.56)"`  le nom de l'événement doit être défini comme :      Load of {HOST.HOST} server increased by {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(0)}% in {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)}) comparing to {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)})  Il est également utile d'autoriser la fermeture manuelle dans la configuration du déclencheur pour ce type de problème.

en-us	##### Example 1  Calculating percentage of free disk space on '/'.  Use of function **last**:      100*last(//vfs.fs.size[/,free])/last(//vfs.fs.size[/,total])  Zabbix will take the latest values for free and total disk spaces and calculate percentage according to the given formula.
fr	##### Exemple 1  Calcul du pourcentage d'espace disque libre sur '/'.  Utilisation de la fonction **last**:      100*last(//vfs.fs.size[/,free])/last(//vfs.fs.size[/,total])  Zabbix prendra les dernières valeurs pour les espaces disque libres et totaux et calculera le pourcentage selon la formule donnée.

en-us	##### Example 1  Message subject:      Problem: {TRIGGER.NAME}  When you receive the message, the message subject will be replaced by something like:      Problem: Processor load is too high on Zabbix server
fr	##### Exemple 1  Objet du message:      Problème : {TRIGGER.NAME}  Lorsque vous recevez le message, le sujet du message sera remplacé par quelque chose comme :      Problème : la charge du processeur est trop élevée sur le serveur Zabbix

en-us	##### Example 1  Sending a repeated notification once every 30 minutes (5 times in total) to a 'MySQL Administrators' group. To configure:  -   in Operations tab, set the *Default operation step duration* to     '30m' (30 minutes) -   Set the escalation steps to be *From* '1' *To* '5' -   Select the 'MySQL Administrators' group as recipients of the message  ![](../../../../../assets/en/manual/config/escalations_a.png){width="600"}  Notifications will be sent at 0:00, 0:30, 1:00, 1:30, 2:00 hours after the problem starts (unless, of course, the problem is resolved sooner).  If the problem is resolved and a recovery message is configured, it will be sent to those who received at least one problem message within this escalation scenario.  ::: noteclassic If the trigger that generated an active escalation is disabled, Zabbix sends an informative message about it to all those that have already received notifications. :::
fr	 ##### Exemple 1   Envoi d'une notification répétée une fois toutes les 30 minutes (5 fois au total) à un groupe 'MySQL Administrators'. Pour le configurer :  - Dans l'onglet Opérations, définissez la *durée de l'étape d'opération par défaut* à '30m' (30 minutes) - Définissez les étapes d'escalade sur *De* '1' *À* '5' - Sélectionnez le groupe 'MySQL Administrators' comme destinataires du message  ![](../../../../../assets/en/manual/config/escalations_a.png){width="600"}  Les notifications seront envoyées 0:00, 0:30, 1:00, 1:30, 2:00 heures après le début du problème (à moins, bien sûr, que le problème ne soit résolu plus tôt).  Si le problème est résolu et qu'un message de récupération est configuré, il sera envoyé à ceux qui ont reçu au moins un message de problème dans ce scénario d'escalade.  ::: noteclassic Si le déclencheur qui a généré une escalade active est désactivé, Zabbix envoie un message informatif à ce sujet à tous ceux qui ont déjà reçu des notifications. :::

en-us	##### Example 1  Send simple GET requests to retrieve data from services such as Elasticsearch:  -   Create a GET item with URL: `localhost:9200/?pretty` -   Notice the response:  ```{=html} <!-- --> ```     {       "name" : "YQ2VAY-",       "cluster_name" : "elasticsearch",       "cluster_uuid" : "kH4CYqh5QfqgeTsjh2F9zg",       "version" : {         "number" : "6.1.3",         "build_hash" : "af51318",         "build_date" : "2018-01-26T18:22:55.523Z",         "build_snapshot" : false,         "lucene_version" : "7.1.0",         "minimum_wire_compatibility_version" : "5.6.0",         "minimum_index_compatibility_version" : "5.0.0"       },       "tagline" : "You know, for search"     }  -   Now extract the version number using a JSONPath preprocessing step:     `$.version.number`
fr	##### Exemple 1  Envoyez des requêtes GET simples pour extraire des données de services tels que Elasticsearch :  - Créer un élément GET avec l'URL : `localhost:9200/?pretty` - Notez la réponse :  ```{=html} <!-- --> ```  {  "name" : "YQ2VAY-",  "cluster_name" : "elasticsearch",  "cluster_uuid" : "kH4CYqh5QfqgeTsjh2F9zg",  "version" : {  "number" : "6.1.3",  "build_hash" : "af51318",  "build_date" : "2018-01-26T18:22:55.523Z",  "build_snapshot" : false,  "lucene_version" : "7.1.0",  "minimum_wire_compatibility_version" : "5.6.0",  "minimum_index_compatibility_version" : "5.0.0"  },  "tagline" : "You know, for search"  }  - Extrayez maintenant le numéro de version en utilisant une étape de prétraitement JSONPath : `$.version.number`

en-us	##### Example 1  Something very simple:      UserParameter=ping[*],echo $1  We may define unlimited number of items for monitoring all having format ping\[something\].  -   ping\[0\] - will always return '0' -   ping\[aaa\] - will always return 'aaa'
fr	##### Exemple 1  Quelque chose de très simple :      UserParameter=ping[*],echo $1  Nous pouvons définir un nombre illimité d'éléments pour la surveillance de tous les formats ping\[quelque chose\].  -   ping\[0\] - retournera toujours '0' -   ping\[aaa\] - retournera toujours 'aaa'

en-us	##### Example 1  Stop repetitive problem events from the same network port.  ![](../../../../assets/en/manual/config/event_correlation/correlation_example.png)  This global correlation rule will correlate problems if *Host* and *Port* tag values exist on the trigger and they are the same in the original event and the new one.  The operation will close new problem events on the same network port, keeping only the original problem open.
fr	##### Exemple 1  Arrêtez les événements de problème répétitifs à partir du même port réseau.  ![](../../../../assets/en/manual/config/event_correlation/correlation_example.png)  Cette règle de corrélation globale corrélera les problèmes si les valeurs des tags *Host* et *Port* existent sur le déclencheur et qu'elles sont identiques dans l'événement d'origine et le nouveau.  L'opération fermera les nouveaux événements de problème sur le même port réseau, en gardant uniquement le problème d'origine ouvert.

en-us	##### Example 1  Temperature in server room is too high.  Problem expression:      last(/server/temp)>20  Recovery expression:      last(/server/temp)<=15
fr	##### Exemple 1  La température dans la salle des serveurs est trop élevée.  Expression du problème :      last(/server/temp)>20  Expression de récupération :      last(/server/temp)<=15

en-us	##### Example 1  The processor load is too high on Zabbix server.      last(/Zabbix server/system.cpu.load[all,avg1])>5  By using the function 'last()', we are referencing the most recent value. `/Zabbix server/system.cpu.load[all,avg1]` gives a short name of the monitored parameter. It specifies that the host is 'Zabbix server' and the key being monitored is 'system.cpu.load\[all,avg1\]'. Finally, `>5` means that the trigger is in the PROBLEM state whenever the most recent processor load measurement from Zabbix server is greater than 5.
fr	##### Exemple 1  La charge du processeur est trop élevée sur le serveur Zabbix.      last(/Zabbix server/system.cpu.load[all,avg1])>5  En utilisant la fonction 'last()', nous faisons référence à la valeur la plus récente. `/Zabbix server/system.cpu.load[all,avg1]` donne un nom court du paramètre surveillé. Il spécifie que l'hôte est 'Zabbix server' et que la clé surveillée est 'system.cpu.load\[all,avg1\]'. Enfin, `>5` signifie que le déclencheur est dans l'état PROBLÈME chaque fois que la mesure de la charge du processeur la plus récente du serveur Zabbix est supérieure à 5.

en-us	##### Example 1  To create a "Web scenario failed" trigger, you can define a trigger expression:      last(/host/web.test.fail[Scenario])<>0  Make sure to replace 'Scenario' with the real name of your scenario.
fr	##### Exemple 1  Pour créer un déclencheur "Échec du scenario Web", vous pouvez définir une expression de déclencheur :      last(/host/web.test.fail[Scenario])<>0  Assurez-vous de remplacer 'Scenario' par le vrai nom de votre scénario.

en-us	##### Example 1  Total disk space of host group 'MySQL Servers'.      sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"]))
fr	##### Exemple 1  Espace disque total du groupe d'hôtes 'MySQL Servers'.      sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"]))

en-us	##### Example 1  Use of host-level macro in the "Status of SSH daemon" item key:  `net.tcp.service[ssh,,{$SSH_PORT}]`  This item can be assigned to multiple hosts, providing that the value of **{$SSH\_PORT}** is defined on those hosts.
fr	##### Exemple 1  Utilisation d'une macro au niveau de l'hôte dans la clé d'élément "État du démon SSH" :  `net.tcp.service[ssh,,{$SSH_PORT}]`  Cet élément peut être attribué à plusieurs hôtes, à condition que la valeur de **{$SSH\_PORT}** soit définie sur ces hôtes.

en-us	##### Example 1  Use of the following expression in low-level discovery to discover databases except a database with a specific name:      ^TESTDATABASE$  ![regexp\_expr\_2.png](../../assets/en/manual/regular_expressions/regexp_expr_2.png)  Chosen *Expression type*: "Result is FALSE". Doesn't match name, containing string "*TESTDATABASE*".
fr	##### Exemple 1  Utilisation de l'expression suivante dans la découverte de bas niveau pour découvrir des bases de données à l'exception d'une base de données portant un nom spécifique :       ^TESTDATABASE$  ![regexp\_expr\_2.png](../../assets/en/manual/regular_expressions/regexp_expr_2.png)  *Type d'expression* choisi : "Le résultat est FAUX". Ne correspond pas au nom, contenant la chaîne "*TESTDATABASE*".

en-us	##### Example 1  Using host metadata to distinguish between Linux and Windows hosts.  Say you would like the hosts to be autoregistered by the Zabbix server. You have active Zabbix agents (see "Configuration" section above) on your network. There are Windows hosts and Linux hosts on your network and you have "Linux by Zabbix agent" and "Windows by Zabbix agent" templates available in your Zabbix frontend. So at host registration, you would like the appropriate Linux/Windows template to be applied to the host being registered. By default, only the hostname is sent to the server at autoregistration, which might not be enough. In order to make sure the proper template is applied to the host you should use host metadata.
fr	##### Exemple 1  Utilisation de métadonnées d'hôte pour distinguer les hôtes Linux et Windows.  Supposons que vous souhaitiez que les hôtes soient automatiquement enregistrés par le serveur Zabbix. Vous avez des agents Zabbix actifs (voir la section "Configuration" ci-dessus) sur votre réseau. Il existe des hôtes Windows et des hôtes Linux sur votre réseau et vous avez des modèles "Template OS Linux" et "Template OS Windows" disponibles dans votre interface Zabbix. Ainsi, lors de l'enregistrement de l'hôte, vous souhaitez que le modèle Linux/Windows approprié soit appliqué à l'hôte en cours d'enregistrement. Par défaut, seul le nom d'hôte est envoyé au serveur lors de l'enregistrement automatique, ce qui pourrait ne pas suffire. Afin de vous assurer que le modèle approprié est appliqué à l'hôte, vous devez utiliser les métadonnées de l'hôte.

en-us	##### Example 2  Calculating a 10-minute average of the number of values processed by Zabbix.  Use of function **avg**:      avg(/Zabbix Server/zabbix[wcache,values],10m)  Note that extensive use of calculated items with long time periods may affect performance of Zabbix server.
fr	##### Exemple 2  Calcul d'une moyenne sur 10 minutes du nombre de valeurs traitées par Zabbix.  Utilisation de la fonction **avg**:      avg(/Zabbix Server/zabbix[wcache,values],10m)  Notez qu'une utilisation intensive d'éléments calculés avec de longues périodes peut affecter les performances du serveur Zabbix.

en-us	##### Example 2  Free disk space is too low.  Problem expression: it is less than 10GB for last 5 minutes      max(/server/vfs.fs.size[/,free],5m)<10G  Recovery expression: it is more than 40GB for last 10 minutes      min(/server/vfs.fs.size[/,free],10m)>40G
fr	##### Exemple 2  L'espace disque libre est trop faible.  Expression du problème : moins de 10 Go pendant les 5 dernières minutes      max(/server/vfs.fs.size[/,free],5m)<10G  Expression de récupération : plus de 40 Go pendant les 10 dernières minutes      min(/server/vfs.fs.size[/,free],10m)>40G

en-us	##### Example 2  Let's add more sense!      UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive  This parameter can be used for monitoring availability of MySQL database. We can pass user name and password:      mysql.ping[zabbix,our_password]
fr	##### Exemple 2  Ajoutons un peu de sens !      UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive  Ce paramètre peut être utilisé pour superviser la disponibilité de la base de données MySQL. Nous pouvons passer le nom d'utilisateur et le mot de passe :      mysql.ping[zabbix,our_password]

en-us	##### Example 2  Message:      Processor load is: {?last(/zabbix.zabbix.com/system.cpu.load[,avg1])}  When you receive the message, the message will be replaced by something like:      Processor load is: 1.45
fr	 ##### Exemple 2  Message :      Processor load is: {?last(/zabbix.zabbix.com/system.cpu.load[,avg1])}  Lorsque vous recevez le message, le message sera remplacé par quelque chose comme :      Processor load is: 1.45

en-us	##### Example 2  Monitoring of uptime:  |Parameter|Description| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**Value type**|Float| |**Units**|uptime| |**Preprocessing step: Custom multiplier**|0.01|
fr	##### Exemple 2  Surveillance de la disponibilité :  |Paramètre|Description| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**Value type**|Float| |**Units**|uptime| |**Étape de prétraitement : multiplicateur personnalisé**|0.01|

en-us	##### Example 2  Sending a delayed notification about a long-standing problem. To configure:  -   In Operations tab, set the *Default operation step duration* to     '10h' (10 hours) -   Set the escalation steps to be *From* '2' *To* '2'  ![](../../../../../assets/en/manual/config/escalations_b.png){width="600"}  A notification will only be sent at Step 2 of the escalation scenario, or 10 hours after the problem starts.  You can customize the message text to something like 'The problem is more than 10 hours old'.
fr	##### Exemple 2  Envoi d'une notification différée concernant un problème de longue date. Configurer :  - Dans l'onglet Opérations, définissez la *durée de l'étape d'opération par défaut* sur '10h' (10 heures) - Définissez les étapes d'escalade sur *De* '2' *À* '2'  ![](../../../../../assets/en/manual/config/escalations_b.png){width="600"}  Une notification ne sera envoyée qu'à l'étape 2 du scénario d'escalade, ou 10 heures après le début du problème.  Vous pouvez personnaliser le texte du message avec quelque chose comme "Le problème date de plus de 10 heures".

en-us	##### Example 2  Send simple POST requests to retrieve data from services such as Elasticsearch:  -   Create a POST item with URL:     `http://localhost:9200/str/values/_search?scroll=10s` -   Configure the following POST body to obtain the processor load (1     min average per core)  ```{=html} <!-- --> ```     {         "query": {             "bool": {                 "must": [{                     "match": {                         "itemid": 28275                     }                 }],                 "filter": [{                     "range": {                         "clock": {                             "gt": 1517565836,                             "lte": 1517566137                         }                     }                 }]             }         }     }  -   Received:  ```{=html} <!-- --> ```     {         "_scroll_id": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAAAAkFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAJRZZUTJWQVktVFNacU5nRHhlcEI0QUxRAAAAAAAAACYWWVEyVkFZLVRTWnFOZ0R4ZXBCNEFMUQAAAAAAAAAnFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAKBZZUTJWQVktVFNacU5nRHhlcEI0QUxR",         "took": 18,         "timed_out": false,         "_shards": {             "total": 5,             "successful": 5,             "skipped": 0,             "failed": 0         },         "hits": {             "total": 1,             "max_score": 1.0,             "hits": [{                 "_index": "dbl",                 "_type": "values",                 "_id": "dqX9VWEBV6sEKSMyk6sw",                 "_score": 1.0,                 "_source": {                     "itemid": 28275,                     "value": "0.138750",                     "clock": 1517566136,                     "ns": 25388713,                     "ttl": 604800                 }             }]         }     }  -   Now use a JSONPath preprocessing step to get the item value:     `$.hits.hits[0]._source.value`
fr	##### Exemple 2  Envoyez des requêtes POST simples pour extraire des données de services tels que Elasticsearch :  - Créez un élément POST avec l'URL : `http://localhost:9200/str/values/_search?scroll=10s` - Configurez le corps POST suivant pour obtenir la charge du processeur (moyenne 1 min par cœur)  ```{=html} <!-- --> ```  {  "query": {  "bool": {  "must": [{  "match": {  "itemid": 28275  }  }],  "filter": [{  "range": {  "clock": {  "gt": 1517565836,  "lte": 1517566137  }  }  }]  }  }  }  - Reçu :  ```{=html} <!-- --> ```  {  "_scroll_id": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAAAAkFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAJRZZUTJWQVktVFNacU5nRHhlcEI0QUxRAAAAAAAAACYWWVEyVkFZLVRTWnFOZ0R4ZXBCNEFMUQAAAAAAAAAnFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAKBZZUTJWQVktVFNacU5nRHhlcEI0QUxR",  "took": 18,  "timed_out": false,  "_shards": {  "total": 5,  "successful": 5,  "skipped": 0,  "failed": 0  },  "hits": {  "total": 1,  "max_score": 1.0,  "hits": [{  "_index": "dbl",  "_type": "values",  "_id": "dqX9VWEBV6sEKSMyk6sw",  "_score": 1.0,  "_source": {  "itemid": 28275,  "value": "0.138750",  "clock": 1517566136,  "ns": 25388713,  "ttl": 604800  }  }]  }  }  - Utilisez maintenant une étape de prétraitement JSONPath pour obtenir la valeur de l’élément: `$.hits.hits[0]._source.value`

en-us	##### Example 2  Sum of latest values of all items matching net.if.in\[\*\] on the host.      sum(last_foreach(/host/net.if.in[*]))
fr	##### Exemple 2  Somme des dernières valeurs de tous les éléments correspondant à net.if.in\[\*\] sur l'hôte.      sum(last_foreach(/host/net.if.in[*]))

en-us	##### Example 2  To create a "Web scenario failed" trigger with a useful problem description in the trigger name, you can define a trigger with name:      Web scenario "Scenario" failed: {ITEM.VALUE}  and trigger expression:      length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0  Make sure to replace 'Scenario' with the real name of your scenario.
fr	##### Exemple 2  Pour créer un déclencheur "Échec du scenario Web" avec une description de problème utile dans le nom du déclencheur, vous pouvez définir un déclencheur avec le nom suivant :      Echec du scenario Web "Scenario": {ITEM.VALUE}  Et l'expression de déclencheur :      length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0  Assurez-vous de remplacer 'Scenario' par le vrai nom de votre scénario.

en-us	##### Example 2  Use of host-level macro in the "CPU load is too high" trigger:  `last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}`  Such a trigger would be created on the template, not edited in individual hosts.  ::: notetip If you want to use the amount of values as the function parameter (for example, **max(/host/key,\#3)**), include hash mark in the macro definition like this: SOME\_PERIOD => \#3 :::
fr	##### Exemple 2  Utilisation de la macro au niveau de l'hôte dans le déclencheur "La charge du processeur est trop élevée" :  `last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}`  Un tel déclencheur serait créé sur le modèle, et non modifié sur des hôtes individuels.  ::: notetip Si vous souhaitez utiliser la quantité de valeurs comme paramètre de fonction (pour exemple, **max(/host/key,\#3)**), incluez le signe dièse dans la définition de la macro comme ceci : SOME\_PERIOD => \#3 :::

en-us	##### Example 2  www.example.com is overloaded.      last(/www.example.com/system.cpu.load[all,avg1])>5 or min(/www.example.com/system.cpu.load[all,avg1],10m)>2   The expression is true when either the current processor load is more than 5 or the processor load was more than 2 during last 10 minutes.
fr	##### Exemple 2  www.example.com est surchargé.      last(/www.example.com/system.cpu.load[all,avg1])>5 or min(/www.example.com/system.cpu.load[all,avg1],10m)>2   L'expression est vraie lorsque la charge actuelle du processeur est supérieure à 5 ou que la charge du processeur était supérieure à 2 au cours des 10 dernières minutes.

en-us	##### Example 3  Average processor load of host group 'MySQL Servers'.      avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"]))
fr	##### Exemple 3  Charge moyenne du processeur du groupe d'hôtes 'MySQL Servers'.      avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"]))

en-us	##### Example 3  Calculating total bandwidth on eth0.  Sum of two functions:      last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes])
fr	##### Exemple 3  Calcul de la bande passante totale sur eth0.  Somme de deux fonctions :      last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes])

en-us	##### Example 3  Checking if Zabbix API is alive, using [apiinfo.version](/manual/api/reference/apiinfo/version).  -   Item configuration:  ![](../../../../../assets/en/manual/config/items/itemtypes/example3_a.png)  Note the use of the POST method with JSON data, setting request headers and asking to return headers only:  -   Item value preprocessing with regular expression to get HTTP code:  ![](../../../../../assets/en/manual/config/items/itemtypes/example3_b.png)  -   Checking the result in *Latest data*:  ![](../../../../../assets/en/manual/config/items/itemtypes/example3_c.png){width="600"}
fr	##### Exemple 3  Vérifier si l'API Zabbix est vivant en utilisant [apiinfo.version](/manual/api/reference/apiinfo/version).  - Configuration de l'élément :  ![](../../../../../assets/en/manual/config/items/itemtypes/example3_a.png)  Notez l'utilisation de la méthode POST avec les données JSON, la définition des en-têtes de requête et le renvoi des en-têtes uniquement :  - Prétraitement de la valeur d'élément avec une expression régulière pour obtenir le code HTTP :  ![](../../../../../assets/en/manual/config/items/itemtypes/example3_b.png)  - Vérification du résultat dans *Dernières données* :  ![](../../../../../assets/en/manual/config/items/itemtypes/example3_c.png){width="600"}

en-us	##### Example 3  Escalating the problem to the Boss.  In the first example above we configured periodical sending of messages to MySQL administrators. In this case, the administrators will get four messages before the problem will be escalated to the Database manager. Note that the manager will get a message only in case the problem is not acknowledged yet, supposedly no one is working on it.  ![](../../../../../assets/en/manual/config/escalations_c.png){width="600"}  Details of Operation 2:  ![](../../../../../assets/en/manual/config/escalations_cc.png)  Note the use of {ESC.HISTORY} macro in the customized message. The macro will contain information about all previously executed steps on this escalation, such as notifications sent and commands executed.
fr	##### Exemple 3  Faire remonter le problème au Boss.  Dans le premier exemple ci-dessus, nous avons configuré l'envoi périodique de messages aux administrateurs MySQL. Dans ce cas, les administrateurs recevront quatre messages avant que le problème ne soit transmis au gestionnaire de base de données. Notez que le responsable ne recevra un message que si le problème n'est pas encore acquitté, c'est-à-dire que personne n'y travaille.  ![](../../../../../assets/en/manual/config/escalations_c.png){width="600"}  Détails de l'opération 2 :  ![](../../../../../assets/en/manual/config/escalations_cc.png)  Notez l'utilisation de la macro {ESC.HISTORY} dans le message personnalisé. La macro contiendra des informations sur toutes les étapes précédemment exécutées sur cette escalade, telles que les notifications envoyées et les commandes exécutées.

en-us	##### Example 3  How many lines matching a regular expression in a file?      UserParameter=wc[*],grep -c "$2" $1  This parameter can be used to calculate number of lines in a file.      wc[/etc/passwd,root]     wc[/etc/services,zabbix]
fr	##### Exemple 3  Combien de lignes correspondent à une expression régulière dans un fichier ?      UserParameter=wc[*],grep -c "$2" $1  Ce paramètre peut être utilisé pour calculer le nombre de ligne dans un fichier.      wc[/etc/passwd,root]     wc[/etc/services,zabbix]

en-us	##### Example 3  Message:      Latest value: {?last(/{HOST.HOST}/{ITEM.KEY})}     MAX for 15 minutes: {?max(/{HOST.HOST}/{ITEM.KEY},15m)}     MIN for 15 minutes: {?min(/{HOST.HOST}/{ITEM.KEY},15m)}  When you receive the message, the message will be replaced by something like:      Latest value: 1.45     MAX for 15 minutes: 2.33     MIN for 15 minutes: 1.01
fr	 ##### Exemple 3  Message :      Latest value: {?last(/{HOST.HOST}/{ITEM.KEY})}     MAX for 15 minutes: {?max(/{HOST.HOST}/{ITEM.KEY},15m)}     MIN for 15 minutes: {?min(/{HOST.HOST}/{ITEM.KEY},15m)}  Lorsque vous recevez le message, le message sera remplacé par quelque chose comme :      Latest value: 1.45     MAX for 15 minutes: 2.33     MIN for 15 minutes: 1.01

en-us	##### Example 3  To create a "Web application is slow" trigger, you can define a trigger expression:      last(/host/web.test.in[Scenario,,bps])<10000  Make sure to replace 'Scenario' with the real name of your scenario.
fr	##### Exemple 3  Pour créer un déclencheur "Application Web lente", vous pouvez définir une expression de déclencheur :      last(/host/web.test.in[Scenario,,bps])<10000  Assurez-vous de remplacer 'Scenario' par le vrai nom de votre scénario.

en-us	##### Example 3  Use of two macros in the "CPU load is too high" trigger:  `min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}`  Note that a macro can be used as a parameter of trigger function, in this example function **min()**.
fr	##### Exemple 3  Utilisation de deux macros dans le déclencheur "La charge CPU est trop élevée" :  `min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}`  Notez qu'une macro peut être utilisée comme paramètre de la fonction de déclenchement, dans cet exemple la fonction **min()**.

en-us	##### Example 4  5-minute average of the number of queries per second for host group 'MySQL Servers'.      avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m))
fr	##### Exemple 4  Moyenne sur 5 minutes du nombre de requêtes par seconde pour le groupe d'hôtes 'MySQL Servers'.      avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m))

en-us	##### Example 4  A more complex scenario. After multiple messages to MySQL administrators and escalation to the manager, Zabbix will try to restart the MySQL database. It will happen if the problem exists for 2:30 hours and it hasn't been acknowledged.  If the problem still exists, after another 30 minutes Zabbix will send a message to all guest users.  If this does not help, after another hour Zabbix will reboot server with the MySQL database (second remote command) using IPMI commands.  ![](../../../../../assets/en/manual/config/escalations_d.png){width="600"}
fr	##### Exemple 4  Un scénario plus complexe. Après plusieurs messages aux administrateurs MySQL et une escalade vers le responsable, Zabbix essaiera de redémarrer la base de données MySQL. Cela se produira si le problème existe depuis 2h30 et qu'il n'a pas été acquitté.  Si le problème persiste, après 30 minutes supplémentaires, Zabbix enverra un message à tous les utilisateurs invités.  Si cela ne résout pas le problème, après une heure supplémentaire, Zabbix redémarrera le serveur avec la base de données MySQL (deuxième commande à distance) à l'aide des commandes IPMI.  ![](../../../../../assets/en/manual/config/escalations_d.png){width="600"}

en-us	##### Example 4  Calculating percentage of incoming traffic.  More complex expression:      100*last(//net.if.in[eth0,bytes])/(last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes]))  See also: [Examples of aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate#usage_examples)
fr	##### Exemple 4  Calcul du pourcentage du trafic entrant.  Expression plus complexe :      100*last(//net.if.in[eth0,bytes])/(last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes]))  Voir également : [Exemples de calculs agrégés](/manual/config/items/itemtypes/calculated/aggregate#usage_examples)

en-us	##### Example 4  Message:      http://<server_ip_or_name>/zabbix/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID}  When you receive the message, it will contain a link to the *Event details* page, which provides information about the event, its trigger, and a list of latest events generated by the same trigger.
fr	##### Exemple 4  Message :      http://<server_ip_or_name>/zabbix/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID}  Lorsque vous recevez le message, il contient un lien vers la page *Détails de l'événement*, qui fournit des informations sur l'événement, son déclencheur et une liste des derniers événements générés par le même déclencheur.

en-us	##### Example 4  Retrieving weather information by connecting to the Openweathermap public service.  -   Configure a master item for bulk data collection in a single JSON:  ![](../../../../../assets/en/manual/config/items/itemtypes/example4_a.png)  Note the usage of macros in query fields. Refer to the [Openweathermap API](https://openweathermap.org/current) for how to fill them.  Sample JSON returned in response to HTTP agent:  ``` {.json} {     "body": {         "coord": {             "lon": 40.01,             "lat": 56.11         },         "weather": [{             "id": 801,             "main": "Clouds",             "description": "few clouds",             "icon": "02n"         }],         "base": "stations",         "main": {             "temp": 15.14,             "pressure": 1012.6,             "humidity": 66,             "temp_min": 15.14,             "temp_max": 15.14,             "sea_level": 1030.91,             "grnd_level": 1012.6         },         "wind": {             "speed": 1.86,             "deg": 246.001         },         "clouds": {             "all": 20         },         "dt": 1526509427,         "sys": {             "message": 0.0035,             "country": "RU",             "sunrise": 1526432608,             "sunset": 1526491828         },         "id": 487837,         "name": "Stavrovo",         "cod": 200     } } ```  The next task is to configure dependent items that extract data from the JSON.  -   Configure a sample dependent item for humidity:  ![](../../../../../assets/en/manual/config/items/itemtypes/example4_b.png)  Other weather metrics such as 'Temperature' are added in the same manner.  -   Sample dependent item value preprocessing with JSONPath:  ![](../../../../../assets/en/manual/config/items/itemtypes/example4_c.png)  -   Check the result of weather data in *Latest data*:  ![](../../../../../assets/en/manual/config/items/itemtypes/example4_d.png){width="600"}
fr	##### Exemple 4  Récupération des informations météorologiques en se connectant au service public Openweathermap.  - Configurez un élément principal pour la collecte de données en bloc dans un seul JSON :  ![](../../../../../assets/en/manual/config/items/itemtypes/example4_a.png)  Notez l'utilisation de macros dans les champs de requête. Reportez-vous à l'API [Openweathermap](https://openweathermap.org/current) pour savoir comment les remplir.  Exemple de code JSON renvoyé en réponse à l'agent HTTP :  ``` {.json} {  "body": {  "coord": {  "lon": 40.01,  "lat": 56.11  },  "weather": [{  "id": 801,  "main": "Clouds",  "description": "few clouds",  "icon": "02n"  }],  "base": "stations",  "main": {  "temp": 15.14,  "pressure": 1012.6,  "humidity": 66,  "temp_min": 15.14,  "temp_max": 15.14,  "sea_level": 1030.91,  "grnd_level": 1012.6  },  "wind": {  "speed": 1.86,  "deg": 246.001  },  "clouds": {  "all": 20  },  "dt": 1526509427,  "sys": {  "message": 0.0035,  "country": "RU",  "sunrise": 1526432608,  "sunset": 1526491828  },  "id": 487837,  "name": "Stavrovo",  "cod": 200  } } ```  La tâche suivante consiste à configurer les éléments dépendants qui extraient les données du JSON.  - Configurez un élément dépendant pour l'humidité :  ![](../../../../../assets/en/manual/config/items/itemtypes/example4_b.png)  D'autres métriques météorologiques telles que 'Température' sont ajoutées de la même manière.  - Exemple de prétraitement de la valeur de l'élément dépendant avec JSONPath :  ![](../../../../../assets/en/manual/config/items/itemtypes/example4_c.png)  - Vérifiez le résultat des données météorologiques dans *Dernières données* :  ![](../../../../../assets/en/manual/config/items/itemtypes/example4_d.png){width="600"}

en-us	##### Example 4  Someone is downloading a large file from the Internet.  Use of function min:      min(/www.example.com/net.if.in[eth0,bytes],5m)>100K  The expression is true when number of received bytes on eth0 is more than 100 KB within last 5 minutes.
fr	##### Exemple 4  Quelqu'un télécharge une fichier volumineux sur Internet.  Utilisation de la fonction min :      min(/www.example.com/net.if.in[eth0,bytes],5m)>100K  L'expression est vraie lorsque le nombre d'octets reçus sur eth0 est supérieur à 100 Ko au cours des 5 dernières minutes.

en-us	##### Example 4  Synchronize the agent unavailability condition with the item update interval:  -   define {$INTERVAL} macro and use it in the item update interval; -   use {$INTERVAL} as parameter of the agent unavailability trigger:  `nodata(/ca_001/agent.ping,{$INTERVAL})=1`
fr	##### Exemple 4  Synchronisez la condition d'indisponibilité de l'agent avec l'intervalle de mise à jour de l'élément :  - définir la macro {$INTERVAL} et l'utiliser dans l'intervalle de mise à jour de l'élément ; - utilisez {$INTERVAL} comme paramètre du déclencheur d'indisponibilité de l'agent :  `nodata(/ca_001/agent.ping,{$INTERVAL})=1`

en-us	##### Example 5  An escalation with several operations assigned to one step and custom intervals used. The default operation step duration is 30 minutes.  ![](../../../../../assets/en/manual/config/escalations_e.png){width="600"}  Notifications will be sent as follows:  -   to MySQL administrators at 0:00, 0:30, 1:00, 1:30 after the problem     starts -   to Database manager at 2:00 and 2:10 (and not at 3:00; seeing that     steps 5 and 6 overlap with the next operation, the shorter custom     step duration of 10 minutes in the next operation overrides the     longer step duration of 1 hour tried to set here) -   to Zabbix administrators at 2:00, 2:10, 2:20 after the problem     starts (the custom step duration of 10 minutes working) -   to guest users at 4:00 hours after the problem start (the default     step duration of 30 minutes returning between steps 8 and 11)
fr	 ##### Exemple 5  Une escalade avec plusieurs opérations affectées à une étape et des intervalles personnalisés utilisés. La durée de l'étape de fonctionnement par défaut est de 30 minutes.  ![](../../../../../assets/en/manual/config/escalations_e.png){width="600"}  Les notifications seront envoyées comme suit :  -   aux administrateurs MySQL 0:00, 0:30, 1:00, 1:30 après le début du problème -   au gestionnaire de base de données 2:00 et 2:10 après le début du problème (et non à 3:00 ; étant donné que les étapes 5 et 6 se chevauchent avec l'opération suivante, la durée d'étape personnalisée plus courte de 10 minutes dans l'opération suivante remplace la durée d'étape plus longue de 1 heure essayé de définir ici) -   aux administrateurs Zabbix 2:00, 2:10, 2:20 après le début du problème (la durée de l'étape personnalisée de 10 minutes de travail) -   aux utilisateurs invités 4:00 heures après le début du problème (la durée d'étape par défaut de 30 minutes revient entre les étapes 8 et 11)

en-us	##### Example 5  Average CPU load on all hosts in multiple host groups that have the specific tags.      avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")]))
fr	##### Exemple 5  Charge CPU moyenne sur tous les hôtes dans plusieurs groupes d'hôtes qui ont des tags spécifiques.      avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")]))

en-us	##### Example 5  Both nodes of clustered SMTP server are down.  Note use of two different hosts in one expression:      last(/smtp1.example.com/net.tcp.service[smtp])=0 and last(/smtp2.example.com/net.tcp.service[smtp])=0  The expression is true when both SMTP servers are down on both smtp1.example.com and smtp2.example.com.
fr	##### Exemple 5  Les deux nœuds du serveur SMTP en cluster sont arrêtés.  Notez l'utilisation de deux hôtes différents dans une expression :      last(/smtp1.example.com/net.tcp.service[smtp])=0 and last(/smtp2.example.com/net.tcp.service[smtp])=0  L'expression est vraie lorsque les deux serveurs SMTP sont en panne sur smtp1.example.com et smtp2.example.com.

en-us	##### Example 5  Centralize configuration of working hours:  -   create a global {$WORKING\_HOURS} macro equal to `1-5,09:00-18:00`; -   use it in the *Working time* field in *Administration* → *General* →     *GUI*; -   use it in the *When active* field in *Administration* → *User* →     *Media*; -   use it to set up more frequent item polling during working hours:  ![](../../../../assets/en/manual/config/macros/usermacro_example5.png)  -   use it in the *Time period* action condition; -   adjust the working time in *Administration* → *General* → *Macros*,     if needed.
fr	##### Exemple 5  Centralisez la configuration des heures de travail :  - créer une macro globale {$WORKING\_HOURS} égale à `1-5,09:00-18:00` ; - utilisez-le dans le champ *Temps de travail* dans *Administration* → *Général* → *GUI* ; - utilisez-le dans le champ *Lorsque actif* dans *Administration* → *Utilisateur* → *Médias* ; - utilisez-le pour configurer une interrogation plus fréquente des éléments pendant les heures de travail :  ![](../../../../assets/en/manual/config/macros/usermacro_example5.png)  - l'utiliser dans la condition d'action *Période* ; - ajuster le temps de travail dans *Administration* → *Général* → *Macros*, si nécessaire.

en-us	##### Example 5  Connecting to Nginx status page and getting its metrics in bulk.  -   Configure Nginx following the [official     guide](https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html).  ```{=html} <!-- --> ``` -   Configure a master item for bulk data collection:  ![](../../../../../assets/en/manual/config/items/itemtypes/example5_a.png)  Sample Nginx stub status output:      Active connections: 1 Active connections:     server accepts handled requests      52 52 52      Reading: 0 Writing: 1 Waiting: 0  The next task is to configure dependent items that extract data.  -   Configure a sample dependent item for requests per second:  ![](../../../../../assets/en/manual/config/items/itemtypes/example5_b.png)  -   Sample dependent item value preprocessing with regular expression     `server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+)`:  ![](../../../../../assets/en/manual/config/items/itemtypes/example5_c.png){width="600"}  -   Check the complete result from stub module in *Latest data*:  ![](../../../../../assets/en/manual/config/items/itemtypes/example5_d.png){width="600"}
fr	##### Exemple 5  Connexion à la page d'état de Nginx et obtention de ses métriques en masse.  - Configurez Nginx en suivant le [guide officiel] (https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html).  ```{=html} <!-- --> ``` - Configurez un élément principal pour la collecte de données en masse :  ![](../../../../../assets/en/manual/config/items/itemtypes/example5_a.png)  Exemple de sortie d'état du stub Nginx :      Active connections: 1 Active connections:     server accepts handled requests     52 52 52      Reading: 0 Writing: 1 Waiting: 0  La tâche suivante consiste à configurer les éléments dépendants qui extraient les données.  - Configurez un exemple d'élément dépendant pour les requêtes par seconde :  ![](../../../../../assets/en/manual/config/items/itemtypes/example5_b.png)  - Exemple de prétraitement de la valeur de l'élément dépendant avec une expression régulière `le serveur accepte les requêtes traitées\s+([0-9]+) ([0-9]+) ([0-9]+)` :  ![](../../../../../assets/en/manual/config/items/itemtypes/example5_c.png){width="600"}  - Vérifiez le résultat complet du module stub dans *Dernières données* :  ![](../../../../../assets/en/manual/config/items/itemtypes/example5_d.png){width="600"}

en-us	##### Example 5  Informing about values from several hosts in a trigger expression.  Message:      Problem name: {TRIGGER.NAME}     Trigger expression: {TRIGGER.EXPRESSION}           1. Item value on {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1})     2. Item value on {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2})  When you receive the message, the message will be replaced by something like:      Problem name: Processor load is too high on a local host     Trigger expression: last(/Myhost/system.cpu.load[percpu,avg1])>5 or last(/Myotherhost/system.cpu.load[percpu,avg1])>5      1. Item value on Myhost: 0.83 (Processor load (1 min average per core))     2. Item value on Myotherhost: 5.125 (Processor load (1 min average per core))
fr	##### Exemple 5  Informer sur les valeurs de plusieurs hôtes dans une expression de déclencheur.  Message:      Problem name: {TRIGGER.NAME}     Trigger expression: {TRIGGER.EXPRESSION}           1. Item value on {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1})     2. Item value on {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2})  Lorsque vous recevez le message, le message sera remplacé par quelque chose comme :      Problem name: Processor load is too high on a local host     Trigger expression: last(/Myhost/system.cpu.load[percpu,avg1])>5 or last(/Myotherhost/system.cpu.load[percpu,avg1])>5      1. Item value on Myhost: 0.83 (Processor load (1 min average per core))     2. Item value on Myotherhost: 5.125 (Processor load (1 min average per core))

en-us	##### Example 6  Calculation used on the latest item value sums of a whole host group.      sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) 
fr	##### Exemple 6  Calcul utilisé sur les dernières sommes de valeur d'élément d'un groupe d'hôtes entier.      sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) 

en-us	##### Example 6  Receiving details of both the problem event and recovery event in a [recovery](/manual/config/notifications/action/recovery_operations) message:  Message:      Problem:      Event ID: {EVENT.ID}     Event value: {EVENT.VALUE}      Event status: {EVENT.STATUS}      Event time: {EVENT.TIME}     Event date: {EVENT.DATE}     Event age: {EVENT.AGE}     Event acknowledgment: {EVENT.ACK.STATUS}      Event update history: {EVENT.UPDATE.HISTORY}      Recovery:       Event ID: {EVENT.RECOVERY.ID}     Event value: {EVENT.RECOVERY.VALUE}      Event status: {EVENT.RECOVERY.STATUS}      Event time: {EVENT.RECOVERY.TIME}     Event date: {EVENT.RECOVERY.DATE}     Operational data: {EVENT.OPDATA}  When you receive the message, the macros will be replaced by something like:      Problem:      Event ID: 21874     Event value: 1      Event status: PROBLEM      Event time: 13:04:30     Event date: 2018.01.02     Event age: 5m     Event acknowledgment: Yes      Event update history: 2018.01.02 13:05:51 "John Smith (Admin)"     Actions: acknowledged.      Recovery:       Event ID: 21896     Event value: 0      Event status: OK      Event time: 13:10:07     Event date: 2018.01.02     Operational data: Current value is 0.83  ::: noteimportant Separate notification macros for the original problem event and recovery event are supported since Zabbix 2.2.0. :::
fr	##### Exemple 6  Réception des détails de l'événement de problème et de l'événement de récupération dans un message de [récupération](/manual/config/notifications/action/recovery_operations) :  Message :      Problème :      Event ID: {EVENT.ID}     Event value: {EVENT.VALUE}      Event status: {EVENT.STATUS}      Event time: {EVENT.TIME}     Event date: {EVENT.DATE}     Event age: {EVENT.AGE}     Event acknowledgment: {EVENT.ACK.STATUS}      Event update history: {EVENT.UPDATE.HISTORY}      Récupération :       Event ID: {EVENT.RECOVERY.ID}     Event value: {EVENT.RECOVERY.VALUE}      Event status: {EVENT.RECOVERY.STATUS}      Event time: {EVENT.RECOVERY.TIME}     Event date: {EVENT.RECOVERY.DATE}     Operational data: {EVENT.OPDATA}  Lorsque vous recevrez le message, les macros seront remplacées par quelque chose comme :      Problème :      Event ID: 21874     Event value: 1      Event status: PROBLEM      Event time: 13:04:30     Event date: 2018.01.02     Event age: 5m     Event acknowledgment: Yes      Event update history: 2018.01.02 13:05:51 "John Smith (Admin)"     Actions: acknowledged.      Récupération :       Event ID: 21896     Event value: 0      Event status: OK      Event time: 13:10:07     Event date: 2018.01.02     Operational data: Current value is 0.83  ::: noteimportant Les macros de notification distinctes pour l'événement de problème d'origine et l'événement de récupération sont prises en charge depuis Zabbix 2.2.0. :::

en-us	##### Example 6  Use host prototype macro to configure items for discovered hosts:  -   on a host prototype define user macro {$SNMPVALUE} with     {\#SNMPVALUE} [low-level     discovery](/manual/config/macros/lld_macros) macro as a value:  ![](../../../../assets/en/manual/config/macros/usermacro_example6.png)  -   assign *Generic SNMPv2* template to the host prototype; -   use {$SNMPVALUE} in the *SNMP OID* field of *Generic SNMPv2*     template items.
fr	##### Exemple 6  Utilisez la macro de prototype d'hôte pour configurer des éléments pour les hôtes découverts :  - sur un prototype d'hôte, définissez la macro utilisateur {$SNMPVALUE} avec la macro {\#SNMPVALUE} de [découverte de bas niveau](/manual/config/macros/lld_macros) comme valeur :  ![](../../../../assets/en/manual/config/macros/usermacro_example6.png)  - attribuer le modèle *Generic SNMPv2* au prototype hôte ; - utilisez {$SNMPVALUE} dans le champ *SNMP OID* des éléments de modèle *Generic SNMPv2*.

en-us	##### Example 6  Zabbix agent needs to be upgraded.  Use of function find():      find(/example.example.com/agent.version,,"like","beta8")=1  The expression is true if Zabbix agent has version beta8.
fr	##### Exemple 6  L'agent Zabbix doit être mis à jour.  Utilisation de la fonction find() :      find(/example.example.com/agent.version,,"like","beta8")=1  L'expression est vraie si l'agent Zabbix a la version beta8.

en-us	##### Example 7  Server is unreachable.      count(/example.example.com/icmpping,30m,,"0")>5  The expression is true if host "example.example.com" is unreachable more than 5 times in the last 30 minutes.
fr	##### Exemple 7  Le serveur est inaccessible.      count(/example.example.com/icmpping,30m,,"0")>5  L'expression est vraie si l'hôte "example.example.com" est inaccessible plus de 5 fois au cours des 30 dernières minutes.

en-us	##### Example 7  The total number of unsupported items in host group 'Zabbix servers'.      sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"]))
fr	##### Exemple 7  Le nombre total d'éléments non pris en charge dans le groupe d'hôtes 'Zabbix servers'.      sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"]))

en-us	##### Example 8  No heartbeats within last 3 minutes.  Use of function nodata():      nodata(/example.example.com/tick,3m)=1  To make use of this trigger, 'tick' must be defined as a Zabbix [trapper](/manual/config/items/itemtypes/trapper) item. The host should periodically send data for this item using zabbix\_sender. If no data is received within 180 seconds, the trigger value becomes PROBLEM.  *Note* that 'nodata' can be used for any item type.
fr	##### Exemple 8  Aucun battement de cœur au cours des 3 dernières minutes.  Utilisation de la fonction nodata() :      nodata(/example.example.com/tick,3m)=1  Pour utiliser ce déclencheur, 'tick' doit être défini comme un élément Zabbix [trapper](/manual/config/items/itemtypes/trapper). L'hôte doit envoyer périodiquement des données pour cet élément en utilisant zabbix\_sender. Si aucune donnée n'est reçue dans les 180 secondes, la valeur de déclenchement devient PROBLÈME.  *Notez* que 'nodata' peut être utilisé pour n'importe quel type d'élément.

en-us	##### Example configuration for Apache      # ..     ProxyPass "/" http://host/zabbix/     ProxyPassReverse "/" http://host/zabbix/     ProxyPassReverseCookiePath /zabbix /     ProxyPassReverseCookieDomain host zabbix.example.com     # ..
fr	##### Exemple de configuration pour Apache      # ..     ProxyPass "/" http://host/zabbix/     ProxyPassReverse "/" http://host/zabbix/     ProxyPassReverseCookiePath /zabbix /     ProxyPassReverseCookieDomain host zabbix.example.com     # ..

en-us	##### Example configuration for nginx      # ..     location / {     # ..     proxy_cookie_path /zabbix /;     proxy_pass http://192.168.0.94/zabbix/;     # ..
fr	##### Exemple de configuration pour nginx      # ..     location / {     # ..     proxy_cookie_path /zabbix /;     proxy_pass http://192.168.0.94/zabbix/;     # ..

en-us	#### Example  Getting memory usage of *apache* process.  If using this OID syntax:      HOST-RESOURCES-MIB::hrSWRunPerfMem["index","HOST-RESOURCES-MIB::hrSWRunPath", "/usr/sbin/apache2"]  the index number will be looked up here:      ...     HOST-RESOURCES-MIB::hrSWRunPath.5376 = STRING: "/sbin/getty"     HOST-RESOURCES-MIB::hrSWRunPath.5377 = STRING: "/sbin/getty"     HOST-RESOURCES-MIB::hrSWRunPath.5388 = STRING: "/usr/sbin/apache2"     HOST-RESOURCES-MIB::hrSWRunPath.5389 = STRING: "/sbin/sshd"     ...  Now we have the index, 5388. The index will be appended to the data OID in order to receive the value we are interested in:      HOST-RESOURCES-MIB::hrSWRunPerfMem.5388 = INTEGER: 31468 KBytes
fr	#### Exemple  Obtenir l'utilisation de la mémoire du processus *apache*.  Si vous utilisez cette syntaxe d'OID :      HOST-RESOURCES-MIB::hrSWRunPerfMem["index","HOST-RESOURCES-MIB::hrSWRunPath", "/usr/sbin/apache2"]  Le numéro d'index sera recherché ici :      ...     HOST-RESOURCES-MIB::hrSWRunPath.5376 = STRING: "/sbin/getty"     HOST-RESOURCES-MIB::hrSWRunPath.5377 = STRING: "/sbin/getty"     HOST-RESOURCES-MIB::hrSWRunPath.5388 = STRING: "/usr/sbin/apache2"     HOST-RESOURCES-MIB::hrSWRunPath.5389 = STRING: "/sbin/sshd"     ...  Maintenant que nous avons l'index 5388. L'index sera ajouté à l'OID de données afin de recevoir la valeur qui nous intéresse :      HOST-RESOURCES-MIB::hrSWRunPerfMem.5388 = INTEGER: 31468 KBytes

en-us	 *Example:*  Problem *Web camera 3 is down* has tags `type:video surveillance`, `floor:1st` and `name:webcam 3` and status *Warning*  The service **Web camera 3** has the only problem tag specified: `name:webcam 3`       ![](../../../assets/en/manual/config/services_example_tags.png){width=600}     Service status will change from *OK* to *Warning* when this problem is detected.   If the service **Web camera 3** had problem tags `name:webcam 3` and `floor:2nd`, its status would not be changed, when the problem is detected, because the conditions are only partially met. 
fr	*Exemple:*  Problème *La caméra Web 3 est en panne* a des tags `type:videosurveillance`, `floor:1st` et `name:webcam 3` et un statut *Warning*  Le service **caméra Web 3** a le seul tag de problème spécifiée : `name:webcam 3`     ![](../../../assets/en/manual/config/services_example_tags.png){width=600}     L'état du service passera de *OK* à *Avertissement* lorsque ce problème sera détecté.  Si le service **Caméra Web 3** avait des tags de problème `name:webcam 3` et `floor:2nd`, son statut ne serait pas modifié, lorsque le problème est détecté, car les conditions ne sont que partiellement remplies.

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemple

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples
fr	### Exemples

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	### Examples  
fr	### Exemples  

en-us	#### Examples
fr	#### Exemples

en-us	#### Examples
fr	#### Exemples

en-us	#### Examples
fr	#### Exemples

en-us	#### Examples
fr	#### Exemples

en-us	#### Examples
fr	#### Exemples

en-us	#### - Examples and dealing with errors  To get a warning when you are about to run out of free disk space on your host you may use a trigger expression like this:      timeleft(/host/vfs.fs.size[/,free],1h,0)}<1h  However, error code -1 may come into play and put your trigger in a problem state. Generally it's good because you get a warning that your predictions don't work correctly and you should look at them more thoroughly to find out why. But sometimes it's bad because -1 can simply mean that there was no data about the host free disk space obtained in the last hour. If you are getting too many false positive alerts consider using more complicated trigger expression [^5]:      timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1  The situation is a bit more difficult with **forecast**. First of all, -1 may or may not put the trigger in a problem state depending on whether you have expression like `forecast(/host/item,(...))<...` or like `forecast(/host/item,(...))>...`  Furthermore, -1 may be a valid forecast if it's normal for the item value to be negative. But probability of this situation in the real world situation is negligible (see [how](/manual/config/triggers/expression) the operator **=** works). So add `... or forecast(/host/item,(...))=-1` or `... and forecast(/host/item,(...))<>-1` if you want or don't want to treat -1 as a problem respectively.  [^1]: For example, a simple trigger like     `timeleft(/host/item,1h,X) < 1h` may go into problem state when the     item value approaches X and then suddenly recover once value X is     reached. If the problem is item value being below X use:     `last(/host/item) < X or timeleft(/host/item,1h,X) < 1h` If the     problem is item value being above X use:     `last(/host/item) > X or timeleft(/host/item,1h,X) < 1h`  [^2]: Polynomial degree can be from 1 to 6, *polynomial1* is equivalent     to *linear*. However, use higher degree polynomials [with     caution](https://en.wikipedia.org/wiki/Runge's_phenomenon). If the     evaluation period contains less points than needed to determine     polynomial coefficients, polynomial degree will be lowered (e.g     *polynomial5* is requested, but there are only 4 points, therefore     *polynomial3* will be fitted).  [^3]: For example fitting *exponential* or *power* functions involves     calculating log() of item values. If data contains zeros or negative     numbers you will get an error since log() is defined for positive     values only.  [^4]: For *linear*, *exponential*, *logarithmic* and *power* fits all     necessary calculations can be written explicitly. For *polynomial*     only *value* can be calculated without any additional steps.     Calculating *avg* involves computing polynomial antiderivative     (analytically). Computing *max*, *min* and *delta* involves     computing polynomial derivative (analytically) and finding its roots     (numerically). Solving f(t) = 0 involves finding polynomial roots     (numerically).  [^5]: But in this case -1 can cause your trigger to recover from the     problem state. To be fully protected use:     `timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and ({TRIGGER.VALUE}=0 and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 or {TRIGGER.VALUE}=1)`
fr	 #### - Exemples et traitement des erreurs  Pour recevoir un avertissement lorsque vous êtes sur le point de manquer d'espace disque libre sur votre hôte, vous pouvez utiliser une expression de déclenchement comme celle-ci :      timeleft(/host/vfs.fs.size[/,free],1h,0)}<1h  Cependant, le code d'erreur -1 peut entrer en jeu et mettre votre déclencheur dans un état problématique. En général, c'est bien parce que vous recevez un avertissement indiquant que vos prédictions ne fonctionnent pas correctement et vous devriez les examiner plus en détail pour savoir pourquoi. Mais parfois, cela peut être problématique parce que -1 peut simplement signifier qu'il n'y avait pas de données sur l'espace disque libre de l'hôte obtenu au cours de la dernière heure. Si vous recevez trop de fausses alertes positives, envisagez d'utiliser une expression de déclencheur plus complexe [^5] :      timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1  La situation est un peu plus difficile avec **forecast**. Tout d'abord, -1 peut ou non mettre le déclencheur dans un état problématique selon que vous avez ou non une expression comme `forecast(/host/item,(...))<...` ou comme`forecast(/host/item,(...))>...`  De plus, -1 peut être une prévision valide s'il est normal que la valeur de l'élément soit négative. Mais la probabilité de cette situation dans une situation réelle est négligeable (voir [comment](/manual/config/triggers/expression) l'opérateur **=** fonctionne). Donc, ajoutez `... or forecast(/host/item,(...))=-1` ou `... and forecast(/host/item,(...))<>-1` respectivement si vous voulez ou ne voulez pas traiter -1 comme un problème.  [^1]: Par exemple, un déclencheur simple comme `timeleft(/host/item,1h,X) < 1h` peut entrer dans un état problématique lorsque la valeur de l'élément approche de X, puis se rétablir soudainement une fois la valeur X atteinte. Si le problème est que la valeur de l'élément est inférieure à X, utilisez : `last(/host/item) < X or timeleft(/host/item,1h,X) < 1h`. Si le problème est que la valeur de l'élément est supérieure à X, utilisez : `last(/host/item) > X or timeleft(/host/item,1h,X) < 1h`  [^2]: Le degré polynomial peut être compris entre 1 et 6, *polynomial1* est équivalent à *linéaire*. Cependant, utilisez des polynômes de degré supérieur [avec prudence](https://en.wikipedia.org/wiki/Runge's_phenomenon). Si la période d'évaluation contient moins de points que nécessaire pour déterminer les coefficients polynomiaux, le degré polynomial sera abaissé (par exemple, *polynôme5* est demandé, mais il n'y a que 4 points, donc *polynôme3* sera ajusté).  [^3]: Par exemple, l'ajustement des fonctions *exponential* ou *power* implique le calcul de log() des valeurs des éléments. Si les données contiennent des zéros ou des nombres négatifs, vous obtiendrez une erreur car log() est défini uniquement pour les valeurs positives.  [^4]: Pour les ajustements *linear*, *exponential*, *logarithmic* et *power*, tous les calculs nécessaires peuvent être écrits explicitement. Pour *polynomial*, seule la *value* peut être calculée sans aucune étape supplémentaire. Le calcul de *avg* implique le calcul de la primitive polynomiale (analytiquement). Calculer *max*, *min* et *delta* implique de calculer la dérivée polynomiale (analytiquement) et de trouver ses racines (numériquement). Résoudre f(t) = 0 implique de trouver des racines polynomiales (numériquement).  [^5]: Mais dans ce cas, -1 peut entraîner la récupération de votre déclencheur à partir de l'état du problème. Pour être entièrement protégé, utilisez :`timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and ({TRIGGER.VALUE}=0 and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 or {TRIGGER.VALUE}=1)`

en-us	#### Examples  **Example 1**      # git checkout 6.0     # docker-compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d  The command will download latest Zabbix 6.0 images for each Zabbix component and run them in detach mode.  ::: noteimportant Do not forget to download `.env_<type of component>` files from github.com official Zabbix repository with compose files. :::  **Example 2**      # git checkout 6.0     # docker-compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d  The command will download base image Ubuntu 20.04 (focal), then build Zabbix 6.0 components locally and run them in detach mode.
fr	#### Exemples  **Exemple 1**      # git checkout 6.0     # docker-compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d  La commande téléchargera les dernières images Zabbix 6.0 pour chaque composant Zabbix et les exécutera en mode détaché.  ::: noteimportant N'oubliez pas de télécharger les fichiers `.env_<type de composant>` depuis le référentiel officiel Zabbix de github.com avec les fichiers compose. :::  **Exemple 2**      # git checkout 6.0     # docker-compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d  La commande téléchargera l'image de base Ubuntu 20.04 (focal), puis construira les composants Zabbix 5.4 localement et les exécutera en mode détaché.

en-us	#### Examples  Examples here illustrate how you can use macros in messages.
fr	#### Exemples  Les exemples illustrent ici comment vous pouvez utiliser des macros dans les messages.

en-us	#### Examples  Examples of [global scripts](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) that may be used as remote commands in action operations.
fr	#### Exemples  Exemples de [scripts globaux](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) pouvant être utilisés comme commandes distantes dans les opérations d'action.

en-us	#### Examples  Here are some code snippets showing how to add Zabbix protocol header to the data you want to send in order  to obtain the packet you should send to Zabbix so that it is interpreted correctly. These code snippets  assume that the data is not larger than 1GB, thus the large packet format is not used.  ##### Python    ```python packet = b"ZBXD\1" + struct.pack("<II", len(data), 0) + data ```  or  ```python def zbx_create_header(plain_data_size, compressed_data_size=None):     protocol = b"ZBXD"     flags = 0x01     if compressed_data_size is None:         datalen = plain_data_size         reserved = 0     else:         flags |= 0x02         datalen = compressed_data_size         reserved = plain_data_size     return protocol + struct.pack("<BII", flags, datalen, reserved)  packet = zbx_create_header(len(data)) + data ```  ##### Perl  ```perl my $packet = "ZBXD\1" . pack("(II)<", length($data), 0) . $data; ```  or  ```perl sub zbx_create_header($;$) {     my $plain_data_size = shift;     my $compressed_data_size = shift;      my $protocol = "ZBXD";     my $flags = 0x01;     my $datalen;     my $reserved;      if (!defined($compressed_data_size))     {         $datalen = $plain_data_size;         $reserved = 0;     }     else     {         $flags |= 0x02;         $datalen = $compressed_data_size;         $reserved = $plain_data_size;     }      return $protocol . chr($flags) . pack("(II)<", $datalen, $reserved); }  my $packet = zbx_create_header(length($data)) . $data; ```  ##### PHP  ```php $packet = "ZBXD\1" . pack("VV", strlen($data), 0) . $data; ```  or  ```php function zbx_create_header($plain_data_size, $compressed_data_size = null) {     $protocol = "ZBXD";     $flags = 0x01;     if (is_null($compressed_data_size))     {         $datalen = $plain_data_size;         $reserved = 0;     }     else     {         $flags |= 0x02;         $datalen = $compressed_data_size;         $reserved = $plain_data_size;     }     return $protocol . chr($flags) . pack("VV", $datalen, $reserved); }  $packet = zbx_create_header(strlen($data)) . $data; ```  ##### Bash    ```bash datalen=$(printf "%08x" ${#data}) datalen="\\x${datalen:6:2}\\x${datalen:4:2}\\x${datalen:2:2}\\x${datalen:0:2}" printf "ZBXD\1${datalen}\0\0\0\0%s" "$data" ```
fr	#### Exemples  Voici quelques extraits de code montrant comment ajouter un en-tête de protocole Zabbix aux données que vous souhaitez envoyer dans l'ordre pour obtenir le paquet que vous devez envoyer à Zabbix afin qu'il soit interprété correctement. Ces extraits de code supposent que les données ne dépassent pas 1 Go, le format de gros paquets n'est donc pas utilisé.  #####Python    ```python packet = b"ZBXD\1" + struct.pack("<II", len(data), 0) + data ```  ou  ```python def zbx_create_header(plain_data_size, compressed_data_size=None):     protocol = b"ZBXD"     flags = 0x01     if compressed_data_size is None:         datalen = plain_data_size         reserved = 0     else:         flags |= 0x02         datalen = compressed_data_size         reserved = plain_data_size     return protocol + struct.pack("<BII", flags, datalen, reserved)  packet = zbx_create_header(len(data)) + data ```  ##### Perl  ```perl my $packet = "ZBXD\1" . pack("(II)<", length($data), 0) . $data; ```  ou  ```perl sub zbx_create_header($;$) {     my $plain_data_size = shift;     my $compressed_data_size = shift;      my $protocol = "ZBXD";     my $flags = 0x01;     my $datalen;     my $reserved;      if (!defined($compressed_data_size))     {         $datalen = $plain_data_size;         $reserved = 0;     }     else     {         $flags |= 0x02;         $datalen = $compressed_data_size;         $reserved = $plain_data_size;     }      return $protocol . chr($flags) . pack("(II)<", $datalen, $reserved); }  my $packet = zbx_create_header(length($data)) . $data; ```  ##### PHP  ```php $packet = "ZBXD\1" . pack("VV", strlen($data), 0) . $data; ```  ou  ```php function zbx_create_header($plain_data_size, $compressed_data_size = null) {     $protocol = "ZBXD";     $flags = 0x01;     if (is_null($compressed_data_size))     {         $datalen = $plain_data_size;         $reserved = 0;     }     else     {         $flags |= 0x02;         $datalen = $compressed_data_size;         $reserved = $plain_data_size;     }     return $protocol . chr($flags) . pack("VV", $datalen, $reserved); }  $packet = zbx_create_header(strlen($data)) . $data; ```  ##### Bash    ```bash datalen=$(printf "%08x" ${#data}) datalen="\\x${datalen:6:2}\\x${datalen:4:2}\\x${datalen:2:2}\\x${datalen:0:2}" printf "ZBXD\1${datalen}\0\0\0\0%s" "$data" ```

en-us	##### Examples  Numeric (unsigned) value:      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3}  Numeric (float) value:      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0}  Character, text value:      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}  Log value:      {"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2}
fr	##### Exemples  Valeur numérique (non signée) :      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3}  Valeur numérique (float) :      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0}  Valeur textuelle ou caractère :      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}  Valeur de log :      {"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2}

en-us	##### Examples  Numeric (unsigned) value:      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}  Numeric (float) value:      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}
fr	##### Exemples  Valeur numérique (non signée) :      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}  Valeur numérique (float) :      {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}

en-us	 ##### Examples of correct/incorrect syntax  Expressions (including function calls) cannot be used as history, trend, or foreach [function](/manual/appendix/functions) parameters. However, those functions themselves can be used in other (non-historical) function parameters.  |Expression|Example| |-|---------| |Valid|`avg(last(/host/key1),last(/host/key2)*10,last(/host/key1)*100)`<br>`max(avg(avg_foreach(/*/system.cpu.load?[group="Servers A"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers B"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers C"],5m)))`| |Invalid|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host/key2))`|  Note that in an expression like:      sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m))  it cannot be guaranteed that both parts of the equation will always have the same set of values.  While one part of the expression is evaluated, a new value for the requested period may arrive and  then the other part of the expression will have a different set of values.
fr	##### Exemples de syntaxe correcte/incorrecte  Les expressions (y compris les appels de fonction) ne peuvent pas être utilisées comme paramètres d'historique, de tendance ou de la [fonction](/manual/appendix/functions) foreach. Cependant, ces fonctions elles-mêmes peuvent être utilisées dans d'autres paramètres de fonction (non historiques).  |Expression|Exemple| |-|---------| |Valide|`avg(last(/host/key1),last(/host/key2)*10,last(/host/key1)*100)`<br>`max(avg(avg_foreach(/*/system.cpu.load?[group="Servers A"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers B"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers C"],5m)))`| |Invalide|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host/key2))`|  Notez que dans une expression comme :      sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m))  il ne peut être garanti que les deux parties de l'équation auront toujours le même ensemble de valeurs. Pendant qu'une partie de l'expression est évaluée, une nouvelle valeur pour la période demandée peut arriver, puis l'autre partie de l'expression aura un ensemble de valeurs différent.

en-us	#### Examples of hardware configuration  The table provides examples of hardware configuration, assuming a **Linux/BSD/Unix** platform.  These are size and hardware configuration examples to start with. Each Zabbix installation is unique.  Make sure to benchmark the performance of your Zabbix system in a staging or development environment,  so that you can fully understand your requirements before deploying the Zabbix installation to its  production environment.  |Installation size|Monitored metrics^**1**^|CPU/vCPU cores|Memory<br>(GiB)|Database|Amazon EC2^**2**^| |-|-|-|-|-|-| |Small|1 000|2|8|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.large/m6g.large| |Medium|10 000|4|16|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.xlarge/m6g.xlarge| |Large|100 000|16|64|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.4xlarge/m6g.4xlarge| |Very large|1 000 000|32|96|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.8xlarge/m6g.8xlarge|  ^**1**^ 1 metric = 1 item + 1 trigger + 1 graph<br> ^**2**^ Example with Amazon general purpose EC2 instances, using ARM64 or x86_64 architecture, a  proper instance type like Compute/Memory/Storage optimised should be selected during Zabbix  installation evaluation and testing before installing in its production environment.  ::: noteclassic Actual configuration depends on the number of active items and refresh rates very much (see [database size](/manual/installation/requirements#Database_size) section of this page for details). It is highly recommended to run the database on a separate box for large installations. :::
fr	 #### Exemples de configuration matérielle  Le tableau fournit des exemples de configuration matérielle, en supposant une plate-forme **Linux/BSD/Unix**.  Ce sont des exemples de taille et de configuration matérielle pour commencer. Chaque installation Zabbix est unique. Assurez-vous de comparer les performances de votre système Zabbix dans un environnement de test ou de développement, afin de bien comprendre vos besoins avant de déployer l'installation de Zabbix dans son environnement de production.  |Taille de l'installation|Métriques surveillées^**1**^|Cœurs de CPU/vCPU|Mémoire<br>(Gio)|Base de données|Amazon EC2^**2**^| |-|-|-|-|-|-| |Petite|1 000|2|8|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.large/m6g.large| |Moyenne|10 000|4|16|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.xlarge/m6g.xlarge| |Grande|100 000|16|64|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.4xlarge/m6g.4xlarge| |Très grande|1 000 000|32|96|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.8xlarge/m6g.8xlarge|  ^**1**^ 1 métrique = 1 élément + 1 déclencheur + 1 graphique<br> ^**2**^ Exemple avec des instances EC2 à usage général d'Amazon, utilisant l'architecture ARM64 ou x86_64, un type d'instance approprié tel que Calcul/Mémoire/Storage optimisé doit être sélectionné lors de l'évaluation et des tests d'installation de Zabbix avant l'installation dans son environnement de production.  ::: noteclassic La configuration réelle dépend beaucoup du nombre d'éléments actifs et des taux de rafraîchissement (voir la section [taille de la base de données](/manual/installation/requirements#Database_size) de cette page pour plus de détails). Il est fortement recommandé d'exécuter la base de données sur un serveur séparé pour les grandes installations. :::