Table of Contents

4 Equipos

4 Equipos

Descripción general

Los equipos se exportan con muchos objetos relacionados y relaciones entre objetos.

La exportación de equipo contiene:

Grupos de equipos vinculados
Datos del equipo
Enlace de plantilla
Vinculación del grupo de equipos
Interfaces del equipo
Métricas vinculadas directamente
Iniciadores vinculados directamente
Gráficos vinculados directamente
Reglas de descubrimiento vinculadas directamente con todos los prototipos.
Escenarios web vinculados directamente
Macros de equipo
Datos de inventario de equipo
Mapas de valores

Exportando

Para exportar equipos, haga lo siguiente:

Vaya a Recopilación de datos → Equipos.
Marque las casillas de verificación de los equipos a exportar.
Haga clic en Exportar debajo de la lista.

Dependiendo del formato seleccionado, los equipos se exportan a un archivo local con un nombre predeterminado:

zabbix_export_hosts.yaml - en exportación YAML (opción predeterminada para exportar);
zabbix_export_hosts.xml - en exportación XML;
zabbix_export_hosts.json - en exportación JSON.

Importación

Para importar equipos, haga lo siguiente:

Vaya a Recopilación de datos → Equipos.
Haga clic en Importar a la derecha.
Seleccione el archivo de importación.
Haga clic en Importar.

Si marca la casilla de verificación Opciones avanzadas, se mostrará una lista detallada de todos los elementos importables: marque o desmarque cada regla de importación según sea necesario.

Si hace clic en la casilla de verificación en la fila Todos, todos los elementos debajo de ella quedarán marcados/desmarcados.

Reglas de importación:

Regla	Descripción
Actualizar existente	Los elementos existentes se actualizarán con los datos tomados del archivo de importación. De lo contrario no se actualizarán.
Crear nuevo	La importación agregará nuevos elementos utilizando datos del archivo de importación. De lo contrario no los agregará.
Eliminar faltante	La importación eliminará los elementos existentes que no están presentes en el archivo de importación. De lo contrario, no los eliminará. Si se marca Eliminar faltante para vinculación de plantilla, se desvinculará la vinculación de plantilla existente que no esté presente en el archivo de importación. Las entidades (elementos, activadores, gráficos, etc.) heredadas de las plantillas desvinculadas no se eliminarán (a menos que también se seleccione la opción Eliminar faltantes para cada entidad).

Se mostrará un mensaje de éxito o fracaso de la importación en el Interfaz.

Formato de exportación

Formato de exportación en YAML:

zabbix_export:
         version: '6.4'
         host_groups:
           - uuid: f2481361f99448eea617b7b1d4765566
             name: 'Discovered hosts'
           - uuid: 6f6799aa69e844b4b3918f779f2abf08
             name: 'Zabbix servers'
         hosts:
           - host: 'Zabbix server 1'
             name: 'Main Zabbix server'
             templates:
               - name: 'Linux by Zabbix agent'
               - name: 'Zabbix server health'
             groups:
               - name: 'Discovered hosts'
               - name: 'Zabbix servers'
             interfaces:
               - ip: 192.168.1.1
                 interface_ref: if1
             items:
               - name: 'Zabbix trap'
                 type: TRAP
                 key: trap
                 delay: '0'
                 history: 1w
                 preprocessing:
                   - type: MULTIPLIER
                     parameters:
                       - '8'
                 tags:
                   - tag: Application
                     value: 'Zabbix server'
                 triggers:
                   - expression: 'last(/Zabbix server 1/trap)=0'
                     name: 'Last value is zero'
                     priority: WARNING
                     tags:
                       - tag: Process
                         value: 'Internal test'
             tags:
               - tag: Process
                 value: Zabbix
             macros:
               - macro: '{$HOST.MACRO}'
                 value: '123'
               - macro: '{$PASSWORD1}'
                 type: SECRET_TEXT
             inventory:
               type: 'Zabbix server'
               name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC
               os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64'
             inventory_mode: AUTOMATIC
         graphs:
           - name: 'CPU utilization server'
             show_work_period: 'NO'
             show_triggers: 'NO'
             graph_items:
               - drawtype: FILLED_REGION
                 color: FF5555
                 item:
                   host: 'Zabbix server 1'
                   key: 'system.cpu.util[,steal]'
               - sortorder: '1'
                 drawtype: FILLED_REGION
                 color: 55FF55
                 item:
                   host: 'Zabbix server 1'
                   key: 'system.cpu.util[,softirq]'
               - sortorder: '2'
                 drawtype: FILLED_REGION
                 color: '009999'
                 item:
                   host: 'Zabbix server 1'
                   key: 'system.cpu.util[,interrupt]'
               - sortorder: '3'
                 drawtype: FILLED_REGION
                 color: '990099'
                 item:
                   host: 'Zabbix server 1'
                   key: 'system.cpu.util[,nice]'
               - sortorder: '4'
                 drawtype: FILLED_REGION
                 color: '999900'
                 item:
                   host: 'Zabbix server 1'
                   key: 'system.cpu.util[,iowait]'
               - sortorder: '5'
                 drawtype: FILLED_REGION
                 color: '990000'
                 item:
                   host: 'Zabbix server 1'
                   key: 'system.cpu.util[,system]'
               - sortorder: '6'
                 drawtype: FILLED_REGION
                 color: '000099'
                 calc_fnc: MIN
                 item:
                   host: 'Zabbix server 1'
                   key: 'system.cpu.util[,user]'
               - sortorder: '7'
                 drawtype: FILLED_REGION
                 color: '009900'
                 item:
                   host: 'Zabbix server 1'
                   key: 'system.cpu.util[,idle]'

Etiquetas de elementos

Los valores de las etiquetas de elementos se explican en la siguiente tabla.

Etiquetas de equipo

Elemento	Propiedad de elemento	Requerido	Tipo	Rango¹	Descripción
groups		x			Elemento raíz para grupos de equipos.
	name	x	`string`		Nombre de grupo de equipos.
hosts		-			Elemento raíz para equipos.
	host	x	`string`		Nombre único de equipo.
	name	-	`string`		Nombre de equipo visible.
	description	-	`text`		Descripción de equipo.
	status	-	`string`	0 - HABILITADO (por defecto) 1 - DESHABILITADO	Estado de equipo.
	ipmi_authtype	-	`string`	-1 - DEFAULT (default) 0 - NONE 1 - MD2 2 - MD5 4 - STRAIGHT 5 - OEM 6 - RMCP_PLUS	Tipo de autenticación de sesión IPMI.
	ipmi_privilege	-	`string`	1 - CALLBACK 2 - USER (default) 3 - OPERATOR 4 - ADMIN 5 - OEM	Nivel de privilegio de sesión IPMI.
	ipmi_username	-	`string`		Nombre para chequeos IPMI.
	ipmi_password	-	`string`		Contraseña para chequeos IPMI.
proxy		-			Proxy.
	name	x	`string`		Nombre del proxy (si existe) que monitoriza el equipo.
templates		-			Elemento raíz para plantillas enlazadas.
	name	x	`string`		Nombre de plantilla.
interfaces		-			Elemento raíz para interfaces de equipo.
	default	-	`string`	0 - NO 1 - SÍ(por defecto)	Si es o no la interfaz principal del equipo. Solo puede haber una interfaz primaría de un tipo en un equipo.
	type	-	`string`	1 - ZABBIX (default) 2 - SNMP 3 - IPMI 4 - JMX	Tipo de Interfaz.
	useip	-	`string`	0 - NO 1 - SÍ(default)	Si usar o no la IP como interfaz para conectar al equipo (si no, se usará DNS).
	ip	-	`string`		Dirección IP, puede ser IPv4 o IPv6. Requerido si la conexión se hace mediante IP.
	dns	-	`string`		Nombre DNS. Requerido si la conexión se hace mediante DNS.
	port	-	`string`		Número de puerto. Admite macros de usuario.
	interface_ref	x	`string`	Formato: `if<N>`	Nombre de referencia de interfaz para ser utilizada en los monitores.
details		-			Elemento raíz para detalles de interfaz.
	version	-	`string`	1 - SNMPV1 2 - SNMP_V2C (default) 3 - SNMP_V3	Usar esta versión SNMP.
	community	-	`string`		Comunidad SNMP. Requerido para monitores SNMPv1 and SNMPv2.
	contextname	-	`string`		Nombre de contexto SNMPv3. Utilizado solo por los monitores SNMPv3.
	securityname	-	`string`		Nombre de seguridad SNMPv3. Utilizado solo por los monitores SNMPv3.
	securitylevel	-	`string`	0 - NOAUTHNOPRIV (por defecto) 1 - AUTHNOPRIV 2 - AUTHPRIV	Nivel de seguridad SNMPv3. Utilizado solo por los monitores SNMPv3.
	authprotocol	-	`string`	0 - MD5 (por defecto) 1 - SHA1 2 - SHA224 3 - SHA256 4 - SHA384 5 - SHA512	Protocolo de autenticación SNMPv3. Utilizado solo por los monitores SNMPv3.
	authpassphrase	-	`string`		Passphrase de autenticación SNMPv3. Utilizado solo por los monitores SNMPv3.
	privprotocol	-	`string`	0 - DES (por defecto) 1 - AES128 2 - AES192 3 - AES256 4 - AES192C 5 - AES256C	Protocolo de privacidad SNMPv3. Utilizado solo por los monitores SNMPv3.
	privpassphrase	-	`string`		Passphrase de privacidad SNMPv3. Utilizado solo por los monitores SNMPv3.
	bulk	-	`string`	0 - NO 1 - SÍ(por defecto)	Utilizar peticiones SNMP masivas (bulk requests).
items		-			Elemento raíz para monitores.
	Para valores de etiqueta de monitor, ver etiquetas de monitor de equipo.
tags		-			Elemento raíz para etiquetas de equipo.
	tag	x	`string`		Nombre de etiqueta.
	value	-	`string`		Valor de etiqueta.
macros		-			Elemento raíz para macros.
	macro	x			Nombre de macro de usuario.
	type	-	`string`	0 - TEXT (por defecto) 1 - SECRET_TEXT 2 - VAULT	Tipo de macro.
	value	-	`string`		Valor de macro de usuario.
	description	-	`string`		Descripción de macro de usuario.
inventory		-			Elemento raíz para inventario de equipo.
	<inventory_property>	-			Propiedad individual de inventario. Todas las propiedades de inventario disponibles se enumeran bajo las respectivas etiquetas, p.ej. <type>, <name>, <os> (ver ejemplo abajo).
inventory_mode		-	`string`	-1 - DISABLED 0 - MANUAL (por defecto) 1 - AUTOMATIC	Modo de inventario.
valuemaps		-			Elemento raíz para host value maps.
	name	x	`string`		Nombre de mapa de valor.
	mapping	-			Elemento raíz para mapeos.
	value	x	`string`		Valor de un mapeo.
	newvalue	x	`string`		Nuevo valor de un mapeo.

Host interfaces

Element		Type	Description
default		string	Whether this is the primary host interface. Note that there can be only one primary interface of one type on a host. Possible values:¹ NO (0), YES (1, default).
type		string	Interface type. Possible values:¹ ZABBIX (1, default), SNMP (2), IPMI (3), JMX (4).
useip		string	Whether to use IP as the interface for connecting to the host (otherwise, DNS will be used). Possible values:¹ NO (0), YES (1, default).
ip		string	(required for IP connections) IP address (IPv4 or IPv6).
dns		string	(required for DNS connections) DNS name.
port		string	Port number.
details			Root element for interface details.
	version	string	Use this SNMP version. Possible values:¹ SNMPV1 (1), SNMP_V2C (2, default), SNMP_V3 (3).
	community	string	(required for SNMPv1 and SNMPv2 items) SNMP community.
	max_repetitions	string	Max repetition value for native SNMP bulk requests (GetBulkRequest-PDUs). Supported for SNMPv2 and SNMPv3 items (`discovery[]` and `walk[]` items). Default: 10.
	contextname	string	SNMPv3 context name. Supported for SNMPv3 items.
	securityname	string	SNMPv3 security name. Supported for SNMPv3 items.
	securitylevel	string	SNMPv3 security level. Supported for SNMPv3 items. Possible values:¹ NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).
	authprotocol	string	SNMPv3 authentication protocol. Supported for SNMPv3 items. Possible values:¹ MD5 (0, default), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).
	authpassphrase	string	SNMPv3 authentication passphrase. Supported for SNMPv3 items.
	privprotocol	string	SNMPv3 privacy protocol. Supported for SNMPv3 items. Possible values:¹ DES (0, default), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).
	privpassphrase	string	SNMPv3 privacy passphrase. Supported for SNMPv3 items.
	bulk	string	Use bulk requests for SNMP. Possible values:¹ NO (0), YES (1, default).
interface_ref		string	Interface reference name to be used in items (format: `if<N>`).

See also: Host interface object (refer to the relevant property with a matching name).

Etiquetas de métrica de equipo

Elemento	Propiedad del elemento	Obligatorio	Tipo	Rango¹	Descripción
items		-			Elemento raíz de las métricas.
	name	x	`cadena`		Nombre de la métrica.
	type	-	`cadena`	0 - ZABBIX_PASSIVE (predeterminado) 2 - TRAP 3 - SIMPLE 5 - INTERNO 7 - ZABBIX_ACTIVE 10 - EXTERNO 11 - ODBC 12 - IPMI 13 - SSH 14 - TELNET 15 - CALCULADO 16 - JMX 17 - SNMP_TRAP 18 - DEPENDIENTE 19 - HTTP_AGENT 20 - SNMP_AGENT 21 - ITEM_TYPE_SCRIPT	Tipo de métrica.
	snmp_oid	-	`cadena`		ID de objeto SNMP. Requerido por las métricas SNMP.
	key	x	`cadena`		Clave de la métrica.
	delay	-	`string`	Predeterminado: 1m	Intervalo de actualización de la métrica. Tenga en cuenta que `delay` siempre será '0' para las métricas de captura. Acepta segundos o una unidad de tiempo con sufijo (30s, 1m, 2h, 1d). Opcionalmente, se pueden especificar uno o más intervalos personalizados como intervalos flexibles o programación.<br >Varios intervalos están separados por un punto y coma. Se pueden utilizar macros de usuario. Una sola macro tiene que llenar todo el campo. No se admiten múltiples macros en un campo ni macros mezcladas con texto. Los intervalos flexibles se pueden escribir como dos macros separadas por una barra diagonal (por ejemplo, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).
	history	-	`string`	Predeterminado: 90d	Período de tiempo durante el cual se deben almacenar los datos del historial. Un período de tiempo que utiliza el sufijo de tiempo, una macro de usuario o una macro LLD.
	trends	-	`string`	Predeterminado: 365d	Período de tiempo durante el cual se deben almacenar los datos de tendencias. Un período de tiempo que utiliza el sufijo de tiempo, una macro de usuario o una macro LLD.
	status	-	`string`	0 - HABILITADO (predeterminado) 1 - DISABLED	Estado del elemento.
	value_type	-	`cadena`	0 - FLOAT 1 - CHAR 2 - LOG 3 - UNSIGNED (predeterminado) 4 - TEXTO	Tipo de valor recibido.
	allowed_hosts	-	`cadena`		Lista de direcciones IP (delimitadas por comas) de equipos que se permite que envien datos para la métrica. Usado por métricas de captura y agente HTTP.
	units	-	`cadena`		Unidades de valores devueltos (bps, B, etc.).
	params	-	`texto`		Parámetros adicionales según el tipo de métrica: - script ejecutado para elementos Script, SSH y Telnet; - consulta SQL para métricas del monitor de base de datos; - fórmula para métricas calculadas.
	ipmi_sensor	-	`cadena`		Sensor IPMI. Usado solo por métricas IPMI.
	authtype	-	`string`	Tipo de autenticación para métricas del agente SSH: 0 - CONTRASEÑA (predeterminada) 1 - PUBLIC_KEY Tipo de autenticación para métricas del agente HTTP: 0 - NINGUNO (predeterminado) 1 - BÁSICO 2 - NTLM	Tipo de autenticación. Usado solo por métricas de agente SSH y HTTP.
	username	-	`cadena`		Nombre de usuario para autenticación. Usado por verificación simple, SSH, Telnet, monitor de base de datos, métricas de agente JMX y HTTP. Requerido por métricas SSH y Telnet. Cuando lo usa el agente JMX, la contraseña también se debe especificar junto con el nombre de usuario o ambas propiedades deben dejarse en blanco.
	password	-	`cadena`		Contraseña para autenticación. Se utiliza mediante comprobación simple, SSH, Telnet, monitor de base de datos, métricas de agente JMX y HTTP. Cuando lo utiliza el agente JMX, el nombre de usuario también debe especificarse junto con la contraseña o ambas propiedades. debe dejarse en blanco.
	publickey	-	`cadena`		Nombre del archivo de clave pública. Obligatorio para las métricas del agente SSH.
	privatekey	-	`cadena`		Nombre del archivo de clave privada. Obligatorio para las métricas del agente SSH.
	description	-	`texto`		Descripción de la métrica.
	inventory_link	-	`string`	0 - NINGUNO Nombre del campo de inventario de equipo en mayúsculas. Por ejemplo: 4 - ALIAS 6 - SO_FULL 14 - HARDWARE etc.	Campo de inventario del equipo que se completa con la métrica. Consulte la página de inventario del equipo para obtener una lista de campos de inventario de equipo admitidos y sus ID.
	logtimefmt	-	`cadena`		Formato de la hora en las entradas del registro. Usado sólo por métricas de registro.
	interface_ref	-	`string`	Formato: `if<N>`	Referencia a la interfaz del equipo.
	jmx_endpoint	-	`cadena`		Punto final JMX. Usado solo por métricas del agente JMX.
	url	-	`cadena`		Cadena URL. Obligatorio solo para métricas del agente HTTP.
	allow_traps	-	`string`	0 - NO (predeterminado) 1 - SÍ	Permite completar el valor como en una métrica de captura. Usado solo por métricas de agente HTTP.
	follow_redirects	-	`string`	0 - NO 1 - SÍ (predeterminado)	Siga las redirecciones de respuesta HTTP mientras sondea los datos. Usado solo por métricas del agente HTTP.
headers		-			Elemento raíz para encabezados de solicitud HTTP(S), donde el nombre del encabezado se usa como clave y el valor del encabezado como valor. Usado solo por métricas del agente HTTP.
	name	x	`cadena`		Nombre del encabezado.
	value	x	`cadena`		Valor del encabezado.
	http_proxy	-	`cadena`		Cadena de conexión de proxy HTTP(S). Utilizada únicamente por métricas del agente HTTP.
	output_format	-	`cadena`	0 - RAW (predeterminado) 1 - JSON	Cómo procesar la respuesta. Usado solo por métricas del agente HTTP.
	post_type	-	`string`	0 - RAW (predeterminado) 2 - JSON 3 - XML	Tipo de cuerpo de datos de la publicación. Usado solo por métricas del agente HTTP.
	posts	-	`cadena`		Datos del cuerpo de la solicitud HTTP(S). Utilizado únicamente por métricas del agente HTTP.
query_fields		-			Elemento raíz para parámetros de consulta. Utilizado únicamente por métricas del agente HTTP.
	name	x	`cadena`		Nombre del parámetro.
	value	-	`cadena`		Valor del parámetro.
	request_method	-	`cadena`	0 - GET (predeterminado) 1 - POST 2 - PUT 3 - HEAD	Método de solicitud. Usado solo por HTTP artículos del agente.
	retrieve_mode	-	`string`	0 - CUERPO (predeterminado) 1 - ENCABEZADOS 2 - AMBOS	Qué parte de la respuesta debe almacenarse. Usado solo por el agente HTTP artículos.
	ssl_cert_file	-	`cadena`		Ruta del archivo de clave SSL pública. Utilizada únicamente por métricas del agente HTTP.
	ssl_key_file	-	`cadena`		Ruta del archivo de clave SSL privada. Utilizada únicamente por métricas del agente HTTP.
	ssl_key_password	-	`cadena`		Contraseña para el archivo de clave SSL. Utilizada únicamente por métricas del agente HTTP.
	status_codes	-	`cadena`		Rangos de códigos de estado HTTP requeridos separados por comas. Admite macros de usuario. Ejemplo: 200,200-{$M},{$M},200-400 Usado solo por métricas del agente HTTP.
	timeout	-	`cadena`		Tiempo de espera de solicitud de sondeo de datos de elementos. Admite macros de usuario. Usado por el agente HTTP y métricas de secuencia de comandos.
	verify_host	-	`string`	0 - NO (predeterminado) 1 - SÍ	Validar si el nombre de equipo en la URL está en el campo Nombre común o en un campo Nombre alternativo del sujeto del certificado de equipo. < br>Usado sólo por métricas del agente HTTP.
	verify_peer	-	`string`	0 - NO (predeterminado) 1 - SÍ	Validar si el certificado de host es auténtico. Usado solo por elementos del agente HTTP.
parameters		-			Elemento raíz para parámetros definidos por el usuario. Utilizado únicamente por métricas de script.
	name	x	`cadena`		Nombre del parámetro. Usado sólo por métricas de script.
	value	-	`cadena`		Valor del parámetro. Usado sólo por métricas de script.
value map		-			Mapa de valores.
	name	x	`cadena`		Nombre del mapa de valores que se utilizará para la métrica.
preprocessing		-			Elemento raíz para el preprocesamiento del valor de la métrica.
step		-			Paso de preprocesamiento del valor de la métrica individual.
	type	x	`cadena`	1 - MULTIPLICADOR 2 - RTRIM 3 - LTRIM 4 - TRIM 5 - REGEX 6 - BOOL_TO_DECIMAL 7 - OCTAL_TO_DECIMAL 8 - HEX_TO_DECIMAL 9 - SIMPLE_CHANGE (calculado como (valor recibido-valor anterior)) 10 - CHANGE_PER_SECOND (calculado como (recibido valor-valor anterior)/(hora actual-hora de la última verificación)) 11 - XMLPATH 12 - JSONPATH 13 - IN_RANGE 14 - MATCHES_REGEX 15 - NOT _MATCHES_REGEX 16 - CHECK_JSON_ERROR 17 - CHECK_XML_ERROR 18 - CHECK_REGEX_ERROR 19 - DISCARD_UNCHANGED 20 - DISCARD_UNCHANGED _HEARTBEAT 21 - JAVASCRIPT 22 - PROMETHEUS_PATTERN 23 - PROMETHEUS_TO_JSON 24 - CSV_TO_JSON 25 - STR_REPLACE 26 - CHECK _NOT_SUPPORTED 27 - XML_TO_JSON	Tipo de paso de preprocesamiento del valor de la métrica.
	parameters	-			Elemento raíz para los parámetros del paso de preprocesamiento del valor del artículo.
	parameter	x	`cadena`		Parámetro individual del paso de preprocesamiento del valor de la métrica.
	error_handler	-	`string`	0 - ORIGINAL_ERROR (predeterminado) 1 - DESCARTAR_VALUE 2 - CUSTOM_VALUE 3 - CUSTOM_ERROR	Tipo de acción utilizado en caso de falla en el paso de preprocesamiento.
	error_handler_params	-	`cadena`		Parámetros del controlador de errores utilizados con 'error_handler'.
master_item		-			Métrica principal de la métrica individual. Requerido por métricas dependientes.
	key	x	`cadena`		Valor de clave de la métrica principal de la métrica dependiente. Se permite la recursividad de hasta 3 métricas dependientes y un recuento máximo de métricas dependientes igual a 29999.
triggers		-			Elemento raíz para iniciadores simples.
	Para conocer los valores de las etiquetas de los elementos iniciadores, consulte las etiquetas de iniciadores del equipo.
tags		-			Elemento raíz para etiquetas de métricas.
	tag	x	`cadena`		Nombre de etiqueta.
	value	-	`cadena`		Valor de etiqueta.

Host item value preprocessing steps

Element		Type	Description
type		string	(required) The item value preprocessing step type. Possible values:¹ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, calculated: received value - previous value), CHANGE_PER_SECOND (10, calculated: (received value - previous value)/(time now - time of last check)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30).
parameters			(required) Root element for parameters of the item value preprocessing step.
	parameter	string	Individual parameter of the item value preprocessing step.
error_handler		string	Action type used in case of preprocessing step failure. Possible values:¹ ORIGINAL_ERROR (0, default), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params		string	Error handler parameters.

See also: Item preprocessing object (refer to the relevant property with a matching name).

Etiquetas de reglas de descubrimiento de bajo nivel del equipo

Elemento	Propiedad del elemento	Obligatorio	Tipo	Rango¹	Descripción
discovery_rules		-			Elemento raíz para reglas de descubrimiento de bajo nivel.
	Para la mayoría de los valores de etiquetas de métricas, consulte los valores de etiquetas de métricas para una métrica normal. A continuación solo se describen las etiquetas que son específicas de las reglas de descubrimiento de bajo nivel.
	type	-	`cadena`	0 - ZABBIX_PASSIVE (predeterminado) 2 - TRAP 3 - SIMPLE 5 - INTERNO 7 - ZABBIX_ACTIVE 10 - EXTERNO 11 - ODBC 12 - IPMI 13 - SSH 14 - TELNET 16 - JMX 18 - DEPENDIENTE 19 - HTTP_AGENT 20 - SNMP _AGENT	Tipo de elemento.
	lifetime	-	`string`	Predeterminado: 30d	Período de tiempo después del cual se eliminarán las métricas que ya no se descubren. Segundos, unidad de tiempo con sufijo o macro de usuario.
filter					Filtro individual.
	evaltype	-	`string`	0 - AND_OR (predeterminado) 1 - AND 2 - O 3 - FÓRMULA	Lógica a usar para verificar las condiciones del filtro de reglas de descubrimiento de bajo nivel.
	formula	-	`cadena`		Fórmula de cálculo personalizada para las condiciones del filtro.
conditions		-			Elemento raíz para condiciones de filtrado.
	macro	x	`cadena`		Nombre de la macro de descubrimiento de bajo nivel.
	value	-	`cadena`		Valor de filtro: expresión regular o expresión regular global.
	operator	-	`cadena`	8 - MATCHES_REGEX (predeterminado) 9 - NOT_MATCHES_REGEX	Operador de condición.
	formulaid	x	`carácter`		ID único arbitrario que se utiliza para hacer referencia a una condición de la expresión personalizada. Sólo puede contener letras mayúsculas. El ID debe ser definido por el usuario al modificar las condiciones del filtro, pero se generará nuevamente al solicitarlas posteriormente.
lld_macro_paths		-			Elemento raíz para rutas de macro LLD.
	lld_macro	x	`cadena`		Nombre de la macro de descubrimiento de bajo nivel.
	path	x	`cadena`		Selector de valor que se asignará a la macro correspondiente.
preprocessing		-			Preprocesamiento del valor de la regla LLD.
step		-			Paso de preprocesamiento del valor de regla LLD individual.
	Para la mayoría de los valores de etiquetas de elementos, consulte los valores de etiquetas de elementos para el preprocesamiento de valores de elementos host. A continuación solo se describen las etiquetas que son específicas del preprocesamiento de valores de descubrimiento de bajo nivel.
	type	x	`cadena`	5 - REGEX 11 - XMLPATH 12 - JSONPATH 15 - NOT_MATCHES_REGEX 16 - CHECK_JSON_ERROR 17 - CHECK _XML_ERROR 20 - DESCARTAR_SIN CAMBIAR_HEARTBEAT 21 - JAVASCRIPT 23 - PROMETHEUS_TO_JSON 24 - CSV_TO_JSON 25 - STR_REPLACE<br >27 - XML_TO_JSON	Tipo de paso de preprocesamiento del valor del elemento.
trigger_prototypes		-			Elemento raíz para prototipos de iniciador.
	Para conocer los valores de etiqueta de elemento de prototipo de iniciador, consulte las etiquetas iniciador de equipo normales.
graph_prototypes		-			Elemento raíz para prototipos de gráficos.
	Para conocer los valores de las etiquetas de los elementos del prototipo del gráfico, consulte las etiquetas normales host graph.
host_prototypes		-			Elemento raíz para prototipos de equipo.
	Para conocer los valores de etiquetas de elementos del prototipo de equipo, consulte las etiquetas equipo normales.
item_prototypes		-			Elemento raíz para prototipos de métricas.
	Para conocer los valores de las etiquetas del elemento prototipo de la métrica, consulte las etiquetas métricas de equipo normales.
master_item		-			Datos del prototipo de métrica individual, métrica principal/prototipo de métrica.
	key	x	`cadena`		Valor clave del prototipo de métrica principal/valor clave del prototipo de métrica dependiente. Obligatorio para una métrica dependiente.

Host low-level discovery rule filters

Element		Type	Description
evaltype		string	Override filter condition evaluation method. Possible values:¹ AND_OR (0, default), AND (1), OR (2), FORMULA (3).
formula		string	Custom calculation formula for filter conditions.
conditions			Root element for filter conditions.
	macro	string	(required) The name of the low-level discovery macro to perform the check on.
	value	string	Value to compare with.
	operator	string	Condition operator. Possible values:¹ MATCHES_REGEX (8, default), NOT_MATCHES_REGEX (9).
	formulaid	string	(required) Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.

See also: LLD rule filter object (refer to the relevant property with a matching name).

Host low-level discovery rule override operations

Element		Type	Description
operationobject		string	Object to which the operation is applied. Possible values:¹ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator		string	Override condition operator. Possible values:¹ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value		string	A regular expression or a string for the override condition operator.
status		string	Status of the object upon the override operation.
discover		string	Whether the object is added as a result of the discovery.
delay		string	Update interval set for the item prototype upon the override operation.
history		string	History storage period set for the item prototype upon the override operation.
trends		string	Trend storage period set for the item prototype upon the override operation.
severity		string	Trigger prototype severity set upon the override operation.
tags			Root element for the tags set for the object upon the override operation.
	tag	string	(required) Tag name.
	value	string	Tag value.
templates			Root element for the templates linked to the host prototype upon the override operation.
	name	string	(required) Template name.
inventory_mode		string	Host prototype inventory mode set upon the override operation.

See also: LLD rule override operation object (refer to the relevant property with a matching name).

Etiquetas de iniciador del equpo

Elemento	Propiedad del elemento	Obligatorio	Tipo	Rango¹	Descripción
triggers		-			Elemento raíz para iniciadores.
	expression	x	`cadena`		Expresión del iniciador.
	recovery_mode	-	`string`	0 - EXPRESSION (predeterminado) 1 - RECOVERY_EXPRESSION 2 - NINGUNO	Base para generar eventos OK.
	recovery_expression	-	`cadena`		Activar expresión de recuperación.
	correlation_mode	-	`string`	0 - DISABLED (predeterminado) 1 - TAG_VALUE	Modo de correlación (sin correlación de eventos o correlación de eventos por etiqueta).
	correlation_tag	-	`cadena`		El nombre de la etiqueta que se utilizará para la correlación de eventos.
	name	x	`cadena`		Nombre del iniciador.
	event_name	-	`cadena`		Nombre del evento.
	opdata	-	`cadena`		Datos operativos.
	url_name	-	`cadena`		Etiqueta de la URL asociada al iniciador.
	url	-	`cadena`		URL asociada al iniciador.
	status	-	`string`	0 - HABILITADO (predeterminado) 1 - DISABLED	Estado del iniciador.
	priority	-	`cadena`	0 - NO_CLASIFICADO (predeterminado) 1 - INFORMACIÓN 2 - ADVERTENCIA 3 - PROMEDIO 4 - ALTO 5 - DESASTRE	Gravedad del iniciador.
	description	-	`texto`		Descripción del iniciador.
	type	-	`string`	0 - SINGLE (predeterminado) 1 - MULTIPLE	Tipo de generación de evento (evento de problema único o eventos de problema múltiple).
	manual_close	-	`string`	0 - NO (predeterminado) 1 - SÍ	Cierre manual de eventos de problema.
dependencies		-			Elemento raíz para dependencias.
	name	x	`cadena`		Nombre de la dependencia del iniciador.
	expression	x	`cadena`		Expresión de la dependencia del iniciador.
	recovery_expression	-	`cadena`		Expresión de recuperación de la dependencia del iniciador.
tags		-			Elemento raíz para etiquetas de eventos.
	tag	x	`cadena`		Nombre de etiqueta.
	value	-	`cadena`		Valor de etiqueta.

Etiquetas del gráfico del equipo

Elemento	Propiedad del elemento	Obligatorio	Tipo	Rango¹	Descripción
graphs		-			Elemento raíz para gráficos.
	name	x	`cadena`		Nombre del gráfico.
	width	-	`entero`	20-65535 (predeterminado: 900)	Ancho del gráfico, en píxeles. Se utiliza para vista previa y para gráficos circulares/explotados.
	height	-	`entero`	20-65535 (predeterminado: 200)	Altura del gráfico, en píxeles. Se utiliza para vista previa y para gráficos circulares/explotados.
	yaxismin	-	`double`	Predeterminado: 0	Valor mínimo del eje Y. Se utiliza si 'ymin_type_1' es FIJO.
	yaxismax	-	`double`	Predeterminado: 0	Valor del máximo del eje Y. Se utiliza si 'ymax_type_1' es FIJO.
	show_work_period	-	`cadena`	0 - NO 1 - SÍ (predeterminado)	Resaltar horas no laborales. Usado para gráficos normales y apilados
	show_triggers	-	`cadena`	0 - NO 1 - SÍ (predeterminado)	Muestra valores de iniciador simples como una línea. Usado para gráficos normales y apilados
	type	-	`cadena`	0 - NORMAL (predeterminado) 1 - APILADO 2 - PIE 3 - EXPLOTADO	Tipo de gráfico.
	show_legend	-	`cadena`	0 - NO 1 - SÍ (predeterminado)	Mostrar leyenda del gráfico.
	show_3d	-	`cadena`	0 - NO (predeterminado) 1 - SÍ	Habilitar estilo 3D. Usado por gráficos circulares y desglosados.
	percent_left	-	`double`	Predeterminado:0	Muestra la línea percentil para el eje izquierdo. Se usa solo para gráficos normales.
	percent_right	-	`double`	Predeterminado:0	Muestra la línea percentil para el eje derecho. Se usa solo para gráficos normales.
	ymin_type_1	-	`cadena`	0 - CALCULADO (predeterminado) 1 - FIJO 2 - MÉTRICA	Valor mínimo del eje Y. Usado para gráficos normales y apilados.
	ymax_type_1	-	`cadena`	0 - CALCULADO (predeterminado) 1 - FIJO 2 - MÉTRICA	Valor máximo del eje Y. Usado para gráficos normales y apilados.
ymin_item_1		-			Detalles de la métrica individual. Obligatorio si 'ymin_type_1' es ITEM.
	host	x	`cadena`		Equipo de la métrica.
	key	x	`cadena`		Clave de la métrica.
ymax_item_1		-			Detalles de la métrica individual. Obligatorio si 'ymax_type_1' es ITEM.
	host	x	`cadena`		Equipo de la métrica.
	key	x	`cadena`		Clave de la métrica.
graph_items		x			Elemento raíz para métricas del gráfico.
	sortorder	-	`entero`		Orden de dibujado. El valor más pequeño se extrae primero. Puede usarse para dibujar líneas o regiones detrás (o delante) de otras.
	drawtype	-	`cadena`	0 - SINGLE_LINE (predeterminado) 1 - FILLED_REGION 2 - BOLD_LINE 3 - DOTTED_LINE 4 - DASHED_LINE 5 - GRADIENT_LINE	Estilo de dibujo de la métrica del gráfico. Usado solo por gráficos normales.
	color	-	`cadena`		Color del elemento (6 símbolos, hexadecimal).
	yaxisside	-	`cadena`	0 - IZQUIERDA (predeterminada) 1 - DERECHA	Lado del gráfico donde se dibujará la escala Y de la métrica del gráfico. Usado por gráficos normales y apilados.
	calc_fnc	-	`cadena`	1 - MIN 2 - AVG (predeterminado) 4 - MAX 7 - TODOS (mínimo, promedio y máximo; usado solo en gráficos simples)< br>9 - ÚLTIMO (usado solo en gráficos circulares y desglosados)	Datos para dibujar si existe más de un valor para una métrica.
	type	-	`cadena`	0 - SIMPLE (predeterminado) 2 - GRAPH_SUM (el valor de la métrica representa el pastel completo; se usa solo en gráficos circulares y desglosados)	Tipo de métrica gráfico.
item		x			Métrica individual.
	host	x	`cadena`		Equipo de la métrica.
	clave	x	`cadena`		Clave de la métrica.

Host graph items

Element		Type	Description
sortorder		integer	Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.
drawtype		string	Draw style of the graph item. Supported for NORMAL graphs. Possible values:¹ SINGLE_LINE (0, default), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5).
color		string	Element color (6 symbols, hex).
yaxisside		string	Side of the graph where the graph item's Y scale will be drawn. Supported for NORMAL and STACKED graphs.
calc_fnc		string	Data to draw if more than one value exists for an item. Possible values:¹ MIN (1), AVG (2, default), MAX (4), ALL (7; minimum, average, and maximum; supported for simple graphs), LAST (9, supported for pie/exploded graphs).
type		string	Graph item type. Possible values:¹ SIMPLE (0, default), GRAPH_SUM (2; value of the item represents the whole pie; supported for pie/exploded graphs).
item			(required) Individual item.
	host	string	(required) Item host.
	key	string	(required) Item key.

See also: Graph item object (refer to the relevant property with a matching name).

Host value maps

Element		Type	Description
uuid		string	(required) Unique identifier for this value map.
name		string	(required) Value map name.
mapping			Root element for mappings.
	type	string	Mapping match type. Possible values:¹ EQUAL (0, default), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
	value	string	Original value.
	newvalue	string	(required) Value to which the original value is mapped to.

See also: Value map object (refer to the relevant property with a matching name).

Etiquetas de escenario web de equipo

Elemento	Propiedad del elemento	Obligatorio	Tipo	Rango¹	Descripción
httptests		-			Elemento raíz para escenarios web.
	name	x	`cadena`		Nombre del escenario web.
	delay	-	`string`	Predeterminado: 1m	Frecuencia de ejecución del escenario web. Segundos, unidad de tiempo con sufijo o macro de usuario.
	attempts	-	`integer`	1-10 (predeterminado: 1)	El número de intentos para ejecutar los pasos del escenario web.
	agent	-	`string`	Predeterminado: Zabbix	Agente cliente. Zabbix pretenderá ser el navegador seleccionado. Esto resulta útil cuando un sitio web devuelve contenido diferente para distintos navegadores.
	http_proxy	-	`cadena`		Especifique un proxy HTTP para usar, usando el formato: `http://[nombre de usuario[:contraseña]@]proxy.example.com[:puerto]`
variables		-			Elemento raíz para variables a nivel de escenario (macros) que pueden usarse en los pasos del escenario.
	name	x	`texto`		Nombre de la variable.
	value	x	`texto`		Valor variable.
headers		-			Elemento raíz para los encabezados HTTP que se enviarán al realizar una solicitud. Los encabezados deben enumerarse utilizando la misma sintaxis que aparecerían en el protocolo HTTP.
	name	x	`texto`		Nombre del encabezado.
	value	x	`texto`		Valor del encabezado.
	status	-	`string`	0 - HABILITADO (predeterminado) 1 - DISABLED	Estado del escenario web.
	authentication	-	`string`	0 - NINGUNO (predeterminado) 1 - BÁSICO 2 - NTLM	Método de autenticación.
	http_user	-	`cadena`		Nombre de usuario utilizado para la autenticación básica, HTTP o NTLM.
	http_password	-	`cadena`		Contraseña utilizada para la autenticación básica, HTTP o NTLM.
	verify_peer	-	`string`	0 - NO (predeterminado) 1 - SÍ	Verifique el certificado SSL del servidor web.
	verify_host	-	`string`	0 - NO (predeterminado) 1 - SÍ	Verifique que el campo Nombre común o el campo Nombre alternativo del sujeto del certificado del servidor web coincidan.
	ssl_cert_file	-	`cadena`		Nombre del archivo de certificado SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
	ssl_key_file	-	`cadena`		Nombre del archivo de clave privada SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
	ssl_key_password	-	`cadena`		Contraseña del archivo de clave privada SSL.
steps		x			Elemento raíz para los pasos del escenario web.
	name	x	`cadena`		Nombre del paso del escenario web.
	url	x	`cadena`		URL para seguimiento.
query_fields		-			Elemento raíz para campos de consulta: una matriz de campos HTTP que se agregarán a la URL al realizar una solicitud.
	name	x	`cadena`		Nombre del campo de consulta.
	value	-	`cadena`		Valor del campo de consulta.
posts		-			Variables HTTP POST como una cadena (datos de publicación sin procesar) o como una matriz de campos HTTP (datos de campo de formulario).
	name	x	`cadena`		Nombre del campo de publicación.
	value	x	`cadena`		Publicar valor del campo.
variables		-			Elemento raíz de las variables de nivel de paso (macros) que se deben aplicar después de este paso. Si el valor de la variable tiene un prefijo 'regex:', entonces su valor se extrae de los datos devueltos por este paso de acuerdo al patrón de expresión regular que sigue el prefijo 'regex:'
	name	x	`cadena`		Nombre de la variable.
	value	x	`cadena`		Valor variable.
headers		-			Elemento raíz para los encabezados HTTP que se enviarán al realizar una solicitud. Los encabezados deben enumerarse utilizando la misma sintaxis que aparecerían en el protocolo HTTP.
	name	x	`cadena`		Nombre del encabezado.
	value	x	`cadena`		Valor del encabezado.
	follow_redirects	-	`string`	0 - NO 1 - SÍ (predeterminado)	Seguir redirecciones HTTP.
	retrieve_mode	-	`string`	0 - CUERPO (predeterminado) 1 - ENCABEZADOS 2 - AMBOS	Modo de recuperación de respuesta HTTP.
	timeout	-	`string`	Predeterminado: 15s	Tiempo de espera de ejecución del paso. Segundos, unidad de tiempo con sufijo o macro de usuario.
	required	-	`cadena`		Texto que debe estar presente en la respuesta. Se ignora si está vacío.
	status_codes	-	`cadena`		Una lista delimitada por comas de códigos de estado HTTP aceptados. Se ignora si está vacío. Por ejemplo: 200-201,210-299
tags		-			Elemento raíz para etiquetas de escenarios web.
	tag	x	`cadena`		Nombre de etiqueta.
	value	-	`cadena`		Valor de etiqueta.

Host web scenario steps

Element		Type	Description
name		string	(required) Web scenario step name.
url		string	(required) URL for monitoring.
query_fields			Root element for query parameters (an array of HTTP fields to be added to the URL when performing a request).
	name	string	(required) Query parameter name.
	value	string	Query parameter value.
posts			Root element for HTTP POST variables (a string (raw post data) or an array of HTTP fields (form field data)).
	name	string	(required) Post field name.
	value	string	(required) Post field value.
variables			Root element of step-level variables (macros) that should be applied after this step. If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix
	name	string	(required) Variable name.
	value	text	(required) Variable value.
headers			Root element for HTTP headers to be sent when performing a request.
	name	string	(required) Header name.
	value	text	(required) Header value.
follow_redirects		string	Follow HTTP redirects. Possible values:¹ NO (0), YES (1, default).
retrieve_mode		string	HTTP response retrieve mode. Possible values:¹ BODY (0, default), HEADERS (1), BOTH (2).
timeout		string	Timeout (using seconds, time suffix, or user macro) of step execution. Default: 15s.
required		string	Text that must be present in the response (ignored if empty).
status_codes		string	A comma-delimited list of accepted HTTP status codes (e.g., `200-201,210-299`; ignored if empty).

See also: Web scenario step object (refer to the relevant property with a matching name).

Notas al pie

¹ Para valores de cadena, solo se exportará la cadena (p. ej. "ZABBIX_ACTIVE") sin la numeración utilizada en esta tabla. Los números para los valores de rango (correspondientes a los valores API) en esta tabla se utiliza solo para realizar pedidos.

Documentation