Documentation
Table of Contents
- Objecte de regla LLD
- Regla LLD
- Cap?alera HTTP
- Camp de consulta HTTP
- Filtre de regla LLD
- Ruta de macro LLD
- Preprocessament de regla LLD
- Sobrec¨¤rrega de regles LLD
- Filtre de sobrec¨¤rrega de la regla LLD
- Condici¨® del filtre de sobrec¨¤rrega de la regla LLD
- Operaci¨® de sobrec¨¤rrega de regles LLD
- Estat de l'operaci¨® de sobrec¨¤rrega de la regla LLD
- Operaci¨® de sobrec¨¤rrega de descobriment de regles LLD
- Per¨ªode d'operaci¨® de substituci¨® de la regla LLD
- Operaci¨® de sobrec¨¤rrega de l'historial de regles LLD
- Operaci¨® de sobrec¨¤rrega de les ³Ù±ð²Ô»å¨¨²Ô³¦¾±±ð²õ de regles LLD
- Operaci¨® de sobrec¨¤rrega de gravetat de la regla LLD
- Operaci¨® de sobrec¨¤rrega d'etiquetes de regla LLD
- Operaci¨® de sobrec¨¤rrega del model de regles LLD
- LLD Rule Operaci¨® de sobrec¨¤rrega d'inventari
Objecte de regla LLD
Els seg¨¹ents objectes s¨®n relacionats amb l'API discoveryrule.
Regla LLD
L'objecte de regla de descobriment de baix nivell t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| itemid | ID | ID de regla LLD. Comportament de la propietat: - nom¨¦s lectura - obligatori per operacions d'actualitzaci¨® |
| delay | string | Interval d'actualitzaci¨® de regles LLD. Admet segons o unitat de temps amb sufix (com ara 30s, 1m, 2h, 1d) i, opcionalment, un o m¨¦s intervals personalitzats separats amb punt i coma. Els intervals personalitzats poden ¨¦sser una barreja d'intervals flexibles i programats. Si s'empren, el valor ha d'¨¦sser una ¨²nica macro. No s'admeten pas m¨²ltiples macros o macros barregades amb text. Els intervals flexibles es poden escriure com dues macros separades per una barra inclinada (com ara {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Exemple: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Comportament de la propietat: - obligatori si el type s'ha establert a "Áú»¢¶Ä²© agent" (0), "Comprovaci¨® simple" (3), "Áú»¢¶Ä²© internal" (5), "Comprovaci¨® externa" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Navegador" (22), o si el type s'ha establert a "Áú»¢¶Ä²© agent (actiu)" (7) i key_ no cont¨¦ pas "mqtt.get" |
| hostid | ID | ID de l'equip al que pertany la regla LLD. Comportament de la propietat: - constant - obligatori per crear operacions |
| interfaceid | ID | ID de la interf¨ªcie de l'equip de la regla LLD. Comportament de la propietat: - obligatori si la regla LLD pertany a l'equip i type ¨¦s establert a "agent Áú»¢¶Ä²©", "agent IPMI", "agent JMX", o "agent SNMP"- ²¹»å³¾¨¨²õ si la regla LLD pertany a l'equip i type ¨¦s definit com a "Verificaci¨® simple", "Verificaci¨® externa", "agent SSH", "agent TELNET", o "agent HTTP" |
| key_ | string | clau de regla LLD. Comportament de la propietat: - obligatori per operacions de creaci¨® - nom¨¦s lectura per objectes heretats |
| name | string | Nom de la regla LLD. Comportament de la propietat: - obligatori per operacions de creaci¨® - nom¨¦s lectura per objectes heretats |
| type | enter | Tipus de regla LLD.. Valors possibles: 0 - Agent Áú»¢¶Ä²©; 2 - Trapper Áú»¢¶Ä²©; 3 - comprovaci¨® simple; 5 - Áú»¢¶Ä²© intern; 7 - Agent Áú»¢¶Ä²© (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; 21 - Script; 22 - Navegador. Comportament de la propietat: - obligatori per operacions de creaci¨® - nom¨¦s lectura per objectes heretats |
| url | string | cadena d'URL. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}. Comportament de la propietat: - obligatori si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| allow_traps | integer | 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. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP" |
| authtype | integer | 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. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent SSH" o "agent HTTP"- nom¨¦s lectura per objectes heretats (si type s'ha establert a "agent HTTP") |
| »å±ð²õ³¦°ù¾±±è³¦¾±¨® | string | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® de la regla LLD. |
| error | string | (nom¨¦s de lectura) Text d'error si hi ha problemes per actualitzar el valor de la regla LLD. Comportament de la propietat: - nom¨¦s lectura |
| follow_redirects | integer | 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. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| headers | array | 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": "Áú»¢¶Ä²©" } Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| http_proxy | string | Cadena de connexi¨® del proxy HTTP(S). Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| ipmi_sensor | string | sensor IPMI. Comportament de la propietat: - obligatori si type s'ha establert a "agent IPMI" i key_ no s'ha establert a "ipmi.get"- ²¹»å³¾¨¨²õ si type s'ha establert a "agent IPMI"- nom¨¦s lectura per objectes heretats |
| jmx_endpoint | string | Cadena de connexi¨® de l'agent JMX personalitzada. Per defecte: service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent JMX" |
| 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. |
| lifetime_type | integer | Escenari per es borrar recursos LLD perduts. Valors possibles: 0 - (per defecte) Esborrar quan s'assoleixi el llindar del temps de vida; 1 - No esborrar pas; 2 - Esborrar immediatament. |
| enabled_lifetime | string | Per¨ªode de temps despr¨¦s del que els elements que no es descobreixen es desactiven. Admet segons, unitat de temps amb sufix, o una macro d'usuari. Per defecte: 0. |
| enabled_lifetime_type | integer | Escenari per desactivar els recursos LLD perduts. Valors possibles: 0 - Desactivar quan s'assoleixi el llindar de temps de vida; 1 - No desactivar pas; 2 - (per defecte) Desactivar immediatament. |
| master_itemid | ID | ID 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 descoberta no pot ser l'element principal d'una altra regla de descoberta. Comportament de la propietat: - obligatori si type s'ha establert a "element dependent"nom¨¦s lectura per objectes heretats |
| output_format | integer | La resposta s'ha de convertir a JSON. Valors possibles: 0 - (per defecte) Emmagatzema en brut. 1 - Converteix a JSON. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"nom¨¦s lectura per objectes heretats |
| 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. Comportament de la propietat: - obligatori si type s'ha establert a "monitor de base de dades", "agent SSH", "agent "TELNET" o "Script"nom¨¦s lectura per objectes heretats (si type s'ha establert a "Script" |
| parameters | object/array | Par¨¤metres addicionals si type s'ha establert a "Script".Matriu d'objectes amb propietats name i value on el nom ha de ser ¨²nic.Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "Script"nom¨¦s lectura per objectes heretats |
| password | string | Mot de pas per a l'autenticaci¨®. Comportament de la propietat: - obligatori si type s'ha establert a "agent JMX" i username s'ha definit- ²¹»å³¾¨¨²õ si type s'ha establert a "comprovaci¨® simple", "monitor de base de dades", "agent SSH", "agent TELNET" o "agent HTTP"- nom¨¦s lectura per objectes heretats (si type s'ha establert a "agent HTTP") |
| post_type | integer | 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. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| posts | string | HTTP(S) sol¡¤licita dades del cos. Comportament de la propietat: - obligatori si type s'ha establert a "agent HTTP" i post_type s'ha establert a "dades JSON" o "dades XML"- ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP" i post_type s'ha definit com a "dades en brut"- nom¨¦s lectura per objectes heretats |
| privatekey | string | Nom del fitxer de clau privada. Comportament de la propietat: - obligatori si type s'ha establert a "agent SSH" i authtype s'ha definit a "clau p¨²blica" |
| publickey | string | Nom del fitxer de clau p¨²blica. Comportament de la propietat: - obligatori si type s'ha establert a "agent SSH" i authtype s'ha definit com a "clau p¨²blica" |
| query_fields | array | Par¨¤metres de consulta Par¨¤metres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor value pot ser una cadena buida. |
| request_method | integer | Tipus de m¨¨tode de sol¡¤licitud. 0 - (per defecte) GET 1 - POST 2 - PUT 3 - HEAD Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| retrieve_mode | integer | Quina part de la resposta s'ha d'emmagatzemar. Valors possibles si request_method s'ha establert a "GET", "POST" o "PUT": 0 - (per defecte) Cos; 1 - Cap?aleres; 2 - S'emmagatzemaran el cos i les cap?aleres. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| snmp_oid | string | SNMP OID. Comportament de la propietat: - obligatori si type s'ha establert a "agent SNMP"- nom¨¦s lectura per objectes heretats |
| ssl_cert_file | string | Cam¨ª al fitxer de clau SSL p¨²blica. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| ssl_key_file | string | Cam¨ª al fitxer de clau SSL privada. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| ssl_key_password | string | Mot de pas per al fitxer de clau SSL. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| state | integer | (nom¨¦s de lectura) Estat de la regla LLD. Valors possibles: 0 - (per defecte) normal; 1 - no compatible. Comportament de la propietat: - nom¨¦s lectura |
| state | integer | Estat de la regla LLD. Valors possibles: 0 - (per defecte) Regla LLD activada; 1 - Regla LLD desactivada. |
| state_codis | string | 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 Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| templateid | ID | ID de regla LLD de la plantilla principal. Comportament de la propietat: - nom¨¦s lectura |
| timeout | string | Temps d'espera de la sol¡¤licitud de consulta de dades d'element. Admet macros d'usuari. valor per defecte: 3svalor m¨¤xim: 60s.Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| trapper_hosts | string | Equips permesos. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "Áú»¢¶Ä²© trapper", o si type s'ha establert a "HTTP agent" i allow_traps definit a "permetre acceptar dades entrants" |
| username | string | Nom d'usuari per a l'autenticaci¨®. Comportament de la propietat: - obligatori si type s'ha establert a "agent SSH", "agent TELNET", o si type s'ha establert a "agent JMX" i password s'ha establert- ²¹»å³¾¨¨²õ si type s'ha establert a "verificacions simples", "monitor de base de dades", o "agent HTTP"- nom¨¦s lectura per objectes heretats (si type s'ha establert a "agent HTTP") |
| uuid | string | Identificador ¨²nic universal, emprat per enlla?ar les regles LLD importades amb les existents. Es genera autom¨¤ticament, si no es proporciona. Comportament de la propietat: - ²¹»å³¾¨¨²õ si la regla LDD pertany a una plantilla |
| verify_host | integer | 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. Valors possibles: 0 - (per defecte) No validar. 1 - Validar. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
| verify_peer | integer | V¨¤lid si el certificat d'equip ¨¦s aut¨¨ntic. 0 - (per defecte) No validar. 1 - Validar. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type s'ha establert a "agent HTTP"- nom¨¦s lectura per objectes heretats |
Cap?alera HTTP
L'objecte de cap?alera t¨¦ les propietats seg¨¹ents:
|Propietat|Tipus|¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®| |--------|----------------------------------------- -----------|-----------| |nom|string|Nom de la cap?alera HTTP.
Comportament de la propietat:
- obligatori| |valor|string|Valor de la cap?alera.
Comportament de la propietat:
- obligatori|
Camp de consulta HTTP
L'objecte del camp de consulta defineix un nom i un valor que s'empra per especificar un par¨¤metre d'URL. T¨¦ les seg¨¹ents propietats:
|Propietat|Tipus|¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®| |--------|----------------------------------------- -----------|-----------| |nom|string|Nom del par¨¤metre.
Comportament de la propietat:
- obligatori| |valor|string|Valor del par¨¤metre.
Comportament de la propietat:
- obligatori|
Filtre de regla LLD
L'objecte de filtre de regla LLD defineix un conjunt de condicions que es poden emprar per filtrar objectes descoberts. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| conditions | object/array | Conjunt de condicions de filtreque s'empren per filtrar els resultats. Les condicions s'ordenaran en l'ordre en que s'hagin afegit a la f¨°rmula. Comportament de la propietat: - obligatori |
| evaltype | integer | M¨¨tode d'avaluaci¨® de la condici¨® del filtre. Valors possibles: 0 - i/o; 1 - i; 2 - o ; 3 - expressi¨® personalitzada. Comportament de la propietat: - obligatori |
| eval_formula | string | (nom¨¦s de lectura) Expressi¨® generada que s'emprar¨¤ per avaluar les condicions del filtre. L'expressi¨® cont¨¦ identificadors que fan refer¨¨ncia a condicions de filtre espec¨ªfiques per la seva "f¨®rmula". El valor d'eval_formula ¨¦s igual al valor de formula per als filtres amb una expressi¨® personalitzada.Comportament de la propietat: - nom¨¦s lectura |
| formula | string | Expressi¨® definida per l'usuari per avaluar les condicions del filtre amb una expressi¨® personalitzada. L'expressi¨® ha de contindre identificadors que facin refer¨¨ncia a condicions de filtre espec¨ªfiques mitjan?ant la seva "f¨®rmula". Els identificadors emprats a l'expressi¨® han de coincidir exactament amb els definits a les condicions del filtre: no es pot pas deixar ni ometre cap condici¨®. Comportament de la propietat: - obligatori si evaltype s'ha establert a "expressi¨® personalitzada" |
Condici¨® de filtre de regla LLD
Aquest objecte defineix una comprovaci¨® separada per dur a terme el valor d'una macro LLD. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| macro | string | Macro LLD per comprovar-ho. Comportament de la propietat: - obligatori |
| valor | cadena | Valor a comparar. Comportament de la propietat: - obligatori si operator s'ha definit a "coincideix amb expressi¨® regular" o "no "coincideix amb expressi¨® regular" |
| formulaid | string | ID ¨²nic arbitrari emprat per fer refer¨¨ncia a la condici¨® d'una expressi¨® personalitzada. Nom¨¦s pot contindre lletres maj¨²scules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, per¨° es tornar¨¤ a generar quan ho demani m¨¦s endavant. Comportament de la propietat: - obligatori si evaltype de l'objecte de filtre de la regla LLD s'ha definit com a "expressi¨® personalitzada" |
| operador | integer | Operador de condici¨®. Valors possibles: 8 - (per defecte) coincideix amb l'expressi¨® regular; 9 - no coincideix amb l'expressi¨® regular; 12 - existeix;< br>13 - no existeix. |
Per entendre millor com emprar filtres amb diferents tipus d'expressions, consulteu els exemples a les p¨¤gines del m¨¨tode discoveryrule.get i discoveryrule.create.
Ruta de macro LLD
La ruta de la macro LLD t¨¦ les propietats seg¨¹ents:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| lld_macro | cadena | Macro LLD. Comportament de la propietat: - obligatori |
| path | cadena | Selector de valor que ser¨¤ assignat a la macro corresponent. Comportament de la propietat: - obligatori |
Preprocessament de regla LLD
L'objecte de preprocessament de regles LLD t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| tipus | integer | El tipus d'opci¨® de preprocessament. Valors possibles: 5 - Coincid¨¨ncia d'expressi¨® regular; 11 - XML ??????XPath ; 12 - JSONPath; 15 - No coincideix amb l'expressi¨® regular;< br>16 - Comprovar si hi ha errors JSON; 17 - Comprovar si hi ha errors XML; 20 - Descartar sense canvis amb el heartbeat; 23 - Prometheus a JSON; 24 - CSV a JSON; 25 - Substitu?u; 27 - XML ????a JSON. 28 - Valor SNMP walk; 29 - SNMP walk a JSON. Comportament de la propietat: - obligatori |
| params | cadena | Par¨¤metres addicionals emprats per l'opci¨® de preprocessament. M¨²ltiples par¨¤metres separats per car¨¤cter LF (\n). Comportament de la propietat: - obligatori si type s'ha establert a "Expressi¨® regular coincident" (5), "XML XPath" (11), "JSONPath" (12), "No coincideix amb l'expressi¨® regular" (15), "Verifica errors a JSON" (16), "Verifica errors a l'XML" (17), "Descarta els no canviats amb heartbeat" (20), "Prometheus a JSON" (23), "CSV a JSON" (24), "Reempla?ar" (25), "Valor SNMP walk" (28), "SNMP walk a JSON" (29) o "valor get SNMP" (30) |
| error_handler | integer | Tipus d'acci¨® que s'empra si la passa de preprocessament falla. Valors possibles: 0 - El servidor Áú»¢¶Ä²© ha establert el missatge d'error del missatge. ; 1 - Elimina el valor; 2 - Estableix un valor personalitzat;< br>3 - Estableix un missatge d'error personalitzat. Comportament de la propietat: - obligatori si type s'ha establert a "Coincid¨¨ncia d'expressi¨® regular" (5), "XPath XML" (11), "JsonPath" (12), "No coincideix amb l'expressi¨® regular" (15), "Verifica errors a JSON" (16), "Verifica errors a l'XML" (17), "Prometheus a JSON" (23), "CSV a JSON" (24), "XML a JSON" (27), "Valor SNMP walk" (28), "SNMP walk a JSON" (29) o "valor get SNMP" (30) |
| error_handler_params | cadena | Par¨¤metres del gestor d'errors. Comportament de la propietat: - obligatori si error_handler t¨¦ el valor d'"Establir valor personalitzat" o "Establir missatge d'error personalitzat" |
Els seg¨¹ents par¨¤metres i gestors d'errors s¨®n compatibles per a cada tipus de preprocessament.
|Tipus de preprocessament|Nom|Par¨¤metre 1|Par¨¤metre 2|Par¨¤metre 3|Gestors d'errors admesos| |-------------------|----|-----------|------------|- ----------|----------| |5|Expressi¨® regular|pattern1|output2|<|0, 1, 2, 3| |11|XML XPath|path3|<|<|0, 1, 2, 3| |12|JSONPath|path3|<|<|0, 1, 2, 3| |14|Coincidex amb expressi¨® regular|pattern1|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressi¨® regular|pattern1|<|<|0, 1, 2, 3| |16|Cerca un error en JSON |path3|<|<|0, 1, 2, 3| |17|Cerca un error a XML|path3|<|<|0, 1, 2, 3| |20|Descartar sense canvis amb el heartbeat|seconds4,?5,?6|<|<|<| |21|JavaScript|script2|<|<|<| |23|Prometeu a JSON|pattern5,\7|<|<|0, 1, 2, 3| |24|CSV a JSON|character2|character2|0,1|0, 1, 2, 3| |25|Substitueix|search string2|replacement2|<|<| |27|XML a JSON|<|<|<|0, 1, 2, 3| |28|SNMP walk value|OID2|Format:
0 - No canviat
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Enter de BITS|<|0, 1, 2, 3| |29|SNMP walk to JSON9|Field name2|Prefix OID 2|Format:
0 - No canviat
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Enter de BITS|0, 1, 2, 3| |30|Valor get SNMP|Format:
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Enter de BITS|<|<|0, 1, 2, 3|
1 expressi¨® regular
2 cadena
3 JSONPath o XML XPath
4 nombre enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)
5 macro d'usuari
6 Patr¨® de Prometheus seguint la sintaxi: <nom m¨¨tric>{<nom de l'etiqueta>="<valor de l'etiqueta>", ...} == <valor>. Cada component del patr¨® de Prometheus (m¨¨trica, nom d'etiqueta, valor d'etiqueta i valor de m¨¨trica) pot ser una macro d'usuari. 7 Admet diversos registres "Field name,OID prefix,Format records" delimitats per un car¨¤cter de nova l¨ªnia.
Sobrec¨¤rrega de regles LLD
L'objecte de sobrec¨¤rrega de regles LLD defineix un conjunt de regles (filtres, condicions i operacions) que s'empren per anul¡¤lar les propietats de diversos objectes prototip. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| nom | string | Nom ¨²nic de sobrec¨¤rrega. Comportament de la propietat: - obligatori |
| passa | integer | Nombre de seq¨¹¨¨ncia ¨²nic de la sobrec¨¤rrega. Comportament de la propietat: - obligatori |
| stop | integer | Atura el processament de les sobrec¨¤rregues futures si coincideix. Valors possibles: 0 - (per defecte) no atura el processament de les sobrec¨¤rregues; 1: atura el processament de les sobrec¨¤rregues del proc¨¦s si el filtre coincideix . |
| filtre | object | Filtre de sobrec¨¤rrega. |
| operacions | object/array | Operacions de sobrec¨¤rrega. |
:::
Filtre de sobrec¨¤rrega de la regla LLD
L'objecte defineix un conjunt de condicions que, si coincideixen amb l'objecte descobert, s'aplica la sobrec¨¤rrega. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| conditions | object/array | Conjunt de condicions de filtre de sobrec¨¤rrega que s'empren per fer coincidir els objectes descoberts. Comportament de la propietat: - obligatori |
| evaltype | integer | Substitueix el m¨¨tode d'avaluaci¨® de la condici¨® de filtre. Valors possibles: 0 - i/o; 1 - i ;< br>2 - o ; 3 - expressi¨® personalitzada. Comportament de la propietat: - obligatori |
| eval_formula | string | Expressi¨® generada que s'emprar¨¤ per avaluar les condicions del filtre de sobrec¨¤rrega. El valor de eval_formula ¨¦s igual al valor de formula per als filtres amb una expressi¨® personalitzada.Comportament de la propietat: - nom¨¦s lectura |
| formula | string | Expressi¨® definida per l'usuari per avaluar les condicions del filtre de sobrec¨¤rrega amb una expressi¨® personalitzada. L'expressi¨® ha de contindre identificadors que facin refer¨¨ncia a condicions espec¨ªfiques del filtre de sobrec¨¤rrega mitjan?ant la seva "f¨®rmula". Els ID emprats a l'expressi¨® han de coincidir exactament amb els definits a les condicions del filtre de sobrec¨¤rrega: cap condici¨® no es pot deixar sense emprar ni ometre. Comportament de la propietat: - obligatori si evaltype s'estableix a "expressi¨® personalitzada" |
:::
Condici¨® del filtre de sobrec¨¤rrega de la regla LLD
L'objecte defineix una comprovaci¨® independent per dur a terme el valor d'una macro LLD. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| macro | string | Macro LLD per realitzar la comprovaci¨®. Comportament de la propietat: - obligatori |
| valor | string | Valor a comparar. Comportament de la propietat: - obligatori si operator s'estableix a "expressi¨® regular coincident" o "no coincideix amb expressi¨® regular" |
| formulaid | string | ID ¨²nic arbitrari emprat per fer refer¨¨ncia a la condici¨® d'una expressi¨® personalitzada. Nom¨¦s pot contindre lletres maj¨²scules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, per¨° es tornar¨¤ a generar quan ho sol¡¤liciti m¨¦s endavant. Comportament de la propietat: - obligatori si evaltype de l'[objecte de filtre de sobreescriptura de regla LLD]#lld-rule-override-filter) s'estableix a "expressi¨® personalizada" |
| operador | integer | Operador de condici¨®. Valors possibles: 8 - (per defecte) coincideix amb l'expressi¨® regular; 9 - no coincideix amb l'expressi¨® regular; 12 - existeix;< br>13 - no existeix. |
Operaci¨® de sobrec¨¤rrega de regles LLD
L'operaci¨® ¨¦s una combinaci¨® d'accions i condicions que s'han de realitzar a l'objecte prototip. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| operationobject | integer | Tipus d'objecte descobert per dur a terme l'acci¨®. Valors possibles: 0 - Prototip d'element; 1 - Prototip de trigger;< br>2 - Prototip de gr¨¤fics; 3 - Prototip d'equip. Comportament de la propietat: - obligatori |
| operador | integer | Operador de condici¨® de sobrec¨¤rrega. Valors possibles: 0 - (per defecte) ¨¦s igual; 1 - no ¨¦s igual; 2 - cont¨¦; 3 - no cont¨¦; 8 - coincideix; 9 - no coincideix. |
| valor | string | Patr¨® per fer coincidir l'element, el trigger, el gr¨¤fic o el nom del prototip d'equip basat en l'objecte triat. |
| opstatus | object | Objecte d'estat de l'operaci¨® de sobrec¨¤rrega per a objectes d'element, trigger i prototip d'equip. |
| opdiscover | object | Objecte d'estat de l'operaci¨® de sobrec¨¤rrega de descobriment (qualsevol tipus d'objecte). |
| opperiod | object | Objecte de per¨ªode d'operaci¨® de sobrec¨¤rrega (interval d'actualitzaci¨®) per a l'objecte prototip d'element. |
| ohistory | object | Objecte de l'hist¨°ric d'operacions de sobrec¨¤rrega per a l'objecte prototip d'element. |
| optrends | object | Objecte de ³Ù±ð²Ô»å¨¨²Ô³¦¾±±ð²õ d'operaci¨® de sobrec¨¤rrega per a l'objecte prototip d'element. |
| opseverity | object | Objecte de gravetat de l'operaci¨® de sobrec¨¤rrega per a l'objecte prototip del trigger. |
| optag | array | Objecte d'etiqueta d'operaci¨® de sobrec¨¤rrega per a l'objecte prototip de l'equip. |
| optemplate | array | Objecte de plantilla d'operaci¨® de sobrec¨¤rrega per a l'objecte prototip de l'equip. |
| opinventory | object | Objecte d'inventari d'operacions de sobrec¨¤rrega per a l'objecte prototip de l'equip. |
Estat de l'operaci¨® de sobrec¨¤rrega de la regla LLD
Estat de l'operaci¨® de sobrec¨¤rrega de la regla LLD que s'estableix com a objecte descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| status | enter | Anul¡¤la l'estat de l'objecte seleccionat. Valors possibles: 0 - Creaci¨® activada; 1 - Creaci¨® desactivada. Comportament de la propietat: - obligatori |
Operaci¨® de sobrec¨¤rrega de descobriment de regles LLD
Estat de l'operaci¨® de sobrec¨¤rrega de descobriment de la regla LLD que s'estableix a l'objecte descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| discover | enter | Anul¡¤la l'estat de descoberta de l'objecte triat. Valors possibles: 0 - S¨ª, continuar descobrint objectes;< br>1 - No , els elements nous no es descobriran i els elements existents es marcaran com a perduts. Comportament de la propietat: - obligatori |
Per¨ªode d'operaci¨® de substituci¨® de la regla LLD
El per¨ªode d'operaci¨® d'anul¡¤laci¨® de la regla LLD ¨¦s un valor d'interval d'actualitzaci¨® que s'estableix com a element descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| endarreriment | string | Substitueix l'interval d'actualitzaci¨® del prototip d'element. Admet segons o unitat de temps amb sufix (com ara 30 s, 1 m, 2 h, 1 d) i, opcionalment, un o m¨¦s intervals personalitzats, tots separats per punt i coma. Els intervals personalitzats poden ser una combinaci¨® d'intervals flexibles i de programaci¨®. Admet macros d'usuari o macros LLD. Si s'empra, el valor ha de ser una ¨²nica macro. No s'admeten diverses macros o macros barrejades amb text. Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (p. ex., {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Exemple: 1h;wd1-5h9-18;{ $Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}[Comportament de la propietat] (/manual/api/reference_commentary#property-behavior): - obligatori |
Operaci¨® de sobrec¨¤rrega de l'historial de regles LLD
Operaci¨® de sobrec¨¤rrega de l'historial de regles LLD establerta a l'element descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| historial | cadena | Substitueix l'hist¨°tic del prototip d'element, que ¨¦s una unitat de temps de quant de temps s'han d'emmagatzemar les dades de l'hist¨°ric. Tamb¨¦ accepta macro d'usuari i macro LLD. Comportament de la propietat: - obligatori |
Operaci¨® de sobrec¨¤rrega de les ³Ù±ð²Ô»å¨¨²Ô³¦¾±±ð²õ de regles LLD
Operaci¨® de sobrec¨¤rrega de les ³Ù±ð²Ô»å¨¨²Ô³¦¾±±ð²õ de regles LLD establerta a l'element descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| ³Ù±ð²Ô»å¨¨²Ô³¦¾±±ð²õ | cadena | Substitueix les ³Ù±ð²Ô»å¨¨²Ô³¦¾±±ð²õ del prototip d'element, que ¨¦s una unitat de temps de quant de temps s'han d'emmagatzemar les dades de les ³Ù±ð²Ô»å¨¨²Ô³¦¾±±ð²õ. Tamb¨¦ accepta macro d'usuari i macro LLD. Comportament de la propietat: - obligatori |
Operaci¨® de sobrec¨¤rrega de gravetat de la regla LLD
L'operaci¨® s'ha establert al trigger descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| severity | enter | Anul¡¤la la gravetat del prototip de trigger. Valors possibles: 0 - (per defecte) sense classificar; 1 - informaci¨® ; 2 - av¨ªs; 3 - mitjana; 4 - alta; 5 - desastre. Comportament de la propietat: - obligatori |
Operaci¨® de sobrec¨¤rrega d'etiquetes de regla LLD
L'operaci¨® cont¨¦ el nom i el valor de l'etiqueta definit a l'objecte descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| tag | cadena | Nom d'etiqueta nou. Comportament de la propietat: - obligatori |
| value | cadena | Valor d'etiqueta nou. |
Operaci¨® de sobrec¨¤rrega del model de regles LLD
Objecte d'operaci¨® de sobrec¨¤rrega del model vinculat a l'equip descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| templateid | ID | Substitueix la plantilla de les plantilles vinculades al prototip de l'equip. Comportament de la propietat: - obligatori |
LLD Rule Operaci¨® de sobrec¨¤rrega d'inventari
Operaci¨® per anul¡¤lar el valor del mode d'inventari de la regla LLD que s'estableix a l'equip descobert. T¨¦ les seg¨¹ents propietats:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| inventory_mode | enter | Ignora el mode d'inventari del prototip de l'equip. Valors possibles: -1 - desactivat;< br>0 - ( per defecte) manual; 1 - autom¨¤tic. Comportament de la propietat: - obligatori |