Siga los siguientes pasos para crear un item en el Zabbix frontend:
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.
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 ![]() 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 ![]() 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.
La pestaña Preprocessing permite definir las reglas de transformación para los valores recibidos.
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:
icmpping*
, vmware.*
items)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:
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.
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. |
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 |
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
, !%
.
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 |
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.