9 Funzioni stringa

Tutte le funzioni elencate qui sono supportate in:

• Espressioni dei trigger
• Item calcolati
• Macro di espressione

Le funzioni sono elencate senza informazioni aggiuntive. Fare clic sulla funzione per visualizzare tutti i dettagli.

Dettagli della funzione

Alcune note generali sui parametri delle funzioni:

• I parametri delle funzioni sono separati da una virgola
• Le espressioni sono accettate come parametri
• I parametri di tipo stringa devono essere racchiusi tra doppi apici; in caso contrario potrebbero essere interpretati in modo errato
• I parametri opzionali delle funzioni (o parti di parametro) sono indicati da < >

ascii(value)

Il codice ASCII del carattere più a sinistra del valore.
Tipi di valore supportati: String, Text, Log.

Parametro:

• value - il valore da controllare

Per esempio, un valore come 'Abc' restituirà '65' (codice ASCII di 'A').

Esempio:

ascii(last(/host/key))

bitlength(value)

La lunghezza di value in bit.
Tipi di valore supportati: String, Text, Log, Integer.

Parametro:

• value - il valore da controllare

Esempio:

bitlength(last(/host/key))

bytelength(value)

La lunghezza di value in byte.
Tipi di valore supportati: String, Text, Log, Integer.

Parametro:

• value - il valore da controllare

Esempio:

bytelength(last(/host/key))

char(value)

Restituisce il carattere interpretando il valore come codice ASCII.
Tipi di valore supportati: Integer.

Parametro:

• value - il valore da controllare

Il valore deve essere compreso nell'intervallo 0-255. Per esempio, un valore come '65' (interpretato come codice ASCII) restituirà 'A'.

Esempio:

char(last(/host/key))

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

La stringa risultante dalla concatenazione dei valori degli item referenziati o di valori costanti.
Tipi di valore supportati: String, Text, Log, Float, Integer.

Parametro:

• valueX - il valore restituito da una delle funzioni della cronologia o un valore costante (stringa, numero intero o in virgola mobile). Deve contenere almeno due parametri.

Ad esempio, un valore come 'Zab' concatenato a 'bix' (la stringa costante) restituirà 'Zabbix'.

Esempi:

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)

Inserisce i caratteri o gli spazi specificati nella stringa di caratteri a partire dalla posizione specificata nella stringa.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• start - posizione iniziale;
  
• length - posizioni da sostituire;
  
• replacement - stringa di sostituzione.

Ad esempio, un valore come 'Zabbbix' verrà sostituito da 'Zabbix' se 'bb' (posizione iniziale 3, posizioni da sostituire 2) viene sostituito con 'b'.

Esempio:

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

jsonpath(value,path,<default>)

Restituisce il risultato JSONPath.
Tipi di valore supportati: Stringa, Testo, Log.

Parametri:

• value - il valore da controllare;
  
• path - il percorso (deve essere tra virgolette);
  
• default - il valore di fallback opzionale se la query JSONPath non restituisce dati. Si noti che in caso di altri errori viene restituito un errore (ad es. "unsupported construct").

Esempio:

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

left(value,count)

Restituisce i caratteri più a sinistra del valore.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• count - il numero di caratteri da restituire.

Ad esempio, è possibile restituire 'Zab' da 'Zabbix' specificando 3 caratteri più a sinistra da restituire. Vedere anche right().

Esempio:

left(last(/host/key),3) #restituisce i tre caratteri più a sinistra

length(value)

La lunghezza di value in caratteri.
Tipi di valore supportati: String, Text, Log.

Parametro:

• value - il valore da controllare.

Esempi:

length(last(/host/key)) #la lunghezza dell'ultimo valore
length(last(/host/key,#3)) #la lunghezza del terzo valore più recente
length(last(/host/key,#1:now-1d)) #la lunghezza del valore più recente di un giorno fa

ltrim(value,<chars>)

Rimuove i caratteri specificati dall'inizio della stringa.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• chars (opzionale) - specifica i caratteri da rimuovere.

Per impostazione predefinita, vengono rimossi gli spazi vuoti iniziali (se non vengono specificati caratteri opzionali). Vedi anche: rtrim(), trim().

Esempi:

ltrim(last(/host/key)) #rimuove gli spazi vuoti dall'inizio della stringa
ltrim(last(/host/key),"Z") #rimuove qualsiasi 'Z' dall'inizio della stringa
ltrim(last(/host/key)," Z") #rimuove qualsiasi spazio e 'Z' dall'inizio della stringa

mid(value,start,length)

Restituisce una sottostringa di N caratteri a partire dalla posizione del carattere specificata da 'start'.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• start - posizione iniziale della sottostringa;
  
• length - posizioni da restituire nella sottostringa.

Ad esempio, è possibile restituire 'abbi' da un valore come 'Zabbix' se la posizione iniziale è 2 e le posizioni da restituire sono 4.

Esempio:

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

repeat(value,count)

Ripete una stringa.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• count - il numero di volte da ripetere.

Esempio:

repeat(last(/host/key),2) #ripete il valore due volte

replace(value,pattern,replacement)

Trova il pattern nel valore e sostituiscilo con replacement. Tutte le occorrenze del pattern verranno sostituite.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• pattern - il pattern da trovare;
  
• replacement - la stringa con cui sostituire il pattern.

Esempio:

replace(last(/host/key),"ibb","abb") #sostituisce tutte le occorrenze di 'ibb' con 'abb'

right(value,count)

Restituisce i caratteri più a destra del valore.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• count - il numero di caratteri da restituire.

Ad esempio, è possibile restituire 'bix' da 'Zabbix' specificando i 3 caratteri più a destra da restituire. Vedere anche left().

Esempio:

right(last(/host/key),3) #restituisce i tre caratteri più a destra

rtrim(value,<chars>)

Rimuove i caratteri specificati dalla fine della stringa.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• chars (opzionale) - specifica i caratteri da rimuovere.

Per impostazione predefinita, gli spazi vuoti vengono rimossi da destra (se non vengono specificati caratteri opzionali). Vedi anche: ltrim(), trim().

Esempi:

rtrim(last(/host/key)) #rimuove gli spazi vuoti dalla fine della stringa
rtrim(last(/host/key),"x") #rimuove qualsiasi 'x' dalla fine della stringa
rtrim(last(/host/key),"x ") #rimuove qualsiasi 'x' e spazio dalla fine della stringa

trim(value,<chars>)

Rimuove i caratteri specificati dall'inizio e dalla fine della stringa.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• chars (opzionale) - specifica i caratteri da rimuovere.

Per impostazione predefinita, gli spazi vuoti vengono rimossi da entrambi i lati (se non vengono specificati caratteri opzionali). Vedi anche: ltrim(), rtrim().

Esempi:

trim(last(/host/key)) #rimuove gli spazi vuoti dall'inizio e dalla fine della stringa
trim(last(/host/key),"_") #rimuove '_' dall'inizio e dalla fine della stringa

xmlxpath(value,path,<default>)

Restituisce il risultato XML XPath.
Tipi di valore supportati: String, Text, Log.

Parametri:

• value - il valore da controllare;
  
• path - il percorso (deve essere tra virgolette);
  
• default - il valore di fallback opzionale se la query XML XPath restituisce un nodeset vuoto. Non verrà restituito se il risultato vuoto non è un nodeset (ad es. una stringa vuota). In caso di altri errori viene restituito un errore (ad es. "invalid expression").

Esempio:

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

Vedere tutte le funzioni supportate.