Parámetro	Descripción
Nombre	Nombre del item. Se admiten macros de usuario.
Tipo	Tipo de item. Consulte las secciones individuales de tipos de item.
Clave	Clave del item (hasta 2048 caracteres). Las claves de item admitidas se pueden encontrar en las secciones individuales de tipos de item. La clave debe ser única dentro de un mismo host. Si el tipo de clave es 'Zabbix agent', 'Zabbix agent (active)' o 'Simple check', el valor de la clave debe ser compatible con el agent de Zabbix o el server de Zabbix. Consulte también: el formato de clave correcto.
Tipo de información	El tipo de dato utilizado para validar el valor del item y almacenarlo en la base de datos, ambos después de cualquier conversión: Numérico (sin signo) - entero sin signo de 64 bits; Numérico (coma flotante) - número de coma flotante de 64 bits; Carácter - texto corto; Log - texto largo con o sin propiedades de log (marca de tiempo, origen, gravedad, ID de evento de log); Texto - texto largo; Binario - número binario (solo compatible para items dependientes); JSON - datos JSON estructurados, almacenados de forma nativa en la base de datos (no compatible para items calculados). Los items que devuelven valores con el tipo de dato binario o JSON no son compatibles en fórmulas de items calculados o expresiones de triggers. Consulte los límites de datos de item para los límites de almacenamiento por tipo de dato y motor de base de datos. Para los items que devuelven datos en un formato específico único, se selecciona automáticamente un tipo de dato coincidente; por ejemplo, `system.cpu.load` y `system.cpu.util` devuelven ambos un número de coma flotante de 64 bits, por lo que Numérico (coma flotante) se selecciona automáticamente.
Interfaz de host	Seleccione la interfaz del host. Este campo está disponible al editar un item a nivel de host.
Unidades	Si se establece un símbolo de unidad, Zabbix aplica un postprocesamiento 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 usando hasta tres unidades de tiempo no nulas más grandes (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, formateada como yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); para un formato correcto, el valor recibido debe ser Numérico (sin signo). Para otras unidades (como Hz, W, etc.), si el valor recibido supera 1000, se divide por 1000 y se muestra con un prefijo correspondiente (5000 → 5 KHz, 881764 → 881.76 KW). Si el símbolo de unidad se antepone con `!`, la conversión y el prefijo de unidad se desactivan (1024 !B → 1024 B, 61 !s → 61 s). Para más ejemplos y detalles sobre los símbolos de unidad y la conversión de unidades, consulte Sufijos de valores de item.
Intervalo de actualización	Recupera un nuevo valor para este item cada N segundos. El intervalo 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 rellenar todo el campo. No se admiten varias macros en un campo ni macros mezcladas con texto. Nota: El intervalo de actualización solo se puede establecer 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. Nota que la primera consulta del item después de que el item se haya activado o después de un cambio en el intervalo de actualización puede ocurrir antes del valor configurado. Los nuevos items se comprobarán dentro de los 60 segundos posteriores a su creación, a menos que tengan un intervalo de actualización programado o flexible y el Intervalo de actualización esté establecido en 0. Un item pasivo existente puede ser consultado inmediatamente 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 diferente frecuencia). Programado - crea una programación de sondeo personalizada. Para 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 rellenar todo el campo. No se admiten varias macros en un campo ni macros mezcladas con texto.
Timeout	Establece el timeout de comprobación del item (disponible para los tipos de item admitidos). Seleccione la opción de timeout: Global - se utiliza el timeout global/proxy (mostrado en el campo Timeout atenuado). Anular - se utiliza un timeout personalizado (establecido en el campo Timeout; rango permitido: 1 - 600s). Se admiten sufijos de tiempo, por ejemplo, 30s, 1m, y macros de usuario. Al hacer clic en el enlace Timeouts puede configurar los timeouts del proxy o los timeouts globales (si no se utiliza un proxy). Tenga en cuenta que el enlace Timeouts solo es visible para los usuarios de tipo Super admin con permisos para las secciones de frontend Administración > General o Administración > Proxies.
Histórico	Seleccione una de las siguientes opciones: No almacenar - no se almacena el histórico del item. Útil para items maestros si solo los items dependientes necesitan mantener histórico. Esta configuración no puede ser anulada por la configuración global de housekeeper. Almacenar hasta - especifique la duración de conservación del histórico detallado en la base de datos (de 1 hora a 25 años). Los datos más antiguos serán eliminados por el housekeeper. Se almacena en segundos. Se admiten sufijos de tiempo, por ejemplo, 2h, 1d. Se admiten macros de usuario. El valor de Almacenar hasta puede ser anulado globalmente en Administración > Housekeeping. Si existe una configuración global que anula, se muestra un icono de información naranja . Si posiciona el ratón sobre él, se muestra un mensaje de advertencia, por ejemplo, Anulado por la configuración global de housekeeper (1d). Se recomienda mantener los valores registrados durante el menor tiempo posible para reducir el tamaño del histórico de valores en la base de datos. En lugar de almacenar un histórico largo de valores, puede almacenar datos de tendencias durante más tiempo. Consulte también Histórico y tendencias.
Tendencias	Seleccione una de las siguientes opciones: No almacenar - no se almacenan tendencias. Esta configuración no puede ser anulada por la configuración global de housekeeper. Almacenar hasta - especifique la duración de conservación del histórico agregado (mínimo, máximo, promedio, recuento por hora) en la base de datos (de 1 día a 25 años). Los datos más antiguos serán eliminados por el housekeeper. Se almacena en segundos. Se admiten sufijos de tiempo, por ejemplo, 24h, 1d. Se admiten macros de usuario. El valor de Almacenar hasta puede ser anulado globalmente en Administración > Housekeeping. Si existe una configuración global que anula, se muestra un icono de información naranja . Si posiciona el ratón sobre él, se muestra un mensaje de advertencia, por ejemplo, Anulado por la configuración global de housekeeper (7d). Nota: Mantener tendencias no está disponible para datos no numéricos - carácter, log y texto. Consulte también Histórico y tendencias.
Mapeo de valores	Aplicar mapeo de valores a este item. El mapeo de valores no cambia los valores recibidos, solo es para mostrar los datos. Funciona con items Numérico (sin signo), Numérico (coma flotante) y Carácter. Por ejemplo, "Estados de servicios de Windows".
Formato de tiempo de log	Disponible solo para items de tipo Log. 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, representando el 1 de enero de 1970. Por ejemplo, considere la siguiente línea del archivo de log del agent de Zabbix: " 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 tiempo de log 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 de inventario de host que el valor del item rellenará. Esto funcionará si el inventario automático está habilitado para el host y con items Numérico (sin signo), Numérico (coma 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 sea procesado. Cuando deshabilita el item, se elimina inmediatamente de la caché de histórico (excepto su último valor, que se mantiene para logs).
Últimos datos	Haga clic en el enlace para ver los últimos datos del item. Este enlace solo está disponible al editar un item ya existente.

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

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

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

Preprocesamiento de valores de ítems

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

Prueba de item

Para realizar la prueba de item, asegúrese de que la hora del sistema en el server y el proxy esté sincronizada. En el caso de que la hora del server esté atrasada, la prueba de item puede devolver un mensaje de error "The task has been expired." Sin embargo, establecer diferentes 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 bajo nivel de descubrimiento. La prueba no está disponible para items activos.

La prueba de item está disponible para los siguientes tipos de items pasivos:

Zabbix agent
SNMP agent (v1, v2, v3)
IPMI agent
Comprobaciones SSH
Comprobaciones Telnet
JMX agent
Comprobaciones simples (excepto icmpping*, vmware.* items)
Zabbix internal
Items calculados
Comprobaciones externas
Monitor de base de datos
HTTP agent
Script
Navegador

Para probar un item, haga clic en el botón Probar en la parte inferior del formulario de configuración del item. Tenga en cuenta que el botón Probar estará deshabilitado para los items que no se pueden probar (como comprobaciones activas, comprobaciones simples excluidas).

El formulario de prueba de item tiene campos para los parámetros requeridos del host (dirección del host, puerto, probar 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 contextuales:

Los valores se rellenan automáticamente cuando es posible, es decir, para los 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 de texto plano se resuelven.
Los campos donde el valor (o parte del valor) es una macro secreta o de Vault están 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: "El item contiene macros definidas por el usuario con valores secretos. Los valores de estas macros deben introducirse manualmente."
Los campos están deshabilitados cuando no se necesitan en el contexto del tipo de item (por ejemplo, el campo de dirección del host y el campo de proxy están deshabilitados para los items calculados)

Para probar el item, haga clic en Obtener valor. Si el valor se recupera correctamente, llenará el campo Valor, moviendo el valor actual (si lo hay) al campo Valor anterior mientras también calcula el campo Tiempo ant., 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 Obtener valor y probar para probar el preprocesamiento.

Los valores recuperados de un host y los resultados de las pruebas se truncan a un tamaño máximo de 512KB 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 los datos de más de 512KB aún se procesan completamente por el Zabbix server.

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

Un valor recuperado con éxito del host también puede utilizarse para probar los pasos de preprocesamiento.

Botones del formulario

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


	Agregar una métrica. Este botón solo está disponible para nuevas métricas.
	Actualizar las propiedades de una métrica.
	Crear otra métrica basada en las propiedades de la métrica actual.
	Ejecutar una comprobación para obtener un nuevo valor de la métrica inmediatamente. Solo es compatible con comprobaciones pasivas (ver más detalles). Nota que 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 de la métrica.
	Probar si la configuración de la métrica es correcta obteniendo un valor.
	Eliminar el historial y las tendencias de la métrica.
	Eliminar la métrica.
	Cancelar la edición de las propiedades de la métrica.

Límites de datos de item

Los límites de datos de item dependen del tipo de dato del item y del motor de 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 (flotantes) se almacenan tal cual y admiten aproximadamente de 15 a 17 dígitos de precisión, con un rango de aproximadamente -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 que coincidan con el límite del tipo de valor de la base de datos:

Base de datos	Tipo de información
	Carácter	Log	Texto
MySQL	255 caracteres	65536 bytes	65536 bytes
PostgreSQL	255 caracteres	65536 caracteres	65536 caracteres
SQLite (solo 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 el tipo de dato 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 (utilizada 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 soporte de valores JSON grandes.

Cuando Zabbix escribe cualquier dato de item en la base de datos, utiliza consultas INSERT y las registra (si DebugLevel está configurado en 4 o 5). Las entradas de log 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 recuperación de datos no ha finalizado. Si los datos se reciben parcialmente, el item se vuelve no soportado y se registra un mensaje de error (por ejemplo, si los datos se recopilan correctamente solo para 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)

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

Precedencia del tiempo 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 de Zabbix server o proxy no tiene ningún papel en las comprobaciones para las que se establecen tiempos de espera flexibles.

Soporte de tiempo de espera flexible

Se admiten tiempos de espera flexibles para estos tipos de item:

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

¹ Para comprobaciones SNMP heredadas (sondeo de un solo OID), se aplican los ajustes de tiempo de espera del server o proxy.
² Para los items icmpping*, el valor de tiempo de espera se especifica directamente en la clave del item; también se aplica un tiempo de espera máximo codificado de 600 segundos. Los items de monitorización de VMware utilizan su propio parámetro VMwareTimeout de la configuración del server o 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).

What’s next?

1 Formato de clave de métrica

Docs

1 Creando una métrica

Descripción general

Configuración