Documentation
Table of Contents
2 Preprocessament del valor de l'element
Vista general
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.
Les transformacions s'executen en l'ordre en qu¨¨ es defineixen. 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 regles de preprocessament es defineixen a la pestanya Preprocessament del formulari ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'element.
Un element es convertir¨¤ en no suportat si alguna de les passes de preprocessament falla, tret que s'hagi especificat la gesti¨® d'errors personalitzada mitjan?ant una opci¨® Personalitzada en cas d'error per a les transformacions admeses.
Per als elements del registre, les metadades del registre (sense valor) sempre restabliran l'estat no adm¨¨s de l'element i tornaran a ser compatible amb l'element, fins i tot si l'error inicial es va produir despr¨¦s de rebre un valor de registre de l'agent.
Tant les macros d'usuari com les macros d'usuari amb context s¨®n compatibles amb:
- els par¨¤metres de preprocessament del valor de l'element, incl¨°s el codi JavaScript;
- par¨¤metres personalitzables de gesti¨® d'errors (camps Establir valor a i Establir error a; des de Áú»¢¶Ä²© 6.4.10).
El context s'ignora quan es substitueix una macro pel seu valor. El valor de la macro s'insereix tal com ¨¦s al codi, no ¨¦s possible afegir una escapada addicional abans de posar valor al codi JavaScript. Tingueu en compte que aix¨° pot provocar errors de JavaScript en alguns casos.
|Tipus|<|<| |-|-----------|-------------------------------------- ----| | |°Õ°ù²¹²Ô²õ´Ú´Ç°ù³¾²¹³¦¾±¨®|¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®| |Text|<|<| | |Expressi¨® regular|Fa coincidir el valor amb l'expressi¨® regular <±è²¹³Ù°ù¨®> i substitueix el valor per <sortida>. L'expressi¨® regular permet extreure un m¨¤xim de 10 grups capturats amb la seq¨¹¨¨ncia \N. Si el valor d'entrada no coincideix, l'element no ser¨¤ compatible.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
±è²¹³Ù°ù¨® - expressi¨® regular
sortida - ±è²¹³Ù°ù¨® de format de sortida. Una seq¨¹¨¨ncia d'escapada \N (on N=1...9) es substitueix pel grup en¨¨ssim corresponent. Una seq¨¹¨¨ncia d'escapada \0 es substitueix pel text corresponent.
Consulteu la secci¨® expressions regulars per veure alguns exemples existents.
Si marqueu el Personalitzat en cas d'error , l'element no ser¨¤ compatible si la passa de preprocessament falla i ¨¦s possible especificar opcions de gesti¨® d'errors personalitzades: per ignorar el valor o per establir un valor especificat, o per establir un missatge d'error especificat.| |^|Reempla?a|Cerqueu la cadena de cerca i substitu?u-la per una altra (o per res). Es substituiran totes les ocurr¨¨ncies de la cadena de cerca.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
cadena de cerca - la cadena a cercar i substituir, distingeix entre maj¨²scules i min¨²scules (obligatori)
** substituir** - la cadena a substituir amb la cadena de cerca. La cadena de substituci¨® tamb¨¦ pot ¨¦sser buida, la qual cosa permet esborrar la cadena de cerca quan la trobi.
?s possible emprar seq¨¹¨¨ncies d'escapada per cercar o substituir salts de l¨ªnia, retorns de carro, tabulacions i espais "\n \r \ t \s"; la barra invertida es pot escapar com a "\\" i les seq¨¹¨¨ncies d'escapament es poden escapar com a "\\n". Els salts de l¨ªnia, els retorns de carro i les pestanyes s'escapen autom¨¤ticament durant la descoberta de baix nivell.| |^|Retallar|Esborra els car¨¤cters especificats al principi i al final del valor.| |^|Retalla a la dreta|Esborra els car¨¤cters especificats del final del valor.| |^|Retalla a l'esquerra|Esborra els car¨¤cters especificats del principi del valor.| |Dades estructurades|<|<| | |XPath XML|Extreu valor o fragment de dades XML mitjan?ant la funcionalitat XPath.
Per tal que aquesta opci¨® funcioni, el servidor Áú»¢¶Ä²© s'ha de compilar amb suport libxml.
Exemples:< br>number(/document/item /value) extreu 10 de <document><item><value>10</value></item></document>number(/document/item/@attribute) extreu 10 de <document><item attribute="10"></item></document>/document/item extreu <item><value> 10</value></item> de <document><item><value>10</value></item></document>
Tingueu en compte que els espais de noms no s¨®n compatibles.
Si marqueu la casella de selecci¨® Personalitzat en cas d'error, l'element no ser¨¤ compatible si la passa de preprocessament falla i ¨¦s possible especificar errors d'opcions de gesti¨® personalitzades: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |^|JSONPath|Extreu el valor o el fragment de les dades JSON mitjan?ant la funcionalitat JSONPath.
Si marqueu el Personalitzat en error, l'element no s'admetr¨¤ si la passa de preprocessament falla i ¨¦s possible especificar opcions de gesti¨® d'errors personalitzades: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |^|CSV a JSON|Convertir les dades del fitxer CSV al format JSON.
Per obtindre m¨¦s informaci¨®, consulteu: Preprocessament de CSV a JSON.| |^|XML a JSON|Convertir dades en format XML a JSON.
Per obtindre m¨¦s informaci¨®, veieu: Regles de serialitzaci¨®.
Si marqueu la casella Personalitzat en cas d'error, l'element no ser¨¤ compatible si la passa de preprocessament falla i ¨¦s possible especificar errors d'opcions de gesti¨® personalitzades: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |SNMP|<|<| | |Valor SNMP Walk|Extreu el valor pel nom OID/MIB especificat i apliqueu les opcions de format:
Sense modificar - retorna la cadena hexadecimal com a cadena hexadecimal sense escapar;
UTF-8 des de hexadecimal- STRING: converteix la cadena hexadecimal en una cadena UTF-8;
MAC des de hex-STRING - valida la cadena hexadecimal com a adre?a MAC i retorna una cadena d'adre?a MAC adequada (on ' ' es substitueix per ':');
Enter de BITS - converteix els primers 8 octets d'una cadena de bits expressada com una seq¨¹¨¨ncia de car¨¤cters hexadecimals (per exemple, "1A 2B 3C 4D") en un nombre enter sense signe de 64 bits. En les cadenes de bits de m¨¦s de 8 octets, els octets conseq¨¹ents s'ignoraran.
Si marqueu la casella de selecci¨® Personalitzat en cas d'error, ¨¦s possible triar 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'un pas de preprocessament fallit, l'element no ser¨¤ compatible si se selecciona l'opci¨® per descartar el valor o establir un valor especificat.| | |SNMP walk to JSON|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 del cam¨ª d'acc¨¦s SNMP OID especificat.
Podeu emprar aquesta passa de preprocessament per a SNMP OID discovery.
Opcions de format de valors semblants com a a la passa Valor de walk SNMP s¨®n disponibles.
Si marqueu la casella de selecci¨® Personalitzat en cas d'error, ¨¦s possible triar 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 se selecciona l'opci¨® per descartar el valor o establir un valor especificat.| |Aritm¨¨tica|<|<| | |Multiplicador personalitzat|Multiplica el valor per l'enter o el valor de coma flotant especificat.
Fes servir aquesta opci¨® per convertir els valors rebuts a Ko, Mops, etc. en o, ops. En cas contrari, Áú»¢¶Ä²© no pot establir correctament prefixos (K, M, G, etc.).
Tingueu en compte que si el tipus d'element de dades ¨¦s Num¨¨ric (sense signe), els valors entrants es retallaran amb una part fraccion¨¤ria (¨¦s a dir, "0,9" es convertir¨¤ en "0") abans que s'apliqui el multiplicador personalitzat.
Suport: notaci¨® cient¨ªfica, per exemple, "1e+70" (des de la versi¨® 2.2); macros d'usuari i macros LLD (des de la versi¨® 4.0); cadenes que inclouen macros, per exemple, {#MACRO}e+10, {$MACRO1}e+{$MACRO2} (des de la versi¨® 5.2.3)
Les macros s'han de resoldre en un nombre enter o flotant.< br>Si marqueu la casella de selecci¨® Personalitzat en cas d'error, l'element no ser¨¤ compatible si la passa de preprocessament falla i ¨¦s possible especificar opcions per al tractament d'errors personalitzats: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |Canvi|<|<| | |Canvi simple|Calculeu la difer¨¨ncia entre el valor actual i el valor anterior.
S'avalua com a valor-valor_anterior, on
valor - valor actual; valor_precedent - valor rebut anteriorment
Aquest par¨¤metre pot ser ¨²til per mesurar un valor que augmenta constantment. Si el valor actual ¨¦s inferior al valor anterior, Áú»¢¶Ä²© ignora aquesta difer¨¨ncia (no emmagatzema res) i espera un altre valor.
Nom¨¦s es permet una operaci¨® d'edici¨® per element.
Si marqueu Personalitzar en cas d'error , l'element no ser¨¤ compatible si la passa de preprocessament falla i ¨¦s possible especificar opcions de gesti¨® d'errors personalitzades: per ignorar el valor o per establir un valor especificat, o per establir un missatge d'error especificat.| |^|Canvi per segon|Calculeu la taxa de canvi de valor (difer¨¨ncia entre el valor actual i anterior) per segon.
Avaluat com a (valor-valor_anterior)/(temps-hora_anterior), on
valor - valor actual; previous_value - valor rebut anteriorment; time - marca de temps actual; time_previous - marca de temps del valor anterior.
Aquest par¨¤metre ¨¦s molt ¨²til per obtindre la velocitat per segon per a un valor que augmenta constantment. Si el valor actual ¨¦s inferior al valor anterior, Áú»¢¶Ä²© ignora aquesta difer¨¨ncia (no emmagatzema res) i espera un altre valor. Aix¨° permet que funcioni b¨¦, per exemple, amb embolcall de comptador SNMP de 32 bits (desbordament).
Nota - Com que aquest c¨¤lcul pot produir nombres de coma flotant, es recomana establir el "Tipus d'informaci¨®" a Num¨¨ric (flotant), fins i tot si els valors en brut entrants s¨®n nombres enters. Aix¨° ¨¦s especialment rellevant per a nombres petits on la part decimal compta. Si els valors de coma flotant s¨®n grans i poden superar la longitud del camp "float", en aquest cas es pot perdre el valor sencer, en realitat es recomana emprar Num¨¨ric (sense signe) i, per tant, esborrar nom¨¦s la part decimal .
Nom¨¦s es permet una operaci¨® d'edici¨® per element.
Si marqueu la casella de selecci¨® Personalitzat en cas d'error, l'element no ser¨¤ compatible si la passa de preprocessament i ¨¦s possible especificar opcions de gesti¨® d'errors personalitzades: ignora el valor, estableix un valor especificat o estableix un missatge d'error especificat.| |Sistemes digitals|<|<| | |Boole¨¤ a decimal|Converteix el valor del format boole¨¤ a decimal. La representaci¨® textual ¨¦s tradu?da com a 0 o 1. Per tant, "TRUE" s'emmagatzema com a 1 i "FALSE" s'emmagatzema com a 0. Tots els valors coincideixen si no distingeixen entre maj¨²scules i min¨²scules. Els valors reconeguts actualment s¨®n, per a:
TRUE - true, t, yes, y, on, up, running, enabled, available, ok, master
FALSE - false, f, no, n , off, down, unused, disabled, unavailable, err, slave
A m¨¦s, qualsevol valor num¨¨ric diferent de zero es considera TRUE i zero es considera FALSE. L'element no ser¨¤ compatible si la passa de preprocessament falla, i ¨¦s possible especificar opcions de gesti¨® d'errors personalitzades: per ignorar el valor o per establir un valor especificat, o per establir un missatge d'error especificat.| |^|Octal a Decimal|Converteix el valor del format octal a decimal.
Si marqueu la casella Personalitzat en cas d'error, l'element no quedar¨¤ incompatible si la passa de preprocessament fall¨¦s i ¨¦s possible especificar-lo. Opcions de gesti¨® d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|Hexadecimal a Decimal|Converteix el valor del format hexadecimal a decimal.
Si marqueu la casella Personalitzat en cas d'error, l'element no ser¨¤ compatible si falla la passa de preprocessament i ¨¦s possible especificar-lo. Opcions de gesti¨® d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |Scripts personalitzats|<|<| | |JavaScript|Introdu?u el codi JavaScript al bloc que apareix quan feu clic al camp de par¨¤metres o a una icona de llapis.
Tingueu en compte que la longitud de JavaScript disponible dep¨¨n de la base de dades emprada.
Per obtindre m¨¦s informaci¨®, veieu: Preprocessament de Javascript.| |Validaci¨®|<|<| | |A l'interval|Definiu un interval dins del qual un valor ha de caure especificant valors m¨ªnims/m¨¤xims (inclosos).
S'accepten valors num¨¨rics (incloent qualsevol nombre de d¨ªgits, part decimal opcional i part exponencial opcional, valors negatius). Es poden emprar macros d'usuari i macros de descoberta de baix nivell. El valor m¨ªnim ha d'¨¦sser inferior al valor m¨¤xim.
Ha d'existir com a m¨ªnim un valor.
Si marqueu la casella de selecci¨® Personalitzat en cas d'error, l'element no quedar¨¤ incompatible en cas d'error de la passa de preprocessament i ¨¦s possible especificar opcions personalitzades de gesti¨® d'errors: per ignorar el valor, o per establir un valor especificat, o per establir un missatge d'error especificat.| |^|Coincideix amb l'expressi¨® regular|Especifiqueu una expressi¨® regular amb la qual ha de coincidir un valor.
Si marqueu la casella de selecci¨® Personalitzat en cas d'error, l'element no ser¨¤ compatible si la passa de preprocessament falla i ¨¦s possible especificar-lo. Opcions de gesti¨® d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|No coincideix amb l'expressi¨® regular|Especifiqueu una expressi¨® regular amb la qual un valor no ha de coincidir.
Si marqueu la casella Personalitzat en cas d'error, l'element no ser¨¤ compatible si la passa de preprocessament falla i ¨¦s possible especificar opcions de gesti¨® d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|Cerqueu un error al JSON|Cerqueu un missatge d'error a nivell d'aplicaci¨® situat al JSONpath. Atura el processament si t¨¦ ¨¨xit i si el missatge no ¨¦s buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquesta passa de preprocessament. Tingueu en compte que aquests errors de servei extern s'informaran a l'usuari tal qual, sense afegir informaci¨® sobre la passa de preprocessament.
No s'informar¨¤ d'errors si l'an¨¤lisi de JSON no v¨¤lid falla.< br>Si marqueu la casella Personalitzat en cas d'error, l'element no ser¨¤ compatible si la passa de preprocessament falla i ¨¦s possible especificar opcions de gesti¨® d'errors personalitzades: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |^|Cerca un error a l'XML|Cerca un missatge d'error a nivell d'aplicaci¨® situat a XPath. Atura el processament si t¨¦ ¨¨xit i si el missatge no ¨¦s buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquesta passa de pretractament. Tingueu en compte que aquests errors de servei extern s'informen a l'usuari tal qual, sense afegir informaci¨® sobre la passa de preprocessament.
No s'informar¨¤ d'error si l'an¨¤lisi d'un XML no v¨¤lid falla.
Si marqueu la casella de selecci¨® Personalitzat en cas d'error, l'element no quedar¨¤ incompatible si la passa de preprocessament falla i ¨¦s possible especificar opcions personalitzades per a la gesti¨® d'errors: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |^|Cerca un error mitjan?ant una expressi¨® regular|Cerca un missatge d'error a nivell d'aplicaci¨® mitjan?ant una expressi¨® regular. Atura el processament si t¨¦ ¨¨xit i si el missatge no ¨¦s buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquest pas de preprocessament. Tingueu en compte que aquests errors de servei extern s'informen a l'usuari tal qual, sense afegir informaci¨® sobre la passa de preprocessament.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
±è²¹³Ù°ù¨® - expressi¨® regular
sortida - ±è²¹³Ù°ù¨® de format de sortida. Una seq¨¹¨¨ncia d'escapada \N (on N=1...9) es substitueix pel grup en¨¨ssim corresponent. Es substitueix una seq¨¹¨¨ncia d'escapada \0 pel text corresponent.
Si marqueu la casella Personalitzat en cas d'error, l'element no quedar¨¤ incompatible en cas d'error de la passa de preprocessament i ¨¦s possible especificar opcions de gesti¨® d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|Comprova si un valor no ¨¦s compatible|Comprova si hi ha hagut un error en recuperar el valor de l'element. Normalment aix¨° comportaria que l'element no s'admet¨¦s, per¨° podeu canviar aquest comportament especificant les opcions de gesti¨® d'errors Personalitzat en cas d'error: ignorar el valor, establir un valor especificat (en aquest cas, l'element es mantindr¨¤ compatible i el valor es pot emprar en triggers) o establir un missatge d'error especificat. Tingueu en compte que per a aquesta passa de preprocessament, la casella de selecci¨® Personalitza en cas d'error ¨¦s en gris i sempre marcada.
Aquesta passa sempre s'executa com a primera passa de preprocessament i es posa per sobre de tots els altres despr¨¦s de desar els canvis a l'element. Nom¨¦s es pot emprar una vegada.
Adm¨¨s des de la versi¨® 5.2.0.| |Escanyament|<|<| | |Descartar sense canvis|Ignorar un valor si no ha canviat.
Si s'ignora un valor, no es desa a la base de dades i el servidor Áú»¢¶Ä²© no sap que aquest valor s'ha canviat. No s'avaluar¨¤ cap trigger i, per tant, no es crearan ni resoldran problemes relacionats amb els triggers. Les funcions nom¨¦s funcionaran en funci¨® de les dades realment desades a la base de dades. Com que les tend¨¨ncies es creen a partir de les dades de la base de dades, si no hi ha cap valor registrat durant una hora, tampoc no hi haur¨¤ dades de tend¨¨ncies per a aquesta hora.
Nom¨¦s es pot especificar una opci¨® d'acceleraci¨® per a un element.
Tingueu en compte que ¨¦s possible per als elements monitorats pel proxy Áú»¢¶Ä²© que les difer¨¨ncies de valor molt petites (menys de 0,000001) no s'esborrin correctament pel proxy, per¨° s'emmagatzemen a l'historial amb el mateix valor excepte si la base de dades de Áú»¢¶Ä²© s'ha [actualitzat] (/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values).| |^|Descartar sense canvis amb el bit de vida|Ignoreu un valor si no ha canviat en el per¨ªode de temps especificat (en segons).
S'admeten valors enters positius per especificar segons (m¨ªnim - 1 segon). Els sufixos de temps es poden emprar en aquest camp (per exemple, 30 s, 1 m, 2 h, 1 d). En aquest camp es poden emprar macros d'usuari i macros de descoberta de baix nivell.
Si s'ignora un valor, no es desa a la base de dades i el servidor Áú»¢¶Ä²© no sap que s'ha rebut aquest valor. No s'avaluar¨¤ cap trigger i, per tant, no es crearan ni resoldran problemes relacionats amb els triggers. Les funcions nom¨¦s funcionaran en funci¨® de les dades realment desades a la base de dades. Com que les tend¨¨ncies es creen a partir de les dades de la base de dades, si no hi ha cap valor registrat durant una hora, tampoc no hi haur¨¤ dades de tend¨¨ncies per a aquesta hora.
Nom¨¦s es pot especificar una opci¨® d'acceleraci¨® per a un element.
Tingueu en compte que nom¨¦s ¨¦s possible per als elements monitorats pel proxy Áú»¢¶Ä²© les difer¨¨ncies de valors petites (menys de 0,000001) no s'esborren correctament pel proxy, per¨° s'emmagatzemen a l'historial amb el mateix valor excepte si la base de dades de Áú»¢¶Ä²© s'ha [actualitzat] (/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values).| |Prometheus|<|<| | |Patr¨® de Prometheus|Empreu la consulta seg¨¹ent per extreure les dades necess¨¤ries de les m¨¨triques de Prometheus.
Consulteu les comprovacions de Prometheus per obtindre m¨¦s informaci¨®.| |^|Prometheus a JSON|Convertiu les m¨¨triques de Prometheus requerides a JSON.
Consulteu les comprovacions de Prometheus per obtindre m¨¦s informaci¨®.|
Per modificar i limitar les passes de preprocessament, Áú»¢¶Ä²© ha de recordar el darrer valor per calcular/comparar el nou valor segons sigui necessari. Aquests valors anteriors els gestiona el gestor de preprocessament. Si es reinicia el servidor o el proxy Áú»¢¶Ä²© o es fan canvis a les passes de preprocessament, es restableix el darrer valor de l'element corresponent, donant lloc a:
- per a passes Canvi ¨²nic, Canvi per segon: el valor seg¨¹ent s'ignorar¨¤ perqu¨¨ no hi ha cap valor anterior per calcular el canvi;
- per a les passes Descartar el que no ha canviat, Descartar sense canvis amb bit viu: el valor seg¨¹ent no s'esborrar¨¤ mai, encara que hauria d'haver sigue a causa de regles d'esborrat.
El par¨¤metre 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.
Si empreu un multiplicador personalitzat o un valor d'emmagatzematge com ara Canvis per segon per als elements amb el tipus d'informaci¨® establert a Num¨¨ric (sense signe) i el valor calculat resultant ¨¦s en realitat un nombre flotant, el valor calculat encara s'admet com el valor correcten esborrant la part decimal i emmagatzemant el valor com a nombre enter.
Prova
La prova de les passes de preprocessament ¨¦s ¨²til per assegurar-se que les canalitzacions complexes de preprocessament produeixen els resultats esperats, sense esperar que el valor de l'article sigui rebut i preprocessat.
Es pot provar:
- amb un valor hipot¨¨tic
- amb un valor real d'equip
Cada passa de preprocessament es pot provar individualment i totes les passes es poden provar plegades. Quan feu clic al bot¨® Prova o Prova totes les passes respectivament al bloc Accions, s'obre una finestra de prova.
Provar un valor hipot¨¨tic
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|
| Obtindre valor de l'equip | Si voleu provar un valor hipot¨¨tic, deixeu aquesta casella sense marcar. Veieu tamb¨¦: Prova del valor real. |
| Valor | Introdu?u el valor d'entrada a provar. Fent clic al camp del par¨¤metre o al bot¨® de visualitzaci¨®/edici¨® s'obrir¨¤ una finestra de quadre de text per introduir el valor o el bloc de codi. |
| No adm¨¨s | Marqueu aquesta casella per comprovar si hi ha un valor no adm¨¨s. Aquesta opci¨® ¨¦s ¨²til per provar la passa de preprocessament Comprova si hi ha valors no compatibles. |
| Hora | Es mostra l'hora del valor d'entrada: ara (nom¨¦s lectura). |
| Valor anterior | Introdu?u un valor d'entrada anterior per comparar. Nom¨¦s per les passes de preprocessament Canvi simple i Acelerador. |
| Hora anterior | Introdu?u l'hora del valor d'entrada anterior per comparar. Nom¨¦s per les passes de preprocessament Canvi simple i Throttle. El valor predeterminat es basa en el valor del camp "Interval d'actualitzaci¨®" de l'element. (si ¨¦s "1m", aquest camp s'omple amb "ara-1m"). Si no s'especifica res o l'usuari no t¨¦ acc¨¦s a l'equip, el valor per defecte ¨¦s now-30s. |
| Macros | Si s'empren macros, s'enumeren amb els seus valors. Els valors es poden editar amb finalitats de prova, per¨° els canvis nom¨¦s es desaran en el context de la prova. |
| Seq¨¹¨¨ncia de final de l¨ªnia | Seleccioneu la seq¨¹¨¨ncia de final de l¨ªnia per als valors d'entrada de diverses l¨ªnies: LF - Seq¨¹¨¨ncia LF (salt de l¨ªnia) CRLF - Seq¨¹¨¨ncia CRLF (retorn de carro -alimentaci¨® de l¨ªnia). |
| Passes de preprocessament | Es llisten les passes de preprocessament; el resultat de la prova es mostra per a cada passa despr¨¦s de fer clic al bot¨® Prova. Des de Áú»¢¶Ä²© 6.4.16, els resultats dels tests es trunquen a una mida m¨¤xima de 512Ko whan s'envien al frontend. Si s'escur?a algun resultat, es veur¨¤ una icona d'av¨ªs. La descripci¨® de l'av¨ªs es veu passant-t'hi el ratol¨ª per damunt. Fixeu-vos que la informaci¨® de m¨¦s de 512Ko encara es processa al servidor Áú»¢¶Ä²©. Si la passa ha fallat, es mostra una icona d'error. La descripci¨® de l'error es mostra al passar el ratol¨ª. Si s'especifica "Personalitzat en cas d'error" per la passa i es realitza l'acci¨®, apareix una l¨ªnia nova just despr¨¦s de la l¨ªnia de la passa de prova de preprocessament, que indica quina acci¨® s'ha realitzat i quin resultat produeix (error o valor). |
| Resultat | El resultat final de la prova de les passes de preprocessament es mostra en tots els casos quan totes les passes es comencen a provar (quan feu clic al bot¨® Prova totes les passes). Des de Áú»¢¶Ä²© 6.4.16, els resultats dels tests es trunquen a una mida m¨¤xima de 512Ko whan s'envien al frontend. Si s'escur?a algun resultat, es veur¨¤ una icona d'av¨ªs. La descripci¨® de l'av¨ªs es veu passant-t'hi el ratol¨ª per damunt. Fixeu-vos que la informaci¨® de m¨¦s de 512Ko encara es processa al servidor Áú»¢¶Ä²©. El tipus de conversi¨® a l'element tamb¨¦ mostra el tipus de valor, per exemple Resultat convertit a num¨¨ric (sense signe). |
Feu clic a Prova per veure el resultat despr¨¦s de cada passa de preprocessament.
Els valors de prova s'emmagatzemen entre sessions de prova per a passes individuals o totes les passes, permetent a l'usuari canviar les passes de preprocessament o la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'element i despr¨¦s tornar a la finestra de prova sense haver de tornar a introduir informaci¨®. Tanmateix, els valors es perden durant una actualitzaci¨® de la p¨¤gina.
Les proves les realitza el servidor Áú»¢¶Ä²©. El frontend envia una petici¨® corresponent al servidor i espera el resultat. La petici¨® cont¨¦ el valor d'entrada i les passes de preprocessament (amb macros d'usuari ampliades). Per a les etapes Canvi i Accelerador, es pot especificar un valor i una hora anteriors opcionals. El servidor respon amb resultats per a cada passa de preprocessament.
Qualsevol error t¨¨cnic o error de validaci¨® d'entrada es mostra al quadre d'error a la part superior de la finestra de prova.
Provant valors reals
Per provar el preprocessament amb un valor real:
- Marqueu la casella de selecci¨® Obtindre el valor de l'equip
- Introdu?u o verifiqueu els par¨¤metres de l'equip (adre?a de l'equip, port, nom proxy) i detalls espec¨ªfics de l'element (com les credencials de seguretat de la comunitat SNMPv2 o SNMPv3). Aquests camps tenen en compte el context:
- Els valors s'emplenen pr¨¨viament quan sigui possible, ¨¦s a dir, per als articles que requereixen un agent, prenent la informaci¨® de la interf¨ªcie triada de l'agent de l'equip
- Els valors s'han d'omplir manualment per als elements de plantilla
- Es resolen els valors de macro de text pla
- Camps on el valor (o part del valor) ¨¦s un secret o les macros de Vault s¨®n buides i s'han d'introduir manualment. Si el par¨¤metre d'element cont¨¦ un valor de macro secret, es veur¨¤ el seg¨¹ent missatge d'av¨ªs: "L'element cont¨¦ macros definides per l'usuari amb valors secrets. S'han d'introduir a m¨¤ els valors d'aquestes macros".
- Els camps es desactiven quan no s¨®n necessaris en el context del tipus d'element (per exemple, l'adre?a de l'equip i els camps de proxy es desactiven per als elements calculats)
- Feu clic a Obtindre valor i prova per provar el preprocessament
Si heu especificat una assignaci¨® de valors al formulari de ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'element (camp "Mostra el valor"), el di¨¤leg de prova de l'element mostrar¨¤ una altra l¨ªnia despr¨¦s del resultat final, anomenada "Resultat amb mapa de valors aplicat".
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ðs espec¨ªfics per obtindre un valor real d'un equip:
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|
| Obtindre valor de l'equip | Marqueu aquesta casella de selecci¨® per obtindre un valor real de l'equip. |
| Adre?a de l'equip | Introdu?u l'adre?a de l'equip. Aquest camp s'emplena autom¨¤ticament amb l'adre?a de la interf¨ªcie de l'equip de l'element. |
| Port | Introdu?u el port de l'equip. Aquest camp s'emplena autom¨¤ticament pel port de la interf¨ªcie de l'equip de l'element. |
| Camps addicionals per a les interf¨ªcies SNMP (versi¨® SNMP, comunitat SNMP, nom de context, etc.) |
Consulteu la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® del monitoratge SNMP per obtindre informaci¨® addicional i detalls sobre la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® d'una interf¨ªcie SNMP (v1, v2 i v3). Aquests camps s'emplenen autom¨¤ticament des de la interf¨ªcie de l'equip de l'element. |
| Proxy | Especifiqueu el proxy si l'equip ¨¦s monitorat per un proxy. Aquest camp s'emplena autom¨¤ticament pel proxy de l'equip (si n'hi ha). |
Per a la resta de par¨¤metres, veieu la prova hipot¨¨tica de valor anterior.