fr:manual:appendix:triggers:functions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
fr:manual:appendix:triggers:functions [2018/06/07 14:21]
127.0.0.1 external edit
fr:manual:appendix:triggers:functions [2019/03/26 13:15] (current)
daudet
Line 1: Line 1:
-==== 1 Supported trigger functions ​====+==== 1 Fonctions de déclencheur supportées ​====
  
-All functions supported in [[:​manual/​config/​triggers/​expression|trigger ​expressions]] ​are listed here.+Toutes les fonctions supportées dans les [[fr:​manual/​config/​triggers/​expression|expressions ​de déclencheur]] sont listées ici.
  
-FUNCTION ​ ​^^^^ +FONCTION ​ ​^^^^ 
-^ ^  **Description** ​ ^  **Parameters**  ^  **Comments**  ^+^ ^  **Description** ​ ^  **Paramètres**  ^  **Commentaires**  ^
 |**abschange** ​ ^^^^ |**abschange** ​ ^^^^
-^ |The amount of absolute difference between last and previous values.  |  |Supported value typesfloat, int, str, text, log\\ \\ For example:\\ (previous value;last value=abschange)\\ 1;5=4\\ 3;1=2\\ 0;​-2.5=2.5\\ \\ For strings returns:\\ 0 - values are equal\\ 1 - values differ ​ |+^ |La différence absolue entre la dernière valeur et les valeurs précédentes.  |  |Types de valeurs supportés ​flottant, int, str, text, log\\ \\ Par exemple ​:\\ (valeur précédente;dernière valeur=abschange)\\ 1;5=4\\ 3;1=2\\ 0;​-2.5=2.5\\ \\ Pour les chaînes renvoie ​: \\ 0 - les valeurs sont égales\\ 1 - les valeurs diffèrent ​ |
 ^ |||| ^ ||||
 |**avg** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^ |**avg** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^
-^ |Average value of an item within the defined evaluation period.  |**sec** ​or **#num** - evaluation period in seconds or in latest collected values ​(preceded by a hash mark)\\ **time_shift** (optional) - evaluation ​point is moved the number of seconds back in time  |Supported value typesfloat, int\\ \\ Examples:\\ => avg(#5) -> average value for the five latest values\\ => avg(1h) -> average value for an hour\\ => avg(1h,1d) -> average value for an hour one day ago.\\ \\ The ''​time_shift'' ​parameter is supported since Zabbix 1.8.2. ​It is useful when there is need to compare the current average value with the average value time_shift ​seconds back.  |+^ |Valeur moyenne d'un élément au cours de la période d'​évaluation définie.  |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées ​(précédée d'un signe dièse)\\ **time_shift** (optionnel) - le point d'​évaluation est déplacé du nombre de secondes dans le temps  |Types de valeurs supportés ​flottant, int\\ \\ Exemples ​:\\ => avg(#5) -> valeur moyenne pour les 5 dernières valeurs\\ => avg(1h) -> valeur moyenne pour une heure\\ => avg(1h,1d) -> valeur moyenne pour une heure il y a 1 jour.\\ \\ Le paramètre ​''​time_shift'' ​est supporté depuis ​Zabbix 1.8.2. ​C'est utile lorsqu'​il est nécessaire de comparer la valeur moyenne actuelle avec la valeur moyenne d'il y a time_shift ​secondes.  |
 ^ |||| ^ ||||
-|**band** (sec<​nowiki>​|</​nowiki>#​num,​mask,<​time_shift>​) ​ ^^^^ +|**band** (<sec<​nowiki>​|</​nowiki>#​num>,​mask,<​time_shift>​) ​ ^^^^ 
-^ |Value of "bitwise AND" ​of an item value and mask.  |**sec** (ignoredor **#num** - the Nth most recent value\\ **mask** (mandatory) - 64-bit ​unsigned integer ​(0 - 18446744073709551615)\\ **time_shift** (optional) - see avg()  |Supported value types: int\\ \\ Take note that ''#​num'' ​works differently here than with many other functions ​(see last()).\\ \\ Although the comparison is done in a bitwise mannerall the values must be supplied and are returned in decimalFor examplechecking for the 3rd bit is done by comparing to 4, not 100.\\ \\ Examples:\\ => %%band(,​12)=8 ​or band(,​12)=4%% -> 3rd or 4th bit setbut not both at the same time\\ => %%band(,​20)=16%% -> 3rd bit not set and 5th bit set.\\ \\ This function is supported since Zabbix 2.2.0. ​ |+^ |Valeur de "ET binaire" ​d'une valeur d'​élément et d'un masque.  |**sec** (ignoré, égal #1ou **#​num** ​(optionnel) ​la Nième valeur plus récente\\ **mask** (obligatoire) - entier non signé ​64-bit (0 - 18446744073709551615)\\ **time_shift** (optionnel) - voir avg()  |Types de valeurs supportés ​: int\\ \\ Notez que ''#​num'' ​fonctionne différemment ici par rapport à beaucoup d'​autres fonction ​(voir last()).\\ \\ Bien que la comparaison se fasse au niveau du bittoutes les valeurs doivent être fournies et sont retournées en décimalPar exemplela vérification du troisième ​bit est effectuée en comparant à et non à 100.\\ \\ Exemples ​:\\ => %%band(,​12)=8 ​ou band(,​12)=4%% -> 3ième ou 4ième ​bit définimais pas les deux en même temps\\ => %%band(,​20)=16%% -> 3ème bit non activé et 5ème bit activé. \\ \\ Cette fonction est supportée depuis ​Zabbix 2.2.0. ​ |
 ^ |||| ^ ||||
 |**change** ​ ^^^^ |**change** ​ ^^^^
-^ |The amount of difference between last and previous values.  |  |Supported value typesfloat, int, str, text, log\\ \\ For example:\\ (previous value;last value=change)\\ 1;5=+4\\ 3;1=-2\\ 0;​-2.5=-2.5\\ \\ See also: [[:​manual/​appendix/​triggers/​functions|abschange]] ​for comparison\\ \\ For strings returns:\\ 0 - values are equal\\ 1 - values differ ​ |+^ |La différence entre la dernière valeur et les valeurs précédentes.  |  |Types de valeurs supportés ​flottant, int, str, text, log\\ \\ Par exemple ​:\\ (valeur précédente;dernière valeur=change)\\ 1;5=+4\\ 3;1=-2\\ 0;​-2.5=-2.5\\ \\ Voir aussi : [[fr:​manual/​appendix/​triggers/​functions|abschange]] ​pour comparaison\\ \\ Pour les chaînes retourne ​:\\ 0 - les valeurs sont égales\\ 1 - les valeurs diffèrent ​ |
 ^ |||| ^ ||||
 |**count** (sec<​nowiki>​|</​nowiki>#​num,<​pattern>,<​operator>,<​time_shift>​) ​ ^^^^ |**count** (sec<​nowiki>​|</​nowiki>#​num,<​pattern>,<​operator>,<​time_shift>​) ​ ^^^^
-^ |Number of values within the defined evaluation period.  |**sec** ​or **#num** - evaluation period in seconds or in latest collected values ​(preceded by a hash mark)\\ **pattern** (optional) - required pattern\\ \\ **operator** (optional)\\ \\ Supported ​''​operators'':​\\ //eq// - equal\\ //ne// - not equal\\ //gt// - greater\\ //ge// - greater or equal\\ //lt// - less\\ //le// - less or equal\\ //like// - matches if contains pattern ​(case-sensitive)\\ //band// - bitwise AND\\ //regexp// - case sensitive match of regular ​expression ​given in ''​pattern''​\\ //iregexp// - case insensitive match of regular ​expression ​given in ''​pattern''​\\ \\ Note that:\\ //eq// (default), //ne//, //gt//, //ge//, //lt//, //le//, //band//, //regexp//, //​iregexp// ​are supported for integer items\\ //eq// (default), //ne//, //gt//, //ge//, //lt//, //le//, //regexp//, //​iregexp// ​are supported for float items\\ //like// (default), //eq//, //ne//, //regexp//, //​iregexp// ​are supported for stringtext and log items\\ \\ **time_shift** (optional) - see avg()  |Supported value typesfloatintegerstringtext, log\\ Float items match with the precision of 0.000001.\\ \\ With //​band// ​as third parameterthe second ''​pattern'' ​parameter can be specified as two numbersseparated by  ​'/':​ **number_to_compare_with/mask**. count() ​calculates ​"bitwise AND" ​from the value and the //mask// and compares the result to //number_to_compare_with//. If the result of "bitwise AND" ​is equal to //number_to_compare_with//, the value is counted.\\ If //number_to_compare_with// and //mask// are equalonly the //mask// need be specified ​(without ​'/'​).\\ \\ With //​regexp// ​or //​iregexp// ​as third parameter the second ''​pattern'' ​parameter can be an ordinary or [[:​manual/​regular_expressions#​global_regular_expressions|global]] (starting with '​@'​) ​regular expressionIn case of global regular ​expressions ​case sensitivity is inherited from global regular expression settingsFor the purpose of regexp matchingfloat values will always be represented with decimal digits after '​.'​. ​Also note that for large numbers difference in decimal ​(stored in databaseand binary ​(used by Zabbix ​serverrepresentation may affect the 4th decimal digit. \\ \\ Examples:\\ => count(10m) -> number of values for last 10 minutes\\ => %%count(10m,"​error",​eq)%% -> number of values for last 10 minutes ​that equal '​error'​\\ => count(10m,​12) -> number of values for last 10 minutes ​that equal '​12'​\\ => %%count(10m,​12,​gt)%% -> number of values for last 10 minutes ​that are over '​12'​\\ => %%count(#​10,​12,​gt)%% -> number of values within last 10 values that are over '​12'​\\ => %%count(10m,​12,​gt,​1d)%% -> number of values for preceding ​10 minutes ​up to 24 hours ago that were over '​12'​\\ => %%count(10m,​6/​7,​band)%% -> number of values for last 10 minutes ​having ​'​110'​ (in binaryin the least significant ​bits.\\ => count(10m,,,​1d) -> number of values for preceding ​10 minutes ​up to 24 hours ago\\ \\ The ''#​num'' ​parameter is supported since Zabbix 1.6.1.\\ ​The ''​time_shift'' ​parameter and string operators are supported since Zabbix 1.8.2.\\ ​The //​band// ​operator is supported since Zabbix 2.2.0.\\ ​The //regexp//, //​iregexp// ​operators are supported since Zabbix 3.2.0. ​ |+^ |Nombre de valeurs dans la période d'​évaluation définie.  |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées ​(précédée d'un signe dièse) \\ **pattern** (optionnel) - motif requis ​\\ \\ **operator** (optionnel)\\ \\ ''​Operators'' ​supportés ​:\\ //eq// - égal\\ //ne// - non égal\\ //gt// - supérieur que\\ //ge// - supérieur ou égal\\ //lt// - inférieur\\ //le// - inférieur ou égal\\ //like// - correspond si contient un motif (sensible à la casse) \\ //band// - ET binaire\\ //regexp// - correspondance sensible à la casse d'​une ​expression ​régulière donnée dans ''​pattern''​\\ //iregexp// - correspondance (non sensible à la casse) de l'expression ​régulière donnée dans ''​pattern''​\\ \\ Notez que :\\ //eq// (défaut), //ne//, //gt//, //ge//, //lt//, //le//, //band//, //regexp//, //​iregexp// ​sont supportés pour les éléments entier\\ //eq// (défaut), //ne//, //gt//, //ge//, //lt//, //le//, //regexp//, //​iregexp// ​sont supportés pour les éléments flottants\\ //like// (défaut), //eq//, //ne//, //regexp//, //​iregexp// ​sont supportés pour les éléments chaînestexte et log\\ \\ **time_shift** (optionnel) - voir avg()  |Types de valeurs supportés ​flottantentierchaînetexte, log\\ Les éléments flottants correspondent avec une précision de 0.000001.\\ \\ Avec //​band// ​comme troisième paramètrele second ​paramètre ​''​pattern'' ​peut être spécifié comme deux nombresséparé par '/'​ : **nombre_à_comparer/masque**. count() ​calcule ​"ET binaire" ​depuis la valeur et le //masque// et compare le resultat à //nombre_à_comparer//. Si le résultat du "ET binaire" ​est égale au //nombre_à_comparer//, la valeur est comptabilisée.\\ Si //nombre_à_comparer// et le //masque// sont égauxseul le //masque// doit être spécifié ​(sans '/'​).\\ \\ Avec //​regexp// ​ou //​iregexp// ​comme troisième paramètre, le second ​paramètre ​''​pattern'' ​peut être une expression régulière normale ou [[fr:​manual/​regular_expressions#​expressions_regulieres_globales|globale]] (commençant par '​@'​). ​En cas d'expressions ​régulières globales, la sensibilité à la casse est héritée des paramètres globaux d'​expressions régulièresDans le but de faire correspondre les expressions régulièresles valeurs flottantes seront toujours représentées avec chiffres après la virgule après le signe '​.'​. ​Notez également que pour les grands nombres, la différence de représentation décimale ​(stockée dans la base de donnéeset binaire ​(utilisée par le serveur ​Zabbix) ​peut affecter le 4ème chiffre décimal \\ \\ Exemples ​:\\ => count(10m) -> nombre de valeurs pour les 10 dernières ​minutes\\ => %%count(10m,"​error",​eq)%% -> nombre de valeurs pour les 10 dernières ​minutes ​qui sont égales à '​error'​\\ => count(10m,​12) -> nombre de valeurs pour les 10 dernières ​minutes ​qui sont égales à '​12'​\\ => %%count(10m,​12,​gt)%% -> nombre de valeurs pour les 10 dernières ​minutes ​qui sont supérieures à '​12'​\\ => %%count(#​10,​12,​gt)%% -> nombre de valeurs sur les 10 dernières valeurs qui sont supérieures à  ​'​12'​\\ => %%count(10m,​12,​gt,​1d)%% -> nombre de valeurs pour les 10 dernières ​minutes ​24h avant maintenant qui sont supérieures à '​12'​\\ => %%count(10m,​6/​7,​band)%% -> nombre de valeurs des 10 dernières ​minutes ​ayant '​110'​ (en binairedans les 3 bits de poids le plus faible. \\ => count(10m,,,​1d) -> nombre de valeurs pour les 10 minutes ​précédentes jusqu'​à ​24 heures ​\\ \\ Le paramètre ​''#​num'' ​est supporté depuis ​Zabbix 1.6.1.\\ ​Le paramètre ​''​time_shift'' ​et les opérateurs de chaîne sont supportés depuis ​Zabbix 1.8.2.\\ ​L'​opérateur ​//​band// ​est supporté depuis ​Zabbix 2.2.0.\\ ​Les opérateurs ​//regexp//, //​iregexp// ​sont supportés depuis ​Zabbix 3.2.0. ​ |
 ^ |||| ^ ||||
 |**date** ​ ^^^^ |**date** ​ ^^^^
-^ |Current date in YYYYMMDD ​format. ​ |  |Supported value types: //any//\\ \\ Example of returned value: 20150731 ​  |+^ |Date actuelle au format ​YYYYMMDD.  |  |Types de valeurs supportés ​: //any//\\ \\ Exemple de valeur retournée ​: 20150731 ​  |
 ^ |||| ^ ||||
 |**dayofmonth** ​ ^^^^ |**dayofmonth** ​ ^^^^
-^ |Day of month in range of to 31.  |  |Supported value types: //any//\\ \\ This function is supported since Zabbix 1.8.5. ​ |+^ |Jour du mois compris entre et 31.  |  |Types de valeurs supportés ​: //any//\\ \\ Cette fonction est supportée depuis ​Zabbix 1.8.5. ​ |
 ^ |||| ^ ||||
 |**dayofweek** ​ ^^^^ |**dayofweek** ​ ^^^^
-^ |Day of week in range of to 7 (Mon - 1, Sun - 7).  |  |Supported value types: //​any// ​ |+^ |Jour de le semaine compris entre et 7 (Mon - 1, Sun - 7).  |  |Types de valeurs supportés ​: //​any// ​ |
 ^ |||| ^ ||||
 |**delta** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^ |**delta** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^
-^ |Difference between the maximum and minimum values within the defined evaluation period ​('​max()' ​minus '​min()'​). ​ |**sec** ​or **#num** - evaluation period in seconds or in latest collected values specified ​(preceded by a hash mark)\\ **time_shift** (optional) - see avg()  |Supported value typesfloat, int\\ \\ The ''​time_shift'' ​parameter is supported since Zabbix 1.8.2. ​ |+^ |Différence entre les valeurs maximale et minimale dans la période d’évaluation définie ​('​max()' ​moins '​min()'​). ​ |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées spécifiées ​(précédées d'un signe dièse) \\ **time_shift** (optionnel) - voir avg()  |Types de valeurs supportés ​flottant, int\\ \\ Le paramètre ​''​time_shift'' ​est supporté depuis ​Zabbix 1.8.2. ​ |
 ^ |||| ^ ||||
 |**diff** ​ ^^^^ |**diff** ​ ^^^^
-^ |Checking if last and previous values differ.  |  |Supported value typesfloat, int, str, text, log\\ \\ Returns:\\ 1 - last and previous values differ\\ 0 - otherwise ​ |+^ |Vérifier si les dernières valeurs et les valeurs précédentes diffèrent.  |  |Types de valeurs supportés ​flottant, int, str, text, log\\ \\ Retourne ​:\\ 1 - la dernière valeur et la valeur précédente diffèrent\\ 0 - sinon  |
 ^ |||| ^ ||||
 |**forecast** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>,​time,<​fit>,<​mode>​) ^^^^ |**forecast** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>,​time,<​fit>,<​mode>​) ^^^^
-^ |Future value, max, min, delta or avg of the item.  |**sec** ​or **#num** - evaluation period in seconds or in latest collected values specified ​(preceded by a hash mark)\\ **time_shift** (optional) - see avg()\\ **time** - forecasting ​horizon ​in seconds\\ **fit** (optional) - function used to fit historical data\\ \\ Supported ​''​fits'':​\\ //linear// - linear function\\ //​polynomialN//​ - polynomial ​of degree ​N (1 <​nowiki><​=</​nowiki>​ N <​nowiki><​=</​nowiki>​ 6)\\ //exponential// - exponential function\\ //logarithmic// - logarithmic function\\ //power// - power function\\ \\ Note that:\\ //linear// is default, //​polynomial1// ​is equivalent to //linear//\\ \\ **mode** (optional) - demanded output\\ \\ Supported ​''​modes'':​\\ //value// - value (default)\\ //max// - maximum\\ //min// - minimum\\ //delta// - //​max//​-//​min//​\\ //avg// - average\\ \\ Note that:\\ //value// estimates item value at the moment ''​now''​ + ''​time''​\\ //max//, //min//, //​delta// ​and //​avg// ​investigate item value estimate on the interval between ​''​now'' ​and ''​now''​ + ''​time'' ​ |Supported value typesfloat, int\\ \\ If value to return is larger than 999999999999.9999 ​or less than -999999999999.9999, ​return value is cropped to 999999999999.9999 ​or -999999999999.9999 ​correspondingly.\\ \\ Becomes not supported only if misused in expression (wrong item type, invalid parameters), otherwise returns ​-1 in case of errors.\\ \\ Examples:\\ => forecast(#​10,,​1h) -> forecast of item value after one hour based on last 10 values\\ => forecast(1h,,​30m) -> forecast of item value after 30 minutes ​based on last hour data\\ => forecast(1h,​1d,​12h) -> forecast of item after 12 hours based on one hour one day ago\\ => forecast(1h,,​10m,​exponential) -> forecast of item value after 10 minutes ​based on last hour data and exponential function\\ => forecast(1h,,​2h,​polynomial3,​max) -> forecast of maximum value item can reach in next two hours based on last hour data and cubic (third degreepolynomial\\ => forecast(#2,,-20m) -> estimate the value of an item which was 20 minutes ​ago based on last two values ​(this can be more precise than using last() ​or prev(), ​especially if item is updated rarelysayonce an hour)\\ \\ This function is supported since Zabbix 3.0.0.\\ ​Negative ​''​time''​​ ​values are supported since Zabbix 3.0.6 and 3.2.2.\\ ​See also additional information on [[:​manual/​config/​triggers/​prediction|predictive trigger functions]].  |+^ |Valeur future, max, min, delta ou avg de l'​élément.  |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées spécifiées ​(précédées d'un signe dièse)\\ **time_shift** (optionnel) - voir avg()\\ **time** - horizon ​de prévision en secondes\\ **fit** (optionnel) - fonction utilisée pour ajuster les données historiques ​\\ \\ Support de ''​fits''​ :\\ //linéaire// - fonction linéaire\\ //​polynomialN//​ - polynomial ​de degrés ​N (1 <​nowiki><​=</​nowiki>​ N <​nowiki><​=</​nowiki>​ 6)\\ //exponentiel// - fonction exponentielle ​\\ //logarithmique// - fonction logarithmique ​\\ //puissance// - fonction puissance\\ \\ Notez que :\\ //linéaire// est par défaut, //​polynomial1// ​est équivalent à //linéaire//\\ \\ **mode** (optionnel) - sortie demandée\\ \\ ''​modes'' ​supportés ​:\\ //valeur// - valeur ​(défaut)\\ //max// - maximum\\ //min// - minimum\\ //delta// - //​max//​-//​min//​\\ //avg// - moyenne\\ \\ Notez que :\\ la //valeur// de l'​élément est estimée au moment ''​now''​ + ''​time''​\\ //max//, //min//, //​delta// ​et //​avg// ​étudient l'​estimation de la valeur d'un élément dans l'​intervalle entre ''​now'' ​et ''​now''​ + ''​time'' ​ |Types de valeurs supportés ​flottant, int\\ \\ Si la valeur retournée est plus grande que  ​999999999999.9999 ​ou plus petite que -999999999999.9999, ​la valeur retournée sera rognée à 999999999999.9999 ​ou -999999999999.9999 ​en conséquence.\\ \\ Devient non supporté uniquement s'il est mal utilisé dans une expression (type d'​élement incorrectparamètres non valides), sinon renvoie ​-1 en cas d'​erreur.\\ \\ Exemples ​:\\ => forecast(#​10,,​1h) -> prévision de la valeur d'un élément après une heure basée sur les 10 dernières valeurs\\ => forecast(1h,,​30m) -> prévision de la valeur de l'​élément après ​30 minutes ​basée sur les données de la dernière heure \\ => forecast(1h,​1d,​12h) -> prévision de l'​élément après ​12 heures sur une heure il y a un jour \\ => forecast(1h,,​10m,​exponential) -> prévision de la valeur de l'​élément après ​10 minutes ​sur la base des données de la dernière heure et de la fonction exponentielle ​\\ => forecast(1h,,​2h,​polynomial3,​max) -> prévision de la valeur maximale que l'​élément peut atteindre dans les deux heures à venir en fonction des données de la dernière heure et du polynôme cubique ​(troisième degré) \\ => forecast(#​2,,​-20m) -> estimer la valeur d'un élément datant d'il y a 20 minutes ​en fonction des deux dernières valeurs ​(cela peut être plus précis que d'​utiliser ​last() ​ou prev(), ​surtout si l'​élément est mis à jour rarementpar exempleune fois par heure)\\ \\ Cette fonction est supportée depuis ​Zabbix 3.0.0.\\ ​Les valeurs négatives de ''​time''​ ​sont supportées depuis ​Zabbix 3.0.6 et 3.2.2.\\ ​Voir aussi les informations additionnelles sur les [[fr:​manual/​config/​triggers/​prediction|fonction de déclencheur prédictives]].  |
 ^ |||| ^ ||||
 |**fuzzytime** (sec) ^^^^ |**fuzzytime** (sec) ^^^^
-^ |Checking how much an item timestamp ​value differs from the Zabbix ​server time.  |**sec** - seconds ​ |Supported value typesfloat, int\\ \\ Returns:\\ if difference between item timestamp ​value and Zabbix server ​timestamp ​is over seconds\\ otherwise.\\ \\ Usually used with system.localtime ​to check that local time is in sync with local time of Zabbix ​server.\\ Can be used also with vfs.file.time[/​path/​file,​modify] ​key to check that file didn't get updates for long time.\\ \\ Example:\\ => fuzzytime(60)=0 -> detect a problem if time difference is over 60 seconds  ​|+^ |Vérification de la valeur d'un élément (son timestamp) par rapport à l'​heure du serveur ​Zabbix. ​ |**sec** - secondes ​ |Types de valeurs supportés ​flottant, int\\ \\ Retourne ​:\\ si la différence entre la valeur de l'​élément (son timestamp) et le timestamp ​du serveur Zabbix est inférieure ou égale à secondes ​\\ sinon.\\ \\ Habituellement utilisé avec l'​élément 'system.localtime' pour vérifier que l'​heure locale est synchronisée avec l'​heure locale du serveur ​Zabbix. //Notez// que '​system.localtime'​ ​doit être configuré comme [[fr:​manual:​appendix:​items:​activepassive#​verifications_passives|vérification passive]]. \\ Peut aussi être utilisé avec la clé vfs.file.time[/​path/​file,​modify] ​pour vérifier que le fichier n'a pas eu de mises à jour depuis longtemps.\\ \\ Exemple ​:\\ => fuzzytime(60)=0 -> détecte un problème si la différence de temps est supérieure à 60 secondes ​|
 ^ |||| ^ ||||
-|**iregexp** (pattern,<​sec<​nowiki>​|</​nowiki>#​num>​) ​ ^^^^ +|**iregexp** (<pattern>,<​sec<​nowiki>​|</​nowiki>#​num>​) ​ ^^^^ 
-^ |This function is a non case-sensitive analogue of regexp(). ​ |see regexp() ​ |Supported value types: str, log, text  |+^ |Cette fonction est identique à regexp() ​mais non sensible à la casse.  |voir regexp() ​ |Types de valeurs supportés ​: str, log, text  |
 ^ |||| ^ ||||
-|**last** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^ +|**last** (<sec<​nowiki>​|</​nowiki>#​num>,<​time_shift>​) ​ ^^^^ 
-^ |The most recent value.  |**sec** (ignoredor **#num** - the Nth most recent value\\ **time_shift** (optional) - see avg()  |Supported value typesfloat, int, str, text, log\\ \\ Take note that ''#​num'' ​works differently here than with many other functions.\\ For example:\\ last() ​is always equal to last(#1)\\ last(#3) - third most recent value (//not// three latest values)\\ \\ Zabbix ​does not guarantee ​exact order of values if more than two values exist within one second in history.\\ \\ The ''#​num'' ​parameter is supported since Zabbix 1.6.2.\\ ​The ''​time_shift'' ​parameter is supported since Zabbix 1.8.2. ​ |+^ |La valeur la plus récente.  |**sec** (ignoré, égal #1ou **#​num** ​(optionnel) ​la Nième valeur la plus récente ​\\ **time_shift** (optionnel) - voir avg()  |Types de valeurs supportés ​flottant, int, str, text, log\\ \\ Notez que ''#​num'' ​fonctionne différemment ici de beaucoup d'​autres fonctions.\\ Par exemple ​:\\ last() ​est toujours égal à last(#1)\\ last(#3) - troisième valeur la plus récente ​(et //non// trois dernières)\\ \\ Zabbix ​ne garantit pas l'​ordre ​exact des valeurs s'il existe plus de deux valeurs dans la seconde dans l'​historique.\\ \\ Le paramètre ​''#​num'' ​est supporté depuis ​Zabbix 1.6.2.\\ ​Le paramètre ​''​time_shift'' ​est supporté depuis ​Zabbix 1.8.2. ​ |
 ^ |||| ^ ||||
-|**logeventid** (pattern) ​ ^^^^ +|**logeventid** (<pattern>)  ^^^^ 
-^ |Checking if event ID of the last log entry matches a regular ​expression. ​ |**pattern** - regular ​expression ​describing the required pattern, [[https://​en.wikipedia.org/​wiki/​Perl_Compatible_Regular_Expressions|Perl Compatible Regular ​Expression]] (PCRE) ​style.  |Supported value types: log\\ \\ Returns:\\ 0 - does not match\\ 1 - matches\\ \\ This function is supported since Zabbix 1.8.5. ​ |+^ |Vérifier si l'ID d'​événement de la dernière entrée de journal correspond à une expression ​régulière.  |**pattern** ​(optionnel) ​- expression ​régulière décrivant le modèle requisstyle [[https://​en.wikipedia.org/​wiki/​Perl_Compatible_Regular_Expressions|Expression ​régulière compatible Perl]] (PCRE). ​ |Types de valeurs supportés ​: log\\ \\ Retourne ​:\\ 0 - ne correspond pas\\ 1 - correspond\\ \\ Cette fonction est supportée depuis ​Zabbix 1.8.5. ​ |
 ^ |||| ^ ||||
 |**logseverity** ​ ^^^^ |**logseverity** ​ ^^^^
-^ |Log severity of the last log entry.  |  |Supported value types: log\\ \\ Returns:\\ 0 - default severity\\ N - severity ​(integeruseful for Windows ​event logs: 1 - Information,​ 2 - Warning, 4 - Error, 7 - Failure ​Audit, 8 - Success ​Audit, 9 - Critical, 10 - Verbose).\\ Zabbix ​takes log severity from **Information** ​field of Windows ​event log.  |+^ |Consigner la gravité de la dernière entrée du journal.  |  |Types de valeurs supportés ​: log\\ \\ Retourne ​:\\ 0 - sévérité par défaut\\ N - sévérité ​(entierutile pour les journaux d'​événements ​Windows : 1 - Information,​ 2 - Avertissement, 4 - Erreur, 7 - Audit d'​échec, 8 - Audit de succès, 9 - Critique, 10 - Verbeux).\\ Zabbix ​prend la sévérité du journal du champs ​**Information** ​du journal des événements ​Windows. ​ |
 ^ |||| ^ ||||
-|**logsource** (pattern) ​ ^^^^ +|**logsource** (<pattern>)  ^^^^ 
-^ |Checking if log source ​of the last log entry matches parameter.  |**pattern** - required string ​ |Supported value types: log\\ \\ Returns:\\ 0 - does not match\\ 1 - matches\\ Normally used for Windows ​event logsFor example, %%logsource("​VMware Server"​)%%. ​ |+^ |Vérifier si la source ​de la dernière entrée du journal correspond à une expression régulière.  |**pattern** ​(optionnel) ​expression régulière décrivant le modèle requis, style  [[https://​en.wikipedia.org/​wiki/​Perl_Compatible_Regular_Expressions|Expression régulière compatible Perl]] (PCRE). ​ |Types de valeurs supportés ​: log\\ \\ Renvoie ​:\\ 0 - ne correspond pas\\ 1 - correspond\\ ​\\ Normalement utilisé pour les journaux d'​événements ​Windows. ​Par exemple, %%logsource("​VMware Server"​)%%. ​ |
 ^ |||| ^ ||||
 |**max** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^ |**max** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^
-^ |Highest value of an item within the defined evaluation period.  |**sec** ​or **#num** - evaluation period in seconds or in latest collected values ​(preceded by a hash mark)\\ **time_shift** (optional) - see avg()  |Supported value typesfloat, int\\ \\ The ''​time_shift'' ​parameter is supported since Zabbix 1.8.2. ​ |+^ |Valeur la plus élevée d'un élément dans la période d'​évaluation définie.  |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées ​(précédée d'un signe dièse) \\ **time_shift** (optionnel) - voir avg()  |Types de valeurs supportés ​flottant, int\\ \\ Le paramètre ​''​time_shift'' ​est supporté depuis ​Zabbix 1.8.2. ​ |
 ^ |||| ^ ||||
 |**min** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^ |**min** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^
-^ |Lowest value of an item within the defined evaluation period.  |**sec** ​or **#num** - evaluation period in seconds or in latest collected values ​(preceded by a hash mark)\\ **time_shift** (optional) - see avg()  |Supported value typesfloat, int\\ \\ The ''​time_shift'' ​parameter is supported since Zabbix 1.8.2. ​ |+^ |Valeur la plus basse d'un élément de la période d'​évaluation définie.  |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées ​(précédée d'un signe dièse) \\ **time_shift** (optionnel) - voir avg()  |Types de valeurs supportés ​flottant, int\\ \\ Le paramètre ​''​time_shift'' ​est supporté depuis ​Zabbix 1.8.2. ​ |
 ^ |||| ^ ||||
 |**nodata** (sec)  ^^^^ |**nodata** (sec)  ^^^^
-^ |Checking for no data received.  |**sec** - evaluation period in seconds.\\ The period should not be less than 30 seconds because the timer process calculates this function only every 30 seconds.\\ \\ nodata(0) ​is disallowed.  |Supported value types: //any//\\ \\ Returns:\\ 1 - if no data received during the defined period of time\\ 0 - otherwise\\ \\ Note that this function will display an error ifwithin the period of the 1st parameter:\\ - there's no data and Zabbix ​server was restarted\\ - there's no data and maintenance ​was completed\\ - there's no data and the item was added or re-enabled\\ Errors are displayed in the //​Info// ​column in trigger ​[[:​manual/​web_interface/​frontend_sections/​configuration/​hosts/​triggers|configuration]]. ​ |+^ |Vérification de l'​absence de données reçues.  |**sec** - période d'​évaluation en secondes.\\ La période ne doit pas être inférieure à 30 secondes car le processus de synchronisation de l'​historique calcule cette fonction uniquement toutes les 30 secondes.\\ \\ nodata(0) ​n'est pas autorisé.  |Types de valeurs supportés ​: //any//\\ \\ Retourne ​:\\ 1 - si aucune donnée n'est reçue pendant la période définie ​\\ 0 - sinon\\ \\ Notez que cette fonction affichera une erreur sidans la période du 1er paramètre ​: \\ - il n'y a pas de données et le serveur ​Zabbix ​a été redémarré ​\\ - il n'y a pas de données et la maintenance ​est terminée ​\\ - il n'y a pas de données et l'​élément a été ajouté ou réactivé ​\\ Les erreurs sont affichées dans la colonne ​//​Info// ​dans la [[fr:​manual/​web_interface/​frontend_sections/​configuration/​hosts/​triggers|configuration]] ​du déclencheur  ​|
 ^ |||| ^ ||||
 |**now** ​ ^^^^ |**now** ​ ^^^^
-^ |Number of seconds since the Epoch (00:00:00 UTC, January 1, 1970). ​ |  |Supported value types: //​any// ​ |+^ |Nombre de secondes depuis l'​époque ​(00:00:00 UTC, 1er janvier ​1970). ​ |  |Types de valeurs supportés ​: //​any// ​ |
 ^ |||| ^ ||||
 |**percentile** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>,​percentage) ​ ^^^^ |**percentile** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>,​percentage) ​ ^^^^
-^ |P-th percentile of a periodwhere P (percentageis specified by the third parameter |**sec** ​or **#num** - evaluation period in seconds or in latest collected values ​(preceded by a hash mark)\\ **time_shift** (optional) - see avg()\\ **percentage** - a floating-point number between ​and 100 (inclusivewith up to digits after the decimal ​point  |Supported value typesfloat, int\\ \\ This function is supported since Zabbix 3.0.0. ​ |+^ |P-ième centile d'une périodeoù P (pourcentageest spécifié par le troisième paramètre. |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées ​(précédée d'un signe dièse) \\ **time_shift** (optionnel) - voir avg()\\ **percentage** - un nombre à virgule flottante compris entre et 100 (inclusavec un maximum de chiffres après le point décimal ​|Types de valeurs supportés ​flottant, int\\ \\ Cette fonction est supportée depuis ​Zabbix 3.0.0. ​ |
 ^ |||| ^ ||||
 |**prev** ​ ^^^^ |**prev** ​ ^^^^
-^ |Previous value.  |  |Supported value typesfloat, int, str, text, log\\ \\ Returns the same as last(#​2). ​ |+^ |Valeur précédente.  |  |Types de valeurs supportés ​flottant, int, str, text, log\\ \\ Retourne la même chose que last(#​2). ​ |
 ^ |||| ^ ||||
-|**regexp** (pattern,<​sec<​nowiki>​|</​nowiki>#​num>​) ​ ^^^^ +|**regexp** (<pattern>,<​sec<​nowiki>​|</​nowiki>#​num>​) ​ ^^^^ 
-^ |Checking if the latest ​(most recentvalue matches regular ​expression. ​ |**pattern** - regular ​expression, [[https://​en.wikipedia.org/​wiki/​Perl_Compatible_Regular_Expressions|Perl Compatible Regular ​Expression]] (PCRE) ​style.\\ **sec** ​or **#num** (optional) - evaluation period in seconds or in latest collected values ​(preceded by a hash mark). In this casemore than one value may be processed.  |Supported value types: str, text, log\\ \\ Returns:\\ 1 - found\\ 0 - otherwise\\ \\ If more than one value is processed, '​1' ​is returned if there is at least one matching value.\\ \\ This function is case-sensitive.  |+^ |Vérifier si la dernière valeur ​(la plus récentecorrespond à l'expression ​régulière. |**pattern** ​(optionnel) ​- expression ​régulièrestyle [[https://​en.wikipedia.org/​wiki/​Perl_Compatible_Regular_Expressions|Expression ​régulière compatible Perl]] (PCRE).\\ **sec** ​ou **#num** (optionnel) - période d’évaluation en secondes ou dans les dernières valeurs collectées ​(précédée d’un signe dièse). Dans ce casplusieurs valeurs peuvent être traitées.  |Types de valeurs supportés ​: str, text, log\\ \\ Retourne ​:\\ 1 - trouvé\\ 0 - sinon\\ \\ Si plus d'une valeur est traitée, '​1' ​est renvoyé s'il existe au moins une valeur correspondante.\\ \\ Cette fonction est sensible à la casse.  |
 ^ |||| ^ ||||
-|**str** (pattern,<​sec<​nowiki>​|</​nowiki>#​num>​) ​ ^^^^ +|**str** (<pattern>,<​sec<​nowiki>​|</​nowiki>#​num>​) ​ ^^^^ 
-^ |Finding a string in the latest ​(most recentvalue.  |**pattern** - required string\\ **sec** ​or **#num** (optional) - evaluation period in seconds or in latest collected values ​(preceded by a hash mark).  In this casemore than one value may be processed. ​ |Supported value types: str, text, log\\ \\ Returns:\\ 1 - found\\ 0 - otherwise\\ \\ If more than one value is processed, '​1' ​is returned if there is at least one matching value.\\ \\ This function is case-sensitive.  |+^ |Recherche d'une chaîne dans la dernière valeur ​(la plus récente).  |**pattern** ​(optionnel) ​chaîne requise\\ **sec** ​ou **#num** (optionnel) - période d’évaluation en secondes ou dans les dernières valeurs collectées ​(précédée d’un signe dièse). Dans ce casplusieurs valeurs peuvent être traitées ​ |Types de valeurs supportés ​: str, text, log\\ \\ Retourne ​:\\ 1 - trouvé\\ 0 - sinon\\ \\ Si plus d'une valeur est traitée, '​1' ​est renvoyé s'il existe au moins une valeur correspondante.\\ \\ Cette fonction est sensible à la casse.  |
 ^ |||| ^ ||||
-|**strlen** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^ +|**strlen** (<sec<​nowiki>​|</​nowiki>#​num>,<​time_shift>​) ​ ^^^^ 
-^ |Length of the latest ​(most recentvalue in characters ​(not bytes).  |**sec** (ignoredor **#num** - the Nth most recent value\\ **time_shift** (optional) - see avg()  |Supported value types: str, text, log\\ \\ Take note that ''#​num'' ​works differently here than with many other functions.\\ \\ Examples:\\ => strlen()(is equal to strlen(#1)) -> length of the latest value\\ => strlen(#3) -> length of the third most recent value\\ => strlen(,1d) -> length of the most recent value one day ago.\\ \\ This function is supported since Zabbix 1.8.4. ​ |+^ |Longueur de la dernière valeur ​(la plus récenteen caractères ​(pas en octets).  |**sec** (ignoré, égal #1ou **#​num** ​(optionnel) ​la Nième valeur la plus récente\\ **time_shift** (optionnel) - voir avg()  |Types de valeurs supportés ​: str, text, log\\ \\ Notez que ''#​num'' ​fonctionne différemment ici de beaucoup d'​autres fonctions.\\ \\ Exemples ​:\\ => strlen() (est égal à strlen(#1)) -> longueur de la dernière valeur\\ => strlen(#3) -> longueur de la troisième valeur la plus récente ​\\ => strlen(,1d) -> longueur de la dernière valeur d'un jour auparavant.\\ \\ Cette fonction est supportée depuis ​Zabbix 1.8.4. ​ |
 ^ |||| ^ ||||
 |**sum** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^ |**sum** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>​) ​ ^^^^
-^ |Sum of collected values within the defined evaluation period.  |**sec** ​or **#num** - evaluation period in seconds or in latest collected values ​(preceded by a hash mark)\\ **time_shift** (optional) - see avg()  |Supported value typesfloat, int\\ \\ The ''​time_shift'' ​parameter is supported since Zabbix 1.8.2. ​ |+^ |Somme des valeurs collectées au cours de la période d’évaluation définie.  |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées ​(précédée d'un signe dièse) \\ **time_shift** (optionnel) - voir avg()  |Types de valeurs supportés ​flottant, int\\ \\ Le paramètre ​''​time_shift'' ​est supporté depuis ​Zabbix 1.8.2. ​ |
 ^ |||| ^ ||||
 |**time** ​ ^^^^ |**time** ​ ^^^^
-^ |Current time in HHMMSS ​format. ​ |  |Supported value types: //any//\\ \\ Example of returned value: 123055 ​ |+^ |Heure actuelle au format ​HHMMSS.  |  |Types de valeurs supportés ​: //any//\\ \\ Exemple de valeur retournée ​: 123055 ​ |
 ^ |||| ^ ||||
 |**timeleft** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>,​threshold,<​fit>​) ​ ^^^^ |**timeleft** (sec<​nowiki>​|</​nowiki>#​num,<​time_shift>,​threshold,<​fit>​) ​ ^^^^
-^ |Time in seconds needed for an item to reach a specified threshold.  |**sec** ​or **#num** - evaluation period in seconds or in latest collected values specified ​(preceded by a hash mark)\\ **time_shift** (optional) - see avg()\\ **threshold** - value to reach\\ **fit** (optional) - see forecast() ​ |Supported value typesfloat, int\\ \\ If value to return is larger than 999999999999.9999, ​return value is cropped to 999999999999.9999.\\ \\ Returns ​999999999999.9999 ​if threshold cannot be reached.\\ \\ Becomes not supported only if misused in expression (wrong item type, invalid parameters), otherwise returns ​-1 in case of errors.\\ \\ Examples:\\ => timeleft(#​10,,​0) -> time until item value reaches zero based on last 10 values\\ => timeleft(1h,,​100) -> time until item value reaches ​100 based on last hour data\\ => timeleft(1h,​1d,​0) -> time until item value reaches ​based on one hour one day ago\\ => timeleft(1h,,​200,​polynomial2) -> time until item reaches ​200 based on last hour data and assumption that item behaves like quadratic ​(second degreepolynomial\\ \\ This function is supported since Zabbix 3.0.0.\\ [[fr:​manual/​appendix/​suffixes|Unit symbols]] in ''​​threshold'' ​​parameter are supported since Zabbix 3.0.6 and 3.2.2.\\ ​See also additional information on [[:​manual/​config/​triggers/​prediction|predictive trigger functions]].  |+^ |Durée en secondes nécessaire à un élément pour atteindre un seuil spécifié.  |**sec** ​ou **#num** - période d'​évaluation en secondes ou dans les dernières valeurs collectées spécifiées ​(précédées d'un signe dièse) \\ **time_shift** (optionnel) - voir avg()\\ **threshold** - valeu à atteindre\\ **fit** (optionnel) - voir forecast() ​ |Types de valeurs supportés ​flottant, int\\ \\ Si la valeur à renvoyer est supérieure à 999999999999.9999, ​la valeur de retour est rognée à 999999999999.9999.\\ \\ Retourne ​999999999999.9999 ​si le seuil ne peut pas être atteint.\\ \\ Devient non supporté uniquement s'il est mal utilisé dans une expression (type d'​élément incorrectparamètres non valides), sinon renvoie ​-1 en cas d'​erreur.\\ \\ Exemples ​:\\ => timeleft(#​10,,​0) -> temps jusqu'​à ce que la valeur de l'​élément atteigne zéro sur la base des 10 dernières valeurs ​\\ => timeleft(1h,,​100) -> temps jusqu'​à ce que la valeur de l'​élément atteigne ​100 sur la base des données de la dernière heure\\ => timeleft(1h,​1d,​0) -> temps jusqu'​à ce que la valeur de l'​élément atteigne ​sur la base d'une heure il y a un jour \\ => timeleft(1h,,​200,​polynomial2) -> temps jusqu'​à ce que l'​élément atteigne ​200 sur la base des données de la dernière heure et en supposant que l'​élément se comporte comme un polynôme quadratique ​(au deuxième degré) \\ \\ Cette fonction est supportée depuis ​Zabbix 3.0.0.\\ ​Les [[fr:​manual/​appendix/​suffixes|symboles d'​unités]] dans le paramètre ​''​​threshold'' ​sont supportés depuis ​Zabbix 3.0.6 et 3.2.2.\\ ​Voir aussi les informations supplémentaires sur les [[fr:​manual/​config/​triggers/​prediction|fonctions de déclenchement prédictives]].  |
  
-<note important>​1) ​All functions return numeric values onlyComparison to strings is not supportedfor example.\\ 2) Some of the functions cannot be used for non-numeric parameters!\\ 3) String ​arguments ​should be double quotedOtherwisethey might get misinterpreted.\\ 4) For all trigger functions ​**sec** ​and **time_shift** ​must be an integer with an optional ​[[fr:​manual:​appendix:​suffixes#​time_suffixes|time unit suffix]] and has absolutely nothing to do with item's data type.  </​note>​+<note important>​1) ​Toutes les fonctions renvoient uniquement des valeurs numériquesPar exemplela comparaison avec des chaînes n'est pas supportée. \\ 2) Certaines fonctions ne peuvent pas être utilisées pour des paramètres ​non numériques ​! \\ 3) Les arguments ​de chaîne doivent être entre guillemets doublesSinonils pourraient être mal interprétés.\\ 4) Pour toutes les fonctions de déclencheur ​**sec** ​et **time_shift** ​doivent être un entier avec un [[fr:​manual:​appendix:​suffixes#​suffixes_de_temps|suffixe temporel]] facultatif et n'ont absolument rien à voir avec le type de données de l'​élément.  </​note>​
  
-=== Functions and unsupported items ===+=== Fonctions et éléments non supportés ​===
  
-<note important>​Starting from Zabbix 3.2, **nodata()**,​ **date()**, **dayofmonth()**,​ **dayofweek()**,​ **now()** ​and **time()** ​functions are calculated for unsupported items, tooOther functions require that the referenced item is in a supported state.</​note>​+<note important>​À partir de Zabbix 3.2, les fonctions ​**nodata()**,​ **date()**, **dayofmonth()**,​ **dayofweek()**,​ **now()** ​et **time()** ​sont également calculées pour les éléments non supportésD'​autres fonctions nécessitent que l'​élément référencé soit dans un état supporté.</​note>​