9 Fonctions de chaîne

Toutes les fonctions répertoriées ici sont prises en charge dans :

• Expressions de déclencheur
• Éléments calculés
• Macros d'expression

Les fonctions sont répertoriées sans informations supplémentaires. Cliquez sur la fonction pour voir tous les détails.

Détails des fonctions

Quelques remarques générales sur les paramètres de fonction :

• Les paramètres de fonction sont séparés par une virgule
• Les expressions sont acceptées comme paramètres
• Les paramètres de chaîne doivent être placés entre guillemets doubles ; sinon, ils risquent d’être mal interprétés
• Les paramètres de fonction facultatifs (ou parties de paramètres) sont indiqués par < >

ascii(value)

Le code ASCII du caractère le plus à gauche de la valeur.
Types de valeurs pris en charge : String, Text, Log.

Paramètre :

• value - la valeur à vérifier

Par exemple, une valeur comme 'Abc' renverra '65' (code ASCII de 'A').

Exemple :

ascii(last(/host/key))

bitlength(value)

La longueur de value en bits.
Types de valeurs pris en charge : String, Text, Log, Integer.

Paramètre :

• value - la valeur à vérifier

Exemple :

bitlength(last(/host/key))

bytelength(value)

La longueur de value en octets.
Types de valeurs pris en charge : String, Text, Log, Integer.

Paramètre :

• value - la valeur à vérifier

Exemple :

bytelength(last(/host/key))

char(value)

Renvoie le caractère en interprétant la valeur comme un code ASCII.
Types de valeurs pris en charge : Integer.

Paramètre :

• value - la valeur à vérifier

La valeur doit être comprise dans la plage 0-255. Par exemple, une valeur telle que « 65 » (interprétée comme un code ASCII) renverra « A ».

Exemple :

char(last(/host/key))

concat(<value1>,<value2>,...)

La chaîne résultant de la concaténation des valeurs d’élément référencées ou de valeurs constantes.
Types de valeurs pris en charge : String, Text, Log, Float, Integer.

Paramètre :

• valueX - la valeur renvoyée par l’une des fonctions d’historique ou une valeur constante (chaîne, entier ou nombre à virgule flottante). Doit contenir au moins deux paramètres.

Par exemple, une valeur telle que 'Zab' concaténée à 'bix' (la chaîne constante) renverra 'Zabbix'.

Exemples :

concat(last(/host/key),"bix")
concat("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15]))

insert(value,start,length,replacement)

Insère les caractères spécifiés ou des espaces dans la chaîne de caractères à partir de la position spécifiée dans la chaîne.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• start - position de début ;
  
• length - positions à remplacer ;
  
• replacement - chaîne de remplacement.

Par exemple, une valeur telle que 'Zabbbix' sera remplacée par 'Zabbix' si 'bb' (position de début 3, 2 positions à remplacer) est remplacé par 'b'.

Exemple :

insert(last(/host/key),3,2,"b")

jsonpath(value,path,<default>)

Renvoie le résultat JSONPath.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• path - le chemin (doit être entre guillemets) ;
  
• default - la valeur de repli facultative si la requête JSONPath ne renvoie aucune donnée. Notez qu’en cas d’autres erreurs, un échec est renvoyé (par ex. « unsupported construct »).

Exemple :

jsonpath(last(/host/proc.get[zabbix_agentd,,,summary]),"$..size")

left(value,count)

Renvoie les caractères les plus à gauche de la valeur.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• count - le nombre de caractères à renvoyer.

Par exemple, vous pouvez renvoyer 'Zab' à partir de 'Zabbix' en spécifiant 3 caractères les plus à gauche à renvoyer. Voir aussi right().

Exemple :

left(last(/host/key),3) #renvoie les trois caractères les plus à gauche

length(value)

La longueur de value en caractères.
Types de valeurs pris en charge : String, Text, Log.

Paramètre :

• value - la valeur à vérifier.

Exemples :

length(last(/host/key)) #la longueur de la dernière valeur
length(last(/host/key,#3)) #la longueur de la troisième valeur la plus récente
length(last(/host/key,#1:now-1d)) #la longueur de la valeur la plus récente il y a un jour

ltrim(value,<chars>)

Supprime les caractères spécifiés du début de la chaîne.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• chars (facultatif) - spécifie les caractères à supprimer.

Les espaces sont supprimés par défaut au début de la chaîne (si aucun caractère facultatif n'est spécifié). Voir aussi : rtrim(), trim().

Exemples :

ltrim(last(/host/key)) #supprime les espaces du début de la chaîne
ltrim(last(/host/key),"Z") #supprime tous les 'Z' du début de la chaîne
ltrim(last(/host/key)," Z") #supprime tous les espaces et les 'Z' du début de la chaîne

mid(value,start,length)

Renvoie une sous-chaîne de N caractères à partir de la position de caractère spécifiée par « start ».
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• start - position de début de la sous-chaîne ;
  
• length - nombre de positions à renvoyer dans la sous-chaîne.

Par exemple, il est possible de renvoyer « abbi » à partir d’une valeur telle que « Zabbix » si la position de départ est 2 et que le nombre de positions à renvoyer est 4.

Exemple :

mid(last(/host/key),2,4)="abbi"

repeat(value,count)

Répète une chaîne.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• count - le nombre de répétitions.

Exemple :

repeat(last(/host/key),2) #répète la valeur deux fois

replace(value,pattern,replacement)

Recherchez le motif dans la valeur et remplacez-le par replacement. Toutes les occurrences du motif seront remplacées.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• pattern - le motif à rechercher ;
  
• replacement - la chaîne par laquelle remplacer le motif.

Exemple :

replace(last(/host/key),"ibb","abb") #remplace toutes les occurrences de 'ibb' par 'abb'

right(value,count)

Renvoie les caractères les plus à droite de la valeur.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• count - le nombre de caractères à renvoyer.

Par exemple, vous pouvez renvoyer « bix » à partir de « Zabbix » en indiquant de renvoyer les 3 caractères les plus à droite. Voir aussi left().

Exemple :

right(last(/host/key),3) #renvoie les trois caractères les plus à droite

rtrim(value,<chars>)

Supprime les caractères spécifiés de la fin de la chaîne.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• chars (optionnel) - spécifie les caractères à supprimer.

Les espaces sont supprimés par défaut à droite (si aucun caractère optionnel n'est spécifié). Voir aussi : ltrim(), trim().

Exemples :

rtrim(last(/host/key)) #supprime les espaces de la fin de la chaîne
rtrim(last(/host/key),"x") #supprime tous les 'x' de la fin de la chaîne
rtrim(last(/host/key),"x ") #supprime tous les 'x' et les espaces de la fin de la chaîne

trim(value,<chars>)

Supprime les caractères spécifiés au début et à la fin de la chaîne.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• chars (facultatif) - spécifie les caractères à supprimer.

Par défaut, les espaces sont supprimés des deux côtés (si aucun caractère facultatif n'est spécifié). Voir aussi : ltrim(), rtrim().

Exemples :

trim(last(/host/key)) #supprime les espaces au début et à la fin de la chaîne
trim(last(/host/key),"_") #supprime '_' au début et à la fin de la chaîne

xmlxpath(value,path,<default>)

Renvoie le résultat XML XPath.
Types de valeurs pris en charge : String, Text, Log.

Paramètres :

• value - la valeur à vérifier ;
  
• path - le chemin (doit être entre guillemets) ;
  
• default - la valeur de repli facultative si la requête XML XPath renvoie un ensemble de nœuds vide. Elle ne sera pas renvoyée si le résultat vide n'est pas un ensemble de nœuds (c'est-à-dire une chaîne vide). En cas d'autres erreurs, un échec est renvoyé (par exemple, "invalid expression").

Exemple :

xmlxpath(last(/host/xml_result),"/response/error/status")

Voir toutes les fonctions prises en charge.