9 Funciones de cadena

Todas las funciones enumeradas aquí son compatibles con:

• Expresiones de iniciador
• Métricas calculadas

Las funciones se enumeran sin información adicional. Haga clic en la función para ver los detalles completos.

Detalles de la función

Algunas notas generales sobre los parámetros de función:

• Los parámetros de la función están separados por una coma.
• Se aceptan expresiones como parámetros.
• Los parámetros de cadena deben estar entre comillas dobles; de lo contrario podrían obtener mal interpretado
• Los parámetros de función opcionales (o partes de parámetros) se indican mediante < >

ascii (valor)

El código ASCII del carácter más a la izquierda del valor.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar

Por ejemplo, un valor como 'Abc' devolverá '65' (código ASCII para 'A').

Ejemplo:

ascii(last(/host/key))

bitlength(valor)

La longitud del valor en bits.
Tipos de valores admitidos: Cadena, Texto, Registro, Entero.

Parámetro:

• valor - el valor a comprobar

Ejemplo:

bitlength(last(/host/key))

bytelength(valor)

La longitud del valor en bytes.
Tipos de valores admitidos: Cadena, Texto, Registro, Entero.

Parámetro:

• valor - el valor a comprobar

Ejemplo:

bytelength(last(/host/key))

char(valor)

Devuelve el carácter interpretando el valor como código ASCII.
Tipos de valores admitidos: Entero.

Parámetro:

• valor - el valor a comprobar

El valor debe estar en el rango 0-255. Por ejemplo, un valor como '65' (interpretado como código ASCII) devolverá 'A'.

Ejemplo:

char(last(/host/key))

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

La cadena resultante de concatenar los valores de la métrica referenciada o los valores constantes.
Tipos de valores admitidos: Cadena, Texto, Registro, Float, Entero.

Parámetro:

• valorX: el valor devuelto por una de las funciones históricas o un valor constante (cadena, entero o número flotante). Debe contener al menos dos parámetros.

Por ejemplo, un valor como 'Zab' concatenado con 'bix' (la cadena constante) devolverá 'Zabbix'.

Ejemplos:

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)

Insert specified characters or spaces into the character string beginning at the specified position in the string.
Supported value types: String, Text, Log.

Parameter:

• value - the value to check;
  
• start - start position;
  
• length - positions to replace;
  
• replacement - replacement string.

For example, a value like 'Zabbbix' will be replaced by 'Zabbix' if 'bb' (starting position 3, positions to replace 2) is replaced by 'b'.

Example:

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

jsonpath(value,path,<default>)

Return JSONPath result.
Supported value types: String, Text, Log.

Parameters:

• value - the value to check;
  
• path - the path (must be quoted);
  
• default - the optional fallback value if the JSONPath query returns no data. Note that on other errors failure is returned (e.g. "unsupported construct").

Example:

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

left(valor, contar)

Devuelve los caracteres más a la izquierda del valor.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar;
  
• contar: el número de caracteres que se devolverán.

Por ejemplo, puede devolver 'Zab' desde 'Zabbix' especificando 3 caracteres situados más a la izquierda para devolver. Véase también right().

Ejemplo:

left(last(/host/key),3) #devuelve los tres caracteres más a la izquierda

length(valor)

La longitud del valor en caracteres.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor: el valor a comprobar.

Ejemplos:

length(last(/host/key)) #la longitud del último valor
       length(last(/host/key,#3)) #la longitud del tercer valor más reciente
       length(last(/host/key,#1:now-1d)) #la longitud del valor más reciente de hace un día

ltrim(valor,<caracteres>)

Elimina los caracteres especificados desde el principio de la cadena.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar;
  
• caracteres (opcional): especifique los caracteres que desea eliminar.

Los espacios en blanco se recortan a la izquierda de forma predeterminada (si no se especifican caracteres opcionales). Ver también: rtrim(), trim().

Ejemplos:

ltrim(last(/host/key)) #eliminar espacios en blanco desde el principio de la cadena
       ltrim(last(/host/key),"Z") #eliminar cualquier 'Z' del principio de la cadena
       ltrim(last(/host/key)," Z") #elimina cualquier espacio y 'Z' del principio de la cadena

mid(valor,inicio,longitud)

Devuelve una subcadena de N caracteres que comienza en la posición del carácter especificada por 'inicio'.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar;
  
• inicio - posición inicial de la subcadena;
  
• longitud - posiciones para devolver en la subcadena.

Por ejemplo, es posible devolver 'abbi' a partir de un valor como 'Zabbix' si la posición inicial es 2 y las posiciones a devolver son 4.

Ejemplo:

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

repeat(valor,count)

Repetir una cadena.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar;
  
• count - el número de veces que se repetirá.

Ejemplo:

repeat(last(/host/key),2) #repetir el valor dos veces

replace(valor, patrón, reemplazo)

Encuentre el patrón en el valor y reemplácelo con reemplazo. Se reemplazarán todas las apariciones del patrón.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar;
  
• patrón - el patrón a encontrar;
  
• reemplazo - la cadena con la que reemplazar el patrón.

Ejemplo:

replace(last(/host/key),"ibb","abb") - reemplaza todo 'ibb' con 'abb'

right(valor, contar)

Devuelve los caracteres situados más a la derecha del valor.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar;
  
• contar: el número de caracteres que se devolverán.

Por ejemplo, puede devolver 'bix' de 'Zabbix' especificando 3 caracteres situados más a la derecha para devolver. Véase también left().

Ejemplo:

right(last(/host/key),3) #devuelve tres caracteres situados más a la derecha

rtrim(valor,<caracteres>)

Elimina los caracteres especificados al final de la cadena.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar;
  
• caracteres (opcional): especifique los caracteres que desea eliminar.

Los espacios en blanco se recortan a la derecha de forma predeterminada (si no se especifican caracteres opcionales). Ver también: ltrim(), trim().

Ejemplos:

rtrim(last(/host/key)) #eliminar espacios en blanco del final de la cadena
       rtrim(last(/host/key),"x") #eliminar cualquier 'x' del final de la cadena
       rtrim(last(/host/key),"x ") #eliminar cualquier 'x' y espacio del final de la cadena

trim(valor,<caracteres>)

Elimina los caracteres especificados al principio y al final de la cadena.
Tipos de valores admitidos: Cadena, Texto, Registro.

Parámetro:

• valor - el valor a comprobar;
  
• caracteres (opcional): especifique los caracteres que desea eliminar.

Los espacios en blanco se recortan de ambos lados de forma predeterminada (si no se especifican caracteres opcionales). Ver también: ltrim(), rtrim().

Ejemplos:

trim(last(/host/key)) - elimina los espacios en blanco del principio y el final de la cadena
       trim(last(/host/key),"_") - elimina '_' del principio y del final de la cadena

xmlxpath(value,path,<default>)

Return XML XPath result.
Supported value types: String, Text, Log.

Parameters:

• value - the value to check;
  
• path - the path (must be quoted);
  
• default - the optional fallback value if the XML XPath query returns an empty nodeset. It will not be returned if the empty result is not a nodeset (i.e., empty string). On other errors failure is returned (e.g. "invalid expression").

Example:

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

Consulte todas las funciones admitidas.