Parámetro	Descripción
Nombre	Nombre del item. Se admiten macros de usuario.
Tipo	Tipo de item. Consulte las secciones individuales sobre tipos de item.
Clave	Clave del item (hasta 2048 caracteres). Las claves de item admitidas se encuentran en las secciones individuales sobre tipos de item. La clave debe ser única dentro de un solo host. Si el tipo de clave es 'Zabbix agent', 'Zabbix agent (active)' o 'Simple check', el valor de la clave debe ser compatible con Zabbix agent o Zabbix server. Consulte también el formato correcto de la clave.
Tipo de información	Tipo de datos utilizado para validar el valor del item y almacenarlo en la base de datos, tanto antes como después de cualquier conversión: Numérico (sin signo): entero sin signo de 64 bits; Numérico (flotante): número de coma flotante de 64 bits; Carácter: texto corto; Registro: texto largo con o sin propiedades de registro (marca de tiempo, origen, gravedad, ID del evento de registro); Texto: texto largo; Binario: número binario (admitido únicamente para items dependientes); JSON: datos JSON estructurados, almacenados de forma nativa en la base de datos (no admitido para items calculados). Los items que devuelven valores con el tipo de datos binario o JSON no se admiten en fórmulas de items calculados ni en expresiones de trigger. Consulte límites de datos de los items para conocer los límites de almacenamiento por tipo de datos y backend de base de datos. Para los items que devuelven datos en un único formato específico, se selecciona automáticamente un tipo de datos coincidente; por ejemplo, `system.cpu.load` y `system.cpu.util` devuelven un número de coma flotante de 64 bits, por lo que Numérico (flotante) se selecciona automáticamente.
Interfaz del host	Seleccione la interfaz del host. Este campo está disponible al editar un item en el nivel del host.
Unidades	Si se establece un símbolo de unidad, Zabbix aplica un posprocesamiento al valor recibido del item y lo muestra con el sufijo de unidad especificado. Símbolos de unidad admitidos con formato especial (y ejemplos de valor recibido → valor mostrado): B: bytes (1024 → 1 KB) Bps: bytes por segundo (1024 → 1 KBps) s: segundos, mostrados utilizando hasta las tres unidades de tiempo más grandes distintas de cero (881764 → 10d 4h 56m) uptime: tiempo transcurrido en hh:mm:ss o N días, hh:mm:ss (881764 → 10 días, 04:56:04) unixtime: marca de tiempo Unix, con formato yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); para obtener el formato correcto, el valor recibido del item debe ser Numérico (sin signo). Para otras unidades (como Hz, W, etc.), si el valor recibido supera 1000, se divide entre 1000 y se muestra con el prefijo correspondiente (5000 → 5 KHz, 881764 → 881.76 KW). Si el símbolo de unidad lleva el prefijo `!`, se deshabilitan la conversión y la aplicación de prefijos (1024 !B → 1024 B, 61 !s → 61 s). Para consultar más ejemplos y detalles sobre los símbolos de unidad y la conversión de unidades, consulte Sufijos de los valores de los items.
Intervalo de actualización	Recupere un nuevo valor para este item cada N segundos. El intervalo de actualización máximo permitido es de 86400 segundos (1 día). Se admiten sufijos de tiempo, por ejemplo, 30s, 1m, 2h, 1d. Se admiten macros de usuario. Una sola macro debe ocupar todo el campo. No se admiten varias macros en un campo ni macros combinadas con texto. Nota: El intervalo de actualización solo puede establecerse en '0' si existen intervalos personalizados con un valor distinto de cero. Si se establece en '0' y existe un intervalo personalizado (flexible o programado) con un valor distinto de cero, el item se sondeará durante la duración del intervalo personalizado. Tenga en cuenta que el primer sondeo del item después de que este se active o después de cambiar el intervalo de actualización puede producirse antes del valor configurado. Los nuevos items se comprobarán en un plazo de 60 segundos desde su creación, a menos que tengan un intervalo de actualización programado o flexible y Intervalo de actualización esté establecido en 0. Un item pasivo existente puede sondearse inmediatamente para obtener su valor pulsando el botón Ejecutar ahora.
Intervalos personalizados	Puede crear reglas personalizadas para comprobar el item: Flexible: crea una excepción al Intervalo de actualización (intervalo con una frecuencia diferente). Programación: crea una programación de sondeo personalizada. Para obtener información detallada, consulte Intervalos personalizados. Se admiten sufijos de tiempo en el campo Intervalo, por ejemplo, 30s, 1m, 2h, 1d. Se admiten macros de usuario. Una sola macro debe ocupar todo el campo. No se admiten varias macros en un campo ni macros combinadas con texto.
Tiempo de espera	Establezca el tiempo de espera de la comprobación del item (disponible para los tipos de item admitidos). Seleccione la opción de tiempo de espera: Global: se utiliza el tiempo de espera del proxy/global (se muestra en el campo Tiempo de espera atenuado). Anulación: se utiliza un tiempo de espera personalizado (establecido en el campo Tiempo de espera; rango permitido: 1 - 600s). Se admiten sufijos de tiempo, por ejemplo, 30s, 1m, y macros de usuario. Al hacer clic en el enlace Tiempos de espera, puede configurar los tiempos de espera del proxy o los tiempos de espera globales (si no se utiliza un proxy). Tenga en cuenta que el enlace Tiempos de espera solo está visible para los usuarios de tipo Super admin con permisos para las secciones del frontend Administración > General o Administración > Proxies.
Historial	Seleccione una de las siguientes opciones: No almacenar: no se almacena el historial del item. Es útil para items maestros si solo los items dependientes necesitan conservar el historial. Esta configuración no puede anularse mediante las configuraciones globales del housekeeper. Almacenar hasta: especifique durante cuánto tiempo se conservará el historial detallado en la base de datos (de 1 hora a 25 años). El housekeeper eliminará los datos más antiguos. Se almacena en segundos. Se admiten sufijos de tiempo, por ejemplo, 2h, 1d. Se admiten macros de usuario. El valor de Almacenar hasta puede anularse globalmente en Administración > Mantenimiento. Si existe una configuración global de anulación, se muestra un icono de información naranja . Al colocar el cursor sobre él, se muestra un mensaje de advertencia, por ejemplo, Anulado por la configuración global del housekeeper (1d). Se recomienda conservar los valores registrados durante el menor tiempo posible para reducir el tamaño del historial de valores en la base de datos. En lugar de almacenar un historial de valores extenso, puede almacenar datos de tendencias durante más tiempo. Consulte también Historial y tendencias.
Tendencias	Seleccione una de las siguientes opciones: No almacenar: no se almacenan las tendencias. Esta configuración no puede anularse mediante las configuraciones globales del housekeeper. Almacenar hasta: especifique durante cuánto tiempo se conservará en la base de datos el historial agregado (mínimo, máximo, promedio y cantidad por hora) (de 1 día a 25 años). El housekeeper eliminará los datos más antiguos. Se almacena en segundos. Se admiten sufijos de tiempo, por ejemplo, 24h, 1d. Se admiten macros de usuario. El valor de Almacenar hasta puede anularse globalmente en Administración > Mantenimiento. Si existe una configuración global de anulación, se muestra un icono de información naranja . Al colocar el cursor sobre él, se muestra un mensaje de advertencia, por ejemplo, Anulado por la configuración global del housekeeper (7d). Nota: La conservación de tendencias no está disponible para datos no numéricos: carácter, registro y texto. Consulte también Historial y tendencias.
Asignación de valores	Aplique una asignación de valores a este item. La asignación de valores no cambia los valores recibidos; solo sirve para mostrar los datos. Funciona con items Numérico (sin signo), Numérico (flotante) y Carácter. Por ejemplo, "Estados de los servicios de Windows".
Formato de hora del registro	Disponible únicamente para items de tipo Registro. Marcadores de posición admitidos: 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 en blanco, la marca de tiempo se establecerá en 0 en tiempo Unix, lo que representa el 1 de enero de 1970. Por ejemplo, considere la siguiente línea del archivo de registro de Zabbix agent: " 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)." Comienza con seis posiciones de caracteres para el PID, seguidas de la fecha, la hora y el resto del mensaje. El formato de hora del registro para esta línea sería "pppppp:yyyyMMdd:hhmmss". Tenga en cuenta que los caracteres "p" y ":" son marcadores de posición y pueden ser cualquier carácter excepto "yMdhms".
Rellena el campo de inventario del host	Puede seleccionar un campo del inventario del host que se rellenará con el valor del item. Esto funcionará si la población automática del inventario está habilitada para el host y con items Numérico (sin signo), Numérico (flotante), Carácter y Texto.
Descripción	Introduzca una descripción del item. Se admiten macros de usuario.
Habilitado	Marque la casilla para habilitar el item y que pueda procesarse. Al deshabilitar el item, se elimina inmediatamente de la caché del historial (excepto su último valor, que se conserva para los registros).
Datos más recientes	Haga clic en el enlace para ver los datos más recientes del item. Este enlace solo está disponible al editar un item ya existente.

Los campos específicos del tipo de item se describen en las páginas correspondientes.

Al editar en el nivel de un host un item existente de nivel de template, varios campos son de solo lectura. Puede utilizar el enlace del encabezado del formulario para ir al nivel del template y editarlos allí, teniendo en cuenta que los cambios realizados en el nivel del template modificarán el item para todos los hosts a los que esté vinculado el template.

La pestaña Etiquetas permite definir etiquetas a nivel del item.

Preprocesamiento de valores de item

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

Prueba de item

Para realizar la prueba de un item, asegúrese de que la hora del sistema en el server y el proxy esté sincronizada. En caso de que la hora del server esté atrasada, la prueba del item puede devolver el mensaje de error "The task has been expired." Sin embargo, haber configurado distintas zonas horarias en el server y el proxy no afectará el resultado de la prueba.

Es posible probar un item y, si está configurado correctamente, obtener un valor real como resultado. La prueba puede realizarse incluso antes de guardar un item.

La prueba está disponible para items de host y template, prototipos de item y reglas de descubrimiento de bajo nivel. La prueba no está disponible para items activos.

La prueba de item está disponible para los siguientes tipos de item 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
Browser

Para probar un item, haga clic en el botón Test en la parte inferior del formulario de configuración del item. Tenga en cuenta que el botón Test estará deshabilitado para los items que no pueden probarse (como las comprobaciones activas, los simple checks excluidos).

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

Los valores se rellenan previamente cuando es posible; es decir, para items que requieren un agent, tomando la información de la interfaz de agent seleccionada del host.
Los valores deben rellenarse manualmente para los items de template.
Los valores de macros en texto plano se resuelven.
Los campos cuyo valor (o parte del valor) sea un secreto o una macro de Vault quedan vacíos y deben introducirse manualmente. Si algún parámetro del item contiene un valor de macro secreto, se muestra el siguiente mensaje de advertencia: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
Los campos se deshabilitan cuando no son necesarios en el contexto del tipo de item (por ejemplo, el campo de dirección del host y el campo de proxy se deshabilitan para los calculated items)

Para probar el item, haga clic en Get value. Si el valor se recupera correctamente, se rellenará el campo Value, moviendo el valor actual (si existe) al campo Previous value y calculando también el campo Prev. time, es decir, la diferencia de tiempo entre los dos valores (clics), e intentando detectar una secuencia EOL y cambiar a CRLF si detecta "\n\r" en el valor recuperado.

Haga clic en Get value and test para probar el preprocessing.

Los valores recuperados de un host y los resultados de la prueba se truncan a un tamaño máximo de 512 KB cuando se envían al frontend. Si un resultado de prueba se trunca, se muestra un icono de advertencia; pase el cursor sobre él para ver los detalles. Si un valor se trunca, puede fallar la validación del tipo de datos en pruebas consecutivas que comparan valores grandes (por ejemplo, JSON); en tales casos, se muestra un mensaje de error. Tenga en cuenta que Zabbix server sigue procesando completamente los datos de más de 512 KB.

Si la configuración es incorrecta, se muestra un mensaje de error que describe la posible causa.

Un valor recuperado correctamente desde el host también puede utilizarse para probar los pasos de preprocessing.

Botones del formulario

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


	Añadir un item. Este botón solo está disponible para items nuevos.
	Actualizar las propiedades de un item.
	Crear otro item basándose en las propiedades del item actual.
	Ejecutar inmediatamente una comprobación para obtener un nuevo valor del item. Solo se admite para comprobaciones pasivas (consulte más información). Nota: al comprobar un valor inmediatamente, la caché de configuración no se actualiza, por lo que el valor no reflejará los cambios más recientes en la configuración del item.
	Comprobar si la configuración del item es correcta obteniendo un valor.
	Eliminar el historial y las tendencias del item.
	Eliminar el item.
	Cancelar la edición de las propiedades del item.

Límites de datos de item

Los límites de datos de item dependen del tipo de datos del item y del backend de la base de datos.

Los valores numéricos (sin signo) se almacenan tal cual. Si se recibe un valor de punto flotante, solo se almacena la parte entera (por ejemplo, 1.23 → 1).

Los valores numéricos (float) se almacenan tal cual y admiten aproximadamente de 15 a 17 dígitos de precisión, con un rango aproximado de -1.79E+308 a 1.79E+308. También se admiten valores en notación científica (por ejemplo, 1.23E+7, 1e308, 1.1E-4).

Los valores de texto se truncan antes de almacenarse para ajustarse al límite del tipo de valor de la base de datos:

Database	Type of information
	Character	Log	Text
MySQL	255 caracteres	65536 bytes	65536 bytes
PostgreSQL	255 caracteres	65536 caracteres	65536 caracteres
SQLite (only Zabbix proxy)	255 caracteres	65536 caracteres	65536 caracteres

Los valores binarios están limitados a 16MiB (16777216 bytes). Los valores que superan este límite se descartan y se muestra un error correspondiente en el frontend.

Los valores con tipo de datos JSON están limitados a 128MiB (134217728 bytes). Los valores que superan este límite se descartan y se muestra un error correspondiente en el frontend. Para MySQL/MariaDB, considere configurar particiones diarias para la tabla history_json (usada para almacenar valores JSON), ya que puede crecer rápidamente y bloquear el housekeeper durante un período prolongado. Si su caso de uso implica valores JSON grandes (1MiB o más), consulte cómo configurar su sistema para compatibilidad con valores JSON grandes.

Cuando Zabbix escribe cualquier dato de item en la base de datos, utiliza consultas INSERT y las registra (si DebugLevel está establecido en 4 o 5). Las entradas de registro grandes se truncan a 64KB.

Límite de script personalizado

La longitud disponible para scripts personalizados depende de la base de datos utilizada:

Base de datos	Límite en caracteres	Límite en bytes
MySQL	65535	65535
PostgreSQL	65535	sin límite
SQLite (solo proxy Zabbix)	65535	sin límite

Tiempo de espera del item

El tiempo de espera del item especifica cuánto tiempo debe esperar Zabbix antes de abortar la comprobación como fallida.

Cuando se alcanza el tiempo de espera, la comprobación se aborta incluso si la obtención de datos no ha finalizado. Si los datos se reciben parcialmente, el item pasa a estar no compatible y se registra un mensaje de error (por ejemplo, si solo se recopilan correctamente datos de uno de varios OID en una comprobación SNMP).

Para muchos tipos de item, puede establecer tiempos de espera de item flexibles:

por item individual
por tipo de item (a nivel de proxy)
por tipo de item (a nivel global global)

Un tiempo de espera personalizado por item individual es útil si desea especificar un tiempo de espera más largo para un item concreto, manteniendo bajos los tiempos de espera de otros items.

Precedencia de los tiempos de espera

El tiempo de espera de un item individual anula cualquier otro tiempo de espera.
Los tiempos de espera a nivel de proxy anulan los tiempos de espera globales.

El tiempo de espera de la configuración del server o del proxy de Zabbix no influye en las comprobaciones para las que se han establecido tiempos de espera flexibles.

Compatibilidad con tiempos de espera flexibles

Los tiempos de espera flexibles de los item son compatibles con estos tipos de item:

Zabbix agent (tanto comprobaciones pasivas como activas)
SNMP agent (excepto las comprobaciones SNMP heredadas¹)
Simple check (excepto icmpping* y los item de VMware²)
SSH agent
Telnet agent
External check
Database monitor
Script
HTTP agent
Browser

¹ Para las comprobaciones SNMP heredadas (sondeo de un solo OID), se aplican los ajustes de tiempo de espera del server o del proxy.
² Para los item icmpping*, el valor de tiempo de espera se especifica directamente en la clave del item; además, se aplica un tiempo de espera máximo fijo posible de 600 segundos. Los item de supervisión de VMware usan su propio parámetro VMwareTimeout de la configuración del server o del proxy.

Items no soportados

Los items no soportados se informan con el estado No soportado y se vuelven a comprobar en su Intervalo de actualización estándar.

Un item se vuelve no soportado si su valor no puede recuperarse por alguna razón (por ejemplo, error de conexión, no hay pollers configurados para procesar el item). Además, los items que no reciben datos históricos permanecen en el estado No soportado. Este es el comportamiento esperado: un item pasa al estado Normal solo cuando recibe nuevos datos históricos válidos.

Al igual que los problemas, los items no soportados solo se reevalúan cuando se reciben nuevos datos, incluso si ya no hay datos históricos disponibles para ese item. En otras palabras, los items y triggers cambian su estado únicamente al recibir nuevos datos. Sin embargo, si una expresión de trigger incluye una función de fecha y hora y/o nodata(), el trigger se recalculará cada 30 segundos (consulte tiempo de cálculo de triggers para más detalles).

¿Qué sigue?

Formato de la clave de item

Docs

Creación de un item

Descripción general

Configuración