Documentation
Table of Contents
- Objeto de regla LLD
- Regla LLD
- Encabezado HTTP
- Campo de consulta HTTP
- Filtro de reglas LLD
- Ruta de macro LLD
- Preprocesamiento de reglas LLD
- Reemplazo de regla LLD
- Filtro de reemplazo de regla LLD
- Condición de filtro de reemplazo de regla LLD
- Operación de reemplazo de regla LLD
- Estado de operación de anulación de regla LLD
- Descubrimiento de operación de anulación de regla LLD
- Período de operación de anulación de regla LLD
- Historial de operaciones de anulación de regla LLD
- Tendencias de operación de anulación de regla LLD
- Regla LLD anula la gravedad de la operación
- Etiqueta de operación de anulación de regla LLD
- Plantilla de operación de anulación de regla LLD
- Inventario de operaciones de anulación de regla LLD
Objeto de regla LLD
Los siguientes objetos están directamente relacionados con la API discoveryrule.
Regla LLD
El objeto de regla de descubrimiento de bajo nivel tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| itemid | ID | ID de la regla LLD. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización |
| delay | cadena | Intervalo de actualización de la regla LLD. Acepta segundos o unidades de tiempo con sufijo (p.e., 30s, 1m, 2h, 1d) y opcionalmente con uno o más intervalos personalizados todos ellos separados por punto y coma. Los intervalos personalizados pueden ser una mezcla de intervalos programados y flexibles. Acepta macros de usuario. Si se usan, el valor debe ser una macro simple. No se soportan macros múltiples o macros mezcladas con texto. Los intervalos flexibles podrían escribirse como dos macros separadas por una barra diagonal. (p.e., {$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: - obligatorio si type está configurado como "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á configurado como "Agente Zabbix (activo)" (7) y key_ no contiene "mqtt.get" |
| hostid | ID | ID del equipo al que pertenece la regla LLD. Comportamiento de la propiedad: - constante - obligatorio para operaciones de creación |
| interfaceid | ID | ID de la interfaz del equipo de la regla LLD. Comportamiento de la propiedad: - obligatorio si la regla LLD pertenece al equipo y type está configurado como "agente Zabbix", "agente IPMI", "agente JMX" o "agente SNMP"- compatible si la regla LLD pertenece al equipo y type está configurado como "Comprobación simple" , "Comprobación externa", "agente SSH", "agente TELNET" o "agente HTTP" |
| key_ | cadena | Clave de regla LLD. Comportamiento de la propiedad: - obligatorio para operaciones de creación - leer -solo para objetos heredados |
| name | cadena | Nombre de la regla LLD. Comportamiento de la propiedad: - obligatorio para operaciones de creación - leer -solo para objetos heredados |
| type | entero | Tipo de regla LLD. Valores posibles: 0 - Agente Zabbix; 2 - Captura Zabbix; 3 - Comprobación simple; 5 - Zabbix interno; 7 - Agente Zabbix (activo); 10 - Verificació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. Propiedad comportamiento: - obligatorio para operaciones de creación - solo lectura para objetos heredados |
| url | cadena | Cadena URL. Admite macros de usuario, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID} , {ITEM.KEY}. Comportamiento de la propiedad: - obligatorio si type está configurado como "agente HTTP"<br >- solo lectura para objetos heredados |
| allow_traps | entero | Permitir completar el valor de manera similar a la métrica de captura. Valores posibles: 0 - (predeterminado) No permitir aceptar datos entrantes; 1 - Permitir para aceptar datos entrantes. Comportamiento de la propiedad: - soportada si type está configurado en "agente HTTP" |
| authtype | entero | Método de autenticación. Valores posibles si type está configurado en "Agente SSH":0 - contraseña (predeterminada); 1 - clave pública.<br > Valores posibles si type está configurado en "agente HTTP":0 - (predeterminado) ninguno; 1 - básico; 2 - NTLM. Comportamiento de la propiedad: - compatible si type está configurado como "agente SSH" o "agente HTTP"- solo lectura para objetos heredados (si tipo está configurado como "agente HTTP") |
| description | cadena | Descripción de la regla LLD. |
| error | cadena | Texto de error si hay problemas al actualizar la regla LLD. Comportamiento de la propiedad: - solo lectura |
| follow_redirects | entero | Seguir redirecciones de respuesta mientras se obtienen datos. Valores posibles: 0: no seguir redirecciones; 1: (predeterminado) Seguir redirecciones. < br>Comportamiento de la propiedad: - soportada si type está configurado como "agente HTTP"- solo lectura para objetos heredados |
| headers | matriz | Matriz de encabezados que se enviarán cuando se realice una solicitud HTTP. Comportamiento de la propiedad: - soportada si type está configurado como "agente HTTP"- solo lectura para objetos heredados |
| http_proxy | cadena | Cadena de conexión de proxy HTTP(S). Comportamiento de la propiedad: - soportada si type es establecida como "agente HTTP"- solo lectura para objetos heredados |
| ipmi_sensor | cadena | Sensor IPMI. Comportamiento de la propiedad: - obligatorio si tipo está configurado en "Agente IPMI " y key_ no están configurados en "ipmi.get"- compatible si type está configurado en "Agente IPMI"- solo lectura para objetos heredados |
| jmx_endpoint | cadena | Cadena de conexión personalizada del agente JMX. Predeterminado: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi< br> Comportamiento de la propiedad: - compatible si tipo está configurado en "agente JMX" |
| lifetime | cadena | Período de tiempo después del cual se eliminarán los elementos que ya no se descubren. Acepta segundos, unidades de tiempo con sufijo o una macro de usuario. Predeterminado: 7d. |
| lifetime_type | entero | Escenario para borrar los recursos LLD perdidos. Posibles valores: 0 - (predeterminado) Borrar después de que el límite de tiempo de vida haya sido alcanzado; 1 - No borrar; 2 - Borrar inmediatamente. |
| enabled_lifetime | cadena | Periodo de tiempo despues de que las métricas que ya no son descubiertas sean desactivadas. Acepta segundos, unidades de tiempo con sufijo, o una macro de usuario. Predeterminado: 0. |
| enabled_lifetime_type | entero | Escenario para desactivar los recursos LLD perdidos. Posibles valores: 0 - Desactivar después de que el límite de tiempo de vida haya sido alcanzado; 1 -No desactivar; 2 - (predeterminado) Desactivar inmediatamente. |
| master_itemid | ID | ID de la métrica principal. Se permite la recursividad de hasta 3 métricas dependientes y un recuento máximo de métricas dependientes igual a 999. La regla de descubrimiento no puede ser una métrica principal para otra regla de descubrimiento. < br>Comportamiento de la propiedad: - obligatorio si type está configurado en "Métrica dependiente"- solo lectura para objetos heredados |
| output_format | entero | ¿Debería la respuesta convertirse a JSON? Valores posibles: 0 - (predeterminado) Almacenar sin formato; 1 - Convertir a JSON. < br>Comportamiento de la propiedad: - compatible si type está configurado como "agente HTTP"- solo lectura para objetos heredados |
| params | cadena | Parámetros adicionales dependiendo del tipo de regla LLD: - script ejecutado para reglas SSH y Telnet LLD; - consulta SQL para reglas LLD de monitor de base de datos; - fórmula para reglas LLD calculadas . Comportamiento de la propiedad: - obligatorio si type está configurado en "Monitor de base de datos", "Agente SSH", "agente TELNET", o "Script"- solo lectura para objetos heredados (si type está configurado en "Script") |
| parameters | objeto/matriz | Parámetros adicionales si type está configurado en "Script" o "Navegador".Matriz de objetos con propiedades name y value, donde name debe ser único.Comportamiento de la propiedad: - soportada si type está configurado en "Script" o "Navegador"- solo lectura para objetos heredados |
| password | cadena | Contraseña para autenticación. Comportamiento de la propiedad: - obligatorio si type está configurado en "agente JMX" y nombre de usuario está configurado- compatible si type está configurado en "Comprobación simple", "Monitor de base de datos", "Agente SSH", "Agente TELNET" o "Agente HTTP"- * solo lectura* para objetos heredados (si type está configurado en "agente HTTP") |
| post_type | entero | Tipo de cuerpo de datos de publicación almacenado en la propiedad posts.Valores posibles: 0 - (predeterminado) Datos sin procesar; 2 - Datos JSON;< br>3 - Datos XML. Comportamiento de la propiedad: - soportada si type está configurado como "agente HTTP"<br >- solo lectura para objetos heredados |
| posts | cadena | Datos del cuerpo de la solicitud HTTP(S). Comportamiento de la propiedad: - obligatorio si type está configurado como "Agente HTTP" y post_type está configurado como "datos JSON" o "datos XML"- compatible si type está configurado como "agente HTTP" y post_type está configurado como "Datos sin procesar"< br>- solo lectura para objetos heredados |
| privatekey | cadena | Nombre del archivo de clave privada. Comportamiento de la propiedad: - obligatorio si type está configurado en " Agente SSH" y authtype están configurados en "clave pública" |
| publickey | cadena | Nombre del archivo de clave pública. Comportamiento de la propiedad: - obligatorio si type está configurado en " Agente SSH" y authtype están configurados en "clave pública" |
| query_fields | matriz | Parámetros de consulta. Matriz de objetos con pares clave:valor, donde valor puede ser una cadena vacía. |
| request_method | entero | Tipo de método de solicitud. Valores posibles: 0 - (predeterminado) GET; 1 - POST; 2 - PUT; 3 - HEAD. Comportamiento de la propiedad: - compatible si type está configurado como "agente HTTP"- * sólo lectura* para objetos heredados |
| retrieve_mode | entero | Qué parte de la respuesta debe almacenarse. Valores posibles si request_method está configurado en "GET", "POST" o "PUT":0 - ( predeterminado) Cuerpo; 1 - Encabezados; 2 - Se almacenarán tanto el cuerpo como los encabezados. Valores posibles si request_method está configurado en "HEAD":1 - Encabezados . Comportamiento de la propiedad: - compatible si tipo está configurado como "agente HTTP"- solo lectura para objetos heredados |
| snmp_oid | string | SNMP OID. Comportamiento de la propiedad: - obligatorio si tipo está configurado en "Agente SNMP "- solo lectura para objetos heredados |
| ssl_cert_file | cadena | Ruta del archivo de clave SSL pública. Comportamiento de la propiedad: - compatible si type es establecido en "agente HTTP"- solo lectura para objetos heredados |
| ssl_key_file | string | Ruta del archivo de clave SSL privada. Comportamiento de la propiedad: - compatible si tipo es 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: - compatible si tipo es establecido en "agente HTTP"- solo lectura para objetos heredados |
| state | entero | Estado de la regla LLD. Valores posibles: 0 - (predeterminado) normal; 1 - no compatible. [Comportamiento de la propiedad] (/manual/api/reference_commentary#property-behavior): - solo lectura |
| status | entero | Estado de la regla LLD. Valores posibles: 0 - (predeterminado) regla LLD habilitada; 1 - regla LLD deshabilitada. |
| status_codes | cadena | Rangos de códigos de estado HTTP requeridos, separados por comas. También admite macros de usuario como parte de una lista separada por comas. Ejemplo: 200,200-{$M},{$M},200-400 Comportamiento de la propiedad: - compatible si tipo está configurado en "agente HTTP"- solo lectura para objetos heredados |
| templateid | ID | ID de la regla LLD de la plantilla principal. Comportamiento de la propiedad: - solo lectura |
| timeout | cadena | Tiempo de espera de solicitud de obtención de datos de la métrica. Admite segundos o unidades de tiempo con sufijo (p.e., 30s, 1m). Tambien admite macros de usuario. Rango de valores admitidos: 1-600s. Predeterminado: "" - usar configuración de proxy/global. Comportamiento de la propiedad: - soportada si type está configurada como "Zabbix agent" (0), "Simple check" (3) y key_ no empieza por "vmware." ni "icmpping", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) y snmp_oid empieza por "walk[" o "get[", "Script" (21), "Browser" (22)- solo-lectura para objetos heredados |
| trapper_hosts | cadena | Equipos permitidos. Comportamiento de la propiedad: - compatible si type está configurado en "Zabbix trapper ", o si type está configurado en "Agente HTTP" y allow_traps está configurado en "Permitir aceptar datos entrantes" |
| username | cadena | Nombre de usuario para la autenticación. Comportamiento de la propiedad: - obligatorio si type está configurado en "Agente SSH" , "agente TELNET", o si "tipo" está configurado en "agente JMX" y "contraseña" está configurada- compatible si "tipo" está configurado en "Comprobación simple", "Monitor de base de datos" o " Agente HTTP" - solo lectura para objetos heredados (si type está configurado en "agente HTTP") |
| uuid | cadena | Identificador único universal, utilizado para vincular reglas LLD importadas con las ya existentes. Generado automáticamente, si no se proporciona. Comportamiento de la propiedad: - compatible si la regla LLD pertenece a una plantilla |
| verify_host | entero | Validar que el nombre del equipo en la URL esté en el campo Nombre común o en el campo Nombre alternativo del sujeto del certificado del equipo. Valores posibles: 0 - (predeterminado) No validar; 1 - Validar. Comportamiento de la propiedad: - compatible si type está configurado como "agente HTTP"<br >- solo lectura para objetos heredados |
| verify_peer | entero | Validar que el certificado de equipo auténtico. Valores posibles: 0 - (predeterminado) No validar; 1 - Validar. Comportamiento de la propiedad: - soportada si type está configurado como "agente HTTP"- solo lectura para objetos heredados |
Encabezado HTTP
El objeto de encabezado tiene las siguientes propiedades:
|Propiedad|Tipo|Descripción| |--------|---------------------------------------- -----------|-----------| |name|cadena|nombre del encabezado HTTP.
Comportamiento de la propiedad:
- obligatorio| |value|cadena|Valor del encabezado.
Comportamiento de la propiedad:
- obligatorio|
Campo de consulta HTTP
El objeto del campo de consulta define un nombre y un valor que se utiliza para especificar un parámetro de URL. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| name | cadena | Nombre del parámetro. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor del parámetro. Comportamiento de la propiedad: - obligatorio |
Filtro de reglas LLD
El objeto de filtro de regla LLD define un conjunto de condiciones que se pueden utilizar para filtrar objetos descubiertos. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| conditions | objeto/matriz | Conjunto de condiciones de filtro que se utilizarán para filtrar los resultados. Las condiciones se ordenarán según el orden en que se ubican en la fórmula. Comportamiento de la propiedad: - obligatorio |
| evaltype | entero | Método de evaluación de la condición del filtro. 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. La expresión contiene ID que hacen referencia a condiciones de filtro específicas mediante su "formulaid". El valor de eval_formula es igual al valor de formula para filtros con una expresión personalizada.
Comportamiento de la propiedad:
- * sólo 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 ID que hagan referencia a condiciones de filtro específicas mediante su formulaid. Los ID utilizados en la expresión deben coincidir exactamente con los definidos en las condiciones del filtro: ninguna condición puede permanecer sin usar u omitir.
Comportamiento de la propiedad:<br >- obligatorio* si evaltype está configurado como "expresión personalizada"|
Condición de filtro de regla LLD
El objeto de condición de filtro de regla LLD define una verificación separada para realizar sobre el valor de una macro LLD. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| macro | cadena | Macro LLD para realizar la verificación. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor con el que comparar. Comportamiento de la propiedad: - obligatorio si operator está configurado como "coincide con expresión regular" o "no coincide con la expresión regular" |
| formulaid | cadena | ID único arbitrario que se utiliza para hacer referencia a la condición desde una 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 cuando se solicite posteriormente. Comportamiento de la propiedad: - obligatorio si evaltype de objeto de filtro de regla LLD está configurado como "expresión personalizada" |
| operator | entero | Operador de condición. Valores posibles: 8 - (predeterminado) coincide con la expresión regular; 9 - no coincide con la expresión regular; 12 - existe;< br>13 - no existe. |
Para comprender mejor cómo utilizar filtros con varios tipos de expresiones, ver ejemplos en las páginas de los métodos discoveryrule.get y discoveryrule.create.
Ruta de macro LLD
La ruta de macro LLD tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| lld_macro | cadena | Macro LLD. Comportamiento de la propiedad: - obligatorio |
| path | cadena | Selector del valor que se asignará a la macro correspondiente. Comportamiento de la propiedad: - requerido |
Preprocesamiento de reglas LLD
El objeto de preprocesamiento de reglas LLD tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| type | entero | El tipo de opción de preprocesamiento. Valores posibles: 5 - Expresión regular; 11 - XML XPath; 12 - JSONPath; 14 - Coincide con la expresión regular ; 15 - No coincide con la expresión regular; 16 - Verifique si hay errores en JSON; 17 - Verifique si hay errores 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 SNMP walk; 29 - SNMP walk a JSON; 30 - valor SNMP get. Comportamiento de la propiedad: - obligatorio |
| params | string | Parámetros adicionales utilizados por la opción de preprocesamiento. Varios parámetros están separados por el carácter de nueva línea (\n). Comportamiento de la propiedad: - obligatorio si se establece type a "Expresión regular" (5), "XML XPath" (11), "JSONPath" (12), "Coincide con la expresión regular" (14), "No coincide con la expresión regular" (15), "Compruebe si hay errores en JSON " (16), "Comprobar errores en XML" (17), "Descartar sin cambios con latido" (20), "JavaScript" (21), "Prometheus a JSON" (23), "CSV a JSON" (24) , "Reemplazar" (25), "Valor de recorrido SNMP" (28), "Recorrido SNMP a JSON" (29) o "Valor de obtención SNMP" (30) |
| error_handler | entero | Tipo de acción utilizado en caso de falla en el paso de preprocesamiento. Valores posibles: 0: el servidor Zabbix establece el mensaje de error; 1: descartar valor; 2 - Establecer un valor personalizado; 3 - Establecer un mensaje de error personalizado. Comportamiento de la propiedad: - obligatorio si tipo está configurado en "Expresión regular" (5), "XML XPath" (11), "JSONPath" (12), "Coincide con la expresión regular" (14), "No coincide con la expresión regular" (15), "Compruebe si hay errores en JSON" (16), "Comprobar errores en XML" (17), "Prometheus a JSON" (23), "CSV a JSON" (24), "XML a JSON" (27), "Valor de recorrido SNMP" (28), "SNMP camina hacia JSON" (29) o "SNMP obtiene valor" (30) |
| error_handler_params | cadena | Parámetros del controlador de errores. Comportamiento de la propiedad: - obligatorio si error_handler está configurado como "Establecer valor personalizado" o "Establecer mensaje de error personalizado" |
Se admiten los siguientes parámetros y controladores de errores para cada tipo de preprocesamiento.
|Tipo de preprocesamiento|Nombre|Parámetro 1|Parámetro 2|Parámetro 3|Manejadores de errores admitidos| |------------------|----|-----------|-----------|- ----------|---------------------------------| |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 la expresión regular|patrón1|<|<|0, 1, 2, 3| |15|No coincide con la expresión regular|patrón1|<|<|0, 1, 2, 3| |16|Compruebe si hay errores en JSON|ruta3|<|<|0, 1, 2, 3| |17|Compruebe si hay errores en XML|ruta3|<|<|0, 1, 2, 3| |20|Descartar sin cambios con latido|segundos4, 5|<|<|<| |21|JavaScript|script2|<|<|<| |23|Prometeo 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 SNMP walk|OID2|Formato:
0 - Sin cambios
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Entero de BITS |<|0, 1, 2, 3| |29|SNMP walk a JSON7|Nombre de campo2|Prefijo OID2|Formato:
0 - Sin cambios
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Entero de BITS|0, 1, 2, 3| |30|valor SNMP get|Formato:
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Entero de 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 Prometheus (métrica, nombre de etiqueta, valor de etiqueta y métrica) valor) puede ser una macro de usuario.
7 Admite múltiples registros de "Nombre de campo, prefijo OID, registros de formato" delimitados por un carácter de nueva línea.
Reemplazo de regla LLD
El objeto de reemplazo de regla LLD define un conjunto de reglas (filtros, condiciones y operaciones) que se utilizan para anular las propiedades de diferentes objetos prototipo. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| name | cadena | Nombre único del reemplazo. Comportamiento de la propiedad: - obligatorio |
| step | entero | Número de orden único del reemplazo. Comportamiento de la propiedad: - obligatorio |
| stop | entero | Detener el procesamiento de los siguientes reemplazos si coinciden. Valores posibles: 0 - (predeterminado) no detener el procesamiento de los reemplazos; 1 - detener el procesamiento de los reemplazos si el filtro coincide. |
| filter | objeto | Filtro de reemplazo. |
| operations | matriz | Operaciones de reemplazo. |
Filtro de reemplazo de regla LLD
El objeto de filtro de reemplazo de regla LLD define un conjunto de condiciones que, si coinciden con el objeto descubierto, se aplica el reemplazo. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| conditions | objeto/matriz | Conjunto de condiciones de filtro de reemplazo a utilizar para hacer coincidir los objetos descubiertos. Las condiciones se ordenarán según el orden en que se ubican en la fórmula. Comportamiento de la propiedad: - obligatorio |
| evaltype | entero | Método de evaluación de la condición del filtro de reemplazo. 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 reemplazo. La expresión contiene ID que hacen referencia a condiciones de filtro de reemplazo específicas mediante su "formulaid". El valor de eval_formula es igual al valor de formula para filtros con una expresión personalizada.Comportamiento de la propiedad: - sólo lectura |
| formula | cadena | Expresión definida por el usuario que se utilizará para evaluar las condiciones de reemplazo de filtros con una expresión personalizada. La expresión debe contener ID que hagan referencia a condiciones de filtro de reemplazo específicas mediante su "formulaid". Los ID utilizados en la expresión deben coincidir exactamente con los definidos en las condiciones del filtro de reemplazo: ninguna condición puede permanecer sin usar u omitir. Comportamiento de la propiedad:< br>- obligatorio si evaltype está configurado en "expresión personalizada" |
Condición de filtro de reemplazo de regla LLD
El objeto de condición de filtro de reemplazo de regla LLD define una verificación separada para realizar sobre el valor de una macro LLD. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| macro | cadena | Macro LLD para realizar la verificación. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor con el que comparar. Comportamiento de la propiedad: - obligatorio si operador está configurado en "coincide con regular expresión" o "no coincide con la expresión regular" |
| formulaid | cadena | ID único arbitrario que se utiliza para hacer referencia a la condición desde una 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á de nuevo cuando se solicite posteriormente. Comportamiento de la propiedad: - obligatorio si evaltype de objeto de filtro de anulación de regla LLD está configurado en "expresión personalizada" |
| operator | entero | Operador de condición. Valores posibles: 8 - (predeterminado) coincide con la expresión regular; 9 - no coincide con la expresión regular; 12 - existe;< br>13 - no existe. |
Operación de reemplazo de regla LLD
La operación de reemplazo de la regla LLD es una combinación de condiciones y acciones a realizar en el objeto prototipo. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| operationobject | entero | Tipo de objeto descubierto para realizar la acción. Valores posibles: 0 - Prototipo de métrica; 1 - Prototipo de iniciador; 2 - Prototipo de gráfico; 3 - Prototipo de equipo. Comportamiento de la propiedad: - obligatorio |
| operator | entero | Operador de condición de reemplazo. Valores posibles: 0 - (predeterminado) es igual; 1 - no es igual; 2 - contiene; 3 - no contiene; 8 - coincide; 9 - no coincide. |
| value | cadena | Patrón para hacer coincidir el nombre de la métrica, iniciador, gráfico o prototipo de equipo según el objeto seleccionado. |
| opstatus | objeto | Anular el objeto de estado de operación para objetos de métrica, iniciador y prototipo de equipo. |
| opdiscover | objeto | Anular operación de descubrimiento de objeto de estado (todos los tipos de objetos). |
| opperiod | objeto | Anular el objeto de período de operación (intervalo de actualización) para el objeto prototipo de métrica. |
| ophistory | objeto | Anular el objeto de historial de operaciones para el objeto prototipo de métrica. |
| optrends | objeto | Anular el objeto de tendencias de operación para el objeto prototipo de métrica. |
| opseverity | objeto | Anular el objeto de gravedad de la operación para el objeto prototipo de iniciador. |
| optag | objeto/matriz | Anular objeto de etiqueta de operación para objetos de prototipo de equipo y iniciador. |
| optemplate | objeto/matriz | Anular el objeto de plantilla de operación para el objeto prototipo de equipo. |
| opinventory | objeto | Anular objeto de inventario de operación para objeto prototipo de equipo. |
Estado de operación de anulación de regla LLD
La regla LLD anula el estado de operación establecido en objeto descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| status | entero | Anula el estado del objeto seleccionado. Valores posibles: 0 - Crear habilitado; 1 - Crear deshabilitado. Comportamiento de la propiedad: - obligatorio |
Descubrimiento de operación de anulación de regla LLD
Estado de descubrimiento de operación de anulación de regla LLD que está establecido en el objeto descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| discover | entero | Anula el estado de descubrimiento del objeto seleccionado. Valores posibles: 0 - Sí, continúa descubriendo los objetos; 1 - No, no se descubrirán nuevos objetos y los existentes se marcará como perdido. Comportamiento de la propiedad: - obligatorio |
Período de operación de anulación de regla LLD
El período de operación de anulación de la regla LLD es un valor de intervalo de actualización que se establece en la métrica descubierta. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| delay | cadena | Anula el intervalo de actualización del prototipo de métrica. Acepta segundos o unidades de tiempo con sufijo (por ejemplo, 30 s, 1 m, 2 h, 1 d) y, opcionalmente, uno o más intervalos personalizados, todos separados por punto y coma. Los intervalos personalizados pueden ser una combinación de intervalos flexibles y de programación. Acepta macros de usuario o macros LLD. Si se utiliza, el valor debe ser una sola macro. No se admiten múltiples macros o macros mezcladas con texto. Los intervalos flexibles se pueden escribir como dos macros separadas por una barra diagonal (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] (/manual/api/reference_commentary#property-behavior): - obligatorio |
Historial de operaciones de anulación de regla LLD
La regla LLD anula el valor del historial de operaciones que está configurado como métrica descubierta. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| history | cadena | Anula el historial del prototipo de métrica, que es una unidad de tiempo de cuánto tiempo se deben almacenar los datos del historial. También acepta macros de usuario y macros LLD. Comportamiento de la propiedad: - requerido |
Tendencias de operación de anulación de regla LLD
La regla LLD anula el valor de tendencias de operación que se establece en la métrica descubierta. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| trends | cadena | Anula las tendencias del prototipo de métrica, que es una unidad de tiempo de cuánto tiempo se deben almacenar los datos de tendencias. También acepta macros de usuario y macros LLD. Comportamiento de la propiedad: - requerido |
Regla LLD anula la gravedad de la operación
La regla LLD anula el valor de gravedad de la operación que está configurada como iniciador descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| severity | entero | Anula la gravedad del prototipo de iniciador. Valores posibles: 0 - (predeterminado) no clasificado; 1 - información; 2 - advertencia;<br >3 - promedio; 4 - alto; 5 - desastre. Comportamiento de la propiedad: - obligatorio |
Etiqueta de operación de anulación de regla LLD
El objeto de etiqueta de operación de anulación de regla LLD contiene el nombre y el valor de la etiqueta que están configurados para el objeto descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | cadena | Nuevo nombre de etiqueta. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Nuevo valor de etiqueta. |
Plantilla de operación de anulación de regla LLD
Objeto de plantilla de operación de anulación de regla LLD que está vinculado al equipo descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| templateid | ID | Anular la plantilla de las plantillas vinculadas del prototipo de equipo. Comportamiento de la propiedad: - obligatorio |
Inventario de operaciones de anulación de regla LLD
La regla LLD anula el valor del modo de inventario de operación que está establecido en equipo descubierto. Tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| inventory_mode | entero | Anula el modo de inventario del prototipo del equipo. Valores posibles: -1 - deshabilitado; 0 - (predeterminado) manual; 1 - automático. Comportamiento de la propiedad: - obligatorio |