Documentation
Table of Contents
Objecte element
Els seg¨¹ents objectes tenen relaci¨® directa amb l'API item.
Element
Els elements web no es poden crear, actualitzar o esborrar directament mitjan?ant l'API de Áú»¢¶Ä²©.
L'objecte element t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| itemid | ID | ID de l'element. Comportament de la propietat: - nom¨¦s lectura - obligatori per operacions d'actualitzaci¨® |
| delay | string | Interval d'actualitzaci¨® de l'element. Accepta segons o una unitat de temps amb sufix (30s, 1m, 2h, 1d). Opcionalment, un o m¨¦s intervals personalitzats es poden especificar com a intervals flexibles o com una programaci¨®. M¨²ltiples intervals estan separats per un punt i coma. Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten pas diverses macros en un camp o macros barrejades amb text. Els intervals flexibles es poden escriure com 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: - obligatori si type s'ha establert a "Agent Áú»¢¶Ä²©" (0), "Verificacions simples" (3), "Intern Áú»¢¶Ä²©" (5), "Verificacions externes" (10), "Monitoratge de base de dades" (11), "Agent IPMI" (12), "Agent SSH" (13), "Agent TELNET" (14), "Calculat" (15), "Agent JMX (16), "Agent HTTP" (19), "Agent SNMP" (20), "Script" (21), "Navegador" (22), o si type s'ha establert a "Agent actiu de Áú»¢¶Ä²©" (7) i key_ no cont¨¦ pas "mqtt.get" |
| hostid | ID | ID de l'equip o del model al qual pertany l'element. Comportament de la propietat: - constant - obligatori per operacions de creaci¨®. |
| interfaceid | ID | ID de la interf¨ªcie d'equip de l'element. Comportament de la propietat: - obligatori si l'element pertany a l'equip i type ¨¦s "Agent Áú»¢¶Ä²©", "Agent IPMI", "Agent JMX", "Tra?a SNMP", o "Agent SNMP"- ²¹»å³¾¨¨²õ si l'element pertant a l'equip i type ¨¦s "Validaci¨® simple", "Validaci¨® externa", "Agent SSH", "Agent TELNET", o "Agent HTTP"- nom¨¦s lectura per objectes descoberts |
| key_ | string | Clau d'element. Comportament de la propietat: - obligatori per operacions de creaci¨® - nom¨¦s lectura per objectes heretats o descoberts |
| name | string | Nom de l'element. Comportament de la propietat: - obligatori per operacions de creaci¨® - nom¨¦s lectura per objectes heretats o descoberts |
| name_resolved | string | Nom de l'element amb les macros d'usuari resoltes. Comportament de la propietat: - nom¨¦s lectura |
| type | integer | Tipus d'element Valors possibles: 0 - Agent Áú»¢¶Ä²©; 2 - Trapper Áú»¢¶Ä²©; 3 - Verificaci¨® simple; 5 - Áú»¢¶Ä²© intern; 7 - Agent Áú»¢¶Ä²© (actiu); 9 - Element web; 10 - Verificaci¨® externa; 11 - Monitor de base de dades;<12> - Agent IPMI; 13 - Agent SSH; 14 - Agent Telnet; 15 - Calculat; 16 - Agent JMX; 17 - Trampa SNMP; 18 - Element dependent; 19 - Agent HTTP; 20 - Agent SNMP; 21 - Script;<22> - Navegador. Comportament de la propietat: - obligatori per les operacions de creaci¨® - nom¨¦s lectura per objectes heretats o descoberts |
| url | string | cadena d'URL, necess¨¤ria nom¨¦s per al tipus d'element d'agent HTTP. 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 "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| value_type | integer | Tipus d'informaci¨® de l'element. Valors possibles: 0 - nombre flotant; 1 - car¨¤cter; 2 - diari; 3 - num¨¨ric sense signe; 4 - text; 5 - binari. Comportament de la propietat: - obligatori per operacions de creaci¨® - nom¨¦s lectura per objectes heretats o descoberts |
| allow_traps | integer | camp d'element 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 "Agent HTTP"- nom¨¦s lectura per objectes descoberts |
| authtype | integer | M¨¨tode d'autenticaci¨®. Valors possibles si type ¨¦s establert a "Agent SSH":0 - (per defecte) mot de pas; 1 - clau p¨²blica. Valors possibles si type ¨¦s "Agent HTTP":0 - (per defecte) cap 1 - B¨¤sic 2 - NTLM 3 - Kerberos Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent SSH" o "Agent HTTP"- nom¨¦s lectura per objectes heretats (si type ¨¦s "Agent HTTP") o objectes descoberts |
| description | string | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® de l'element. Comportament de la propietat: - nom¨¦s lectura per objectes descoberts |
| error | string | Text d'error si hi ha problemes per actualitzar el valor de l'element. Comportament de la propietat: - nom¨¦s lectura |
| flags | integer | Origen de l'objecte. Valors possibles: 0 - Objecte normal; 4 - Objecte descobert. Comportament de la propietat: - nom¨¦s lectura |
| follow_redirects | integer | Camp d'element de l'agent HTTP. Seguiu les redireccions de respostes mentre afegiu dades. 0 - No seguiu les redireccions. 1 - (per defecte) Seguiu les redireccions. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| headers | array | Taula de cap?aleres que s'enviar¨¤ quan es faci una petici¨® HTTP. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| history | string | Unitat de temps que indica quant de temps s'han d'emmagatzemar les dades de l'hist¨°ric. Tamb¨¦ accepta macros d'usuari. Per defecte: 90d. Comportament de la propietat: - nom¨¦s lectura per objectes descoberts |
| http_proxy | string | Cadena de connexi¨® del proxy HTTP(S). Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent SSH" - nom¨¦s lectura per objectes heretats o descoberts |
| inventory_link | integer | ID del camp d'inventari de l'equip emplenat per l'element. Consulteu la p¨¤gina d'inventari d'equip per obtindre una llista de camps d'inventari d'equip admesos i els seus identificadors. Per defecte: 0. Comportament de la propietat: - ²¹»å³¾¨¨²õ si value_type ¨¦s "num¨¨ric flotant", "car¨¤cter", "num¨¨ric sense signe" o "text"- nom¨¦s lectura per objectes descoberts |
| ipmi_sensor | string | sensor IPMI. Comportament de la propietat: - obligatori si type ¨¦s "Agent IPMI" i key_ no ¨¦s "ipmi.get"- ²¹»å³¾¨¨²õ si type ¨¦s "Agent IPMI"- nom¨¦s lectura per objectes heretats o descoberts |
| 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 "Agent JMX"- nom¨¦s lectura per objectes descoberts |
| lastclock | timestamp | Hora en qu¨¨ l'element es va actualitzar per darrer cop. Per defecte, nom¨¦s es mostren els valors de les darreres 24 hores. Podeu ampliar aquest per¨ªode canviant el valor del par¨¤metre Per¨ªode m¨¤xim de visualitzaci¨® de l'historial a la secci¨® del men¨² Administraci¨® ¡ú General. Comportament de la propietat: - nom¨¦s lectura |
| lastns | integer | (nom¨¦s lectura) Nanosegons de la darrera actualitzaci¨® de l'element. De manera predeterminada, nom¨¦s es mostren els valors de les darreres 24 hores. Podeu ampliar aquest per¨ªode canviant el valor del par¨¤metre Per¨ªode m¨¤xim de visualitzaci¨® de l'historial a la secci¨® del men¨² Administraci¨® ¡ú General. Comportament de la propietat: - nom¨¦s lectura |
| lastvalue | string | (nom¨¦s lectura) Darrer valor de l'element. Per defecte, nom¨¦s es mostren els valors de les darreres 24 hores. Podeu ampliar aquest per¨ªode canviant el valor del par¨¤metre Per¨ªode m¨¤xim de visualitzaci¨® de l'historial a la secci¨® del men¨² Administraci¨® ¡ú General. Comportament de la propietat: - nom¨¦s lectura |
| logtimefmt | string | Format d'hora a les entrades de registre. Comportament de la propietat: - ²¹»å³¾¨¨²õ si value_type ¨¦s "log"- nom¨¦s lectura per objectes heretats o descoberts |
| master_itemid | integer | Identificador d'element principal. Es permet la recurr¨¨ncia de fins a 3 elements dependents i el nombre m¨¤xim d'elements dependents de 29.999. Comportament de la propietat: - obligatori si type ¨¦s "Element dependent"- nom¨¦s lectura per objectes heretats o descoberts |
| output_format | integer | Camp d'element de l'agent HTTP. En cas de convertir la resposta a JSON. 0 - (per defecte) Emmagatzema en brut. 1 - Converteix a JSON. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| params | string | Par¨¤metres addicionals en ´Ú³Ü²Ô³¦¾±¨® del tipus d'element: - script executat per a elements SSH i Telnet; - consulta SQL per a elements de monitoratge de la base de dades; - f¨®rmula per als elements calculats; - l'script per a un element d'script. Comportament de la propietat: - obligatori si type ¨¦s "Monitor de base de dades", "Agent SSH", "Agent TELNET", "Calculat", "Script" o "Navegador"- nom¨¦s lectura per objectes heretats (si type ¨¦s "Script" o "Navegador") o objectes descoberts |
| parameters | object/array | Par¨¤metres addicionals si type ¨¦s establert a "Script" o "Navegador". Matriu d'objectes amb propietats namei value, on name ha d'¨¦sser ¨²nic.Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Script" o "Navegador"- nom¨¦s lectura per objectes heretats o descoberts |
| password | string | Mot de pas per a l'autenticaci¨®. Comportament de la propietat: - obligatori si type ¨¦s "Agent JMX" i username s'ha especificat- ²¹»å³¾¨¨²õ si type ¨¦s "Verificaci¨® simple", "Agent SSH", "Agent TELNET", "Monitoratge de base de dades" o "Agent HTTP"- nom¨¦s lectura per objectes heretats (si type ¨¦s "Agent HTTP") o objectes descoberts |
| post_type | integer | Tipus de cos de dades de publicaci¨® emmagatzemat a la propietat posts.0 - (per defecte) Dades en brut. 2 - Dades JSON. 3 - Dades XML. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| posts | string | Informaci¨® del cos de la petici¨® HTTP(S). Comportament de la propietat: - obligatori si type ¨¦s "Agent HTTP" i post_type ¨¦s "Dades JSON" o "Dades XML"- ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP" i post_type ¨¦s "Dades en brut"- nom¨¦s lectura per objectes heretats o descoberts |
| prevvalue | string | Valor anterior de l'element. Per defecte, nom¨¦s es veuen els valors de les ¨²ltimes 24 hores. Podeu ampliar aquest per¨ªode canviant el valor del par¨¤metre Per¨ªode m¨¤xim de visualitzaci¨® de l'historial a la secci¨® del men¨² Administraci¨® ¡ú General. Comportament de la propietat: - nom¨¦s lectura |
| privatekey | string | Nom del fitxer de clau privada. Comportament de la propietat: - obligatori si type ¨¦s "Agent SSH" i authtype ¨¦s "clau p¨²blica"- nom¨¦s lectura per objectes descoberts |
| publickey | string | Nom del fitxer de clau p¨²blica. Comportament de la propietat: - obligatori si type ¨¦s "Agent SSH" i authtype ¨¦s "clau p¨²blica"- nom¨¦s lectura per objectes descoberts |
| query_camps | array | Camp d'element de l'agent HTTP. Par¨¤metres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ¨¦sser una cadena buida. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| request_method | integer | Camp d'element de l'agent HTTP. Tipus de m¨¨tode de petici¨®. 0 - (per defecte) GET 1 - POST 2 - PUT 3 - HEAD Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| retrieve_mode | integer | 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 only 1 ¨¦s el valor perm¨¨s. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| snmp_oid | string | SNMP OID. Comportament de la propietat: - obligatori si type ¨¦s "Agent SNMP"- nom¨¦s lectura per objectes heretats o descoberts |
| ssl_cert_file | string | Cam¨ª al fitxer de clau SSL p¨²blica. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| ssl_key_file | string | Cam¨ª al fitxer de clau SSL privada. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| ssl_key_password | string | Mot de pas per al fitxer de clau SSL. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| state | integer | Estat de l'element. Valors possibles: 0 - (per defecte) normal; 1 - no compatible. Comportament de la propietat: - nom¨¦s lectura |
| status | integer | Estat de l'element. Valors possibles: 0 - element activat (per defecte); 1 - element desactivat. |
| status_codes | 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 "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| templateid | ID | ID de l'element de la plantilla principal. Consell: Empreu la propietat hostid per especificar la plantilla a la qual pertany l'element.Comportament de la propietat: - nom¨¦s lectura |
| timeout | string | Temps d'espera de la petici¨® de consulta de dades d'element. Admet segons o unitats de temps amb sufix (com ara 30s, 1m). Tamb¨¦ admet macros d'usuari. Valors possibles: 1-600s. Per defecte: "" - emprar la configuraci¨® global del proxy. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent Áú»¢¶Ä²©" (0), "Verificaci¨® simple" (3) i key_ no comen?a amb "vmware." i "icmpping", "agent de Áú»¢¶Ä²© (actiu)" (7), "Validaci¨® externa" (10), "Database monitor" (11), "Agent SSH" (13), "Agent TELNET" (14), "Agent HTTP" (19), "Agent SNMP" (20) i snmp_oid comen?a amb "walk[" o "get[", "Script" (21), "Navegador" (22)- nom¨¦s lectura per objectes descoberts i heretats |
| trapper_hosts | string | Equips permesos. Comportament de la propietat: - nom¨¦s lectura per objectes descoberts - ²¹»å³¾¨¨²õ si type ¨¦s "Áú»¢¶Ä²© trapper" o si type ¨¦s "Agent HTTP" i allow_traps ¨¦s "Permetre acceptar dades entrants" |
| trends | string | Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tend¨¨ncies. Tamb¨¦ accepta macros d'usuari. Per defecte: 365d. Comportament de la propietat: - ²¹»å³¾¨¨²õ si value_type ¨¦s "num¨¨ric flotant" o "num¨¨ric sense signe"- nom¨¦s lectura per objectes descoberts |
| units | string | Unitats de valor. Comportament de la propietat: - ²¹»å³¾¨¨²õ si value_type ¨¦s "num¨¨ric flotant" o "num¨¨ric sense signe"- nom¨¦s lectura per objectes heretats o descoberts |
| username | string | Nom d'usuari per a l'autenticaci¨®. Comportament de la propietat: - obligatori si type ¨¦s "Agent SSH", "Agent TELNET", o si type ¨¦s "Agent JMX" i password s'ha definit- ²¹»å³¾¨¨²õ si type ¨¦s "Verificaci¨® simple", "Monitoratge de base de dades" o "Agent HTTP"- nom¨¦s lectura per objectes heretats (si type ¨¦s "Agent HTTP") o descoberts |
| uuid | string | Identificador ¨²nic universal, emprat per enlla?ar un element importat amb elements ja existents. Es genera autom¨¤ticament, si no es proporciona. Comportament de la propietat: - ²¹»å³¾¨¨²õ si l'element pertany a una plantilla |
| valuemapid | ID | ID del mapa de valor associat. Comportament de la propietat: - ²¹»å³¾¨¨²õ si value_type ¨¦s "num¨¨ric flotant", "car¨¤cter" o "num¨¨ric sense signe"- nom¨¦s lectura per objectes heretats o descoberts |
| verify_host | integer | Valideu que el nom d'equip per la connexi¨® coincideix amb el del certificat d'equip. Valors possibles: 0 - (per defecte) No valida. 1 - Valida. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
| verify_peer | integer | Valida si el certificat de l'equip ¨¦s aut¨¨ntic. 0 - (per defecte) No valida. 1 - Valida. Comportament de la propietat: - ²¹»å³¾¨¨²õ si type ¨¦s "Agent HTTP"- nom¨¦s lectura per objectes heretats o descoberts |
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|
Etiqueta d'element
L'objecte d'etiqueta d'element t¨¦ les propietats seg¨¹ents:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| tag | string | Nom de l'etiqueta de l'element. Comportament de la propietat: - obligatori |
| value | string | Valor de l'etiqueta de l'element. |
Preprocessament de l'element
L'objecte t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| type | integer | El tipus d'opci¨® de preprocessament. Valors possibles: 1 - Multiplicador personalitzat; 2 - Retalla a la dreta;< br>3 - Retalla a l'esquerra; 4 - Retalla; 5 - Coincid¨¨ncia d'expressi¨® regular; 6 - Boole¨¤ a decimal; 7 - Octal a decimal; 8 - Hexadecimal a decimal; 9 - Canvi ¨²nic; 10 - Canvi per segon; 11 - XML XPath; 12 - JSONPath; 13 - Dins l'interval; 14 - Coincideix amb l'expressi¨® regular; 15 - No coincideix amb l'expressi¨® regular; 16 - Comprova si hi ha errors en JSON; 17 - Comprova si hi ha errors en XML; 18 - Comprova si hi ha errors mitjan?ant una expressi¨® regular; 19 - Descartar sense canvis; 20 - Descartar sense canvis amb un heartbeat; 21 - JavaScript; 22 - Patr¨® de Prometheus; 23 - Prometheus a JSON; 24 - CSV a JSON; 25 - Substitu?u; >26 - No s'admet la verificaci¨®; 27 - XML a JSON; 28 - Valor SNMP walk; 29 - SNMP walk a JSON; 30 - Valor SNMP get. Comportament de la propietat: - obligatori |
| params | string | Par¨¤metres addicionals emprats per l'opci¨® de preprocessament. Diversos par¨¤metres s¨®n separats pel car¨¤cter de nova l¨ªnia (\n). Si type ¨¦s "Validar no suportats", els par¨¤metres segueixen una sintaxi de <scope>[\n<pattern>], on pattern ¨¦s una expressi¨® regular, i scope ¨¦s una d'aquestes:-1 - verifica davant qualsevol error; ?0 - verificar si el missatge d'error coincideix amb pattern; ?1 - verificar si el missatge d'error no coincideix amb pattern. Comportament de la propietat: - obligatori si type s'ha establert a "Multiplicador personalitzat" (1), "Retall dret" (2), "Retall esquerre" (3), "Retall" (4), "Expressi¨® regular" (5), "XML XPath" (11), "JSONPath" (12), "Dins l'int¨¨rval" (13), "Coincideix amb l'expressi¨® regular" (14), "No coincideix amb l'expressi¨® regular" (15), "Validar per error al JSON" (16), "Validar per error al XML" (17), "Validar per error emprant una expressi¨® regular" (18), "Descartar els no canviants amb heartbeat" (20), "JavaScript" (21), "Patr¨® Prometheus" (22), "Prometheus a JSON" (23), "CSV a JSON" (24), "Substitu?r" (25), Validar no suportats (26), "Valor SNMP walk" (28), "SNMP walk a JSON" (29), or "Valor SNMP get" (30) |
| error_handler | integer | Tipus d'acci¨® que s'empra quan falla el pas de preprocessament. Valors possibles: 0 - Áú»¢¶Ä²© defineix el missatge d'error del missatge;< br>1 - Elimina el valor; 2 - Estableix un valor personalitzat; 3 - Estableix un missatge d'error personalitzat. Valors possibles si type ¨¦s "Validar no suportat":1 - Descartar el valor; 2 - Establir valor personalitzat; 3 - Establir missatge d'error personalitzat. Comportament de la propietat: - obligatori si type ¨¦s "Multiplicador personalitzat" (1), "Coincid¨¨ncia d'expressi¨® regular" (5), "Boole¨¤ a decimal" (6), "Octal a decimal" (7), "Hexadecimal a decimal" (8), "Canvi simple" (9), "Canvi per segon" (10), "XML XPath" (11), "JSONPath" (12), "En rang" (13), "Coincideix amb expressi¨® regular" (14), "No coincideix amb expressi¨® regular" (15), "Verificar errors a JSON" (16), "Verificar errors a XML" (17), "Verificar errors emprant una expressi¨® regular" (18), "Patr¨® Prometheus" (22), "Prometheus a JSON" (23), "CSV a JSON" (24), "Verificaci¨® no admesa" (26), "XML a JSON" (27), "Valor SNMP walk" (28), or "SNMP walk a JSON" (29), o "Valor SNMP get" (30) |
| error_handler_params | string | Par¨¤metres del gestor d'errors. Comportament de la propietat: - obligatori si error_handler ¨¦s "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| |------------------|----|------------|-----------|-- ---------|---------| |1|Multiplicador personalitzat|nombre1,\6|<|<|0, 1, 2, 3| |2|Retalla a la dreta|llista de car¨¤cters2|<|<|<| |3|Retalla a l'esquerra|llista de car¨¤cters2|<|<|<| |4|Retalla|llista de car¨¤cters2|<|<|<| |5|Expressi¨® regular|patr¨®3|sortida2|<|0, 1, 2, 3| |6|Boole¨¤ a decimal|<|<|<|0, 1, 2, 3| |7|Octal a decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal a decimal|<|<|<|0, 1, 2, 3| |9|Canvi ¨²nic|<|<|<|0, 1, 2, 3| |10|Canvi per segon|<|<|<|0, 1, 2, 3| |11|XML XPath|cam¨ª4|<|<|0, 1, 2, 3| |12|JSONPath|cam¨ª4|<|<|0, 1, 2, 3| |13|Dins de l'interval|min1,?6|max1,?6|<|0, 1, 2, 3| |14|Coincideix amb l'expressi¨® regular|patr¨®3|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressi¨® regular|patr¨®3|<|<|0, 1, 2, 3| |16|Comprova l'error a JSON|cam¨ª4|<|<|0, 1, 2, 3| |17|Comprova l'error en XML|cam¨ª4|<|<|0, 1, 2, 3| |18|Comprova si hi ha errors emprant l'expressi¨® regular|patr¨®3|sortida2|<|0, 1, 2, 3| |19|Descarta el que no ha canviat|<|<|<|<| |20|Descarta el no canviat amb un heartbeat|segons5,?6|<|<|<| |21|JavaScript|script2|<|<|<| |22|Patr¨® de Prometheus|patr¨®6,\7|valor, etiqueta, ´Ú³Ü²Ô³¦¾±¨®|sortida8,\9|0, 1, 2, 3| |23|Prometheus a JSON|patr¨®6,\7|<|<|0, 1, 2, 3| |24|CSV a JSON|char2|char2|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca2|substitueix2|<|<| |26|La verificaci¨® no ¨¦s compatible|<|<|<|1, 2, 3| |27|XML a JSON|<|<|<|0, 1, 2, 3| |28|Valor SNMP walk|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 a JSON10|Field name2|OID prefix2|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 SNMP get|Format:
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Integer de BITS|<|<|0, 1, 2, 3|
1 nombre enter o coma flotant
2 cadena
3 expressi¨® regular
4 JSONPath o XML XPath
5 enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)
6 macro d'usuari
7 El model de Prometheus segueix 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. 8 Prometheus mostra la seg¨¹ent sintaxi: <nom de l'etiqueta> (pot ser una macro d'usuari) si etiqueta est¨¤ seleccionada com a segon par¨¤metre.
9 Una de les funcions agregades: sum, min, max, avg, count si function est¨¤ seleccionat com a segon par¨¤metre. 10 Admet diversos "Nom de camp,prefix OID,Registre de format" registres separtas per un car¨¤cter de nova l¨ªnia.