Documentation
Table of Contents
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 de equipo
- Métricas directamente vinculadas
- Iniciadores directamente vinculados
- Reglas de descubrimiento directamente vinculadas con todos los prototipos.
- Escenarios web directamente vinculados
- Macros de equipo
- Datos de inventario de equipo
- Mapas de valores
- Gráficos vinculados
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.
Importando
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 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 se marcarán/desmarcarán.
Reglas de importación:
| Regla | Descripción |
|---|---|
| Actualizar existente | Los elementos existentes se actualizarán utilizando los datos del archivo de importación. En caso contrario no se actualizarán. |
| Crear nuevo | Se crearán nuevos elementos utilizando los datos del archivo de importación. En caso contrario no se crearán. |
| Eliminar faltante | Se eliminarán los elementos existentes que no estén presentes en el archivo de importación. De lo contrario, no se eliminarán. Si Eliminar faltante está marcado para Vínculo de plantilla, el vínculo de plantilla actual que no esté presente en el archivo de importación se desvinculará. Las entidades (métricas, iniciadores, 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 la interfaz.
Formato de exportación
Formato de exportación en YAML:
zabbix_export:
version: '7.0'
host_groups:
- uuid: f2481361f99448eea617b7b1d4765566
name: 'Discovered hosts'
- uuid: 6f6799aa69e844b4b3918f779f2abf08
name: 'Zabbix servers'
hosts:
- host: 'Zabbix server 1'
name: 'Main Zabbix server'
monitored_by: '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: component
value: 'raw'
triggers:
- expression: 'last(/Zabbix server 1/trap)=0'
name: 'Last value is zero'
priority: WARNING
tags:
- tag: scope
value: 'availability'
tags:
- tag: service
value: zabbix-server
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]'Elementos exportados
Los elementos exportados se explican en las tablas siguientes.
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| version | cadena | (obligatorio) Versión de Zabbix. | |
| host_groups | (obligatorio) Elemento raíz para grupos de equipos. | ||
| uuid | cadena | (obligatorio) Identificador único para este grupo de equipos. | |
| name | cadena | (obligatorio) Nombre del grupo de equipos. | |
| hosts | Elemento raíz para equipos. | ||
Equipos
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| host | cadena | (obligatorio) Nombre de equipo único. | |
| name | cadena | Nombre de equipo visible. | |
| description | texto | Descripción del equipo. | |
| monitored_by | string | El equipo es monitoreado por: SERVER, PROXY o PROXY_GROUP. | |
| proxy | Elemento raíz para proxy. | ||
| name | cadena | (obligatorio) Nombre del proxy (si lo hay) que monitorea el equipo. | |
| proxy_group | Elemento raíz para el grupo proxy. | ||
| name | cadena | (obligatorio) Nombre del grupo de proxy (si lo hay) que se utiliza para monitorear el equipo. | |
| status | cadena | Estado del equipo. Valores posibles:1 HABILITADO (0, predeterminado), DISABLED (1). |
|
| ipmi_authtype | string | Tipo de autenticación de sesión IPMI. Valores posibles:1 DEFAULT (-1, predeterminado), NINGUNO (0), MD2 (1), MD5 (2 ), RECTO (4), OEM (5), RMCP_PLUS (6). |
|
| ipmi_privilege | string | Nivel de privilegio de sesión IPMI. Valores posibles:1 DEVOLUCIÓN DE LLAMADA (1), USUARIO (2, predeterminado), OPERADOR (3), ADMIN (4) , OEM (5). |
|
| ipmi_username | string | Nombre de usuario para comprobaciones de IPMI. | |
| ipmi_password | string | Contraseña para comprobaciones de IPMI. | |
| templates | Elemento raíz para plantillas vinculadas. | ||
| name | cadena | (obligatorio) Nombre de la plantilla. | |
| groups | Elemento raíz para los grupos de equipos a los que pertenece el equipo. | ||
| name | cadena | (obligatorio) Nombre del grupo de equipos. | |
| interfaces | Elemento raíz para interfaces de equipo. | ||
| items | Elemento raíz para métricas de equipo. | ||
| discovery_rules | Elemento raíz para reglas de descubrimiento de bajo nivel del host. | ||
| http_tests | Elemento raíz para escenarios web de equipo. | ||
| tags | Elemento raíz para etiquetas de equipo. | ||
| tag | cadena | (obligatorio) Nombre de etiqueta. | |
| value | cadena | Valor de etiqueta. | |
| macros | Elemento raíz para macros de equipo. | ||
| macro | cadena | (obligatorio) Nombre de macro de usuario. | |
| type | cadena | Tipo de macro de usuario. Valores posibles:1 TEXTO (0, predeterminado), SECRETO_TEXTO (1), BÓVEDA (2). |
|
| value | cadena | Valor de macro de usuario. | |
| description | cadena | Descripción de macro de usuario. | |
| inventory | Elemento raíz para el inventario de host. | ||
| <inventory_property> | cadena | Propiedad de inventario. Todas las propiedades tienen su elemento respectivo (tipo, nombre, os, etc.; por ejemplo, consulte Formato de exportación). |
|
| inventory_mode | cadena | Modo de inventario. Valores posibles:1 DISABLED (-1), MANUAL (0, predeterminado), AUTOMATICO (1). |
|
| valuemaps | Elemento raíz para mapas de valores de equipo. | ||
Consulte también: Objeto equipo (consulte la propiedad relevante con un nombre coincidente).
Interfaces de equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| default | cadena | Si esta es la interfaz del equipo principal. Tenga en cuenta que sólo puede haber una interfaz principal de un tipo en un equipo. Valores posibles:1 NO (0), SÍ (1, predeterminado). |
|
| type | cadena | Tipo de interfaz. Valores posibles:1 ZABBIX (1, predeterminado), SNMP (2), IPMI (3), JMX (4). |
|
| useip | cadena | Si se debe usar IP como interfaz para conectarse al host (de lo contrario, se usará DNS). Valores posibles:1 NO (0), SÍ ( 1, predeterminado). |
|
| ip | cadena | (obligatorio para conexiones IP) Dirección IP (IPv4 o IPv6). | |
| dns | cadena | (obligatorio para conexiones DNS) Nombre DNS. | |
| port | cadena | Número de puerto. | |
| details | Elemento raíz para detalles de la interfaz. | ||
| version | cadena | Utilice esta versión de SNMP. Valores posibles:1 SNMPV1 (1), SNMP_V2C (2, predeterminado), SNMP_V3 (3). |
|
| community | cadena | Comunidad SNMP (obligatorio para métricas SNMPv1 y SNMPv2). | |
| max_repetitions | cadena | Valor máximo de repetición para solicitudes masivas SNMP nativas (GetBulkRequest-PDU). Compatible con métricas SNMPv2 y SNMPv3 (métricas discovery[] y walk[]).Valor predeterminado: 10. |
|
| contextname | cadena | Nombre de contexto SNMPv3. Compatible con métricas SNMPv3. |
|
| securityname | cadena | Nombre de seguridad SNMPv3. Compatible con métricas SNMPv3. |
|
| securitylevel | cadena | Nivel de seguridad SNMPv3. Compatible con métricas SNMPv3. Valores posibles:1 NOAUTHNOPRIV (0, predeterminado), AUTHNOPRIV (1), AUTHPRIV (2) . |
|
| authprotocol | string | Protocolo de autenticación SNMPv3. Compatible con métricas SNMPv3. Valores posibles:1 MD5 (0, predeterminado), SHA1 (1), SHA224 (2) , SHA256 (3), SHA384 (4), SHA512 (5). |
|
| authpassphrase | string | Frase de contraseña de autenticación SNMPv3. Compatible con métricas SNMPv3. |
|
| privprotocol | string | Protocolo de privacidad SNMPv3. Compatible con métricas SNMPv3. Valores posibles:1 DES (0, predeterminado), AES128 (1), AES192 (2) , AES256 (3), AES192C (4), AES256C (5). |
|
| privpassphrase | string | Frase de contraseña de privacidad SNMPv3. Compatible con métricas SNMPv3. |
|
| bulk | string | Usar solicitudes masivas para SNMP. Valores posibles:1 NO (0), SÍ (1, predeterminado). |
|
| interface_ref | cadena | Nombre de referencia de la interfaz que se utilizará en las métricas (formato: if<N>). |
|
Consulte también: Objeto de interfaz de equipo (consulte la propiedad relevante con un nombre coincidente).
Elementos del host
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| name | cadena | (obligatorio) Nombre de la métrica. | |
| type | cadena | Tipo de métrica. Valores posibles:1 ZABBIX_PASSIVE (0, predeterminado), 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). |
|
| snmp_oid | cadena | ID de objeto SNMP (obligatorio para métricas SNMP_AGENT). | |
| key | cadena | (obligatorio) Clave de la métrica. | |
| delay | cadena | Intervalo de actualización de la métrica. Predeterminado: 1 m. El valor siempre será 0 para los métricas TRAP. |
|
| history | cadena | Período de tiempo (usando sufijo de tiempo, macro de usuario o macro LLD) de cuánto tiempo se deben almacenar los datos del historial. Predeterminado: 31d. |
|
| trends | cadena | Período de tiempo (usando sufijo de tiempo, macro de usuario o macro LLD) de cuánto tiempo se deben almacenar los datos de tendencias. Predeterminado: 365d. |
|
| status | string | Estado de la métrica. Valores posibles:1 HABILITADO (0, predeterminado), DISABLED (1). |
|
| value_type | cadena | Tipo de valor recibido. Valores posibles:1 FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, predeterminado), TEXTO (4), BINARIO (5). |
|
| allowed_hosts | cadena | Lista de direcciones IP delimitadas por comas de equipos autorizados a enviar datos para la métrica. Compatible con métricas TRAP y HTTP_AGENT. |
|
| units | cadena | Unidades de 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 CALCULADAS; script para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER). | |
| ipmi_sensor | string | Sensor IPMI. Compatible con métricas IPMI. |
|
| authtype | string | Tipo de autenticación. Compatible con métricas SSH y HTTP_AGENT. Valores posibles para métricas SSH:1 CONTRASEÑA (0, predeterminada), PUBLIC_KEY (1). Valores posibles para métricas HTTP_AGENT:1 NONE (0, predeterminado), BASIC (1), NTLM (2). |
|
| username | cadena | Nombre de usuario para autenticación (obligatorio para métricas SSH y TELNET). Compatible con métricas SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se usa para métricas JMX, password (ver más abajo ) también debe especificarse o ambos elementos deben dejarse en blanco. |
|
| password | cadena | (obligatorio para elementos SSH y TELNET) Contraseña para autenticación. Compatible con métricas SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se usa para métricas JMX, username (ver arriba ) también debe especificarse o ambos elementos deben dejarse 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 | texto | Descripción de la métrica. | |
| inventory_link | cadena | Campo de inventario del equipo que se completa con la métrica. Valores posibles:1 NINGUNO (0), ALIAS (4), etc. (consulte inventario de equipos para campos admitidos). |
|
| valuemap | Elemento raíz para mapas de valores de métricas. | ||
| name | cadena | (obligatorio) Nombre del mapa de valores que se utilizará para la métrica. | |
| logtimefmt | string | Formato de la hora en las entradas del registro. Compatible con métricas de tipo de valor LOG. |
|
| preprocessing | Elemento raíz para el preprocesamiento del valor de la métrica. | ||
| step | Elemento raíz para pasos de preprocesamiento del valor de la métrica del equipo. | ||
| interface_ref | string | Referencia a la interfaz del equipo (formato: if<N>). |
|
| jmx_endpoint | string | Punto final JMX. Compatible con elementos JMX. |
|
| master_item | (obligatorio para artículos DEPENDENTES) Elemento raíz para la métrica principal de al métrica dependiente. | ||
| key | cadena | (obligatorio) Clave maestra de la métrica dependiente. | |
| timeout | string | Tiempo de espera de solicitud de sondeo de datos de métricas. Compatible con la lista de tipos de métricas Tiempos de espera. |
|
| url | cadena | Cadena de URL (obligatorio para métricas HTTP_AGENT). | |
| query_fields | Elemento raíz para parámetros de consulta. Compatible con métricas HTTP_AGENT. |
||
| name | cadena | (obligatorio para elementos HTTP_AGENT) Nombre del parámetro de consulta. | |
| value | cadena | Valor del parámetro de consulta. Compatible con métricas HTTP_AGENT. |
|
| parameters | Elemento raíz para parámetros definidos por el usuario. Compatible con métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER. |
||
| name | cadena | (obligatorio para las métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER) Nombre de parámetro definido por el usuario. | |
| value | cadena | Valor de parámetro definido por el usuario. Compatible con métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER. |
|
| posts | cadena | Datos del cuerpo de la solicitud HTTP(S). Compatible con métricas HTTP_AGENT. |
|
| status_codes | cadena | Rangos de códigos de estado HTTP requeridos, separados por comas. Compatible con métricas HTTP_AGENT. |
|
| follow_redirects | string | Siga las redirecciones de respuesta mientras sondea los datos. Compatible con métricas HTTP_AGENT. Valores posibles:1 NO (0), SÍ (1, predeterminado). |
|
| post_type | string | Tipo de cuerpo de datos de la publicación. Compatible con métricas HTTP_AGENT. Valores posibles:1 RAW (0, predeterminado), JSON (2 ), XML (3). |
|
| http_proxy | cadena | Cadena de conexión de proxy HTTP(S). Compatible con métricas HTTP_AGENT. |
|
| headers | Elemento raíz para encabezados de solicitud HTTP(S). Compatible con métricas HTTP_AGENT. |
||
| name | cadena | (obligatorio para elementos HTTP_AGENT) Nombre del encabezado. | |
| value | cadena | (obligatorio para elementos HTTP_AGENT) Valor del encabezado. | |
| retrieve_mode | cadena | Qué parte de la respuesta debe almacenarse. Compatible con métricas HTTP_AGENT. Valores posibles:1 BODY (0, predeterminado), HEADERS (1), AMBOS (2). |
|
| request_method | cadena | Tipo de método de solicitud. Compatible con métricas HTTP_AGENT. Valores posibles:1 GET (0, predeterminado), POST (1), PONER (2), CABEZA (3). |
|
| output_format | cadena | Cómo procesar la respuesta. Compatible con métricas HTTP_AGENT. Valores posibles:1 RAW (0, predeterminado), JSON (1) . |
|
| allow_traps | string | Permite completar el valor de manera similar a la métrica de captura. Compatible con elementos HTTP_AGENT. Valores posibles:1 NO (0, predeterminado) , SÍ (1). |
|
| ssl_cert_file | cadena | Ruta del archivo de clave SSL pública. Compatible con métricas HTTP_AGENT. |
|
| ssl_key_file | cadena | Ruta del archivo de clave SSL privada. Compatible con métricas HTTP_AGENT. |
|
| ssl_key_password | cadena | Contraseña para el archivo de clave SSL. Compatible con métricas HTTP_AGENT. |
|
| verify_peer | cadena | Si se valida que el certificado del equipo es auténtico. Compatible con métricas HTTP_AGENT. Valores posibles:1 NO (0, predeterminado) , SÍ (1). |
|
| verify_host | string | Si se valida que el nombre de equipo para la conexión coincida con el del certificado del equipo. Compatible con elementos HTTP_AGENT. Valores posibles:1 NO (0, predeterminado), SÍ (1). |
|
| tags | Elemento raíz para etiquetas de métricas. | ||
| tag | cadena | (obligatorio) Nombre de etiqueta. | |
| value | cadena | Valor de etiqueta. | |
| triggers | Elemento raíz para iniciadores de métricas de equipo. | ||
Consulte también: Objeto de métrica (consulte la propiedad relevante con un nombre coincidente).
Pasos de preprocesamiento del valor de la métrica del equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| type | cadena | (obligatorio) El tipo de paso de preprocesamiento del valor de la métrica. Valores posibles: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, calculado: valor recibido - valor anterior), CHANGE _PER_SECOND (10, calculado: (valor recibido - valor anterior)/(hora actual - hora de la última verificació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 | (obligatorio) Elemento raíz para los parámetros del paso de preprocesamiento del valor de la métrica. | ||
| parameter | cadena | Parámetro individual del paso de preprocesamiento del valor de la métrica. | |
| error_handler | cadena | Tipo de acción utilizado en caso de falla en el paso de preprocesamiento. Valores posibles:1 ORIGINAL_ERROR (0, predeterminado), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3). |
|
| error_handler_params | cadena | Parámetros del controlador de errores. | |
Consulte también: Objeto de preprocesamiento de métricas (consulte la propiedad relevante con un nombre coincidente).
Iniciadores de métricas del equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| uuid | cadena | (obligatorio) Identificador único para este iniciador. | |
| expression | cadena | (obligatorio) Expresión de iniciador. | |
| recovery_mode | string | Base para generar eventos OK. Valores posibles:1 EXPRESSION (0, predeterminado), RECOVERY_EXPRESSION (1), NONE (2). |
|
| recovery_expression | string | Activar expresión de recuperación. | |
| correlation_mode | string | Modo de correlación (sin correlación de eventos o correlación de eventos por etiqueta). Valores posibles:1 DISABLED (0, predeterminado), TAG_VALUE (1) . |
|
| correlation_tag | string | El nombre de la etiqueta que se utilizará para la correlación de eventos. | |
| name | cadena | (obligatorio) Nombre del iniciador. | |
| event_name | cadena | Nombre del evento. | |
| opdata | string | Datos operativos. | |
| url_name | string | Etiqueta para la URL asociada con el iniciador. | |
| url | cadena | URL asociada con el iniciador. | |
| status | string | Estado del iniciador. Valores posibles:1 HABILITADO (0, predeterminado), DISABLED (1). |
|
| priority | cadena | Severidad del iniciador. Valores posibles:1 NOT_CLASSIFIED (0, predeterminado), INFORMACIÓN (1), ADVERTENCIA (2), PROMEDIO (3), ALTA (4), DESASTRE (5). |
|
| description | texto | Descripción del iniciador. | |
| type | cadena | Tipo de generación de evento (evento de problema único o eventos de problema múltiple). Valores posibles:1 SINGLE (0, predeterminado), MULTIPLE (1). |
|
| manual_close | string | Cierre manual de eventos de problema. Valores posibles:1 NO (0, predeterminado), SÍ (1). |
|
| dependencies | Elemento raíz para dependencias. | ||
| name | cadena | (obligatorio) Nombre del iniciador de dependencia. | |
| expression | cadena | (obligatorio) Expresión desencadenante de dependencia. | |
| recovery_expression | string | Expresión de recuperación del iniciador de dependencia. | |
| tags | Elemento raíz para etiquetas de activación. | ||
| tag | cadena | (obligatorio) Nombre de etiqueta. | |
| value | cadena | Valor de etiqueta. | |
Consulte también: Objeto de iniciador (consulte la propiedad relevante con un nombre coincidente).
Reglas de descubrimiento de host de bajo nivel
La mayoría de los elementos de las reglas de descubrimiento de bajo nivel del equipo son los mismos que para las métricas de equipo. La siguiente tabla describe aquellos elementos que difieren de las métricas de equipo.
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| type | cadena | Tipo de métrica. Valores posibles:1 ZABBIX_PASSIVE (0, default), 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 | cadena | (obligatorio) La clave de la regla de descubrimiento de bajo nivel. | |
| filter | Elemento raíz para filtros de reglas de descubrimiento de bajo nivel de equipo. | ||
| lifetime | cadena | Período de tiempo (usando segundos, sufijo de tiempo, o macro de usuario), después del cual los recursos descubiertos que ya no se encuentren se eliminarán. Predeterminado: 7d. |
|
| lifetime_type | cadena | Escenario para eliminar recursos LLD perdidos. Valores posibles: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER. |
|
| enabled_lifetime | cadena | Período de tiempo (usando segundos, sufijo de tiempo, o macro de usuario), después del cual los recursos descubiertos durante más tiempo se desactivarán. | |
| enabled_lifetime_type | cadena | 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 del equipo, que son los mismos que para métricas de equipo. | ||
| trigger_prototypes | Elemento raíz para los elementos prototipo de iniciador del equipo, que son los mismos que para iniciadores de métricas del equipo. | ||
| graph_prototypes | Elemento raíz para prototipos de gráficos del equipo, que son los mismos que para gráficos de equipo. | ||
| host_prototypes | Elemento raíz para prototipos de equipo, que son los mismos que para equipos. | ||
| master_item | cadena | (obligatorio para reglas DEPENDENTES) Elemento raíz para el elemento maestro de la regla dependiente. | |
| lld_macro_paths | Elemento raíz para rutas de macros de reglas de descubrimiento de bajo nivel. | ||
| lld_macro | cadena | (obligatorio) Nombre de macro de regla de descubrimiento de bajo nivel. | |
| path | cadena | (obligatorio) Selector de valor, que será asignado a la macro correspondiente. | |
| preprocessing | Elemento raíz para el preprocesamiento del valor de la regla de descubrimiento de bajo nivel. | ||
| step | Elemento raíz para los elementos de paso de preprocesamiento de valor de regla de descubrimiento de bajo nivel, que son los mismos que para pasos de preprocesamiento de valor de elemento de host, excepto que tienen menos valores posibles. Ver también: objeto de preprocesamiento de reglas LLD. | ||
| overrides | Elemento raíz para reglas de anulación de reglas de descubrimiento de bajo nivel. | ||
| name | cadena | (obligatorio) Nombre de anulación único. | |
| step | cadena | (obligatorio) Número de orden único de la anulación. | |
| stop | string | Detener el procesamiento de las siguientes anulaciones si coinciden. | |
| filter | Elemento raíz para los elementos de filtro de reglas de anulación de reglas de descubrimiento de bajo nivel, que son los mismos que para filtros de reglas de descubrimiento de bajo nivel de equipo. | ||
| operations | Elemento raíz para operaciones de anulación de reglas de descubrimiento de bajo nivel del equipo. | ||
Consulte también: objeto de regla LLD (consulte la propiedad relevante con un nombre coincidente).
Alojar filtros de reglas de descubrimiento de bajo nivel
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| evaltype | string | Reemplazar el método de evaluación de la condición del filtro. Valores posibles:1 AND_OR (0, predeterminado), AND (1), OR (2), FORMULA (3 ). |
|
| formula | cadena | Fórmula de cálculo personalizada para condiciones de filtro. | |
| conditions | Elemento raíz para condiciones de filtrado. | ||
| macro | cadena | (obligatorio) El nombre de la macro de descubrimiento de bajo nivel para realizar la verificación. | |
| value | cadena | Valor con el que comparar. | |
| operator | cadena | Operador de condición. Valores posibles:1 MATCHES_REGEX (8, predeterminado), NOT_MATCHES_REGEX (9). |
|
| formulaid | cadena | (obligatorio) 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. | |
Consulte también: objeto de filtro de regla LLD (consulte la propiedad relevante con un nombre coincidente).
Operaciones de reemplazo de reglas de descubrimiento de bajo nivel del equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| operationobject | cadena | Objeto al que se aplica la operación. Valores posibles:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3). |
|
| operator | cadena | Operador de condición de anulación. Valores posibles:1 EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5) , NOT_REGEXP (6). |
|
| value | cadena | Una expresión regular o una cadena para el operador de condición de reemplazo. | |
| status | string | Estado del objeto tras la operación de reemplazo. | |
| discover | string | Si el objeto se agrega como resultado del descubrimiento. | |
| delay | cadena | Intervalo de actualización establecido para el prototipo de la métrica tras la operación de reemplazo. | |
| history | string | Período de almacenamiento del historial establecido para el prototipo de la métrica en la operación de reemplazo. | |
| trends | string | Período de almacenamiento de tendencias establecido para el prototipo de la métrica tras la operación de reemplazo. | |
| severity | string | Severidad del prototipo de activación establecida en la operación de reemplazo. | |
| tags | Elemento raíz de las etiquetas establecidas para el objeto en la operación de reemplazo. | ||
| tag | cadena | (obligatorio) Nombre de etiqueta. | |
| value | cadena | Valor de etiqueta. | |
| templates | Elemento raíz para las plantillas vinculadas al prototipo de equipo tras la operación de reemplazo. | ||
| name | cadena | (obligatorio) Nombre de la plantilla. | |
| inventory_mode | string | Modo de inventario del prototipo del equipo establecido en la operación de reemplazo. | |
Consulte también: objeto de operación de reemplazo de regla LLD (consulte la propiedad relevante con un nombre coincidente).
Escenarios web de equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| uuid | cadena | (obligatorio) Identificador único para este escenario web. | |
| name | cadena | (obligatorio) Nombre del escenario web. | |
| delay | cadena | Frecuencia (usando segundos, sufijo de tiempo, o macro de usuario) de ejecución del escenario web. Predeterminado: 1m. |
|
| attempts | entero | El número de intentos para ejecutar los pasos del escenario web. Valores posibles: 1-10 (predeterminado: 1). |
|
| agent | cadena | Agente cliente. Zabbix pretenderá ser el navegador seleccionado. Esto es útil cuando un sitio web devuelve contenido diferente para diferentes navegadores. Predeterminado: Zabbix. |
|
| http_proxy | cadena | Proxy que será utilizado por el escenario web dado como: http://[nombre de usuario[:contraseña]@]proxy.example.com[:puerto] |
|
| variables | Elemento raíz para las variables del escenario web que pueden usarse en los pasos del escenario. | ||
| name | cadena | (obligatorio) Nombre de la variable. | |
| value | texto | (obligatorio) Valor de la 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 | cadena | (obligatorio) Nombre del encabezado. | |
| value | texto | (obligatorio) Valor del encabezado. | |
| status | cadena | Estado del escenario web. Valores posibles:1 HABILITADO (0, predeterminado), DESHABILITADO (1). |
|
| authentication | cadena | Método de autenticación. Valores posibles:1 NINGUNO (0, predeterminado), BÁSICO (1), NTLM (2). |
|
| 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 | cadena | Verifica el certificado SSL del servidor web. Valores posibles:1 NO (0, predeterminado), SÍ (1). |
|
| verify_host | cadena | Verifique que el campo Nombre común o el campo Nombre alternativo del sujeto del certificado del servidor web coincidan. Valores posibles:1 NO (0 , predeterminado), SÍ (1). |
|
| 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 | (obligatorio) Elemento raíz para pasos del escenario web del equipo. | ||
| tags | Elemento raíz para etiquetas de escenarios web. | ||
| tag | cadena | (obligatorio) Nombre de etiqueta. | |
| value | cadena | Valor de etiqueta. | |
Consulte también: Objeto de escenario web (consulte la propiedad relevante con un nombre coincidente).
Pasos del escenario web de equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| name | cadena | (obligatorio) Nombre del paso del escenario web. | |
| url | string | (obligatorio) URL para monitoreo. | |
| query_fields | Elemento raíz para los parámetros de consulta (una serie de campos HTTP que se agregarán a la URL al realizar una solicitud). | ||
| name | cadena | (obligatorio) Nombre del parámetro de consulta. | |
| value | cadena | Valor del parámetro de consulta. | |
| posts | Elemento raíz para variables HTTP POST (una cadena (datos de publicación sin procesar) o una matriz de campos HTTP (datos de campo de formulario)). | ||
| name | cadena | (obligatorio) Nombre del campo de publicación. | |
| value | cadena | (obligatorio) Valor del campo de publicación. | |
| variables | Elemento raíz de las variables de nivel de paso (macros) que deben aplicarse 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 con el procedimiento habitual. patrón de expresión que sigue el prefijo 'regex:' |
||
| name | cadena | (obligatorio) Nombre de la variable. | |
| value | texto | (obligatorio) Valor de la variable. | |
| headers | Elemento raíz para los encabezados HTTP que se enviarán al realizar una solicitud. | ||
| name | cadena | (obligatorio) Nombre del encabezado. | |
| value | texto | (obligatorio) Valor del encabezado. | |
| follow_redirects | string | Seguir redirecciones HTTP. Valores posibles:1 NO (0), SÍ (1, predeterminado). |
|
| retrieve_mode | string | Modo de recuperación de respuesta HTTP. Valores posibles:1 BODY (0, predeterminado), HEADERS (1), BOTH (2). |
|
| timeout | string | Tiempo de espera (usando segundos, sufijo de tiempo, o macro de usuario) de ejecución del paso.< br>Predeterminado: 15 s. | |
| required | cadena | Texto que debe estar presente en la respuesta (ignorado si está vacío). | |
| status_codes | cadena | Una lista delimitada por comas de códigos de estado HTTP aceptados (por ejemplo, 200-201,210-299; ignorado si está vacío). |
|
Consulte también: Objeto de paso de escenario web (consulte la propiedad relevante con un nombre coincidente).
Gráficos de equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| uuid | string | Identificador único del gráfico. | |
| name | string | (obligatorio) Nombre del gráfico. | |
| width | integer | Ancho del gráfico, en píxeles. Se utiliza para obtener vistas previas y para gráficos circulares/desglosados. Valores posibles:1 20-65535 (predeterminado: 900). |
|
| height | integer | Altura del gráfico, en píxeles. Se utiliza para obtener vistas previas y para gráficos circulares/desglosados. Valores posibles:1 20-65535 (predeterminado: 900). |
|
| yaxismin | double | Valor del mínimo del eje Y. Compatible con valor mínimo FIJO del eje Y. Por defecto: 0. |
|
| yaxismax | double | Valor máximo del eje Y. Compatible con valor mínimo FIJO del eje X. Por defecto: 0. |
|
| show_work_period | string | Resaltar horas no laborables. Compatible con gráficos NORMALES y APILADOS. Valores posibles:1 NO (0), SÍ (1 , por defecto). |
|
| show_triggers | string | Muestra valores de activación simples como una línea. Compatible con gráficos NORMALES y APILADOS. Valores posibles:1 NO (0), SÍ (1 , por defecto). |
|
| type | cadena | Tipo de gráfico. Valores posibles:1 NORMAL (0, por defecto), APILADO (1), PIE (2), EXPLODADO (3). |
|
| show_legend | cadena | Mostrar leyenda del gráfico. Valores posibles:1 NO (0), SÍ (1, por defecto). |
|
| show_3d | cadena | Habilitar estilo 3D. Compatible con gráficos NORMALES y APILADOS. Valores posibles:1 NO (0, por defecto), SÍ (1). |
|
| percent_left | double | Muestra la línea percentil para el eje izquierdo. Compatible con gráficos NORMALES. Por defecto: 0. |
|
| percent_right | double | Muestra la línea percentil para el eje derecho. Compatible con gráficos NORMALES. Po defecto: 0. |
|
| ymin_type_1 | cadena | Valor mínimo del eje Y. Compatible con gráficos NORMALES y APILADOS. Valores posibles:1 CALCULADO (0, por defecto), FIJO (1), MÉTRICA (2). |
|
| ymin_item_1 | (obligatorio si ymin_type_1 está configurado en ITEM) Elemento raíz para detalles de elementos individuales. |
||
| host | cadena | (obligatorio) Equipo del elemento. | |
| key | cadena | (obligatorio) Llave del elemento. | |
| graph_items | (obligatorio) Elemento raíz para elementos del gráfico de equipo. | ||
Ver también: Objeto gráfico (consulte la propiedad relevante con un nombre coincidente).
Elementos del gráfico del equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| sortorder | entero | 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 otro. | |
| drawtype | cadena | Estilo de dibujo de la métrica del gráfico. Compatible con gráficos NORMALES. Valores posibles:1 SINGLE_LINE (0, predeterminado), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5). |
|
| color | cadena | Color del elemento (6 símbolos, hexadecimal). | |
| yaxisside | cadena | Lado del gráfico donde se dibujará la escala Y del elemento del gráfico. Compatible con gráficos NORMAL y APILADOS. |
|
| calc_fnc | cadena | Datos que se dibujarán si existe más de un valor para una métrica. Valores posibles:1 MIN (1), AVG (2, predeterminado), MAX (4), ALL (7; mínimo, promedio y máximo; compatible con gráficos simples), LAST (9, compatible con gráficos circulares/explotados). |
|
| type | cadena | Tipo de métrica del gráfico. Valores posibles:1 SIMPLE (0, predeterminado), GRAPH_SUM (2; el valor de la métrica representa el gráfico circular completo; compatible con gráficos circulares/explotados). |
|
| item | (obligatorio) Métrica individual. | ||
| host | cadena | (obligatorio) Equipo de la métrica. | |
| key | cadena | (obligatorio) Clave de la métrica. | |
Ver también: Objeto de métrica de gráfico (consulte la propiedad relevante con un nombre coincidente).
Mapas de valores de equipo
| Elemento | Tipo | Descripción | |
|---|---|---|---|
| uuid | cadena | (obligatorio) Identificador único para este mapa de valores. | |
| name | cadena | (obligatorio) Nombre del mapa de valores. | |
| mapping | Elemento raíz para asignaciones. | ||
| type | cadena | Tipo de coincidencia de asignación. Valores posibles:1 EQUAL (0, predeterminado), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP ( 5), POR DEFECTO (6). |
|
| value | cadena | Valor original. | |
| newvalue | cadena | (obligatorio) Valor al que se asigna el valor original. | |
Consulte también: Objeto de mapa de valores (consulte la propiedad relevante con un nombre coincidente).
Notas al pie
1 Los valores enteros de API entre paréntesis, por ejemplo, HABILITADO (0), se mencionan solo como referencia. Para obtener más información, consulte la página del objeto API vinculado en la entrada de la tabla o al final de cada sección.