9 Funciones de cadenas

Todas las funciones listadas aquí son compatibles en:

• Expresiones de disparadores
• Métricas calculadas

Las funciones se listan 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 la 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 tipo cadena deben ir entre comillas dobles; de lo contrario, podrían ser malinterpretados
• Los parámetros opcionales de la función (o partes del parámetro) se indican mediante < >

ascii(valor)

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

Parámetro:

• valor - el valor a comprobar

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

Ejemplo:

ascii(last(/equipo/clave))

bitlength(valor)

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

Parámetro:

• valor - el valor a comprobar

Ejemplo:

bitlength(last(/equipo/clave))

bytelength(value)

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

Parámetro:

• value - el valor a comprobar

Ejemplo:

bytelength(last(/equipo/clave))

char(valor)

Devuelve el carácter interpretando el valor como código ASCII.
Tipos de valor soportados: 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(/equipo/clave))

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

La cadena resultante de concatenar los valores de las métricas referenciadas o valores constantes.
Tipos de valores soportados: Cadena, Texto, Registro, Flotante, Entero.

Parámetro:

• valorX: el valor devuelto por una de las funciones de histórico 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(/equipo/clave),"bix")
       concat("1 min: ",last(/equipo/system.cpu.load[all,avg1]),", 15 min: ",last(/equipo/system.cpu.load[all,avg15]))

insert(value,start,length,replacement)

Inserta los caracteres o espacios especificados en la cadena de caracteres comenzando en la posición especificada en la cadena.
Tipos de valor soportados: Cadena, Texto, Registro.

Parámetros:

• value - el valor a comprobar;
  
• start - posición de inicio;
  
• length - posiciones a reemplazar;
  
• replacement - cadena de reemplazo.

Por ejemplo, un valor como 'Zabbbix' será reemplazado por 'Zabbix' si 'bb' (posición de inicio 3, posiciones a reemplazar 2) se reemplaza por 'b'.

Ejemplo:

insert(last(/equipo/clave),3,2,"b")

jsonpath(valor,ruta,<por_defecto>)

Devuelve el resultado de JSONPath.
Tipos de valor soportados: Cadena, Texto, Registro.

Parámetros:

• valor - el valor a comprobar;
  
• ruta - la ruta (debe ir entre comillas);
  
• por_defecto - el valor opcional de reserva si la consulta JSONPath no devuelve datos. Tenga en cuenta que en otros errores se devuelve un fallo (por ejemplo, "constructo no soportado").

Ejemplo:

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

left(value,count)

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

Parámetros:

• value - el valor a comprobar;
  
• count - el número de caracteres a devolver.

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

Ejemplo:

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

length(value)

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

Parámetro:

• value - el valor a comprobar.

Ejemplos:

length(last(/equipo/clave)) #la longitud del valor más reciente
       length(last(/equipo/clave,#3)) #la longitud del tercer valor más reciente
       length(last(/equipo/clave,#1:now-1d)) #la longitud del valor más reciente hace un día

ltrim(value,<chars>)

Elimina los caracteres especificados del principio de la cadena.
Tipos de valor soportados: Cadena, Texto, Log.

Parámetros:

• value - el valor a comprobar;
  
• chars (opcional) - especifica los caracteres a eliminar.

Por defecto, se eliminan los espacios en blanco al principio (si no se especifican caracteres opcionales). Véase también: rtrim(), trim().

Ejemplos:

ltrim(last(/equipo/clave)) #elimina los espacios en blanco del principio de la cadena
       ltrim(last(/equipo/clave),"Z") #elimina cualquier 'Z' del principio de la cadena
       ltrim(last(/equipo/clave)," Z") #elimina cualquier espacio y 'Z' del principio de la cadena

mid(valor,inicio,longitud)

Devuelve una subcadena de N caracteres comenzando en la posición de carácter especificada por 'inicio'.
Tipos de valor soportados: String, Text, Log.

Parámetros:

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

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

Ejemplo:

mid(last(/equipo/clave),2,4)="abbi"

repeat(value,count)

Repetir una cadena.
Tipos de valor soportados: Cadena, Texto, Registro.

Parámetros:

• value - el valor a comprobar;
  
• count - el número de veces a repetir.

Ejemplo:

repeat(last(/equipo/clave),2) #repetir el valor dos veces

replace(valor,patrón,reemplazo)

Busca el patrón en el valor y lo reemplaza por el reemplazo. Todas las ocurrencias del patrón serán reemplazadas.
Tipos de valor soportados: Cadena, Texto, Registro.

Parámetros:

• valor - el valor a comprobar;
  
• patrón - el patrón a buscar;
  
• reemplazo - la cadena por la que se reemplazará el patrón.

Ejemplo:

replace(last(/equipo/clave),"ibb","abb") #reemplaza todas las 'ibb' por 'abb'

right(valor,cuenta)

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

Parámetros:

• valor: el valor a comprobar;
  
• cuenta: el número de caracteres a devolver.

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

Ejemplo:

right(last(/equipo/clave),3) #devuelve los tres caracteres más a la derecha

rtrim(value,<chars>)

Elimina los caracteres especificados del final de la cadena.
Tipos de valor soportados: String, Text, Log.

Parámetros:

• value - el valor a comprobar;
  
• chars (opcional) - especifica los caracteres a eliminar.

Por defecto, se eliminan los espacios en blanco a la derecha (si no se especifican caracteres opcionales). Véase también: ltrim(), trim().

Ejemplos:

rtrim(last(/equipo/clave)) #elimina los espacios en blanco del final de la cadena
       rtrim(last(/equipo/clave),"x") #elimina cualquier 'x' del final de la cadena
       rtrim(last(/equipo/clave),"x ") #elimina cualquier 'x' y espacio del final de la cadena

trim(value,<chars>)

Elimina los caracteres especificados del principio y final de la cadena.
Tipos de valor soportados: Cadena, Texto, Registro.

Parámetros:

• value - el valor a comprobar;
  
• chars (opcional) - especifica los caracteres a eliminar.

Por defecto, se eliminan los espacios en blanco de ambos lados (si no se especifican caracteres opcionales). Véase también: ltrim(), rtrim().

Ejemplos:

trim(last(/equipo/clave)) #elimina los espacios en blanco del principio y final de la cadena
       trim(last(/equipo/clave),"_") #elimina '_' del principio y final de la cadena

xmlxpath(valor,ruta,<por_defecto>)

Devuelve el resultado de XML XPath.
Tipos de valor soportados: Cadena, Texto, Registro.

Parámetros:

• valor - el valor a comprobar;
  
• ruta - la ruta (debe ir entre comillas);
  
• por_defecto - el valor opcional de reserva si la consulta XML XPath devuelve un conjunto de nodos vacío. No se devolverá si el resultado vacío no es un conjunto de nodos (es decir, cadena vacía). En otros errores se devuelve fallo (por ejemplo, "expresión no válida").

Ejemplo:

xmlxpath(last(/equipo/xml_resultado),"/response/error/status")

Consulte todas las funciones compatibles.