Los siguientes objetos están directamente relacionados con la API discoveryrule
.
The low-level discovery rule object has the following properties.
Property | Type | Description |
---|---|---|
itemid | string | (readonly) ID of the LLD rule. |
delay (required) |
string | Update interval of the LLD rule. Accepts seconds or time unit with suffix and with or without one or more custom intervals that consist of either flexible intervals and scheduling intervals as serialized strings. Also accepts user macros. Flexible intervals could be written as two macros separated by a forward slash. Intervals are separated by a semicolon. Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with mqtt.get key. |
hostid (required) |
string | ID of the host that the LLD rule belongs to. |
interfaceid (required) |
string | ID of the LLD rule's host interface. Used only for host LLD rules. Optional for Zabbix agent (active), Zabbix internal, Zabbix trapper and database monitor LLD rules. |
key_ (required) |
string | LLD rule key. |
name (required) |
string | Name of the LLD rule. |
type (required) |
integer | Type of the LLD rule. Possible values: 0 - Zabbix agent; 2 - Zabbix trapper; 3 - simple check; 5 - Zabbix internal; 7 - Zabbix agent (active); 10 - external check; 11 - database monitor; 12 - IPMI agent; 13 - SSH agent; 14 - TELNET agent; 16 - JMX agent; 18 - Dependent item; 19 - HTTP agent; 20 - SNMP agent; 21 - Script. |
url (required) |
string | URL string, required for HTTP agent LLD rule. Supports user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}. |
allow_traps | integer | HTTP agent LLD rule field. Allow to populate value as in trapper item type also. 0 - (default) Do not allow to accept incoming data. 1 - Allow to accept incoming data. |
authtype | integer | Used only by SSH agent or HTTP agent LLD rules. SSH agent authentication method possible values: 0 - (default) password; 1 - public key. HTTP agent authentication method possible values: 0 - (default) none 1 - basic 2 - NTLM |
description | string | Description of the LLD rule. |
error | string | (readonly) Error text if there are problems updating the LLD rule. |
follow_redirects | integer | HTTP agent LLD rule field. Follow response redirects while pooling data. 0 - Do not follow redirects. 1 - (default) Follow redirects. |
headers | object | HTTP agent LLD rule field. Object with HTTP(S) request headers, where header name is used as key and header value as value. Example: { "User-Agent": "Zabbix" } |
http_proxy | string | HTTP agent LLD rule field. HTTP(S) proxy connection string. |
ipmi_sensor | string | IPMI sensor. Used only by IPMI LLD rules. |
jmx_endpoint | string | JMX agent custom connection string. Default value: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi |
lifetime | string | Time period after which items that are no longer discovered will be deleted. Accepts seconds, time unit with suffix and user macro. Default: 30d . |
master_itemid | integer | Master item ID. Recursion up to 3 dependent items and maximum count of dependent items equal to 999 are allowed. Discovery rule cannot be master item for another discovery rule. Required for Dependent item. |
output_format | integer | HTTP agent LLD rule field. Should response be converted to JSON. 0 - (default) Store raw. 1 - Convert to JSON. |
params | string | Additional parameters depending on the type of the LLD rule: - executed script for SSH and Telnet LLD rules; - SQL query for database monitor LLD rules; - formula for calculated LLD rules. |
parameters | array | Additional parameters for script type LLD rule. Array of objects with 'name' and 'value' properties, where name must be unique. |
password | string | Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD rules. |
post_type | integer | HTTP agent LLD rule field. Type of post data body stored in posts property. 0 - (default) Raw data. 2 - JSON data. 3 - XML data. |
posts | string | HTTP agent LLD rule field. HTTP(S) request body data. Used with post_type. |
privatekey | string | Name of the private key file. |
publickey | string | Name of the public key file. |
query_fields | array | HTTP agent LLD rule field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string. |
request_method | integer | HTTP agent LLD rule field. Type of request method. 0 - (default) GET 1 - POST 2 - PUT 3 - HEAD |
retrieve_mode | integer | HTTP agent LLD rule field. What part of response should be stored. 0 - (default) Body. 1 - Headers. 2 - Both body and headers will be stored. For request_method HEAD only 1 is allowed value. |
snmp_oid | string | SNMP OID. |
ssl_cert_file | string | HTTP agent LLD rule field. Public SSL Key file path. |
ssl_key_file | string | HTTP agent LLD rule field. Private SSL Key file path. |
ssl_key_password | string | HTTP agent LLD rule field. Password for SSL Key file. |
state | integer | (readonly) State of the LLD rule. Possible values: 0 - (default) normal; 1 - not supported. |
status | integer | Status of the LLD rule. Possible values: 0 - (default) enabled LLD rule; 1 - disabled LLD rule. |
status_codes | string | HTTP agent LLD rule field. Ranges of required HTTP status codes separated by commas. Also supports user macros as part of comma separated list. Example: 200,200-{$M},{$M},200-400 |
templateid | string | (readonly) ID of the parent template LLD rule. |
timeout | string | Item data polling request timeout. Used for HTTP agent and script LLD rules. Supports user macros. default: 3s maximum value: 60s |
trapper_hosts | string | Allowed hosts. Used by trapper LLD rules or HTTP agent LLD rules. |
username | string | Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD rules. Required by SSH and Telnet LLD rules. |
uuid | string | Universal unique identifier, used for linking imported LLD rules to already existing ones. Used only for LLD rules on templates. Auto-generated, if not given. For update operations this field is readonly. |
verify_host | integer | HTTP agent LLD rule field. Validate host name in URL is in Common Name field or a Subject Alternate Name field of host certificate. 0 - (default) Do not validate. 1 - Validate. |
verify_peer | integer | HTTP agent LLD rule field. Validate is host certificate authentic. 0 - (default) Do not validate. 1 - Validate. |
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. |
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.
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. |
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ón1|salida2|<|0, 1, 2, 3| |11|XML XPath|ruta3|<|<|0, 1, 2, 3| |12|JSONPath|ruta3|<|<|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|
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.
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |