9 Funções de string

Todas as funções listadas aqui são suportadas em:

• Expressões de trigger
• Items calculados
• Macros de expressão

As funções são listadas sem informações adicionais. Clique na função para ver os detalhes completos.

Detalhes da função

Algumas observações gerais sobre os parâmetros da função:

• Os parâmetros da função são separados por vírgula
• Expressões são aceitas como parâmetros
• Parâmetros de string devem estar entre aspas duplas; caso contrário, podem ser interpretados incorretamente
• Parâmetros de função opcionais (ou partes do parâmetro) são indicados por < >

ascii(value)

O código ASCII do caractere mais à esquerda do valor.
Tipos de valores suportados: String, Text, Log.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, um valor como 'Abc' retornará '65' (código ASCII para 'A').

Exemplo:

ascii(last(/host/key))

bitlength(value)

O comprimento do valor em bits.
Tipos de valor suportados: String, Text, Log, Integer.

Parâmetro:

• value - o valor a ser verificado

Exemplo:

bitlength(last(/host/key))

bytelength(value)

O comprimento do valor em bytes.
Tipos de valor suportados: String, Text, Log, Integer.

Parâmetro:

• value - o valor a ser verificado

Exemplo:

bytelength(last(/host/key))

char(value)

Retorna o caractere interpretando o valor como código ASCII.
Tipos de valor suportados: Inteiro.

Parâmetro:

• value - o valor a ser verificado

O valor deve estar no intervalo de 0-255. Por exemplo, um valor como '65' (interpretado como código ASCII) retornará 'A'.

Exemplo:

char(last(/host/key))

concat(<valor1>,<valor2>,...)

A string resultante da concatenação dos valores dos items referenciados ou valores constantes.
Tipos de valores suportados: String, Text, Log, Float, Integer.

Parâmetro:

• valorX - o valor retornado por uma das funções de histórico ou um valor constante (string, inteiro ou número float). Deve conter pelo menos dois parâmetros.

Por exemplo, um valor como 'Zab' concatenado com 'bix' (a string constante) retornará 'Zabbix'.

Exemplos:

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)

Insere caracteres ou espaços especificados na string de caracteres começando na posição especificada na string.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• start - posição inicial;
  
• length - posições a substituir;
  
• replacement - string de substituição.

Por exemplo, um valor como 'Zabbbix' será substituído por 'Zabbix' se 'bb' (posição inicial 3, posições a substituir 2) for substituído por 'b'.

Exemplo:

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

jsonpath(value,path,<default>)

Retorna o resultado do JSONPath.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• path - o caminho (deve ser entre aspas);
  
• default - o valor opcional de fallback se a consulta JSONPath não retornar dados. Observe que em outros erros é retornada falha (por exemplo, "unsupported construct").

Exemplo:

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

left(value,count)

Retorna os caracteres mais à esquerda do valor.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• count - o número de caracteres a serem retornados.

Por exemplo, você pode retornar 'Zab' de 'Zabbix' especificando 3 caracteres mais à esquerda para retornar. Veja também right().

Exemplo:

left(last(/host/key),3) #retorna três caracteres mais à esquerda

length(value)

O comprimento do valor em caracteres.
Tipos de valores suportados: String, Text, Log.

Parâmetro:

• value - o valor a ser verificado.

Exemplos:

length(last(/host/key)) #o comprimento do valor mais recente
       length(last(/host/key,#3)) #o comprimento do terceiro valor mais recente
       length(last(/host/key,#1:now-1d)) #o comprimento do valor mais recente de um dia atrás

ltrim(value,<chars>)

Remove os caracteres especificados do início da string.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• chars (opcional) - especifica os caracteres a serem removidos.

Espaços em branco são removidos do início por padrão (se nenhum caractere opcional for especificado). Veja também: rtrim(), trim().

Exemplos:

ltrim(last(/host/key)) #remove espaços em branco do início da string
       ltrim(last(/host/key),"Z") #remove qualquer 'Z' do início da string
       ltrim(last(/host/key)," Z") #remove qualquer espaço e 'Z' do início da string

mid(value,start,length)

Retorna uma substring de N caracteres começando na posição de caractere especificada por 'start'.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• start - posição inicial da substring;
  
• length - posições a serem retornadas na substring.

Por exemplo, é possível retornar 'abbi' de um valor como 'Zabbix' se a posição inicial for 2 e as posições a serem retornadas forem 4.

Exemplo:

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

repeat(value,count)

Repete uma string.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• count - o número de vezes a repetir.

Exemplo:

repeat(last(/host/key),2) #repete o valor duas vezes

replace(value,pattern,replacement)

Encontra o padrão no valor e substitui pelo valor de substituição. Todas as ocorrências do padrão serão substituídas.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• pattern - o padrão a ser encontrado;
  
• replacement - a string para substituir o padrão.

Exemplo:

replace(last(/host/key),"ibb","abb") #substitui todos os 'ibb' por 'abb'

right(value,count)

Retorna os caracteres mais à direita do valor.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• count - o número de caracteres a serem retornados.

Por exemplo, você pode retornar 'bix' de 'Zabbix' especificando 3 caracteres mais à direita para retornar. Veja também left().

Exemplo:

right(last(/host/key),3) #retorna três caracteres mais à direita

rtrim(value,<chars>)

Remove os caracteres especificados do final da string.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• chars (opcional) - especifica os caracteres a serem removidos.

Espaços em branco são removidos por padrão (se nenhum caractere opcional for especificado). Veja também: ltrim(), trim().

Exemplos:

rtrim(last(/host/key)) #remove espaços em branco do final da string
       rtrim(last(/host/key),"x") #remove qualquer 'x' do final da string
       rtrim(last(/host/key),"x ") #remove qualquer 'x' e espaço do final da string

trim(value,<chars>)

Remove os caracteres especificados do início e do final da string.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• chars (opcional) - especifica os caracteres a serem removidos.

Espaços em branco são removidos de ambos os lados por padrão (se nenhum caractere opcional for especificado). Veja também: ltrim(), rtrim().

Exemplos:

trim(last(/host/key)) #remove espaços em branco do início e do final da string
       trim(last(/host/key),"_") #remove '_' do início e do final da string

xmlxpath(value,path,<default>)

Retorna o resultado do XML XPath.
Tipos de valor suportados: String, Text, Log.

Parâmetros:

• value - o valor a ser verificado;
  
• path - o caminho (deve estar entre aspas);
  
• default - o valor opcional de fallback se a consulta XML XPath retornar um conjunto de nós vazio. Não será retornado se o resultado vazio não for um conjunto de nós (ou seja, string vazia). Em outros erros, a falha é retornada (por exemplo, "expressão inválida").

Exemplo:

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

Veja todas as funções suportadas.