Áú»¢¶Ä²©

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.

Hi ha molts usos per a aquesta funcionalitat. ?s possible que vulgueu, per exemple:

  • multipliqcar el valor del tr¨¤nsit de xarxa per "8" per convertir octets en bits;
  • obtindre les estad¨ªstiques per segon d'un valor creixent;
  • aplicar una expressi¨® regular al valor;
  • emprar un script personalitzat sobre el valor;
  • descartar els valors sense canvis.

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.

Transformaci¨® admesa

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:

  • per a passes Canvi simple, Canvi per segon - el valor seg¨¹ent s'ignora perqu¨¨ no hi ha cap valor anterior des d'on calcular el canvi;
  • per a passes Descartar sense canvis, Descartar sense canvis amb heartbeat - el valor seg¨¹ent no es descartar¨¤ mai, encara que ho hauria d'haver-hi estat a causa de les normes de descart.
Expressi¨® regular

Relacioneu el valor amb l'expressi¨® regular i substitu?u-lo amb la sortida esperada.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

  • ±è²¹³Ù°ù¨® - l'expressi¨® regular;
  • sortida - la plantilla de format de sortida. Una seq¨¹¨¨ncia d'escapada \N (on N=1...9) es substitueix per l'en¨¨ssim grup coincident. Una seq¨¹¨¨ncia d'escapada \0 es substitueix pel text coincident.

Comentaris:

  • Si no coincideix amb el valor d'entrada, l'element no ser¨¤ pas compatible;
  • L'expressi¨® regular admet l'extracci¨® d'un m¨¤xim de 10 grups capturats amb la seq¨¹¨¨ncia \N;
  • Si marqueu la casella de selecci¨® Personalitzat 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 cas d'un pas de preprocessament fallit, l'element no ser¨¤ compatible si es tria l'opci¨® per descartar el valor o establir un valor especificat.
  • Consulteu la secci¨® expressions regulars per veure alguns exemples.
Substitueix

Cerqueu la cadena de cerca i substitu?u-la per una altra (o res).

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

  • cadena de cerca - la cadena a trobar i substituir, distingeix entre maj¨²scules i min¨²scules (obligatori);
  • reempla?ament - la cadena per substituir la cadena de cerca. La cadena de substituci¨® tamb¨¦ pot ¨¦sser buida de manera efectiva, permetent eliminar la cadena de cerca quan es trobi.

Comentaris:

  • Es substituiran totes les ocurr¨¨ncies de la cadena de cerca;
  • ?s possible emprar seq¨¹¨¨ncies d'escapada per cercar o substituir salts de l¨ªnia, retorn 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";
  • L'escapament de salts de l¨ªnia, retorn de carro i pestanyes es fa autom¨¤ticament durant la descoberta de baix nivell.
Retallar

Esborra els car¨¤cters especificats del principi i del final del valor.

Retallar dreta

Esborra els car¨¤cters especificats al final del valor.

Retallar esquerra

Esborra els car¨¤cters especificats al principi del valor.

XML XPath

Extraieu valor o fragment de dades XML mitjan?ant la funcionalitat XPath.

Comentaris:

  • Perqu¨¨ aquesta opci¨® funcioni, el servidor Áú»¢¶Ä²© (o el proxy Áú»¢¶Ä²©) s'ha de compilar amb suport libxml;
  • Els espais de noms no s¨®n compatibles;
  • Si marqueu la casella de selecci¨® Personalitzat 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'un pas de preprocessament fallit, l'element no ser¨¤ compatible si se selecciona l'opci¨® per descartar el valor o establir un valor especificat.

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>
Cam¨ª JSON

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.

CSV a JSON

Converteix les dades del fitxer CSV a format JSON.

Per obtindre m¨¦s informaci¨®, consulteu: Preprocessament de CSV a JSON.

XML 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.

Valor d'SNMP walk

Extreu el valor pel nom OID/MIB especificat i aplica les opcions de format:

  • Sense modificar - retorna la cadena hexadecimal com a cadena hexadecimal sense escapar;
  • UTF-8 de hex-STRING - converteix la cadena hexadecimal en una cadena UTF-8;
  • MAC 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 (p. ex., "1A 2B 3C 4D") a 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¨® 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.

SNMP a peu fins a 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 de la ruta d'OID SNMP especificada.

Comentaris:

  • Hi ha disponibles opcions de format de valor similars a les de la passa Valor d'SNMP walk;
  • Podeu fer servir aquesta passa de preprocessament per a la descoberta d'SNMP OID;
  • Si marqueu la casella de selecci¨® Personalitzat 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.
Valor d'SNMP get

Aplica les opcions de formataci¨® al valor d'SNMP get:

  • UTF-8 de Hex-STRING - converteix la cadena hexadecimal en una cadena UTF-8;
  • MAC 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 (p. ex., "1A 2B 3C 4D") a 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¨® 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.

Multiplicador personalitzat

Multiplica el valor per l'enter o el valor de coma flotant especificat.

Comentaris:

  • Empreu aquesta opci¨® per convertir els valors rebuts en Ko, Mops, etc., en B, Bps. En cas contrari, Áú»¢¶Ä²© no pot establir correctament prefixos (o, M, G, etc.).
  • Tingueu en compte que si el tipus d'informaci¨® d'element ¨¦s Num¨¨ric (sense signe), els valors entrants amb una part fraccional es retallaran (¨¦s a dir, "0,9" es convertir¨¤ en "0") abans que s'apliqui el multiplicador personalitzat;
  • Si empreu un multiplicador personalitzat o un valor emmagatzemat com a Canvi per segon per als articles amb el tipus d'informaci¨® establert a Num¨¨ric (sense signe) i el resultat calculat el valor ¨¦s en realitat un nombre flotant, el valor calculat encara s'accepta com a corregiu-ne un retallant la part decimal i emmagatzemant el valor com a nombre enter;
  • Admet: notaci¨® cient¨ªfica, com ara 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.
  • 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¨® de descartar el valor o establir un valor especificat.
Canvi simple

Calcula la difer¨¨ncia entre el valor actual i l'anterior.

Comentaris:

  • Aquesta passa pot ¨¦sser ¨²til per mesurar un valor en constant creixement;
  • Avaluat com a value-prev_value, on value - el valor actual; prev_value - el valor rebut anteriorment;
  • Nom¨¦s es permet una operaci¨® de canvi per element ("Canvi simple" o "Canvi per segon");
  • Si el valor actual ¨¦s m¨¦s petit que el valor anterior, Áú»¢¶Ä²© descarta aquesta difer¨¨ncia (no emmagatzema res) i espera un altre valor;
  • Si marqueu la casella de selecci¨® Personalitzat 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.
Canvi per segon

Calcula la velocitat de canvi de valor (difer¨¨ncia entre el valor actual i anterior) per segon.

Comentaris:

  • Aquesta passa ¨¦s ¨²til per calcular la velocitat per segon d'un valor en constant creixement;
  • 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 importa. Si els valors de coma flotant s¨®n grans i poden superar la llarg¨¤ria del camp 'float', en aquest cas es pot perdre el valor sencer, en realitat es recomana emprar Num¨¨ric (sense signe) i, per tant, retallar nom¨¦s la part decimal.
  • Avaluat com a (value-prev_value)/(time-prev_time), on value - el valor actual; prev_value - el valor rebut pr¨¨viament; time - la marca de temps actual; prev_time - la marca de temps del valor anterior;
  • Nom¨¦s es permet una operaci¨® de canvi per element ("Canvi simple" o "Canvi per segon");
  • Si el valor actual ¨¦s menor que el valor anterior, Áú»¢¶Ä²© descarta aquesta difer¨¨ncia (no emmagatzema res) i espera un altre valor. Aix¨° ajuda a funcionar correctament, per exemple, amb un embolcall (desbordament) de comptadors SNMP de 32 bits.
  • 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.
De boole¨¤ a decimal

Converteix el valor de format boole¨¤ a decimal.

Comentaris:

  • La representaci¨® textual es tradueix a 0 o 1. Aix¨ª, 'CERT' s'emmagatzema com a 1 i 'FALS' s'emmagatzema com a 0. Tots els valors s'ajusten sense distingir entre maj¨²scules i min¨²scules. Els valors reconeguts actualment s¨®n, per a CERT - true, t, yes, y, on, up, running, enabled, available, ok, master; per a FALS - fals, f, no, n, apagat, avall, sense emprar, desactivat, no disponible, err, esclau. A m¨¦s, qualsevol valor num¨¨ric diferent de zero es considera CERT i zero es considera FALS.
  • 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.
Octal a decimal

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.

Hexadecimal a decimal

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.

JavaScript

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:

Dins l'interval

Defineix un interval en el qual hi hauria d'haver un valor especificant valors m¨ªnims/m¨¤xims (inclosos).

Comentaris:

  • S'admeten valors num¨¨rics (incloent qualsevol nombre de d¨ªgits, part decimal opcional i part exponencial opcional, valors negatius);
  • El valor m¨ªnim ha d'¨¦sser inferior al m¨¤xim;
  • Ha d'existir almenys un valor;
  • Es poden emprar macros d'usuari i macros de descoberta de baix nivell;
  • 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.
Coincideix amb una expressi¨® regular

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.

No coincideix amb una expressi¨® regular

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 errors en JSON

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:

  • Aquests errors de servei extern es notifiquen a l'usuari tal qual, sense afegir informaci¨® sobre la passa de preprocessament;
  • No s'informar¨¤ d'error en cas de fallar en l'an¨¤lisi de JSON no v¨¤lid;
  • 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 errors en XML

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:

  • Aquests errors de servei extern es notifiquen a l'usuari tal qual, sense afegir informaci¨® sobre la passa de preprocessament;
  • No s'informar¨¤ d'error en cas de fallar en l'an¨¤lisi de XML no v¨¤lid;
  • 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.
Comprovar si hi ha errors emprant una expressi¨® regular

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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

  • ±è²¹³Ù°ù¨® - l'expressi¨® regular;
  • sortida - la plantilla de format de sortida. Una seq¨¹¨¨ncia d'escapada \N (on N=1...9) es substitueix per l'en¨¨sim grup coincident. Una seq¨¹¨¨ncia d'escapada \0 es substitueix pel text coincident.

Comentaris:

  • Aquests errors de servei extern es lliuren a l'usuari tal qual, sense afegir informaci¨® sobre la passa de preprocessament;
  • 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.
Comprovar el valor no adm¨¨s

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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

  • abast - trieu l'¨¤mbit de processament d'errors:
    qualsevol error - qualsevol error;
    error coincident - nom¨¦s l'error que coincideix amb l'expressi¨® regular especificada a ±è²¹³Ù°ù¨®;
    * error no coincident* - nom¨¦s l'error que no coincideix amb l'expressi¨® regular especificada a ±è²¹³Ù°ù¨®
  • ±è²¹³Ù°ù¨® - l'expressi¨® regular amb la qual coincideix l'error. Si es tria qualsevol error al par¨¤metre d'abast, aquest camp no es veu. Si es mostra, aquest camp ¨¦s obligatori.

Comentaris:

  • Normalment, l'abs¨¨ncia/no recuperar un valor comportaria que l'element no s'admet. En aquesta passa de preprocessament ¨¦s possible modificar el
    comportament marcant l'opci¨® Personalitzar en cas d'error. Les seg¨¹ents opcions personalitzades de gesti¨® d'errors s¨®n disponibles: Descartar valor, Establir el valor a (el valor es pot emprar a triggers) o Establir error a.
  • L'element es mantindr¨¤ compatible si Descartar el valor o s'ha seleccionat Establir el valor a;
  • Aquesta passa de preprocessament nom¨¦s comprova si no s'ha pogut recuperar cap valor d'element. No verifica, per exemple, si el tipus del valor recuperat (p. ex., cadena) coincideix amb el tipus d'informaci¨® de l'element (p. ex., num¨¨rica). Si hi ha una discrep¨¤ncia de tipus, ¨¦s possible que l'element encara no sigui compatible despr¨¦s d'executar totes les passes de preprocessament. Per comprovar si hi ha una discrep¨¤ncia de tipus, podeu emprar, per exemple, la passa de preprocessament Multiplicador personalitzat; veieu Exemples de preprocessament.
  • La captura de grups d'expressions regulars s'admet als camps Establir el valor a o Establir error a. Una seq¨¹¨¨ncia d'escapada \N (on N=1...9) es substitueix per l'en¨¨sim grup coincident. Una seq¨¹¨¨ncia d'escapada \0 es substitueix pel text coincident.
  • Per a aquest pas de preprocessament, la casella de selecci¨® Personalitzat en cas d'error est¨¤ en gris i sempre marcat;
  • Aquestes passes sempre s'executen com les primeres passes de preprocessament i es posen per sobre de totes les altres despr¨¦s de desar els canvis a l'element.
  • S'admeten diverses passes Comprovar valors no compatibles, en l'ordre especificat. Una passa per a qualsevol error es posar¨¤ autom¨¤ticament com a darrer pas d'aquest grup.
Descartar sense canvis

Descarta un valor si no ha canviat.

Comentaris:

  • Si es descarta 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 expressi¨® de trigger, com a resultat, no es crearan/resolveran cap problema per a triggers relacionats. Les funcions nom¨¦s funcionaran basant-se en les dades que realment es desen 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 desat 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 element.
Descarta sense canvis amb el heartbeat

Descarta un valor si no ha canviat dins del per¨ªode de temps definit (en segons).

Comentaris:

  • S'admeten valors enters positius per especificar els segons (m¨ªnim - 1 segon);
  • Es poden emprar sufixos de temps (com ara 30s, 1m, 2h, 1d);
  • Es poden emprar macros d'usuari i macros de descoberta de baix nivell;
  • Si es descarta 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 expressi¨® trigger, com a resultat, no es crearan/resolveran cap problema per a triggers relacionats. Les funcions nom¨¦s funcionaran basant-se en les dades que realment es desen 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 desat 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 element.
Patr¨® de Prometeu

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.

Prometheus a json

Converteix la m¨¨trica Prometeus especificada a JSON.

Consulteu Comprovacions de Prometheus per a m¨¦s detalls.

Suport de macro

Macros d'usuari i macros d'usuari amb context s'admeten a:

  • par¨¤metres de passa de preprocessament, incl¨°s el codi JavaScript;
  • Par¨¤metres personalitzats de gesti¨® d'errors (camps Establor el valor a i Establir error 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.

Prova

Veieu proves de preprocessament.