Documentation
Table of Contents
- Objeto prototipo de regla LLD
- Prototipo de regla LLD
- Filtro de prototipo de regla LLD
- Ruta de macro LLD
- Prototipo de regla LLD de preprocesamiento
- Anulaciones de prototipos de reglas LLD
- Filtro de anulación de prototipo de regla LLD
- Operación de anulación de prototipo de regla LLD
- Estado de la operación de anulación del prototipo de regla LLD
- Descubrir la operación de anulación del prototipo de regla LLD
- Período de operación de la anulación del prototipo de regla LLD
- Historial de operaciones de anulación de prototipo de regla LLD
- Tendencias de la operación de anulación del prototipo de regla LLD
- Gravedad de la operación de anulación del prototipo de regla LLD
- Etiqueta de operación de anulación de prototipo de regla LLD
- Plantilla de operación de anulación de prototipo de regla LLD
- Inventario de operaciones de anulación de prototipo de regla LLD
Objeto prototipo de regla LLD
Los siguientes objetos están directamente relacionados con la API discoveryruleprototype.
Prototipo de regla LLD
El objeto prototipo de regla de bajo nivel de descubrimiento (LLD) tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| itemid | ID | ID del prototipo de regla LLD. Comportamiento de la propiedad: - solo lectura - requerido para operaciones de actualización |
| ruleid | ID | ID de la regla LLD principal/prototipo de regla LLD principal. Comportamiento de la propiedad: - solo lectura - requerido para operaciones de creación |
| delay | string | Intervalo de actualización del prototipo de regla LLD. Acepta segundos o unidad de tiempo con sufijo (por ejemplo, 30s, 1m, 2h, 1d) y, opcionalmente, uno o más intervalos personalizados, todos separados por punto y coma. Los intervalos personalizados pueden ser una mezcla de intervalos flexibles y de programación. Acepta macros de usuario. Si se utiliza, el valor debe ser una sola macro. No se admiten varias macros ni macros mezcladas con texto. Los intervalos flexibles pueden escribirse como dos macros separadas por una barra inclinada (por ejemplo, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Ejemplo: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Comportamiento de la propiedad: - requerido si type está establecido en "Agente Zabbix" (0), "Comprobación simple" (3), "Zabbix interno" (5), "Comprobación externa" (10), "Monitor de base de datos" (11), "Agente IPMI" (12), "Agente SSH" (13), "Agente TELNET" (14), "Agente JMX" (16), "Agente HTTP" (19), "Agente SNMP" (20), "Script" (21), "Navegador" (22), o si type está establecido en "Agente Zabbix (activo)" (7) y key_ no contiene "mqtt.get" |
| hostid | ID | ID del host al que pertenece el prototipo de regla LLD. Comportamiento de la propiedad: - constante - requerido para operaciones de creación |
| interfaceid | ID | ID de la interfaz de host del prototipo de regla LLD. Comportamiento de la propiedad: - requerido si el prototipo de regla LLD pertenece a un host y type está establecido en "Agente Zabbix", "Agente IPMI", "Agente JMX" o "Agente SNMP"- soportado si el prototipo de regla LLD pertenece a un host y type está establecido en "Comprobación simple", "Comprobación externa", "Agente SSH", "Agente TELNET" o "Agente HTTP" |
| key_ | string | Clave del prototipo de regla LLD. Se requiere al menos una macro LLD. Comportamiento de la propiedad: - requerido para operaciones de creación - solo lectura para objetos heredados |
| name | string | Nombre del prototipo de regla LLD. Comportamiento de la propiedad: - requerido para operaciones de creación - solo lectura para objetos heredados |
| type | integer | Tipo del prototipo de regla LLD. Valores posibles: 0 - Agente Zabbix; 2 - Zabbix trapper; 3 - Comprobación simple; 5 - Zabbix interno; 7 - Agente Zabbix (activo); 10 - Comprobación externa; 11 - Monitor de base de datos; 12 - Agente IPMI; 13 - Agente SSH; 14 - Agente TELNET; 16 - Agente JMX; 18 - Elemento dependiente; 19 - Agente HTTP; 20 - Agente SNMP; 21 - Script; 22 - Navegador; 23 - Anidado. Comportamiento de la propiedad: - requerido para operaciones de creación - solo lectura para objetos heredados |
| url | string | Cadena de URL. Soporta macros de usuario, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}. Comportamiento de la propiedad: - requerido si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| allow_traps | integer | Permitir poblar el valor de manera similar al elemento trapper. Valores posibles: 0 - (por defecto) No permitir aceptar datos entrantes; 1 - Permitir aceptar datos entrantes. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP" |
| authtype | integer | Método de autenticación. Valores posibles si type está establecido en "Agente SSH":0 - (por defecto) contraseña; 1 - clave pública. Valores posibles si type está establecido en "Agente HTTP":0 - (por defecto) ninguno; 1 - básico; 2 - NTLM. Comportamiento de la propiedad: - soportado si type está establecido en "Agente SSH" o "Agente HTTP"- solo lectura para objetos heredados (si type está establecido en "Agente HTTP") |
| description | string | Descripción del prototipo de regla LLD. |
| error | string | Texto de error si hay problemas al actualizar el valor del prototipo de regla LLD. Comportamiento de la propiedad: - solo lectura |
| follow_redirects | integer | Seguir redirecciones de respuesta al sondear datos. Valores posibles: 0 - No seguir redirecciones; 1 - (por defecto) Seguir redirecciones. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| headers | array | Array de cabeceras que se enviarán al realizar una solicitud HTTP. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| http_proxy | string | Cadena de conexión de proxy HTTP(S). Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| ipmi_sensor | string | Sensor IPMI. Comportamiento de la propiedad: - requerido si type está establecido en "Agente IPMI" y key_ no está establecido en "ipmi.get"- soportado si type está establecido en "Agente IPMI"- solo lectura para objetos heredados |
| jmx_endpoint | string | Cadena de conexión personalizada del agente JMX. Por defecto: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Comportamiento de la propiedad: - soportado si type está establecido en "Agente JMX" |
| lifetime | string | Período de tiempo después del cual se eliminarán los elementos que ya no se descubran. Acepta segundos, unidad de tiempo con sufijo o una macro de usuario. Por defecto: 7d. |
| lifetime_type | integer | Escenario para eliminar recursos LLD perdidos. Valores posibles: 0 - (por defecto) Eliminar después de alcanzar el umbral de vida útil; 1 - No eliminar; 2 - Eliminar inmediatamente. |
| enabled_lifetime | string | Período de tiempo después del cual los elementos que ya no se descubran serán deshabilitados. Acepta segundos, unidad de tiempo con sufijo o una macro de usuario. Por defecto: 0. |
| enabled_lifetime_type | integer | Escenario para deshabilitar recursos LLD perdidos. Valores posibles: 0 - Deshabilitar después de alcanzar el umbral de vida útil; 1 - No deshabilitar; 2 - (por defecto) Deshabilitar inmediatamente. |
| master_itemid | ID | ID del elemento maestro. La regla de descubrimiento no puede ser elemento maestro de otra regla de descubrimiento. Comportamiento de la propiedad: - requerido si type está establecido en "Elemento dependiente"- solo lectura para objetos heredados |
| output_format | integer | Si la respuesta debe convertirse a JSON. Valores posibles: 0 - (por defecto) Almacenar sin procesar; 1 - Convertir a JSON. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| params | string | Parámetros adicionales dependiendo del tipo de prototipo de regla LLD: - script ejecutado para reglas LLD SSH y Telnet; - consulta SQL para reglas LLD de monitor de base de datos; - fórmula para reglas LLD calculadas; - el script para reglas LLD de tipo script y navegador. Comportamiento de la propiedad: - requerido si type está establecido en "Monitor de base de datos", "Agente SSH", "Agente TELNET", "Script" o "Navegador"- solo lectura para objetos heredados (si type está establecido en "Script" o "Navegador") |
| parameters | object/array | Parámetros adicionales si type está establecido en "Script" o "Navegador".Array de objetos con propiedades name y value, donde name debe ser único.Comportamiento de la propiedad: - soportado si type está establecido en "Script" o "Navegador"- solo lectura para objetos heredados |
| password | string | Contraseña para autenticación. Comportamiento de la propiedad: - requerido si type está establecido en "Agente JMX" y username está establecido- soportado si type está establecido en "Comprobación simple", "Monitor de base de datos", "Agente SSH", "Agente TELNET" o "Agente HTTP"- solo lectura para objetos heredados (si type está establecido en "Agente HTTP") |
| post_type | integer | Tipo de cuerpo de datos POST almacenado en la propiedad posts.Valores posibles: 0 - (por defecto) Datos sin procesar; 2 - Datos JSON; 3 - Datos XML. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| posts | string | Datos del cuerpo de la solicitud HTTP(S). Comportamiento de la propiedad: - requerido si type está establecido en "Agente HTTP" y post_type está establecido en "Datos JSON" o "Datos XML"- soportado si type está establecido en "Agente HTTP" y post_type está establecido en "Datos sin procesar"- solo lectura para objetos heredados |
| privatekey | string | Nombre del archivo de clave privada. Comportamiento de la propiedad: - requerido si type está establecido en "Agente SSH" y authtype está establecido en "clave pública" |
| publickey | string | Nombre del archivo de clave pública. Comportamiento de la propiedad: - requerido si type está establecido en "Agente SSH" y authtype está establecido en "clave pública" |
| query_fields | array | Array de campos de consulta que se enviarán al realizar una solicitud HTTP. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| request_method | integer | Tipo de método de solicitud. Valores posibles: 0 - (por defecto) GET; 1 - POST; 2 - PUT; 3 - HEAD. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| retrieve_mode | integer | Qué parte de la respuesta debe almacenarse. Valores posibles si request_method está establecido en "GET", "POST" o "PUT":0 - (por defecto) Cuerpo; 1 - Cabeceras; 2 - Se almacenarán tanto el cuerpo como las cabeceras. Valores posibles si request_method está establecido en "HEAD":1 - Cabeceras. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| snmp_oid | string | OID SNMP. Comportamiento de la propiedad: - requerido si type está establecido en "Agente SNMP"- solo lectura para objetos heredados |
| ssl_cert_file | string | Ruta del archivo de clave pública SSL. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| ssl_key_file | string | Ruta del archivo de clave privada SSL. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| ssl_key_password | string | Contraseña para el archivo de clave SSL. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| state | integer | Estado del prototipo de regla LLD. Valores posibles: 0 - (por defecto) normal; 1 - no soportado. Comportamiento de la propiedad: - solo lectura |
| status | integer | Estado del prototipo de regla LLD. Valores posibles: 0 - (por defecto) prototipo de regla LLD habilitado; 1 - prototipo de regla LLD deshabilitado. |
| status_codes | string | Rangos de códigos de estado HTTP requeridos, separados por comas. También admite macros de usuario como parte de la lista separada por comas. Ejemplo: 200,200-{$M},{$M},200-400 Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| templateid | ID | ID del prototipo de regla LLD de la plantilla principal. Comportamiento de la propiedad: - solo lectura |
| timeout | string | Tiempo de espera de la solicitud de sondeo de datos del elemento. Acepta segundos o unidad de tiempo con sufijo (por ejemplo, 30s, 1m). También acepta macros de usuario. Rango de valores posibles: 1-600s. Por defecto: "" - usar configuración de proxy/global. Comportamiento de la propiedad: - soportado si type está establecido en "Agente Zabbix" (0), "Comprobación simple" (3) y key_ no comienza con "vmware." ni "icmpping", "Agente Zabbix (activo)" (7), "Comprobación externa" (10), "Monitor de base de datos" (11), "Agente SSH" (13), "Agente TELNET" (14), "Agente HTTP" (19), "Agente SNMP" (20) y snmp_oid comienza con "walk[" o "get[", "Script" (21), "Navegador" (22)- solo lectura para objetos heredados |
| trapper_hosts | string | Hosts permitidos. Comportamiento de la propiedad: - soportado si type está establecido en "Zabbix trapper", o si type está establecido en "Agente HTTP" y allow_traps está establecido en "Permitir aceptar datos entrantes" |
| username | string | Nombre de usuario para autenticación. Comportamiento de la propiedad: - requerido si type está establecido en "Agente SSH", "Agente TELNET", o si type está establecido en "Agente JMX" y password está establecido- soportado si type está establecido en "Comprobación simple", "Monitor de base de datos" o "Agente HTTP"- solo lectura para objetos heredados (si type está establecido en "Agente HTTP") |
| uuid | string | Identificador único universal, utilizado para vincular prototipos de reglas LLD importados a los ya existentes. Se genera automáticamente si no se proporciona. Comportamiento de la propiedad: - soportado si el prototipo de regla LLD pertenece a una plantilla |
| verify_host | integer | Si se debe validar que el nombre del host para la conexión coincida con el del certificado del host. Valores posibles: 0 - (por defecto) No validar; 1 - Validar. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
| verify_peer | integer | Si se debe validar que el certificado del host sea auténtico. Valores posibles: 0 - (por defecto) No validar; 1 - Validar. Comportamiento de la propiedad: - soportado si type está establecido en "Agente HTTP"- solo lectura para objetos heredados |
Encabezado HTTP
El objeto header tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| name | string | Nombre del encabezado HTTP. Comportamiento de la propiedad: - obligatorio |
| value | string | Valor del encabezado. Comportamiento de la propiedad: - obligatorio |
Campo de consulta HTTP
El objeto campo de consulta define un nombre y un valor que se utilizan para especificar un parámetro de URL. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| name | string | Nombre del parámetro. Comportamiento de la propiedad: - obligatorio |
| value | string | Valor del parámetro. Comportamiento de la propiedad: - obligatorio |
Filtro de prototipo de regla LLD
El objeto filtro de prototipo de regla LLD define un conjunto de condiciones que pueden utilizarse para filtrar objetos descubiertos. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| conditions | objeto/array | Conjunto de condiciones de filtro a utilizar para filtrar resultados. Las condiciones se ordenarán en el orden de su colocación en la fórmula. Comportamiento de la propiedad: - requerido |
| evaltype | entero | Método de evaluación de la condición de filtro. Valores posibles: 0 - y/o; 1 - y; 2 - o; 3 - expresión personalizada. Comportamiento de la propiedad: - requerido |
| eval_formula | cadena | Expresión generada que se utilizará para evaluar las condiciones del filtro. La expresión contiene IDs que hacen referencia a condiciones de filtro específicas por su formulaid. El valor de eval_formula es igual al valor de formula para los filtros con una expresión personalizada.Comportamiento de la propiedad: - solo lectura |
| formula | cadena | Expresión definida por el usuario que se utilizará para evaluar las condiciones de los filtros con una expresión personalizada. La expresión debe contener IDs que hagan referencia a condiciones de filtro específicas por su formulaid. Los IDs utilizados en la expresión deben coincidir exactamente con los definidos en las condiciones del filtro: ninguna condición puede quedar sin usar u omitida.Comportamiento de la propiedad: - requerido si evaltype está establecido en "expresión personalizada" |
Condición de filtro de prototipo de regla LLD
El objeto de condición de filtro de prototipo de regla LLD define una comprobación independiente que se realiza sobre el valor de una macro LLD. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| macro | string | Macro LLD sobre la que realizar la comprobación. Comportamiento de la propiedad: - obligatorio |
| value | string | Valor con el que comparar. Comportamiento de la propiedad: - obligatorio si operator está establecido en "coincide con la expresión regular" o "no coincide con la expresión regular" |
| formulaid | string | ID único arbitrario que se utiliza para hacer referencia a la condición desde una 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á uno nuevo al solicitarlas posteriormente. Comportamiento de la propiedad: - obligatorio si evaltype del objeto de filtro de prototipo de regla LLD está establecido en "expresión personalizada" |
| operator | integer | Operador de condición. Valores posibles: 8 - (por defecto) coincide con la expresión regular; 9 - no coincide con la expresión regular; 12 - existe; 13 - no existe. |
Para comprender mejor cómo utilizar los filtros con varios tipos de expresiones, consulte los ejemplos en las páginas de los métodos discoveryruleprototype.get y discoveryruleprototype.create.
Ruta de macro LLD
La ruta de macro LLD tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| lld_macro | string | Macro LLD. Comportamiento de la propiedad: - requerido |
| path | string | Selector para el valor que se asignará a la macro correspondiente. Comportamiento de la propiedad: - requerido |
Prototipo de regla LLD de preprocesamiento
El objeto de prototipo de regla LLD de preprocesamiento tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| type | integer | El tipo de opción de preprocesamiento. Valores posibles: 5 - Expresión regular; 11 - XML XPath; 12 - JSONPath; 14 - Coincide con expresión regular; 15 - No coincide con expresión regular; 16 - Comprobar error en JSON; 17 - Comprobar error en XML; 20 - Descartar sin cambios con latido; 21 - JavaScript; 23 - Prometheus a JSON; 24 - CSV a JSON; 25 - Reemplazar; 27 - XML a JSON; 28 - Valor de SNMP walk; 29 - SNMP walk a JSON; 30 - Valor de SNMP get. Comportamiento de la propiedad: - requerido |
| params | string | Parámetros adicionales utilizados por la opción de preprocesamiento. Varios parámetros se separan por el carácter de nueva línea (\n). Comportamiento de la propiedad: - requerido si type está establecido en "Expresión regular" (5), "XML XPath" (11), "JSONPath" (12), "Coincide con expresión regular" (14), "No coincide con expresión regular" (15), "Comprobar error en JSON" (16), "Comprobar error en XML" (17), "Descartar sin cambios con latido" (20), "JavaScript" (21), "Prometheus a JSON" (23), "CSV a JSON" (24), "Reemplazar" (25), "Valor de SNMP walk" (28), "SNMP walk a JSON" (29) o "Valor de SNMP get" (30) |
| error_handler | integer | Tipo de acción utilizada en caso de fallo en el paso de preprocesamiento. Valores posibles: 0 - El mensaje de error es establecido por el servidor Zabbix; 1 - Descartar valor; 2 - Establecer valor personalizado; 3 - Establecer mensaje de error personalizado. Comportamiento de la propiedad: - requerido si type está establecido en "Expresión regular" (5), "XML XPath" (11), "JSONPath" (12), "Coincide con expresión regular" (14), "No coincide con expresión regular" (15), "Comprobar error en JSON" (16), "Comprobar error en XML" (17), "Prometheus a JSON" (23), "CSV a JSON" (24), "XML a JSON" (27), "Valor de SNMP walk" (28), "SNMP walk a JSON" (29) o "Valor de SNMP get" (30) |
| error_handler_params | string | Parámetros del gestor de errores. Comportamiento de la propiedad: - requerido si error_handler está establecido en "Establecer valor personalizado" o "Establecer mensaje de error personalizado" |
Se admiten los siguientes parámetros y gestores de errores para cada tipo de preprocesamiento.
| Tipo de preprocesamiento | Nombre | Parámetro 1 | Parámetro 2 | Parámetro 3 | Gestores de errores soportados |
|---|---|---|---|---|---|
| 5 | Expresión regular | patrón1 | salida2 | 0, 1, 2, 3 | |
| 11 | XML XPath | ruta3 | 0, 1, 2, 3 | ||
| 12 | JSONPath | ruta3 | 0, 1, 2, 3 | ||
| 14 | Coincide con expresión regular | patrón1 | 0, 1, 2, 3 | ||
| 15 | No coincide con expresión regular | patrón1 | 0, 1, 2, 3 | ||
| 16 | Comprobar error en JSON | ruta3 | 0, 1, 2, 3 | ||
| 17 | Comprobar error en XML | ruta3 | 0, 1, 2, 3 | ||
| 20 | Descartar sin cambios con latido | segundos4, 5 | |||
| 21 | JavaScript | script2 | |||
| 23 | Prometheus a JSON | patrón5, 6 | 0, 1, 2, 3 | ||
| 24 | CSV a JSON | carácter2 | carácter2 | 0,1 | 0, 1, 2, 3 |
| 25 | Reemplazar | cadena de búsqueda2 | reemplazo2 | ||
| 27 | XML a JSON | 0, 1, 2, 3 | |||
| 28 | Valor de SNMP walk | OID2 | Formato: 0 - Sin cambios 1 - UTF-8 desde Hex-STRING 2 - MAC desde Hex-STRING 3 - Entero desde BITS |
0, 1, 2, 3 | |
| 29 | SNMP walk a JSON7 | Nombre de campo2 | Prefijo OID2 | Formato: 0 - Sin cambios 1 - UTF-8 desde Hex-STRING 2 - MAC desde Hex-STRING 3 - Entero desde BITS |
0, 1, 2, 3 |
| 30 | Valor de SNMP get | Formato: 1 - UTF-8 desde Hex-STRING 2 - MAC desde Hex-STRING 3 - Entero desde BITS |
0, 1, 2, 3 | ||
1 expresión regular
2 cadena
3 JSONPath o XML XPath
4 entero positivo (con soporte de sufijos de tiempo, por ejemplo, 30s, 1m, 2h, 1d)
5 macro de usuario
6 patrón de Prometheus siguiendo la sintaxis: <nombre de métrica>{<nombre de etiqueta>="<valor de etiqueta>", ...} == <valor>. Cada componente del patrón de Prometheus (métrica, nombre de etiqueta, valor de etiqueta y valor de métrica) puede ser una macro de usuario.
7 Soporta múltiples registros "Nombre de campo,Prefijo OID,Formato" delimitados por un carácter de nueva línea.
Anulaciones de prototipos de reglas LLD
El objeto de anulaciones de prototipos de reglas LLD define un conjunto de reglas (filtros, condiciones y operaciones) que se utilizan para anular propiedades de diferentes objetos prototipo. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| name | string | Nombre único de la anulación. Comportamiento de la propiedad: - requerido |
| step | integer | Número de orden único de la anulación. Comportamiento de la propiedad: - requerido |
| stop | integer | Detener el procesamiento de las siguientes anulaciones si coincide. Valores posibles: 0 - (por defecto) no detener el procesamiento de anulaciones; 1 - detener el procesamiento de anulaciones si el filtro coincide. |
| filter | object | Filtro de anulación. |
| operations | object/array | Operaciones de anulación. |
Filtro de anulación de prototipo de regla LLD
El objeto filtro de anulación de prototipo de regla LLD define un conjunto de condiciones que, si coinciden con el objeto descubierto, se aplica la anulación. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| conditions | objeto/array | Conjunto de condiciones de filtro de anulación a utilizar para hacer coincidir los objetos descubiertos. Las condiciones se ordenarán en el orden de su colocación en la fórmula. Comportamiento de la propiedad: - obligatorio |
| evaltype | entero | Método de evaluación de la condición del filtro de anulación. Valores posibles: 0 - y/o; 1 - y; 2 - o; 3 - expresión personalizada. Comportamiento de la propiedad: - obligatorio |
| eval_formula | cadena | Expresión generada que se utilizará para evaluar las condiciones del filtro de anulación. La expresión contiene IDs que hacen referencia a condiciones específicas del filtro de anulación por su formulaid. El valor de eval_formula es igual al valor de formula para los filtros con una expresión personalizada.Comportamiento de la propiedad: - solo lectura |
| formula | cadena | Expresión definida por el usuario que se utilizará para evaluar las condiciones de los filtros de anulación con una expresión personalizada. La expresión debe contener IDs que hagan referencia a condiciones específicas del filtro de anulación por su formulaid. Los IDs utilizados en la expresión deben coincidir exactamente con los definidos en las condiciones del filtro de anulación: ninguna condición puede quedar sin usar u omitida.Comportamiento de la propiedad: - obligatorio si evaltype está establecido en "expresión personalizada" |
Condición de filtro de anulación de prototipo de regla LLD
El objeto de condición de filtro de anulación de prototipo de regla LLD define una comprobación separada para realizar sobre el valor de una macro LLD. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| macro | string | Macro LLD sobre la que realizar la comprobación. Comportamiento de la propiedad: - obligatorio |
| value | string | Valor con el que comparar. Comportamiento de la propiedad: - obligatorio si operator está establecido en "coincide con la expresión regular" o "no coincide con la expresión regular" |
| formulaid | string | ID único arbitrario que se utiliza para hacer referencia a la condición desde una 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. Comportamiento de la propiedad: - obligatorio si evaltype del objeto de condición de filtro de anulación de prototipo de regla LLD está establecido en "expresión personalizada" |
| operator | integer | Operador de condición. Valores posibles: 8 - (por defecto) coincide con la expresión regular; 9 - no coincide con la expresión regular; 12 - existe; 13 - no existe. |
Operación de anulación de prototipo de regla LLD
La operación de anulación de prototipo de regla LLD es una combinación de condiciones y acciones a realizar sobre el objeto prototipo. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| operationobject | entero | Tipo de objeto descubierto sobre el que realizar la acción. Valores posibles: 0 - Prototipo de elemento; 1 - Prototipo de disparador; 2 - Prototipo de gráfico; 3 - Prototipo de equipo. Comportamiento de la propiedad: - obligatorio |
| operator | entero | Operador de condición de anulación. Valores posibles: 0 - (por defecto) igual; 1 - no igual; 2 - contiene; 3 - no contiene; 8 - coincide; 9 - no coincide. |
| value | cadena | Patrón para hacer coincidir el nombre del prototipo de elemento, disparador, gráfico o equipo dependiendo del objeto seleccionado. |
| opstatus | objeto | Objeto de estado de operación de anulación para objetos prototipo de elemento, disparador y equipo. |
| opdiscover | objeto | Objeto de estado de descubrimiento de operación de anulación (todos los tipos de objeto). |
| opperiod | objeto | Objeto de periodo de operación de anulación (intervalo de actualización) para el objeto prototipo de elemento. |
| ophistory | objeto | Objeto de historial de operación de anulación para el objeto prototipo de elemento. |
| optrends | objeto | Objeto de tendencias de operación de anulación para el objeto prototipo de elemento. |
| opseverity | objeto | Objeto de severidad de operación de anulación para el objeto prototipo de disparador. |
| optag | objeto/array | Objeto de etiqueta de operación de anulación para objetos prototipo de disparador y equipo. |
| optemplate | objeto/array | Objeto de plantilla de operación de anulación para el objeto prototipo de equipo. |
| opinventory | objeto | Objeto de inventario de operación de anulación para el objeto prototipo de equipo. |
Estado de la operación de anulación del prototipo de regla LLD
Estado de la operación de anulación del prototipo de regla LLD que se establece en el objeto descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| status | entero | Anula el estado para el objeto seleccionado. Valores posibles: 0 - Crear habilitado; 1 - Crear deshabilitado. Comportamiento de la propiedad: - obligatorio |
Descubrir la operación de anulación del prototipo de regla LLD
El estado de descubrimiento de la operación de anulación del prototipo de regla LLD que se establece en el objeto descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| discover | entero | Anula el estado de descubrimiento para el objeto seleccionado. Valores posibles: 0 - Sí, continuar descubriendo los objetos; 1 - No, no se descubrirán nuevos objetos y los existentes se marcarán como perdidos. Comportamiento de la propiedad: - obligatorio |
Período de operación de la anulación del prototipo de regla LLD
El período de operación de la anulación del prototipo de regla LLD es un valor de intervalo de actualización que se establece en el elemento descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| delay | string | Anula el intervalo de actualización del prototipo de elemento. Acepta segundos o unidad de tiempo con sufijo (por ejemplo, 30s, 1m, 2h, 1d) y, opcionalmente, uno o más intervalos personalizados, todos separados por punto y coma. Los intervalos personalizados pueden ser una mezcla de intervalos flexibles y de programación. Acepta macros de usuario o macros LLD. Si se utilizan, el valor debe ser una sola macro. No se admiten varias macros ni macros mezcladas con texto. Los intervalos flexibles pueden escribirse como dos macros separadas por una barra inclinada (por ejemplo, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Ejemplo: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Comportamiento de la propiedad: - requerido |
Historial de operaciones de anulación de prototipo de regla LLD
Valor de historial de operaciones de anulación de prototipo de regla LLD que se establece en el elemento descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| history | string | Anula el historial del prototipo de elemento, que es una unidad de tiempo de cuánto tiempo deben almacenarse los datos históricos. También acepta macro de usuario y macro LLD. Comportamiento de la propiedad: - obligatorio |
Tendencias de la operación de anulación del prototipo de regla LLD
Valor de tendencias de la operación de anulación del prototipo de regla LLD que se establece en el elemento descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| trends | string | Anula las tendencias del prototipo de elemento, que es una unidad de tiempo de cuánto tiempo deben almacenarse los datos de tendencias. También acepta macro de usuario y macro LLD. Comportamiento de la propiedad: - obligatorio |
Gravedad de la operación de anulación del prototipo de regla LLD
Valor de gravedad de la operación de anulación del prototipo de regla LLD que se establece en el disparador descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| severity | integer | Anula la gravedad del prototipo de disparador. Valores posibles: 0 - (por defecto) no clasificado; 1 - información; 2 - advertencia; 3 - media; 4 - alta; 5 - desastre. Comportamiento de la propiedad: - requerido |
Etiqueta de operación de anulación de prototipo de regla LLD
El objeto de etiqueta de operación de anulación de prototipo de regla LLD contiene el nombre y el valor de la etiqueta que se asignan al objeto descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | string | Nuevo nombre de etiqueta. Comportamiento de la propiedad: - obligatorio |
| value | string | Nuevo valor de etiqueta. |
Plantilla de operación de anulación de prototipo de regla LLD
Objeto de plantilla de operación de anulación de prototipo de regla LLD que está vinculado al host descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| templateid | ID | Anula la plantilla de las plantillas vinculadas al prototipo de host. Comportamiento de la propiedad: - obligatorio |
Inventario de operaciones de anulación de prototipo de regla LLD
El valor del modo de inventario de operación de anulación de prototipo de regla LLD que se establece en el host descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| inventory_mode | entero | Anula el modo de inventario del prototipo de host. Valores posibles: -1 - deshabilitado; 0 - (por defecto) manual; 1 - automático. Comportamiento de la propiedad: - requerido |