Table of Contents

> objeto de regla LLD

> objeto de regla LLD

Los siguientes objetos están directamente relacionados con la API discoveryrule.

Regla LLD

L'objecte de regla de descobriment de baix nivell té les propietats següents.

Propietat	Tipus	Descripció
itemid	cadena	(només de lectura) ID de regla LLD.
delay (obligatori)	cadena	Interval d'actualització de regles LLD. Accepta segons o unitat de temps amb sufix i amb o sense un o més intervals personalitzats que consisteixen en intervals flexibles i intervals de programació com a cadenes serialitzades. També accepta macros d'usuari. Els intervals flexibles es poden escriure com dues macros separades per una barra inclinada. Els intervals són separats per un punt i coma. Opcional per a Zabbix trapper, elements dependents i per a l'agent Zabbix (actiu) amb la clau `mqtt.get`.
hostid (obligatori)	cadena	ID de l'equip al que pertany la regla LLD.
interfaceid (obligatori)	cadena	ID de la interfície de l'equip de la regla LLD. S'empra només per a les regles de LLD de l'equip. No es calen per a les regles de LLD de l'agent Zabbix (actiu), Zabbix intern, trapper de Zabbix, dependent, monitor de base de dades i scripts. Opcional per a les regles LLD de l'agent HTTP.
clau_ (obligatori)	cadena	clau de regla LLD.
nom (obligatori)	cadena	Nom de la regla LLD.
tipus (obligatori)	enter	Tipus de regla LLD.. Valors possibles: 0 - Agent Zabbix; 2 - Trapper Zabbix; 3 - comprovació simple; 5 - Zabbix intern; 7 - Agent Zabbix (actiu); 10 - comprovació externa; 11 - Monitor de base de dades; 12 - Agent IPMI ; 13 - Agent SSH; 14 - Agent TELNET; 16 - Agent JMX; 18 - Element dependent;< br>19 - Agent HTTP; 20 - Agent SNMP;< br>21 - Guió.
url (obligatori)	cadena	cadena d'URL, necessària per a la regla LLD de l'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.
allow_traps	enteger	Camp de regla LLD de l'agent HTTP. També permet l'ampliació de valors com en el tipus d'element trapper. 0 - (per defecte) No permet acceptar dades entrants. 1 - Permet acceptar dades entrants.
authtype	enteger	Només l'empren l'agent SSH o les regles LLD de l'agent HTTP. Valors possibles per al mètode d'autenticació de l'agent SSH: 0 - passa mot de pas (per defecte); 1 - clau pública. Valors possibles del mètode d'autenticació de l'agent HTTP: 0 - (per defecte) cap<br >1 - bàsic 2 - NTLM
descripció	cadena	Descripció de la regla LLD.
error	cadena	(només de lectura) Text d'error si hi ha problemes per actualitzar el valor de la regla LLD.
follow_redirects	enteger	Camp de regla LLD de l'agent HTTP. Seguiu les redireccions de resposta en afegir dades. 0: No seguiu les redireccions. 1: (per defecte) Seguiu les redireccions.
capçaleres	objecte	Camp de política LLD de l'agent HTTP. Objecte amb capçaleres de sol·licitud HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor. Exemple: { " User-Agent": "Zabbix" }
http_proxy	string	Camp de regla LLD de l'agent HTTP. Cadena de connexió del proxy HTTP(S).
ipmi_sensor	string	sensor IPMI. S'empra només per les regles IPMI LLD.
jmx_endpoint	cadena	Cadena de connexió de l'agent JMX personalitzada. Per defecte: service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi
lifetime	string	Període després del qual s'eliminaran els elements que ja no es descobreixen. Accepta segons, unitat de temps amb sufix i macro d'usuari. Per defecte: `30d`.
master_itemid	enteger	Identificador de l'element principal. Es permet la recursivitat fins a 3 elements dependents i un nombre màxim d'elements dependents igual a 999. La regla de descobriment no pot ser l'element principal d'una altra regla de descobriment.<br > Obligatori per a l'element dependent.
output_format	enteger	Camp de regla LLD de l'agent HTTP. la resposta s'ha de convertir a JSON. 0 - (per defecte) Emmagatzema en brut. 1 - Converteix a JSON.
params	string	Paràmetres addicionals en funció del tipus de regla LLD: - script executat per a regles LLD SSH i Telnet; - Consulta SQL per a regles de supervisió de bases de dades LLD; - fórmula per a regles LLD calculades.
parameters	array	Paràmetres addicionals per a la regla LLD semblant a un script. Matriu d'objectes amb propietats "nom" i "valor", on el nom ha de ser únic.
password	cadena	Mot de pas per a l'autenticació. S'empra per a Simple Check, SSH, Telnet, Database Monitor, JMX LLD Rules i HTTP Agent.
post_type	enteger	Camp de regla LLD de l'agent HTTP. Tipus de cos de dades de publicació emmagatzemat a la propietat de publicacions. 0 - (per defecte) Dades en brut. 2 - Dades JSON. 3 - Dades XML.
posts	cadena	Camp de política LLD de l'agent HTTP. HTTP(S) sol·licita dades del cos. S'empra amb post_type.
privatekey	string	Nom del fitxer de clau privada.
publickey	string	Nom del fitxer de clau pública.
query_fields	array	Camp de regla LLD de l'agent HTTP. Paràmetres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ser una cadena buida.
request_method	enteger	Camp de regla LLD de l'agent HTTP. Tipus de mètode de sol·licitud. 0 - (per defecte) GET 1 - POST 2 - PUT 3 - HEAD
retrieve_mode	enteger	Camp de regla LLD de l'agent HTTP. Quina part de la resposta s'ha d'emmagatzemar. 0 - (per defecte) Cos. 1 - Capçaleres. 2 - S'emmagatzemaran el cos i les capçaleres.< br> Per request_method HEAD només es permet el valor 1.
snmp_oid	cadena	SNMP OID.
ssl_cert_file	string	camp de política LLD de l'agent HTTP. Camí al fitxer de clau SSL pública.
ssl_key_file	string	camp de política LLD de l'agent HTTP. Camí al fitxer de clau SSL privada.
ssl_key_password	string	camp de política LLD de l'agent HTTP. Contrasenya per al fitxer de clau SSL.
state	entier	(només de lectura) Estat de la regla LLD. Valors possibles: 0 - (per defecte) normal; 1 - no compatible.
state	entier	Estat de la regla LLD. Valors possibles: 0 - (per defecte) Regla LLD activada; 1 - Regla LLD desactivada.
state_codis	cadena	Camp de regla LLD de l'agent HTTP. Intervals de codis d'estat HTTP obligatoris separats per comes. També admet macros d'usuari com a part d'una llista separada per comes. Exemple: 200.200-{$M},{$M},200-400
templateid	string	(només de lectura) ID de regla LLD de la plantilla principal.
timeout	string	Temps d'espera de la sol·licitud de consulta de dades d'element. S'empra per a l'agent HTTP i les regles d'script LLD. Admet macros d'usuari. valor per defecte: 3s valor màxim: 60s
trapper_hosts	string	Equips permesos. Emprat per les regles Trapper LLD o les regles LLD de l'agent HTTP.
username	cadena	Nom d'usuari per a l'autenticació. S'empra per les regles LLD de Simple Check, SSH, Telnet, Database Monitor, JMX i HTTP Agent LLD. Requerit per les regles SSH i Telnet LLD.
uuid	string	Identificador únic universal, emprat per enllaçar les regles LLD importades amb les existents. S'empra només per a regles LLD en models. Es genera automàticament, si no es proporciona. Per a les operacions d'actualització, aquest camp és només de lectura.
verify_host	enteger	Camp de regla LLD de l'agent HTTP. Valida que el nom d'equip a l'URL es troba al camp Nom comú o al camp Nom alternatiu de l'assumpte del certificat d'equip. 0 - (per defecte) No validar. 1 - Validar.
verify_peer	enteger	Camp de regla LLD de l'agent HTTP. Vàlid si el certificat d'equip és autèntic. 0 - (per defecte) No validar. 1 - Validar.

Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

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 (obligatorio)	matriz	Conjunto de condiciones de filtro a utilizar para filtrar resultados.
evaltype (obligatorio)	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.
eval_formula	string	(readonly) 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.
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. Obligatorio para filtros de expresión personalizados.

Condición de filtro de regla LLD

El objeto de condición de filtro 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 (obligatorio)	cadena	Macro LLD para realizar la verificación.
value (obligatorio)	cadena	Valor con el que comparar.
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 al solicitarlas posteriormente.
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 los 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 (obligatorio)	cadena	Macro LLD.
path (obligatorio)	cadena	Selector del valor que se asignará a la macro correspondiente.

Preprocesamiento de reglas LLD

El objeto de preprocesamiento de reglas LLD tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
type (obligatorio)	entero	El tipo de opción de preprocesamiento. Valores posibles: 5 - Coincidencia de expresiones regulares; 11 - XML XPath; 12 - JSONPath; 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 un latido; 21 - JavaScript; 23 - Prometheus a JSON; 24 - CSV a JSON; 25 - Reemplazar; 27 - XML a JSON.
params (obligatorio)	cadena	Parámetros adicionales utilizados por la opción de preprocesamiento. Varios parámetros están separados por el carácter LF (\n).
error_handler (obligatorio)	entero	Tipo de acción utilizado en caso de error en el paso de preprocesamiento. Valores posibles: 0: el servidor Zabbix establece el mensaje de error;< br>1 - Descartar valor; 2 - Establecer valor personalizado; 3 - Establecer mensaje de error personalizado.
error_handler_params (obligatorio)	cadena	Parámetros del controlador de errores. Se usa con `error_handler`. Debe estar vacío, si `error_handler` es 0 o 1. Puede estar vacío si `error_handler` es 2. No puede estar vacío, si `error_handler` es 3.

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ón¹|salida²|<|0, 1, 2, 3| |11|XML XPath|ruta³|<|<|0, 1, 2, 3| |12|JSONPath|ruta³|<|<|0, 1, 2, 3| |15|No coincide con la expresión regular|patrón¹|<|<|0, 1, 2, 3| |16|Compruebe si hay errores en JSON|ruta³|<|<|0, 1, 2, 3| |17|Compruebe si hay errores en XML|ruta³|<|<|0, 1, 2, 3| |20|Descartar sin cambios con latido|segundos^4, 5|<|<|<| |21|JavaScript|script²|<|<|<| |23|Prometeo a JSON|patrón^5, 6|<|<|0, 1, 2, 3| |24|CSV a JSON|carácter²|carácter²|0,1|0, 1, 2, 3| |25|Reemplazar|cadena de búsqueda²|reemplazo²|<|<| |27|XML a JSON|<|<|<|0, 1, 2, 3|

¹ expresión regular
² cadena
³ JSONPath o XML XPath
⁴ entero positivo (con soporte de sufijos de tiempo, por ejemplo, 30s, 1m, 2h, 1d)
⁵ macro de usuario
⁶ 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.

Anulación de regla LLD

El objeto de anulación 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 (obligatoria)	cadena	Nombre único de anulación.
step (obligatoria)	entero	Número de orden único de la anulación.
stop	entero	Detener el procesamiento de las siguientes anulaciones si coinciden. Valores posibles: 0 - (predeterminado) no detener el procesamiento de las anulaciones; 1 - detener el procesamiento de las anulaciones si el filtro coincide.
filter	objeto	Anular filtro.
operations	matriz	Operaciones de anulación.

Filtro de anulación de regla LLD

El objeto de filtro de anulación 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
evaltype (obligatorio)	entero	Anular el método de evaluación de la condición del filtro. Valores posibles: 0 - y/o; 1 - y; 2 - o; 3 - expresión personalizada.
conditions (obligatorio)	matriz	Conjunto de condiciones de filtro de anulación que se utilizarán para hacer coincidir los objetos descubiertos.
eval_formula	string	(readonly) Expresión generada que se utilizará para evaluar las condiciones del filtro de anulación. La expresión contiene ID que hacen referencia a condiciones de filtro de anulación específicas mediante su "formulaid". El valor de `eval_formula` es igual al valor de `formula` para filtros con una expresión personalizada.
formula	cadena	Expresión definida por el usuario que se utilizará para evaluar las condiciones de anulación de filtros con una expresión personalizada. La expresión debe contener ID que hagan referencia a condiciones de filtro de anulación específicas mediante su "formulaid". Los ID utilizados en la expresión deben coincidir exactamente con los definidos en las condiciones del filtro de anulación: ninguna condición puede permanecer sin usar u omitir. Obligatorio para filtros de anulación de expresiones personalizadas.

Condición de filtro de anulación de regla LLD

El objeto de condición de filtro de anulación 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 (obligatorio)	cadena	Macro LLD para realizar la verificación.
value (obligatorio)	cadena	Valor con el que comparar.
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 al solicitarlas posteriormente.
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 anulación de regla LLD

La operación de anulación de la regla LLD es una combinación de condiciones y acciones. realizar en el objeto prototipo. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
operationobject (obligatorio)	entero	Tipo de objeto descubierto para realizar la acción. Valores posibles: 0 - Prototipo de métrica; 1 - Prototipo de iniciador;< br>2 - Prototipo de gráfico; 3 - Prototipo de equipo.
operator	entero	Operador de condición de anulación. 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 elemento, activador y prototipo de host.
opdiscover	objeto	Anular operación de descubrimiento de objeto de estado (todos los tipos de objetos).
opperiod	object	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	object	Anular el objeto de tendencias de operación para el objeto prototipo de métrica.
opseverity	object	Anular el objeto de gravedad de la operación para el objeto prototipo de iniciador.
optag	array	Anular objeto de etiqueta de operación para objetos de prototipo de equipo e iniciador.
optemplate	array	Anular el objeto de plantilla de operación para el objeto prototipo de equipo.
opinventory	object	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 (obligatoria)	entero	Anula el estado del objeto seleccionado. Valores posibles: 0 - Crear habilitado; 1 - Crear deshabilitado.

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 (obligatoria)	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.

Período de operación de anulación de regla LLD

El período de operación de anulación de regla LLD es un valor de intervalo de actualización (admite intervalos personalizados) que se establece como elemento descubierto. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
delay (obligatoria)	cadena	Anula el intervalo de actualización del prototipo del artículo. Acepta segundos o una unidad de tiempo con sufijo (30s,1m,2h,1d), así como intervalos flexibles y de programación y macros de usuario o macros LLD. Varios intervalos están separados por un punto y coma.

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 (obligatoria)	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.

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 (obligatorio)	string	Anula las tendencias del prototipo de la 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.

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 (obligatoria)	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.

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 (obligatoria)	cadena	Nuevo nombre de etiqueta.
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 a un equipo descubierto. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
templateid (obligatoria)	cadena	Anular la plantilla de prototipo de equipo de las plantillas vinculadas.

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 (obligatoria)	entero	Anula el modo de inventario del prototipo del equipo. Valores posibles: -1 - deshabilitado; 0 - (predeterminado) manual; 1 - automático.

Documentation