Sidebar

1 Creando un item

Descripción general

Siga los siguientes pasos para crear un item en el Zabbix frontend:

  • Vaya a: ConfigurationHosts
  • De Click en Items en la fila del host
  • Click en Create item en la esquina superior derecha de la pantalla.
  • Agregue los parámetros del item en el formulario

También es posible crear un nuevo item si abrimos alguno existente, presionamos el botón Clone y después guardando utilizando un nombre diferente.

Configuración

La pestaña Item contiene los atributos generales del item.

Todos los campos obligatorios están marcados con un asterisco rojo.

Parámetro Descripción
Name Nombre del item.
Type Tipo de item. Vea las secciones individuales de tipos de item.
Key La key del item (hasta 2048 caractéres).
Los tipos de item soportados pueden ser encontrados en las secciones individuales de tipos de datos.
La key debe ser única dentro de un host.
Si el tipo de key es 'Zabbix agent', 'Zabbix agent (active)' o 'Simple check', el valor de la key debe ser soportado por el Zabbix agent o el Zabbix server.
Vea también: Los formatos de key correctos.
Type of information Tipo de información como será guardada en una base de datos después de procesar las conversiones, en caso de haberlas.
Numeric (unsigned) - Entero sin signo de 64bit
Numeric (float) - Número de punto flotante de 64bit.
Este tipo permitirá una presición de 15 dígitos y un rango aproximado de -1.79E+308 a 1.79E+308 (con excepción de PostgreSQL 11 y versiones anteriores).
También está soportado recibir los valores en notación científica. Por ejemplo. 1.23E+7, 1e308, 1.1E-4.
Character - Datos de texto corto
Log - Datos de texto largo con propiedades de log opcionales (timestamp, fuente, severidad, logeventid)
Text - Datos de texto largo. Vea también Límites de datos de texto.
Para keys de item que regresen datos solo en un formato específico, matching type of information (coincidir tipo de información) está seleccionada de manera automática.
Host interface Seleccione la interface del host. Este campo esta disponible cuando editamos un item a nivel de host.
Units Si un símbolo de unidad se encuentra definido, Zabbix realizará un post procesamiento del valor recibido y lo mostrará con el prefijo de unidad.
Por defecto, si el valor bruto excede 1000, este será dividido entre 1000 será mostrado respectivamente. Por ejemplo, si definimos bps y recibimos un valor de 881764, este serpa mostrado como 881.76 Kbps.
El estándar de memoria JEDEC es utilizado para el procesamiento de unidades B (byte), Bps (bytes por segundo), las cuales son divididas por 1024. Así, si las unidades son configuradas a B o Bps Zabbix mostrará:
1 como 1B/1Bps
1024 como 1KB/1KBps
1536 como 1.5KB/1.5KBps
Un procesamiento especial sera utilizado si usamos las siguientes unidades relacionadas con tiempo:
unixtime - traducido a "yyyy.mm.dd hh:mm:ss". Para traducirlo correctamente, el valor recibido debe ser un dato de tipo Numeric (unsigned).
uptime - traducido a "hh:mm:ss" o "N días, hh:mm:ss"
Por ejemplo, si se recibe un valor como 881764 (segundos), éste será mostrado como "10 días, 04:56:04"
s - traducido a "yyy mmm ddd hhh mmm sss ms"; el parámetro será tratado como número de segundos.
Por ejemplo, si se recibe un valor como 881764 (segundos), serpa mostrado como "10d 4h 56m"
Sólo las tres unidades mayores serán mostradas, como "1m 15d 5h" o "2h 4m 46s". Si no hay días para mostrar, sólo dos niveles serán mostrados - "1m 5h" (no se mostrarán minutos, segundos o milisegundos). Serán traducidos a "< 1 ms" si el valor es menor a 0.001.
Note que si una unidad lleva como prefijo !, entonces no se aplicará procesamiento/prefijo a los valores del ítem. Vea Conversión de unidades.
Update interval Obtiene un nuevo valor para este item cada N segundos. El máximo permitido para el intervalo de actualización es de 86400 segundos (1 día).
Sufijos de tiempo son soportados, por ejemplo. 30s, 1m, 2h, 1d.
Macros de usuario están soportados.
Un solo macro tiene que completar todo el campo. Macros múltiples en un campo, o macros combinados con texto no están soportados.
Note: El intervalo de actualización puede ser configurado a '0' solo si los intervalos personalizados existen con un valor diferente a cero. Si se configura a '0', y existe un intervalo personalizado (flexible o programado) con un valor diferente a cero, el item será obtenido durante el intervalo personalizado de duración.
Note que el primer item obtenido tras activar el item o después de cambiar el intervalo de actualización puede ocurrir antes que el valor configurado.
Un item pasivo puede obtener un valor de manera inmediata si presionamos el botón Execute now.
Custom intervals Puede crear reglas personalizadas para checar el item:
Flexible - crea una excepción al Update interval (intervalo con una frecuencia diferente)
Programado - crea un programa de obtención del item personalizado.
Para más detalles vea Custom intervals.
Sufijos de tiempo están soportados en el campo Interval , ejemplo. 30s, 1m, 2h, 1d.
Macros de usuario están soportados.
Un solo macro tiene que completar todo el campo. Macros múltiples en un campo, o macros combinados con texto no están soportados.
La programación de intervalos esta soportada desde Zabbix 3.0.0.
Nota: No está disponible para items activos del Zabbix agent.
History storage period Seleccione:
Do not keep history - El historial del item no será almacenado. Útil para items maestro si solo los items dependientes necesitan retener el historial.
Este valor no puede ser anulado por la configuración del housekeeper global.
Storage period - especifica la duración del detallado histórico en la base de datos (de 1 hora a 25 años). La información más antigua será borrada por el housekeeper. Guardado en segundos.
Sufijos de tiempo están soportados, por ejemplo. 2h, 1d. Los Macros de usuario están permitidos.
El valor Storage period puede ser reemplazado a nivel global en Administration → General → Housekeeper.
Si existe una configuración de reemplazo global, se mostrará un ícono de información verde . Si posiciona su ratón sobre el, se mostrará un mensaje de advertencia, por ejemplo, Overridden by global housekeeper settings (1d).
Se recomienda mantener los valores almacenados por el periodo de tiempo más bajo permitido para así reducir el tamaño del valor histórico en la base de datos. En lugar de mantener un histórico largo para estos datos, puede mantener un historial de tendencia de datos mas largo.
Vea también History and trends (historial y tendencias).
Trend storage period Seleccione:
Do not keep trends - las tendencias no serán almacenadas.
Este valor no puede ser reemplazado por la configuración global del housekeeper.
Storage period - especifica la duración del historial de los agregados (por hora mínimo, máximo, promedio, conteo, de 1 día a 25 años). La información más antigua será borrada por el housekeeper. Almacenado en segundos.
Sufijos de tiempo están soportados, por ejemplo. 24h, 1d. Macros de usuario están permitidos.
El valor Storage period puede ser reemplazado a nivel global en Administration → General → Housekeeper.
Si existe una configuración de reemplazo global, se mostrará un ícono de información verde . Si posiciona su ratón sobre el, se mostrará un mensaje de advertencia, por ejemplo, Overridden by global housekeeper settings (7d).
Nota: Conservar los trends no está disponible para datos no-numéricos - caracteres, log y texto.
Vea también History y trends.
Value mapping Aplica un mapeo de valores a este item. Value mapping no cambia los valores recibidos, sólo afecta la manera en que mostramos la información.
Funciona con items tipo Numeric(unsigned), Numeric(float) y Character.
Por ejemplo, "Estado de servicios Windows".
Log time format Disponible sólo para items tipo Log. Marcadores permitidos:
* y: Año (1970-2038)
* M: Mes(01-12)
* d: Día(01-31)
* h: Hora(00-23)
* m: Minuto (00-59)
* s: Segundo (00-59)
Si se deja vacío, el timestamp no será procesado.
Por ejemplo, considere la siguiente línea del archivo log de Zabbix agent:
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
Ésta comienza con seis posiciones de caracteres para el PID (identificador del proceso), seguido de la fecha, tiempo, y el resto de la línea.
El Log time format para esta línea puede ser "pppppp:yyyyMMdd:hhmmss".
Note que los caracteres "p" y ":" sólo son marcadores de posición (placeholders) y puede ser cualquier cosa menos "yMdhms".
Populates host inventory field Puede seleccionar un campo de inventario del host que el valor del item va a obtener. Esto va a funcionar si la obtención automática del inventario está habilitada en el host.
Este campo no está disponible si Type of information esta configurado como 'Log'.
Description Definir una descripción del item.
Enabled Marque esta casilla de selección para habilitar el item para que este pueda ser procesado.
Latest data Presione el enlace para ver el último valor para el item.
Éste enlace solo está disponible cuando editamos un item previamente existente.

Los campos específicos para el tipo de Item están descritos en sus páginas correspondientes.

Cuando editamos a nivel de host un item existente a nivel template, algunos campos serán de solo lectura. Puede utilizar el enlace en la parte superior del formulario e ir a nivel template y realizar las modificaciones ahí, considerando siempre que los cambios a nivel template modificaran el item en todos los host en los cuales el template está ligado.

La pestaña Tags permite definir tags a nivel de item.

Preprocesamiento de los valores del item

La pestaña Preprocessing permite definir las reglas de transformación para los valores recibidos.

Pruebas

Es posible realizar pruebas a un item y, si se configura correctamente, obtener un valor real en respuesta. Las pruebas puede ocurrir aún antes de que el item sea guardado

Las pruebas están disponibles para items de host y de template, prototipos de item y low-level discovery rules. Las pruebas no están disponibles para items activos.

Las pruebas de items están disponibles para los siguientes tipos de items pasivos:

  • Zabbix agent
  • SNMP agent (v1, v2, v3)
  • IPMI agent
  • SSH checks
  • Telnet checks
  • JMX agent
  • Simple checks (except icmpping*, vmware.* items)
  • Zabbix internal
  • Calculated items
  • External checks
  • Database monitor
  • HTTP agent
  • Script

Para probar un item, presione el botón Test en la parte inferior del formulario de configuración del item. Nótese que el botón Test estará deshabilitado para items que no pueden ser probados (como chequeos activos, exclusión de chequeos simples).

El formulario de prueba de items contiene campos para los parámetros de host requeridos (dirección del host, puerto, nombre del proxy/no proxy) y detalles específicos del item (como la comunidad SNMPv2 o las credenciales de seguridad SNMPv3). Estos campos son conscientes del contexto:

  • Los valores están prellenados cuando es posible, por ejemplo los items que requieren de un agent, al obtener la información de la interfaz del agent de ese host
  • Los valores se tienen que llenar de manera manual para items de template
  • Los valores de texto plano de los macros ya estarán resueltos
  • Los campos donde el valor (o parte del valor) son secretos o de tipo macro Vault estarán vacíos y se tendrán que llenar de manera manual. Si algún valor de parámetro del item contiene un valor secreto de macro, el siguiente mensaje de alerta será mostrad: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
  • Los campos estarán deshabilitados cuando no sean necesarios en el contexto del tipo de item (por ejemplo, el campo de la dirección del host y el valor del proxy están deshabilitados para items calculados)

Para probar el item, dé click en Get value. Si se obtiene el valor de manera satisfactoria, se llenara el campo Value, desplazando el valor actual (si hubiese) al campo Previous value calculando también el campo Prev. time, por ejemplo la diferencia de tiempo entre los dos valores (clicks) y tratando de detectar una secuencia EOL y cambiar a CRLF si se detecta "\n\r" en el valor obtenido.

Si la configuración es incorrecta, se mostrará un mensaje de error describiendo la posible causa.

Un valor obtenido exitoso desde el host también puede ser utilizado para probar los pasos de preproceso.

Botones de formulario

Los botones en la parte inferior del formulario permiten realizar varias operaciones.

Agregar un item. Éste botón solo está disponible ara nuevos items.
Actualizar las propiedades de un item.
Crear otro item basándonos en las propiedades del item actual.
Ejecuta la verificación del valor de un nuevo item de manera inmediata. Soportado sólo en verificaciones pasivas (vea más detalles).
Note que cuando verificamos un valor de manera inmediata, la configuración del caché no se actualiza, por lo que el valor no reflejará los cambios recientes a la configración del item.
Prueba si la configuración del item es correcta al obtener un valor.
Borra el history y el trend del item.
Borra el item.
Cancela la edición de las propiedades del item.

Límites de datos de texto

Los límites de datos de texto dependen de la base de datos utilizada. Antes de almacenar los valores de texto en la base de datos éstos son truncados para hacerlo coincidir con el límite del tipo de valor de la base de datos:

Base de datos Tipo de información
Character Log Text
MySQL 255 caracteres 65536 bytes 65536 bytes
PostgreSQL 255 caracteres 65536 caracteres 65536 caracteres
Oracle 255 caracteres 65536 caracteres 65536 caracteres

Conversión de unidades

Por defecto, especificar una unidad para un item resulta en un prefijo multiplicador que será agregado - por ejemplo, si obtenemos un valor '2048' con unidad 'B', éste se mostrará como '2KB'.

Para prevenir que una unidad sea convertida, utilice el prefijo !, por ejemplo, !B. Para comprender de una mejor manera cómo funciona la conversión con o sin el signo de exclamación, vea los siguientes ejemplos de valores y unidades:

1024 !B → 1024 B
       1024 B → 1 KB
       61 !s → 61 s
       61 s → 1m 1s
       0 !uptime → 0 uptime
       0 uptime → 00:00:00
       0 !! → 0 !
       0 ! → 0

Antes de Zabbix 4.0, existía una lista de espera de unidades precodificada que consistía en ms, rpm, RPM, %. Ésta lista de espera ha sido descartada, por lo que la manera correcta de prevenir convertir esas unidades es !ms, !rpm, !RPM, !%.

Límite de script personalizado

La longitud de los scripts personalizados disponibles depende de la base de datos utilizada:

Base de datos Límite en caracteres Limite en bytes
MySQL 65535 65535
Oracle Database 2048 4000
PostgreSQL 65535 ilimitada
SQLite (only Zabbix proxy) 65535 ilimitada

Items no soportados

Un item se puede convertirse en no soportado si su valor no puede ser obtenido por alguna razón. Éste item volverá a ser verificado según la configuración de su Intervalo de verificación.

Los items no soportados se reportan teniendo un estado NOT SUPPORTED.