Table of Contents

4 Equipos

4 Equipos

Descripción general

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

La exportación de equipos contiene:

Grupos de equipos vinculados
Datos del equipo
Vinculación de plantilla
Vinculación de grupo de equipos
Interfaces del equipo
Métricas vinculadas directamente
Disparadores vinculados directamente
Reglas de descubrimiento vinculadas directamente con todas las prototipos
Escenarios web vinculados directamente
Macros del equipo
Datos de inventario del equipo
Mapas de valores
Gráficas vinculadas

Exportar

Para exportar equipos, haga lo siguiente:

Vaya a Recopilación de datos → Equipos.
Marque las casillas 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 por defecto:

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

Importar

Para importar equipos, haga lo siguiente:

Vaya a Recopilación de datos → Equipos.
Haga clic en Importar en la esquina superior derecha.
Seleccione el archivo de importación.
Haga clic en Importar en la esquina inferior derecha del formulario de configuración.

Si marca la casilla 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 la fila Todos, todos los elementos debajo de ella serán marcados/desmarcados.

Reglas de importación:

Regla	Descripción
Actualizar existentes	Los elementos existentes se actualizarán utilizando los datos del archivo de importación. De lo contrario, no se actualizarán.
Crear nuevos	Se crearán nuevos elementos utilizando los datos del archivo de importación. De lo contrario, no se crearán.
Eliminar los que faltan	Los elementos existentes que no estén presentes en el archivo de importación serán eliminados. De lo contrario, no se eliminarán. Si se marca Eliminar los que faltan para Vinculación de plantilla, la vinculación de plantilla actual que no esté presente en el archivo de importación será desvinculada. Las entidades (métricas, disparadores, gráficos, etc.) heredadas de las plantillas desvinculadas no se eliminarán (a menos que también se seleccione la opción Eliminar los que faltan para cada entidad).

Un mensaje de éxito o error de la importación se mostrará en la interfaz.

Formato de exportación

Cuando se exporta un equipo, Zabbix genera un formato estructurado en YAML, JSON o XML. La exportación incluye elementos del equipo, como metadatos del equipo, métricas, macros, disparadores y más.

Cada elemento cumple una función específica y puede contener elementos anidados.

Las siguientes secciones describen cada elemento en el formato de exportación. Los ejemplos utilizan un equipo con la plantilla MySQL by Zabbix agent 2. Para fines de demostración de los elementos, la plantilla se desvincula después de crear el equipo. Desvincular mantiene todos los elementos en la configuración (a diferencia de desvincular y limpiar, que los elimina).

Un paréntesis (...) indica elementos omitidos por brevedad. La nota (ver tabla abajo) se utiliza cuando el elemento se explica con más detalle en secciones posteriores.

Metadatos del equipo

zabbix_export:
         version: '8.0'
         host_groups:
           - uuid: 748ad4d098d447d492bb935c907f652f
             name: Bases de datos
         hosts: (ver tabla abajo)
         graphs: (ver tabla abajo)

Elemento		Tipo	Descripción
version		string	(obligatorio) Versión de Zabbix.
host_groups			(obligatorio) Elemento raíz para los grupos de equipos.
	uuid	string	(obligatorio) Identificador único para este grupo de equipos.
	name	string	(obligatorio) Nombre del grupo de equipos.
hosts			Elemento raíz para los equipos.
graphs			Elemento raíz para las gráficas de equipos.

Equipos

zabbix_export:
         (...)
         hosts:
           - host: 'Servidor MySQL'
             name: 'Servidor MySQL'
             groups:
               - name: Bases de datos
             interfaces: (ver tabla abajo)
             items: (ver tabla abajo)
             discovery_rules: (ver tabla abajo)
             tags:
               - tag: location
                 value: Riga
             macros:
               (...)
               - macro: '{$MYSQL.DSN}'
                 value: 192.0.2.0
               (...)
               - macro: '{$MYSQL.PASSWORD}'
                 type: SECRET_TEXT
                 description: 'Contraseña del usuario MySQL.'
               (...)
             valuemaps: (ver tabla abajo)
         (...)

Elemento		Tipo	Descripción
host		string	(requerido) Nombre único del equipo.
name		string	Nombre visible del equipo.
description		text	Descripción del equipo.
monitored_by		string	Cómo se monitoriza el equipo. Valores posibles:¹ SERVER (0, por defecto), PROXY (1) o PROXY_GROUP (2).
proxy			Elemento raíz para proxy.
	name	string	(requerido) Nombre del proxy (si lo hay) que monitoriza el equipo.
proxy_group			Elemento raíz para grupo de proxies.
	name	string	(requerido) Nombre del grupo de proxies (si lo hay) que se utiliza para monitorizar el equipo.
status		string	Estado del equipo. Valores posibles:¹ ENABLED (0, por defecto), DISABLED (1).
ipmi_authtype		string	Tipo de autenticación de sesión IPMI. Valores posibles:¹ DEFAULT (-1, por defecto), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP_PLUS (6).
ipmi_privilege		string	Nivel de privilegio de la sesión IPMI. Valores posibles:¹ CALLBACK (1), USER (2, por defecto), OPERATOR (3), ADMIN (4), OEM (5).
ipmi_username		string	Nombre de usuario para comprobaciones IPMI.
ipmi_password		string	Contraseña para comprobaciones IPMI.
templates			Elemento raíz para plantillas vinculadas.
	name	string	(requerido) Nombre de la plantilla.
groups			Elemento raíz para los grupos de equipos a los que pertenece el equipo.
	name	string	(requerido) Nombre del grupo de equipos.
interfaces			Elemento raíz para interfaces de equipo.
items			Elemento raíz para métricas del equipo.
discovery_rules			Elemento raíz para reglas de bajo nivel de descubrimiento del equipo.
http_tests			Elemento raíz para escenarios web del equipo.
tags			Elemento raíz para etiquetas del equipo.
	tag	string	(requerido) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.
macros			Elemento raíz para macros del equipo.
	macro	string	(requerido) Nombre de la macro de usuario.
	type	string	Tipo de macro de usuario. Valores posibles:¹ TEXT (0, por defecto), SECRET_TEXT (1), VAULT (2).
	value	string	Valor de la macro de usuario.
	description	string	Descripción de la macro de usuario.
inventory			Elemento raíz para el inventario del equipo.
	<inventory_property>	string	Propiedad de inventario. Todas las propiedades tienen su respectivo elemento (`type`, `name`, `os`, etc.; por ejemplo, ver Formato de exportación).
inventory_mode		string	Modo de inventario. Valores posibles:¹ DISABLED (-1), MANUAL (0, por defecto), AUTOMATIC (1).
valuemaps			Elemento raíz para mapas de valores del equipo.

Ver también: Objeto equipo (consulte la propiedad relevante con el mismo nombre).

Interfaces de equipos

zabbix_export:
         (...)
         hosts:
           - host: 'Servidor MySQL'
             (...)
             interfaces:
               - ip: 192.0.2.0
                 interface_ref: if1
             (...)

Elemento		Tipo	Descripción
default		string	Indica si esta es la interfaz principal del equipo. Tenga en cuenta que solo puede haber una interfaz principal de un tipo en un equipo. Valores posibles:¹ NO (0), SÍ (1, por defecto).
type		string	Tipo de interfaz. Valores posibles:¹ ZABBIX (1, por defecto), SNMP (2), IPMI (3), JMX (4).
useip		string	Indica si se debe usar la IP como interfaz para conectarse al equipo (de lo contrario, se usará DNS). Valores posibles:¹ NO (0), SÍ (1, por defecto).
ip		string	(requerido para conexiones por IP) Dirección IP (IPv4 o IPv6).
dns		string	(requerido para conexiones por DNS) Nombre DNS.
port		string	Número de puerto.
details			Elemento raíz para los detalles de la interfaz.
	version	string	Usar esta versión de SNMP. Valores posibles:¹ SNMPV1 (1), SNMP_V2C (2, por defecto), SNMP_V3 (3).
	community	string	(requerido para métricas SNMPv1 y SNMPv2) Comunidad SNMP.
	max_repetitions	string	Valor máximo de repeticiones para solicitudes nativas SNMP bulk (GetBulkRequest-PDUs). Soportado para métricas SNMPv2 y SNMPv3 (métricas `discovery[]` y `walk[]`). Por defecto: 10.
	contextname	string	Nombre de contexto SNMPv3. Soportado para métricas SNMPv3.
	securityname	string	Nombre de seguridad SNMPv3. Soportado para métricas SNMPv3.
	securitylevel	string	Nivel de seguridad SNMPv3. Soportado para métricas SNMPv3. Valores posibles:¹ NOAUTHNOPRIV (0, por defecto), AUTHNOPRIV (1), AUTHPRIV (2).
	authprotocol	string	Protocolo de autenticación SNMPv3. Soportado para métricas SNMPv3. Valores posibles:¹ MD5 (0, por defecto), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).
	authpassphrase	string	Frase de autenticación SNMPv3. Soportado para métricas SNMPv3.
	privprotocol	string	Protocolo de privacidad SNMPv3. Soportado para métricas SNMPv3. Valores posibles:¹ DES (0, por defecto), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).
	privpassphrase	string	Frase de privacidad SNMPv3. Soportado para métricas SNMPv3.
	bulk	string	Usar solicitudes bulk para SNMP. Valores posibles:¹ NO (0), SÍ (1, por defecto).
interface_ref		string	Nombre de referencia de la interfaz que se utilizará en las métricas (formato: `if<N>`).

Véase también: Objeto de interfaz de equipo (consulte la propiedad relevante con el mismo nombre).

Métricas del equipo

zabbix_export:
         (...)
         hosts:
           - host: 'Servidor MySQL'
             (...)
             items:
               (...)
               - name: 'Uso de caché de binlog en disco'
                 type: DEPENDENT
                 key: mysql.binlog_cache_disk_use
                 value_type: FLOAT
                 description: 'Número de transacciones que utilizaron una caché temporal en disco porque no pudieron caber en la caché de binario de registro regular, siendo mayores que `binlog_cache_size`.'
                 preprocessing: (ver tabla abajo)
                 master_item:
                   key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
                 tags:
                   - tag: component
                     value: cache
               (...)
               - name: 'Utilización del buffer pool'
                 type: CALCULATED
                 key: mysql.buffer_pool_utilization
                 value_type: FLOAT
                 units: '%'
                 params: |
                   ( last(//mysql.innodb_buffer_pool_pages_total) - 
                   last(//mysql.innodb_buffer_pool_pages_free) ) / 
                   ( last(//mysql.innodb_buffer_pool_pages_total) + 
                   ( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 * 
                   ( last(//mysql.innodb_buffer_pool_pages_total) > 0 )
                 description: 'Proporción de páginas usadas respecto al total en el buffer pool.'
                 tags:
                   - tag: component
                     value: memory
                 triggers: (ver tabla abajo)
               (...)
               - name: Tiempo de actividad
                 type: DEPENDENT
                 key: mysql.uptime
                 units: uptime
                 description: 'Número de segundos que el servidor ha estado en funcionamiento.'
                 preprocessing: (ver tabla abajo)
                 master_item:
                   key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
                 tags:
                   - tag: component
                     value: application
                 triggers: (ver tabla abajo)
               (...)

Elemento		Tipo	Descripción
name		string	(obligatorio) Nombre de la métrica.
type		string	Tipo de métrica. Valores posibles:¹ ZABBIX_PASSIVE (0, por defecto), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP_TRAP (17), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22), ITEM_TYPE_NESTED (23).
snmp_oid		string	(obligatorio para métricas SNMP_AGENT) ID de objeto SNMP.
key		string	(obligatorio) Clave de la métrica.
delay		string	Intervalo de actualización de la métrica. Por defecto: 1m. El valor siempre será 0 para métricas TRAP.
history		string	Periodo de tiempo (usando sufijo de tiempo, macro de usuario o macro LLD) durante el cual se almacenarán los datos históricos. Por defecto: 31d.
trends		string	Periodo de tiempo (usando sufijo de tiempo, macro de usuario o macro LLD) durante el cual se almacenarán los datos de tendencias. Por defecto: 365d.
status		string	Estado de la métrica. Valores posibles:¹ ENABLED (0, por defecto), DISABLED (1).
value_type		string	Tipo de valor recibido. Valores posibles:¹ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, por defecto), TEXT (4), BINARY (5).
allowed_hosts		string	Lista de direcciones IP de equipos, separadas por comas, autorizadas para enviar datos para la métrica. Soportado para métricas TRAP y HTTP_AGENT.
units		string	Unidades del valor recibido (bps, B, etc.).
params		text	Parámetros adicionales dependiendo del tipo de métrica (script ejecutado para métricas SSH y TELNET; consulta SQL para métricas ODBC; fórmula para métricas CALCULATED; el script para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER).
ipmi_sensor		string	Sensor IPMI. Soportado para métricas IPMI.
authtype		string	Tipo de autenticación. Soportado para métricas SSH y HTTP_AGENT. Valores posibles para métricas SSH:¹ PASSWORD (0, por defecto), PUBLIC_KEY (1). Valores posibles para métricas HTTP_AGENT:¹ NONE (0, por defecto), BASIC (1), NTLM (2).
username		string	(obligatorio para métricas SSH y TELNET) Nombre de usuario para autenticación. Soportado para métricas SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se usa para métricas JMX, también se debe especificar `password` (ver abajo) o dejar ambos elementos en blanco.
password		string	(obligatorio para métricas SSH y TELNET) Contraseña para autenticación. Soportado para métricas SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se usa para métricas JMX, también se debe especificar `username` (ver arriba) o dejar ambos elementos en blanco.
publickey		string	(obligatorio para métricas SSH) Nombre del archivo de clave pública.
privatekey		string	(obligatorio para métricas SSH) Nombre del archivo de clave privada.
description		text	Descripción de la métrica.
inventory_link		string	Campo de inventario del equipo que es rellenado por la métrica. Valores posibles:¹ NONE (0), ALIAS (4), etc. (ver Inventario de equipos para los campos soportados).
valuemap			Elemento raíz para los mapas de valores de la métrica.
	name	string	(obligatorio) Nombre del mapa de valores a usar para la métrica.
logtimefmt		string	Formato de la hora en las entradas de log. Soportado para métricas de tipo de valor LOG.
preprocessing			Elemento raíz para el preprocesamiento de valores de la métrica.
	step		Elemento raíz para los pasos de preprocesamiento de valores de métricas de equipo.
interface_ref		string	Referencia a la interfaz del equipo (formato: `if<N>`).
jmx_endpoint		string	Endpoint JMX. Soportado para métricas JMX.
master_item			(obligatorio para métricas DEPENDENT) Elemento raíz para la métrica principal de la métrica dependiente.
	key	string	(obligatorio) Clave de la métrica principal de la métrica dependiente.
timeout		string	Tiempo de espera para la solicitud de sondeo de datos de la métrica. Soportado para la lista de tipos de métricas en Tiempos de espera.
url		string	(obligatorio para métricas HTTP_AGENT) Cadena de URL.
query_fields			Elemento raíz para los parámetros de consulta. Soportado para métricas HTTP_AGENT.
	name	string	(obligatorio para métricas HTTP_AGENT) Nombre del parámetro de consulta.
	value	string	Valor del parámetro de consulta. Soportado para métricas HTTP_AGENT.
parameters			Elemento raíz para los parámetros definidos por el usuario. Soportado para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER.
	name	string	(obligatorio para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER) Nombre del parámetro definido por el usuario.
	value	string	Valor del parámetro definido por el usuario. Soportado para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER.
posts		string	Datos del cuerpo de la solicitud HTTP(S). Soportado para métricas HTTP_AGENT.
status_codes		string	Rangos de códigos de estado HTTP requeridos, separados por comas. Soportado para métricas HTTP_AGENT.
follow_redirects		string	Seguir redirecciones de respuesta al sondear datos. Soportado para métricas HTTP_AGENT. Valores posibles:¹ NO (0), YES (1, por defecto).
post_type		string	Tipo de cuerpo de datos post. Soportado para métricas HTTP_AGENT. Valores posibles:¹ RAW (0, por defecto), JSON (2), XML (3).
http_proxy		string	Cadena de conexión de proxy HTTP(S). Soportado para métricas HTTP_AGENT.
headers			Elemento raíz para las cabeceras de la solicitud HTTP(S). Soportado para métricas HTTP_AGENT.
	name	string	(obligatorio para métricas HTTP_AGENT) Nombre de la cabecera.
	value	string	(obligatorio para métricas HTTP_AGENT) Valor de la cabecera.
retrieve_mode		string	Qué parte de la respuesta debe almacenarse. Soportado para métricas HTTP_AGENT. Valores posibles:¹ BODY (0, por defecto), HEADERS (1), BOTH (2).
request_method		string	Tipo de método de solicitud. Soportado para métricas HTTP_AGENT. Valores posibles:¹ GET (0, por defecto), POST (1), PUT (2), HEAD (3).
output_format		string	Cómo procesar la respuesta. Soportado para métricas HTTP_AGENT. Valores posibles:¹ RAW (0, por defecto), JSON (1).
allow_traps		string	Permitir poblar el valor de manera similar a la métrica trapper. Soportado para métricas HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
ssl_cert_file		string	Ruta del archivo de clave pública SSL. Soportado para métricas HTTP_AGENT.
ssl_key_file		string	Ruta del archivo de clave privada SSL. Soportado para métricas HTTP_AGENT.
ssl_key_password		string	Contraseña para el archivo de clave SSL. Soportado para métricas HTTP_AGENT.
verify_peer		string	Si se debe validar que el certificado del equipo es auténtico. Soportado para métricas HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
verify_host		string	Si se debe validar que el nombre del equipo para la conexión coincide con el del certificado del equipo. Soportado para métricas HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
tags			Elemento raíz para las etiquetas de la métrica.
	tag	string	(obligatorio) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.
triggers			Elemento raíz para los disparadores de métricas de equipo.

Ver también: Objeto métrica (consulte la propiedad relevante con el mismo nombre).

Pasos de preprocesamiento de valores de métricas de equipo

zabbix_export:
         (...)
         hosts:
           - host: 'Servidor MySQL'
             (...)
             items:
               (...)
               - name: 'Uso de disco de caché de Binlog'
                 (...)
                 preprocessing:
                   - type: JSONPATH
                     parameters:
                       - $.Binlog_cache_disk_use
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 6h
                 (...)

Elemento		Tipo	Descripción
type		string	(requerido) El tipo de paso de preprocesamiento de valor de métrica. Valores posibles:¹ 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, calculado: valor recibido - valor anterior), CHANGE_PER_SECOND (10, calculado: (valor recibido - valor anterior)/(hora actual - hora de la última comprobación)), 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			(requerido) Elemento raíz para los parámetros del paso de preprocesamiento de valor de métrica.
	parameter	string	Parámetro individual del paso de preprocesamiento de valor de métrica.
error_handler		string	Tipo de acción utilizada en caso de fallo en el paso de preprocesamiento. Valores posibles:¹ ORIGINAL_ERROR (0, por defecto), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params		string	Parámetros del gestor de errores.

Ver también: Objeto de preprocesamiento de métrica (consulte la propiedad relevante con el mismo nombre).

Disparadores de métricas de equipo

zabbix_export:
         (...)
         hosts:
           - host: 'Servidor MySQL'
             (...)
             items:
               (...)
               - name: Tiempo de actividad
                 (...)
                 triggers:
                   - expression: 'nodata(/Servidor MySQL/mysql.uptime,30m)=1'
                     name: 'MySQL: Error al obtener datos de información'
                     event_name: 'MySQL: Error al obtener datos de información (o sin datos durante 30m)'
                     priority: INFO
                     description: 'Zabbix no ha recibido ningún dato de las métricas en los últimos 30 minutos.'
                     dependencies:
                       - name: 'MySQL: El servicio está caído'
                         expression: 'last(/Servidor MySQL/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0'
                     tags:
                       - tag: scope
                         value: availability
                   - expression: 'last(/Servidor MySQL/mysql.uptime)<10m'
                     name: 'MySQL: El servicio ha sido reiniciado'
                     event_name: 'MySQL: El servicio ha sido reiniciado (tiempo de actividad < 10m)'
                     priority: INFO
                     description: 'El tiempo de actividad de MySQL es inferior a 10 minutos.'
                     tags:
                       - tag: scope
                         value: notice
               (...)

Elemento		Tipo	Descripción
uuid		string	(obligatorio) Identificador único para este disparador.
expression		string	(obligatorio) Expresión del disparador.
recovery_mode		string	Base para generar eventos OK. Valores posibles:¹ EXPRESSION (0, por defecto), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression		string	Expresión de recuperación del disparador.
correlation_mode		string	Modo de correlación (sin correlación de eventos o correlación de eventos por etiqueta). Valores posibles:¹ DISABLED (0, por defecto), TAG_VALUE (1).
correlation_tag		string	Nombre de la etiqueta que se utilizará para la correlación de eventos.
name		string	(obligatorio) Nombre del disparador.
event_name		string	Nombre del evento.
opdata		string	Datos operativos.
url_name		string	Etiqueta para la URL asociada al disparador.
url		string	URL asociada al disparador.
status		string	Estado del disparador. Valores posibles:¹ ENABLED (0, por defecto), DISABLED (1).
priority		string	Severidad del disparador. Valores posibles:¹ NOT_CLASSIFIED (0, por defecto), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description		text	Descripción del disparador.
type		string	Tipo de generación de eventos (evento de problema único o múltiples eventos de problema). Valores posibles:¹ SINGLE (0, por defecto), MULTIPLE (1).
manual_close		string	Cierre manual de eventos de problema. Valores posibles:¹ NO (0, por defecto), YES (1).
dependencies			Elemento raíz para dependencias.
	name	string	(obligatorio) Nombre del disparador de dependencia.
	expression	string	(obligatorio) Expresión del disparador de dependencia.
	recovery_expression	string	Expresión de recuperación del disparador de dependencia.
tags			Elemento raíz para etiquetas de disparador.
	tag	string	(obligatorio) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.

Ver también: Objeto disparador (consulte la propiedad relevante con el mismo nombre).

Reglas de descubrimiento de bajo nivel de equipos

zabbix_export:
         (...)
         hosts:
           - host: 'Servidor MySQL'
             (...)
             discovery_rules:
               - name: 'Descubrimiento de bases de datos'
                 key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
                 delay: 1h
                 filter: (ver tabla abajo)
                 description: 'Escaneo de bases de datos en el SGBD.'
                 interface_ref: if1
                 item_prototypes:
                   - name: 'Tamaño de la base de datos {#DATABASE}'
                     key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
                     delay: 5m
                     units: B
                     description: 'Tamaño de la base de datos.'
                     preprocessing:
                       - type: DISCARD_UNCHANGED_HEARTBEAT
                         parameters:
                           - 1h
                     interface_ref: if1
                     tags:
                       - tag: component
                         value: storage
                       - tag: database
                         value: '{#DATABASE}'
                 lld_macro_paths:
                   - lld_macro: '{#DATABASE}'
                     path: $.Database
                 preprocessing:
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 1d
               (...)

La mayoría de los elementos de las reglas de descubrimiento de bajo nivel de equipos son iguales que para las métricas de equipos. La siguiente tabla describe aquellos elementos que difieren de las métricas de equipos.

Elemento		Tipo	Descripción
type		string	Tipo de métrica. Valores posibles:¹ ZABBIX_PASSIVE (0, por defecto), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
key		string	(requerido) Clave de la regla de descubrimiento de bajo nivel.
filter			Elemento raíz para los filtros de reglas de descubrimiento de bajo nivel de equipos.
lifetime		string	Periodo de tiempo (usando segundos, sufijo de tiempo, o macro de usuario), después del cual los recursos ya no descubiertos serán eliminados. Por defecto: 7d.
lifetime_type		string	Escenario para eliminar recursos LLD perdidos. Valores posibles: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER.
enabled_lifetime		string	Periodo de tiempo (usando segundos, sufijo de tiempo, o macro de usuario), después del cual los recursos ya no descubiertos serán deshabilitados.
enabled_lifetime_type		string	Escenario para deshabilitar recursos LLD perdidos. Valores posibles: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER.
item_prototypes			Elemento raíz para los elementos prototipo de métricas de equipos, que son iguales que para las métricas de equipos.
trigger_prototypes			Elemento raíz para los elementos prototipo de disparadores de equipos, que son iguales que para los disparadores de métricas de equipos.
graph_prototypes			Elemento raíz para los prototipos de gráficos de equipos, que son iguales que para los gráficos de equipos.
host_prototypes			Elemento raíz para los prototipos de equipos, que son iguales que para los equipos.
parent_discovery_rule			Elemento raíz para la regla de descubrimiento de bajo nivel padre (o prototipo de regla) del prototipo de regla de descubrimiento de bajo nivel. Esta propiedad indica que es un prototipo de regla LLD, hijo directo de la regla/prototipo referenciado.
	key	string	(requerido) Clave de la regla de descubrimiento de bajo nivel padre (o prototipo de regla).
master_item		string	(requerido para reglas DEPENDENT) Elemento raíz para la métrica principal de la regla dependiente.
lld_macro_paths			Elemento raíz para las rutas de macros de reglas de descubrimiento de bajo nivel.
	lld_macro	string	(requerido) Nombre de la macro de la regla de descubrimiento de bajo nivel.
	path	string	(requerido) Selector para el valor, que se asignará a la macro correspondiente.
preprocessing			Elemento raíz para el preprocesamiento de valores de la regla de descubrimiento de bajo nivel.
	step		Elemento raíz para los pasos de preprocesamiento de valores de la regla de descubrimiento de bajo nivel, que son iguales que para los pasos de preprocesamiento de valores de métricas de equipos, excepto con menos valores posibles. Véase también: Objeto de preprocesamiento de reglas LLD.
overrides			Elemento raíz para las reglas de sobrescritura de reglas de descubrimiento de bajo nivel.
	name	string	(requerido) Nombre único de la sobrescritura.
	step	string	(requerido) Número de orden único de la sobrescritura.
	stop	string	Detener el procesamiento de siguientes sobrescrituras si coincide.
	filter		Elemento raíz para los elementos de filtro de reglas de sobrescritura de reglas de descubrimiento de bajo nivel, que son iguales que para los filtros de reglas de descubrimiento de bajo nivel de equipos.
	operations		Elemento raíz para las operaciones de sobrescritura de reglas de descubrimiento de bajo nivel de equipos.

Véase también: Objeto de regla LLD (consulte la propiedad relevante con el mismo nombre).

Filtros de reglas de bajo nivel de descubrimiento de equipos

zabbix_export:
         (...)
         hosts:
           - host: 'Servidor MySQL'
             (...)
             discovery_rules:
               - name: 'Descubrimiento de bases de datos'
                 (...)
                 filter:
                   evaltype: AND
                   conditions:
                     - macro: '{#DATABASE}'
                       value: '{$MYSQL.DBNAME.MATCHES}'
                     - macro: '{#DATABASE}'
                       value: '{$MYSQL.DBNAME.NOT_MATCHES}'
                       operator: NOT_MATCHES_REGEX
                 (...)

Elemento		Tipo	Descripción
evaltype		string	Sobrescribe el método de evaluación de la condición del filtro. Valores posibles:¹ AND_OR (0, por defecto), AND (1), OR (2), FORMULA (3).
formula		string	Fórmula de cálculo personalizada para las condiciones del filtro.
conditions			Elemento raíz para las condiciones del filtro.
	macro	string	(requerido) El nombre de la macro de bajo nivel de descubrimiento sobre la que realizar la comprobación.
	value	string	Valor con el que comparar.
	operator	string	Operador de condición. Valores posibles:¹ MATCHES_REGEX (8, por defecto), NOT_MATCHES_REGEX (9).
	formulaid	string	(requerido) ID único arbitrario que se utiliza para referenciar una condición desde la expresión personalizada. Solo puede contener letras mayúsculas. El ID debe ser definido por el usuario al modificar las condiciones del filtro, pero se generará de nuevo al solicitarlas posteriormente.

Véase también: Objeto de filtro de regla LLD (consulte la propiedad relevante con el nombre correspondiente).

Operaciones de anulación de reglas de bajo nivel de descubrimiento de equipos

Elemento		Tipo	Descripción
operationobject		string	Objeto al que se aplica la operación. Valores posibles:¹ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3), DISCOVERY_PROTOTYPE (4).
operator		string	Operador de condición de anulación. Valores posibles:¹ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value		string	Una expresión regular o una cadena para el operador de condición de anulación.
status		string	Estado del objeto tras la operación de anulación.
discover		string	Indica si el objeto se añade como resultado del descubrimiento.
delay		string	Intervalo de actualización establecido para la métrica prototipo tras la operación de anulación.
history		string	Periodo de almacenamiento de histórico establecido para la métrica prototipo tras la operación de anulación.
trends		string	Periodo de almacenamiento de tendencias establecido para la métrica prototipo tras la operación de anulación.
severity		string	Gravedad del prototipo de disparador establecida tras la operación de anulación.
tags			Elemento raíz para las etiquetas establecidas para el objeto tras la operación de anulación.
	tag	string	(obligatorio) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.
templates			Elemento raíz para las plantillas vinculadas al prototipo de equipo tras la operación de anulación.
	name	string	(obligatorio) Nombre de la plantilla.
inventory_mode		string	Modo de inventario del prototipo de equipo establecido tras la operación de anulación.

Consulte también: Objeto de operación de anulación de regla LLD (consulte la propiedad relevante con el mismo nombre).

Escenarios web de equipos

Elemento		Tipo	Descripción
uuid		string	(requerido) Identificador único para este escenario web.
name		string	(requerido) Nombre del escenario web.
delay		string	Frecuencia (usando segundos, sufijo de tiempo, o macro de usuario) de ejecución del escenario web. Por defecto: 1m.
attempts		integer	El número de intentos para ejecutar los pasos del escenario web. Valores posibles: 1-10 (por defecto: 1).
agent		string	Agente cliente. Zabbix simulará ser el navegador seleccionado. Esto es útil cuando un sitio web devuelve contenido diferente para diferentes navegadores. Por defecto: Zabbix.
http_proxy		string	Proxy que será utilizado por el escenario web dado como: `http://[usuario[:contraseña]@]proxy.ejemplo.com[:puerto]`
variables			Elemento raíz para las variables del escenario web que pueden ser utilizadas en los pasos del escenario.
	name	string	(requerido) Nombre de la variable.
	value	text	(requerido) Valor de la variable.
headers			Elemento raíz para las cabeceras HTTP que se enviarán al realizar una petición. Las cabeceras deben listarse usando la misma sintaxis que aparecerían en el protocolo HTTP.
	name	string	(requerido) Nombre de la cabecera.
	value	text	(requerido) Valor de la cabecera.
status		string	Estado del escenario web. Valores posibles:¹ HABILITADO (0, por defecto), DESHABILITADO (1).
authentication		string	Método de autenticación. Valores posibles:¹ NINGUNO (0, por defecto), BÁSICO (1), NTLM (2).
http_user		string	Nombre de usuario utilizado para la autenticación BÁSICA (HTTP) o NTLM.
http_password		string	Contraseña utilizada para la autenticación BÁSICA (HTTP) o NTLM.
verify_peer		string	Verificar el certificado SSL del servidor web. Valores posibles:¹ NO (0, por defecto), SÍ (1).
verify_host		string	Verificar que el campo Common Name o el campo Subject Alternate Name del certificado del servidor web coincida. Valores posibles:¹ NO (0, por defecto), SÍ (1).
ssl_cert_file		string	Nombre del archivo de certificado SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
ssl_key_file		string	Nombre del archivo de clave privada SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
ssl_key_password		string	Contraseña del archivo de clave privada SSL.
steps			(requerido) Elemento raíz para los pasos del escenario web de equipos.
tags			Elemento raíz para las etiquetas del escenario web.
	tag	string	(requerido) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.

Ver también: Objeto escenario web (consulte la propiedad relevante con el mismo nombre).

Pasos del escenario web del equipo

Elemento		Tipo	Descripción
name		string	(obligatorio) Nombre del paso del escenario web.
url		string	(obligatorio) URL para monitorización.
query_fields			Elemento raíz para los parámetros de consulta (un array de campos HTTP que se añadirán a la URL al realizar una petición).
	name	string	(obligatorio) Nombre del parámetro de consulta.
	value	string	Valor del parámetro de consulta.
posts			Elemento raíz para variables HTTP POST (una cadena (datos raw post) o un array de campos HTTP (datos de campo de formulario)).
	name	string	(obligatorio) Nombre del campo POST.
	value	string	(obligatorio) Valor del campo POST.
variables			Elemento raíz de variables a nivel de paso (macros) que deben aplicarse después de este paso. Si el valor de la variable tiene el prefijo 'regex:', entonces su valor se extrae de los datos devueltos por este paso según el patrón de expresión regular que sigue al prefijo 'regex:'
	name	string	(obligatorio) Nombre de la variable.
	value	text	(obligatorio) Valor de la variable.
headers			Elemento raíz para las cabeceras HTTP que se enviarán al realizar una petición.
	name	string	(obligatorio) Nombre de la cabecera.
	value	text	(obligatorio) Valor de la cabecera.
follow_redirects		string	Seguir redirecciones HTTP. Valores posibles:¹ NO (0), SÍ (1, por defecto).
retrieve_mode		string	Modo de obtención de la respuesta HTTP. Valores posibles:¹ BODY (0, por defecto), HEADERS (1), BOTH (2).
timeout		string	Tiempo de espera (usando segundos, sufijo de tiempo, o macro de usuario) para la ejecución del paso. Por defecto: 15s.
required		string	Texto que debe estar presente en la respuesta (se ignora si está vacío).
status_codes		string	Lista separada por comas de códigos de estado HTTP aceptados (por ejemplo, `200-201,210-299`; se ignora si está vacío).

Ver también: Objeto paso de escenario web (consulte la propiedad relevante con el mismo nombre).

Gráficas de equipo

zabbix_export:
         (...)
         graphs:
           - name: 'MySQL: Ancho de banda'
             graph_items: (ver tabla abajo)
           (...)

Elemento		Tipo	Descripción
uuid		string	Identificador único de la gráfica.
name		string	(requerido) Nombre de la gráfica.
width		integer	Ancho de la gráfica, en píxeles. Usado para la vista previa y para gráficas de tipo tarta/explosión. Valores posibles:¹ 20-65535 (por defecto: 900).
height		integer	Altura de la gráfica, en píxeles. Usado para la vista previa y para gráficas de tipo tarta/explosión. Valores posibles:¹ 20-65535 (por defecto: 900).
yaxismin		double	Valor mínimo del eje Y. Soportado para valor FIJO mínimo del eje Y. Por defecto: 0.
yaxismax		double	Valor máximo del eje Y. Soportado para valor FIJO máximo del eje X. Por defecto: 0.
show_work_period		string	Resaltar horas no laborables. Soportado para gráficas NORMALES y APILADAS. Valores posibles:¹ NO (0), SÍ (1, por defecto).
show_triggers		string	Mostrar valores simples de disparadores como una línea. Soportado para gráficas NORMALES y APILADAS. Valores posibles:¹ NO (0), SÍ (1, por defecto).
type		string	Tipo de gráfica. Valores posibles:¹ NORMAL (0, por defecto), STACKED (1), PIE (2), EXPLODED (3).
show_legend		string	Mostrar leyenda de la gráfica. Valores posibles:¹ NO (0), SÍ (1, por defecto).
show_3d		string	Habilitar estilo 3D. Soportado para gráficas NORMALES y APILADAS. Valores posibles:¹ NO (0, por defecto), SÍ (1).
percent_left		double	Mostrar la línea de percentil para el eje izquierdo. Soportado para gráficas NORMALES. Por defecto: 0.
percent_right		double	Mostrar la línea de percentil para el eje derecho. Soportado para gráficas NORMALES. Por defecto: 0.
ymin_type_1		string	Valor mínimo del eje Y. Soportado para gráficas NORMALES y APILADAS. Valores posibles:¹ CALCULADO (0, por defecto), FIJO (1), MÉTRICA (2).
ymin_item_1			(requerido si `ymin_type_1` está establecido en `ITEM`) Elemento raíz para los detalles individuales de la métrica.
	host	string	(requerido) Equipo de la métrica.
	key	string	(requerido) Clave de la métrica.
ymax_type_1		string	Valor máximo del eje Y. Soportado para gráficas NORMALES y APILADAS. Valores posibles:¹ CALCULADO (0, por defecto), FIJO (1), MÉTRICA (2).
ymax_item_1			(requerido si `ymax_type_1` está establecido en `ITEM`) Elemento raíz para los detalles individuales de la métrica.
	host	string	(requerido) Equipo de la métrica.
	key	string	(requerido) Clave de la métrica.
graph_items			(requerido) Elemento raíz para métricas de gráficas de equipo.

Ver también: Objeto gráfica (consulte la propiedad relevante con el mismo nombre).

Métricas de gráfico de equipo

zabbix_export:
         (...)
         graphs:
           - name: 'MySQL: Ancho de banda'
             graph_items:
               - drawtype: GRADIENT_LINE
                 color: 199C0D
                 item:
                   host: 'Servidor MySQL'
                   key: mysql.bytes_received.rate
               - sortorder: '1'
                 drawtype: GRADIENT_LINE
                 color: F63100
                 item:
                   host: 'Servidor MySQL'
                   key: mysql.bytes_sent.rate
           (...)

Elemento		Tipo	Descripción
sortorder		integer	Orden de dibujo. El valor más pequeño se dibuja primero. Puede usarse para dibujar líneas o regiones detrás (o delante) de otra.
drawtype		string	Estilo de dibujo del elemento del gráfico. Soportado para gráficos NORMALES. Valores posibles:¹ SINGLE_LINE (0, por defecto), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5).
color		string	Color del elemento (6 símbolos, hex).
yaxisside		string	Lado del gráfico donde se dibujará la escala Y del elemento del gráfico. Soportado para gráficos NORMALES y APILADOS.
calc_fnc		string	Dato a dibujar si existe más de un valor para una métrica. Valores posibles:¹ MIN (1), AVG (2, por defecto), MAX (4), ALL (7; mínimo, promedio y máximo; soportado para gráficos simples), LAST (9, soportado para gráficos de pastel/explosión).
type		string	Tipo de elemento de gráfico. Valores posibles:¹ SIMPLE (0, por defecto), GRAPH_SUM (2; el valor de la métrica representa todo el pastel; soportado para gráficos de pastel/explosión).
item			(requerido) Métrica individual.
	host	string	(requerido) Equipo de la métrica.
	key	string	(requerido) Clave de la métrica.

Ver también: Objeto de elemento de gráfico (consulte la propiedad correspondiente con el mismo nombre).

Mapas de valores de equipo

zabbix_export:
         (...)
         hosts:
           - host: 'Servidor MySQL'
             (...)
             valuemaps:
               - name: Ejemplo de mapa de valores
                 mappings:
                   - value: '1'
                     newvalue: Valor de ejemplo
         (...)

Elemento		Tipo	Descripción
uuid		string	(obligatorio) Identificador único para este mapa de valores.
name		string	(obligatorio) Nombre del mapa de valores.
mapping			Elemento raíz para las asignaciones.
	type	string	Tipo de coincidencia de asignación. Valores posibles:¹ EQUAL (0, por defecto), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
	value	string	Valor original.
	newvalue	string	(obligatorio) Valor al que se asigna el valor original.

Ver también: Objeto mapa de valores (consulte la propiedad correspondiente con el mismo nombre).

Notas al pie

¹ Los valores enteros de la API entre corchetes, por ejemplo, ENABLED (0), se mencionan solo como referencia. Para obtener más información, consulte la página del objeto API enlazada en la entrada de la tabla o al final de cada sección.

Documentation