This shows you the differences between two versions of the page.
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 types: float, 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 types: float, 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 a 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** (ignored) or **#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 manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.\\ \\ Examples:\\ => %%band(,12)=8 or band(,12)=4%% -> 3rd or 4th bit set, but 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 #1) ou **#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 bit, toutes les valeurs doivent être fournies et sont retournées en décimal. Par exemple, la vérification du troisième bit est effectuée en comparant à 4 et non à 100.\\ \\ Exemples :\\ => %%band(,12)=8 ou band(,12)=4%% -> 3ième ou 4ième bit défini, mais 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 types: float, 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 string, text and log items\\ \\ **time_shift** (optional) - see avg() |Supported value types: float, integer, string, text, log\\ Float items match with the precision of 0.000001.\\ \\ With //band// as third parameter, the second ''pattern'' parameter can be specified as two numbers, separated 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 equal, only 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 expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation 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 binary) in the 3 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înes, texte et log\\ \\ **time_shift** (optionnel) - voir avg() |Types de valeurs supportés : flottant, entier, chaîne, texte, log\\ Les éléments flottants correspondent avec une précision de 0.000001.\\ \\ Avec //band// comme troisième paramètre, le second paramètre ''pattern'' peut être spécifié comme deux nombres, sé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 égaux, seul 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ères. Dans le but de faire correspondre les expressions régulières, les valeurs flottantes seront toujours représentées avec 4 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ées) et 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 binaire) dans 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 1 to 31. | |Supported value types: //any//\\ \\ This function is supported since Zabbix 1.8.5. | | + | ^ |Jour du mois compris entre 1 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 1 to 7 (Mon - 1, Sun - 7). | |Supported value types: //any// | | + | ^ |Jour de le semaine compris entre 1 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 types: float, 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 types: float, 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 types: float, 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 degree) polynomial\\ => 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 rarely, say, once 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 incorrect, paramè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 rarement, par exemple, une 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 types: float, int\\ \\ Returns:\\ 0 - if difference between item timestamp value and Zabbix server timestamp is over T seconds\\ 1 - 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 :\\ 1 - si la différence entre la valeur de l'élément (son timestamp) et le timestamp du serveur Zabbix est inférieure ou égale à T secondes \\ 0 - 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** (ignored) or **#num** - the Nth most recent value\\ **time_shift** (optional) - see avg() |Supported value types: float, 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 #1) ou **#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 requis, style [[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 (integer, useful 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é (entier, utile 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 logs. For 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 types: float, 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 types: float, 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 if, within 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 si, dans 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 period, where P (percentage) is 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 0 and 100 (inclusive) with up to 4 digits after the decimal point |Supported value types: float, int\\ \\ This function is supported since Zabbix 3.0.0. | | + | ^ |P-ième centile d'une période, où P (pourcentage) est 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 0 et 100 (inclus) avec un maximum de 4 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 types: float, 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 recent) value 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 case, more 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écente) correspond à l'expression régulière. |**pattern** (optionnel) - expression régulière, style [[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 cas, plusieurs 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 recent) value. |**pattern** - required string\\ **sec** or **#num** (optional) - evaluation period in seconds or in latest collected values (preceded by a hash mark). In this case, more 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 cas, plusieurs 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 recent) value in characters (not bytes). |**sec** (ignored) or **#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écente) en caractères (pas en octets). |**sec** (ignoré, égal #1) ou **#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 types: float, 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 types: float, 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 0 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 degree) polynomial\\ \\ 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 incorrect, paramè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 0 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 only. Comparison to strings is not supported, for example.\\ 2) Some of the functions cannot be used for non-numeric parameters!\\ 3) String arguments should be double quoted. Otherwise, they 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ériques. Par exemple, la 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 doubles. Sinon, ils 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, too. Other 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és. D'autres fonctions nécessitent que l'élément référencé soit dans un état supporté.</note> |