9 String-Funktionen

Alle hier aufgeführten Funktionen werden unterstützt in:

• Auslöser-Ausdrücken
• Berechneten Datenpunkten
• Ausdrucks-Makros

Die Funktionen sind hier ohne zusätzliche Informationen aufgeführt. Klicken Sie auf die Funktion, um die vollständigen Details anzuzeigen.

Funktionsdetails

Einige allgemeine Hinweise zu Funktionsparametern:

• Funktionsparameter werden durch ein Komma getrennt
• Ausdrücke werden als Parameter akzeptiert
• Zeichenkettenparameter müssen in doppelte Anführungszeichen gesetzt werden; andernfalls könnten sie falsch interpretiert werden
• Optionale Funktionsparameter (oder Parameterteile) werden durch < > gekennzeichnet

ascii(value)

Der ASCII-Code des am weitesten links stehenden Zeichens des Werts.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel gibt ein Wert wie 'Abc' '65' zurück (ASCII-Code für 'A').

Beispiel:

ascii(last(/host/key))

bitlength(value)

Die Länge von value in Bits.
Unterstützte Werttypen: String, Text, Log, Integer.

Parameter:

• value - der zu prüfende Wert

Beispiel:

bitlength(last(/host/key))

bytelength(value)

Die Länge von value in Byte.
Unterstützte Werttypen: String, Text, Log, Integer.

Parameter:

• value - der zu prüfende Wert

Beispiel:

bytelength(last(/host/key))

char(value)

Gibt das Zeichen zurück, indem der Wert als ASCII-Code interpretiert wird.
Unterstützte Werttypen: Integer.

Parameter:

• value - der zu prüfende Wert

Der Wert muss im Bereich 0-255 liegen. Zum Beispiel gibt ein Wert wie '65' (als ASCII-Code interpretiert) 'A' zurück.

Beispiel:

char(last(/host/key))

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

Die Zeichenkette, die durch das Verketten der referenzierten Datenpunktwerte oder konstanter Werte entsteht.
Unterstützte Werttypen: String, Text, Log, Float, Integer.

Parameter:

• valueX - der von einer der Verlaufsfunktionen zurückgegebene Wert oder ein konstanter Wert (Zeichenkette, Ganzzahl oder Gleitkommazahl). Muss mindestens zwei Parameter enthalten.

Zum Beispiel ergibt ein Wert wie 'Zab', der mit 'bix' (der konstanten Zeichenkette) verkettet wird, 'Zabbix'.

Beispiele:

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)

Fügt angegebene Zeichen oder Leerzeichen in die Zeichenkette ein, beginnend an der angegebenen Position in der Zeichenkette.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• start - Startposition;
  
• length - zu ersetzende Positionen;
  
• replacement - Ersetzungszeichenkette.

Zum Beispiel wird ein Wert wie 'Zabbbix' durch 'Zabbix' ersetzt, wenn 'bb' (Startposition 3, zu ersetzende Positionen 2) durch 'b' ersetzt wird.

Beispiel:

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

jsonpath(value,path,<default>)

Gibt das JSONPath-Ergebnis zurück.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• path - der Pfad (muss in Anführungszeichen gesetzt werden);
  
• default - der optionale Ersatzwert, falls die JSONPath-Abfrage keine Daten zurückgibt. Beachten Sie, dass bei anderen Fehlern ein Fehlschlag zurückgegeben wird (z. B. „unsupported construct“).

Beispiel:

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

left(value,count)

Gibt die Zeichen ganz links im Wert zurück.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• count - die Anzahl der zurückzugebenden Zeichen.

Zum Beispiel können Sie aus 'Zabbix' 'Zab' zurückgeben, indem Sie angeben, dass die 3 Zeichen ganz links zurückgegeben werden sollen. Siehe auch right().

Beispiel:

left(last(/host/key),3) #gibt die drei Zeichen ganz links zurück

length(value)

Die Länge von value in Zeichen.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value – der zu prüfende Wert.

Beispiele:

length(last(/host/key)) #die Länge des letzten Werts
length(last(/host/key,#3)) #die Länge des drittletzten Werts
length(last(/host/key,#1:now-1d)) #die Länge des letzten Werts vor einem Tag

ltrim(value,<chars>)

Entfernt angegebene Zeichen vom Anfang einer Zeichenkette.
Unterstützte Wertetypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• chars (optional) - gibt die zu entfernenden Zeichen an.

Standardmäßig werden führende Leerraumzeichen entfernt (wenn keine optionalen Zeichen angegeben sind). Siehe auch: rtrim(), trim().

Beispiele:

ltrim(last(/host/key)) #entfernt Leerraum vom Anfang der Zeichenkette
ltrim(last(/host/key),"Z") #entfernt alle 'Z' vom Anfang der Zeichenkette
ltrim(last(/host/key)," Z") #entfernt alle Leerzeichen und 'Z' vom Anfang der Zeichenkette

mid(value,start,length)

Gibt eine Teilzeichenfolge mit N Zeichen zurück, beginnend an der durch 'start' angegebenen Zeichenposition.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• start - Startposition der Teilzeichenfolge;
  
• length - in der Teilzeichenfolge zurückzugebende Positionen.

Zum Beispiel ist es möglich, aus einem Wert wie 'Zabbix' 'abbi' zurückzugeben, wenn die Startposition 2 ist und die Anzahl der zurückzugebenden Positionen 4 beträgt.

Beispiel:

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

repeat(value,count)

Wiederholt eine Zeichenkette.
Unterstützte Wertetypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• count - die Anzahl der Wiederholungen.

Beispiel:

repeat(last(/host/key),2) #Wert zweimal wiederholen

replace(value,pattern,replacement)

Sucht das Muster im Wert und ersetzt es durch replacement. Alle Vorkommen des Musters werden ersetzt.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• pattern - das zu findende Muster;
  
• replacement - die Zeichenfolge, durch die das Muster ersetzt wird.

Beispiel:

replace(last(/host/key),"ibb","abb") #alle 'ibb' durch 'abb' ersetzen

right(value,count)

Gibt die Zeichen ganz rechts im Wert zurück.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• count - die Anzahl der zurückzugebenden Zeichen.

Zum Beispiel können Sie aus 'Zabbix' 'bix' zurückgeben, indem Sie angeben, dass die 3 Zeichen ganz rechts zurückgegeben werden sollen. Siehe auch left().

Beispiel:

right(last(/host/key),3) #gibt die drei Zeichen ganz rechts zurück

rtrim(value,<chars>)

Entfernt angegebene Zeichen vom Ende einer Zeichenkette.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• chars (optional) - gibt die zu entfernenden Zeichen an.

Leerraum wird standardmäßig rechts abgeschnitten (wenn keine optionalen Zeichen angegeben sind). Siehe auch: ltrim(), trim().

Beispiele:

rtrim(last(/host/key)) #Leerraum vom Ende der Zeichenkette entfernen
rtrim(last(/host/key),"x") #beliebiges 'x' vom Ende der Zeichenkette entfernen
rtrim(last(/host/key),"x ") #beliebiges 'x' und Leerzeichen vom Ende der Zeichenkette entfernen

trim(value,<chars>)

Entfernt angegebene Zeichen vom Anfang und Ende einer Zeichenkette.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• chars (optional) - gibt die zu entfernenden Zeichen an.

Standardmäßig werden Leerraumzeichen auf beiden Seiten entfernt (wenn keine optionalen Zeichen angegeben sind). Siehe auch: ltrim(), rtrim().

Beispiele:

trim(last(/host/key)) #entfernt Leerraumzeichen vom Anfang und Ende der Zeichenkette
trim(last(/host/key),"_") #entfernt '_' vom Anfang und Ende der Zeichenkette

xmlxpath(value,path,<default>)

Gibt das XML-XPath-Ergebnis zurück.
Unterstützte Werttypen: String, Text, Log.

Parameter:

• value - der zu prüfende Wert;
  
• path - der Pfad (muss in Anführungszeichen gesetzt werden);
  
• default - der optionale Ersatzwert, falls die XML-XPath-Abfrage eine leere Knotenmenge zurückgibt. Er wird nicht zurückgegeben, wenn das leere Ergebnis keine Knotenmenge ist (d. h. eine leere Zeichenkette). Bei anderen Fehlern wird ein Fehlschlag zurückgegeben (z. B. „ungültiger Ausdruck“).

Beispiel:

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

Siehe alle unterstützten Funktionen.