Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

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:

  1. Vaya a Recopilación de datosEquipos.
  2. Marque las casillas de verificación de los equipos a exportar.
  3. 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:

  1. Vaya a Recopilación de datosEquipos.
  2. Haga clic en Importar a la derecha.
  3. Seleccione el archivo de importación.
  4. 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 Rango1 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:1 NO (0), YES (1, default).
type string Interface type.
Possible values:1 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:1 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:1 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:1 NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).
authprotocol string SNMPv3 authentication protocol.
Supported for SNMPv3 items.
Possible values:1 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:1 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:1 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 Rango1 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:1 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:1 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 Rango1 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:1 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:1 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:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator string Override condition operator.
Possible values:1 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 Rango1 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 Rango1 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:1 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:1 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:1 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:1 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 Rango1 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:1 NO (0), YES (1, default).
retrieve_mode string HTTP response retrieve mode.
Possible values:1 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

1 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.