9 Virkņu funkcijas

Visas šeit uzskaitītās funkcijas tiek atbalstītas:

• Trigeru izteiksmēs
• Aprēķinātajos vienumos
• Izteiksmju makrosos

Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju.

Funkciju informācija

Dažas vispārīgas piezīmes par funkciju parametriem:

• Funkciju parametrus atdala ar komatu
• Izteiksmes tiek pieņemtas kā parametri
• Virknes parametriem jābūt dubultpēdiņās; pretējā gadījumā tie var tikt nepareizi interpretēti
• Neobligātie funkciju parametri (vai parametru daļas) tiek norādīti ar < >

ascii(value)

Vērtības kreisākās rakstzīmes ASCII kods.
Atbalstītie vērtību tipi: String, Text, Log.

Parametrs:

• value - pārbaudāmā vērtība

Piemēram, tāda vērtība kā 'Abc' atgriezīs '65' ('A' ASCII kodu).

Piemērs:

ascii(last(/host/key))

bitlength(value)

Vērtības garums bitos.
Atbalstītie vērtību tipi: String, Text, Log, Integer.

Parametrs:

• value - pārbaudāmā vērtība

Piemērs:

bitlength(last(/host/key))

bytelength(value)

Vērtības garums baitos.
Atbalstītie vērtību tipi: String, Text, Log, Integer.

Parametrs:

• value - pārbaudāmā vērtība

Piemērs:

bytelength(last(/host/key))

char(value)

Atgriež rakstzīmi, interpretējot vērtību kā ASCII kodu.
Atbalstītie vērtību tipi: Integer.

Parametrs:

• value - pārbaudāmā vērtība

Vērtībai jābūt diapazonā no 0 līdz 255. Piemēram, vērtība '65' (interpretēta kā ASCII kods) atgriezīs 'A'.

Piemērs:

char(last(/host/key))

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

Virkne, kas iegūta, savienojot norādīto vienumu vērtības vai konstantās vērtības.
Atbalstītie vērtību tipi: String, Text, Log, Float, Integer.

Parametrs:

• valueX - vērtība, ko atgriež kāda no vēstures funkcijām, vai konstanta vērtība (virkne, vesels skaitlis vai peldošā komata skaitlis). Jāsatur vismaz divi parametri.

Piemēram, vērtība 'Zab', kas savienota ar 'bix' (konstanta virkne), atgriezīs 'Zabbix'.

Piemēri:

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)

Ievieto norādītās rakstzīmes vai atstarpes rakstzīmju virknē, sākot no norādītās pozīcijas virknē.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• start - sākuma pozīcija;
  
• length - aizstājamās pozīcijas;
  
• replacement - aizstāšanas virkne.

Piemēram, vērtība 'Zabbbix' tiks aizstāta ar 'Zabbix', ja 'bb' (sākuma pozīcija 3, aizstājamās pozīcijas 2) tiek aizstāts ar 'b'.

Piemērs:

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

jsonpath(value,path,<default>)

Atgriež JSONPath rezultātu.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• path - ceļš (jānorāda pēdiņās);
  
• default - neobligātā rezerves vērtība, ja JSONPath vaicājums neatgriež datus. Ņemiet vērā, ka citu kļūdu gadījumā tiek atgriezta kļūme (piemēram, "unsupported construct").

Piemērs:

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

left(value,count)

Atgriež vērtības kreisākās rakstzīmes.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• count - atgriežamo rakstzīmju skaits.

Piemēram, no 'Zabbix' var atgriezt 'Zab', norādot 3 atgriežamās kreisākās rakstzīmes. Skatiet arī right().

Piemērs:

left(last(/host/key),3) #atgriež trīs kreisākās rakstzīmes

length(value)

Vērtības garums rakstzīmēs.
Atbalstītie vērtību tipi: String, Text, Log.

Parametrs:

• value - pārbaudāmā vērtība.

Piemēri:

length(last(/host/key)) #jaunākās vērtības garums
length(last(/host/key,#3)) #trešās jaunākās vērtības garums
length(last(/host/key,#1:now-1d)) #jaunākās vērtības garums pirms vienas dienas

ltrim(value,<chars>)

Noņem norādītās rakstzīmes no virknes sākuma.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• chars (neobligāts) - norādiet noņemamās rakstzīmes.

Pēc noklusējuma no sākuma tiek noņemtas atstarpes (ja nav norādītas neobligātās rakstzīmes). Skatiet arī: rtrim(), trim().

Piemēri:

ltrim(last(/host/key)) #noņem atstarpes no virknes sākuma
ltrim(last(/host/key),"Z") #noņem visas 'Z' no virknes sākuma
ltrim(last(/host/key)," Z") #noņem visas atstarpes un 'Z' no virknes sākuma

mid(value,start,length)

Atgriež apakšvirkni ar N rakstzīmēm, sākot no rakstzīmes pozīcijas, kas norādīta ar 'start'.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• start - apakšvirknes sākuma pozīcija;
  
• length - pozīciju skaits, ko atgriezt apakšvirknē.

Piemēram, ir iespējams atgriezt 'abbi' no vērtības 'Zabbix', ja sākuma pozīcija ir 2 un atgriežamo pozīciju skaits ir 4.

Piemērs:

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

repeat(value,count)

Atkārto virkni.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• count - atkārtojumu skaits.

Piemērs:

repeat(last(/host/key),2) #atkārto vērtību divas reizes

replace(value,pattern,replacement)

Atrodiet šablonu vērtībā un aizstājiet to ar aizvietojumu. Tiks aizstātas visas šablona parādīšanās reizes.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• pattern - atrodamais šablons;
  
• replacement - virkne, ar ko aizstāt šablonu.

Piemērs:

replace(last(/host/key),"ibb","abb") #aizstāt visus 'ibb' ar 'abb'

right(value,count)

Atgriež vērtības labējās rakstzīmes.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• count - atgriežamo rakstzīmju skaits.

Piemēram, no 'Zabbix' var atgriezt 'bix', norādot atgriezt 3 labējās rakstzīmes. Skatiet arī left().

Piemērs:

right(last(/host/key),3) #atgriež trīs labējās rakstzīmes

rtrim(value,<chars>)

Noņem norādītās rakstzīmes no virknes beigām.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• chars (neobligāts) - norādiet noņemamās rakstzīmes.

Pēc noklusējuma tiek noņemtas atstarpes virknes labajā pusē (ja nav norādītas neobligātās rakstzīmes). Skatiet arī: ltrim(), trim().

Piemēri:

rtrim(last(/host/key)) #noņem atstarpes no virknes beigām
rtrim(last(/host/key),"x") #noņem jebkuru 'x' no virknes beigām
rtrim(last(/host/key),"x ") #noņem jebkuru 'x' un atstarpi no virknes beigām

trim(value,<chars>)

Noņem norādītās rakstzīmes no virknes sākuma un beigām.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• chars (neobligāts) - norādiet noņemamās rakstzīmes.

Pēc noklusējuma atstarpes tiek noņemtas no abām pusēm (ja nav norādītas neobligātās rakstzīmes). Skatiet arī: ltrim(), rtrim().

Piemēri:

trim(last(/host/key)) #noņem atstarpes no virknes sākuma un beigām
trim(last(/host/key),"_") #noņem '_' no virknes sākuma un beigām

xmlxpath(value,path,<default>)

Atgriež XML XPath rezultātu.
Atbalstītie vērtību tipi: String, Text, Log.

Parametri:

• value - pārbaudāmā vērtība;
  
• path - ceļš (jānorāda pēdiņās);
  
• default - neobligātā rezerves vērtība, ja XML XPath vaicājums atgriež tukšu mezglu kopu. Tā netiks atgriezta, ja tukšais rezultāts nav mezglu kopa (t.i., tukša virkne). Citu kļūdu gadījumā tiek atgriezta kļūme (piemēram, "invalid expression").

Piemērs:

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

Skatīt visas atbalstītās funkcijas.