El preprocessament s'empra per definir regles de transformaci¨® dels valors dels elements rebuts. S¨®n possibles una o m¨¦s transformacions abans de desar a la base de dades.
Hi ha molts usos per a aquesta funcionalitat. ?s possible que vulgueu, per exemple:
Es permeten una o m¨²ltiples transformacions. Les transformacions (passes de preprocessament) s'executen en l'ordre en qu¨¨ es defineixen.
Un element es convertir¨¤ en no suportat si hi ha passes de preprocessament fallen. Aix¨° es pot evitar mitjan?ant el tractament d'errors personalitzats en cas d'error (disponible per a transformacions compatibles), que es pot configurar per descartar el valor o establir un valor especificat.
Per assegurar-vos que la canalitzaci¨® de preprocessament configurada funciona, ¨¦s possible provar-la.
Per als elements de registre, les metadades de registre (sense valor) sempre restabliran l'element en estat no compatible i tornar a fer que sigui compatible, encara que sigui l'error inicial s'hagi produ?t despr¨¦s de rebre un valor de registre de l'agent.
El preprocessament el fa el servidor o proxy Áú»¢¶Ä²© (si els elements s¨®n monitorats per proxy).
Tingueu en compte que tots els valors passats al preprocessament s¨®n de tipus string, la conversi¨® al tipus de valor esperat (tal com es defineix a la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'element) es fa al final de la canalitzaci¨® de preprocessament; no obstant aix¨°, les conversions tamb¨¦ poden tindre lloc si ho requereix la passa de preprocessament corresponent. Veieu detalls del preprocessament per obtindre m¨¦s informaci¨® t¨¨cnica.
Veieu tamb¨¦: Exemples d'¨²s
Les passes de preprocessament es defineixen a la pestanya Preprocessament del formulari ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'element.
Feu clic a Afegir per triar una transformaci¨® admesa.
El camp Tipus d'informaci¨® de l'element es mostra a la part inferior de la pestanya quan es defineix almenys una passa de preprocessament. Si cal, ¨¦s possible modificar el tipus d'informaci¨® sense sortir de la pestanya Preprocessament. Veieu la creaci¨® d'un element per a la descripci¨® detallada dels par¨¤metres.
Totes les transformacions admeses es veuen tot seguit. Feu clic al nom de la transformaci¨® per veure'n tots els detalls.
Nom | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® | Tipus |
---|---|---|
Expressi¨® regular | Fa coincidir el valor amb l'expressi¨® regular i el substitueix amb la sortida requerida. | Text |
Reempla?a | Cerca la cadena de cerca i la substitueix per una altra (o res). | |
Retalla | Esborra els car¨¤cters especificats del principi i el final del valor. | |
Retall dreta | Esborra els car¨¤cters especificats del final del valor. | |
Retall esquerra | Esborra els car¨¤cters especificats del principi del valor. | |
XML XPath | Extreu valor o fragment de dades XML mitjan?ant la funcionalitat XPath. | Dades estructurades |
Cam¨ª JSON | Extreu valor o fragment de dades JSON mitjan?ant la funcionalitat JSONPath. | |
CSV a JSON | Converteix les dades del fitxer CSV a format JSON. | |
XML a JSON | Converteix dades en format XML a JSON. | |
Valor d'SNMP walk | Extreu el valor pel nom OID/MIB especificat i aplica opcions de format. | SNMP |
SNMP walk to JSON | Converteix els valors SNMP a JSON. | |
SNMP get value | Aplica opcions de format al valor SNMP get. | |
Multiplicador personalitzat | Multiplica el valor per l'enter o el valor de coma flotant especificat. | ´¡°ù¾±³Ù³¾¨¨³Ù¾±³¦²¹ |
Canvi simple | Calculeu la difer¨¨ncia entre el valor actual i l'anterior. | Canvi |
Canvi per segon | Calcula el canvi de valor (difer¨¨ncia entre el valor actual i el valor anterior) velocitat per segon. | |
Boole¨¤ a decimal | Convertir el valor de format boole¨¤ a decimal. | Sistemes num¨¨rics |
Octal a decimal | Converteix el valor de format octal a decimal. | |
Hexadecimal a decimal | Converteix el valor de format hexadecimal a decimal. | |
JavaScript | Introdueix el codi JavaScript. | Scripts personalitzats |
En l'interval | Defineix un interval en el qual hauria de ser-hi un valor. | ³Õ²¹±ô¾±»å²¹³¦¾±¨® |
Coincideix amb l'expressi¨® regular | Especifiqueu una expressi¨® regular amb la qual ha de coincidir un valor. | |
No coincideix amb l'expressi¨® regular | Especifiqueu una expressi¨® regular que un valor no ha de coincidir. | |
Comprova si hi ha errors a JSON | Comprova si hi ha un missatge d'error a nivell d'aplicaci¨® situat a JSONPath. | |
Comprova si hi ha errors en XML | Comprova si hi ha un missatge d'error a nivell d'aplicaci¨® situat a XPath. | |
Comprova si hi ha errors mitjan?ant una expressi¨® regular | Comprova si hi ha un missatge d'error a nivell d'aplicaci¨® mitjan?ant una expressi¨® regular. | |
Comprova si hi ha un valor no compatible | Comprova si hi ha hagut un error en recuperar el valor de l'element. | |
Descartar sense canvis | Descartar un valor si no ha canviat. | ´¡³¦³¦±ð±ô±ð°ù²¹³¦¾±¨® |
Descartar sense canvis amb heartbeat | Descartar un valor si no ha canviat dins del per¨ªode de temps definit. | |
Patr¨® de Prometheus | Empreu la consulta seg¨¹ent per extreure les dades necess¨¤ries de les m¨¨triques de Prometheus. | Prometheus |
Prometheus a JSON | Converteix les m¨¨triques de Prometheus necess¨¤ries a JSON. |
Tingueu en compte que per a les passes de preprocessament Canvi i ´¡³¦³¦±ð±ô±ð°ù²¹³¦¾±¨®, Áú»¢¶Ä²© ha de recordar el darrer valor per calcular/comparar el nou valor segons sigui necessari. Aquests valors anteriors s¨®n gestionats pel preprocessament gerent. Si es reinicia el servidor o el proxy Áú»¢¶Ä²© o hi ha algun canvi fet a les passes de preprocessament, el darrer valor de l'element corresponent ¨¦s restableix, resultant en:
Relacioneu el valor amb l'expressi¨® regular i substitu?u-lo amb la sortida esperada.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
Comentaris:
Cerqueu la cadena de cerca i substitu?u-la per una altra (o res).
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
Comentaris:
Esborra els car¨¤cters especificats del principi i del final del valor.
Esborra els car¨¤cters especificats al final del valor.
Esborra els car¨¤cters especificats al principi del valor.
Extraieu valor o fragment de dades XML mitjan?ant la funcionalitat XPath.
Comentaris:
Exemples:
number(/document/item/value) #will extract '10' from <document><item><value>10</value></item></document>
number(/document/item/@attribute) #will extract '10' from <document><item attribute="10"></item></document>/document/item #will extraur¨¤ '<item><value>10</value></item>' de <document><item><value>10</value></item></document>
Extraeu el valor o fragment de les dades JSON mitjan?ant funcionalitat JSONPath.
Si marqueu la casella de selecci¨® Personalitzar en cas d'error, ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no ser¨¤ compatible si es tria l'opci¨® per descartar el valor o establir un valor especificat.
Converteix les dades del fitxer CSV a format JSON.
Per obtindre m¨¦s informaci¨®, consulteu: Preprocessament de CSV a JSON.
Converteix dades en format XML a JSON.
Per obtindre m¨¦s informaci¨®, consulteu: Regles de serialitzaci¨®.
Si marqueu la casella de selecci¨® Personalitzar en cas d'error, ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no ser¨¤ compatible si es tria l'opci¨® per descartar el valor o establir un valor especificat.
Extreu el valor pel nom OID/MIB especificat i aplica les opcions de format:
' '
es substitueix per ':'
);Si marqueu la casella de selecci¨® Personalitzrt en cas d'error, ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no ser¨¤ compatible si es tria l'opci¨® de descartar el valor o establir un valor especificat.
Converteix els valors SNMP a JSON.
Especifiqueu un nom de camp al JSON i la ruta d'OID SNMP corresponent. Els valors dels camps s'emplenaran amb els valors de la ruta d'OID SNMP especificada.
Comentaris:
Aplica les opcions de formataci¨® al valor d'SNMP get:
' '
es substitueix per ':'
);Si marqueu la casella de selecci¨® Personalitzrt en cas d'error, ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no ser¨¤ compatible si es tria l'opci¨® de descartar el valor o establir un valor especificat.
Multiplica el valor per l'enter o el valor de coma flotant especificat.
Comentaris:
1e+70
; macros d'usuari i macros LLD; cadenes que inclouen macros, com ara {#MACRO}e+10
, {$MACRO1}e+{$MACRO2}
. Les macros s'han de resoldre en un nombre enter o en coma flotant.Calcula la difer¨¨ncia entre el valor actual i l'anterior.
Comentaris:
Calcula la velocitat de canvi de valor (difer¨¨ncia entre el valor actual i anterior) per segon.
Comentaris:
Converteix el valor de format boole¨¤ a decimal.
Comentaris:
Converteix el valor de format octal a decimal.
Si marqueu la casella de selecci¨® Personalitzar en cas d'error, ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no ser¨¤ pas compatible si es tria l'opci¨® per descartar el valor o establir un valor especificat.
Converteix el valor de format hexadecimal a decimal.
Si marqueu la casella de selecci¨® Personalitzar en cas d'error, ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no ser¨¤ pas compatible si es tria l'opci¨® per descartar el valor o establir un valor especificat.
Introdu?u el codi JavaScript a l'editor modal que s'obre quan cliquem al camp de par¨¤metres, o a la icona de text del ll¨¤pis que hi ha al costat.
Comentaris:
Defineix un interval en el qual hi hauria d'haver un valor especificant valors m¨ªnims/m¨¤xims (inclosos).
Comentaris:
Defineix una expressi¨® regular que ha de coincidir amb el valor.
Si marqueu la casella de selecci¨® Personalitzar en cas d'error, ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no ser¨¤ pas compatible si es tria l'opci¨® per descartar el valor o establir un valor especificat.
Defineix una expressi¨® regular que no ha de coincidir amb el valor.
Si marqueu la casella de selecci¨® Personalitzar en cas d'error, ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no ser¨¤ pas compatible si es tria l'opci¨® per descartar el valor o establir un valor especificat.
Comproveu si hi ha un missatge d'error a nivell d'aplicaci¨® situat a JSONPath. Atura el processament si s'ha realitzat correctament i el missatge no ¨¦s buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquesta passa de preprocessament.
Comentaris:
Comproveu si hi ha un missatge d'error a nivell d'aplicaci¨® situat a XPath. Atura el processament si s'ha realitzat correctament i el missatge no ¨¦s buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquesta passa de preprocessament.
Comentaris:
Comprova si hi ha un missatge d'error a nivell d'aplicaci¨® mitjan?ant una expressi¨® regular. Atura el processament si s'ha fet correctament i el missatge no est¨¤ buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquesta passa de preprocessament.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
Comentaris:
Comprova si no s'ha pogut recuperar cap valor de l'element. Especifiqueu com s'ha de processar l'error, basant-se en la inspecci¨® del missatge d'error retornat.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
Comentaris:
Descarta un valor si no ha canviat.
Comentaris:
Descarta un valor si no ha canviat dins del per¨ªode de temps definit (en segons).
Comentaris:
Empreu la consulta seg¨¹ent per extreure les dades necess¨¤ries de les m¨¨triques de Prometheus.
Consulteu Comprovacions de Prometheus per a m¨¦s detalls.
Converteix la m¨¨trica Prometeus especificada a JSON.
Consulteu Comprovacions de Prometheus per a m¨¦s detalls.
Macros d'usuari i macros d'usuari amb context s'admeten a:
El context de la macro s'ignora quan se substitueix una macro pel seu valor. El valor de la macro s'insereix al codi tal com ¨¦s, no es pot afegir escapament addicional abans de col¡¤locar el valor al codi JavaScript. Tingueu en compte que aix¨° pot provocar errors de JavaScript en alguns casos.
Veieu proves de preprocessament.