Documentation
Table of Contents
Objeto de m¨¦trica
Los siguientes objetos est¨¢n directamente relacionados con la API item.
²Ñ¨¦³Ù°ù¾±³¦²¹
Las m¨¦tricas web no se pueden crear, modificar o borrar directamente mediante la API Áú»¢¶Ä²©.
El objeto de m¨¦trica tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| itemid | ID | ID de la m¨¦trica. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualizaci¨®n |
| delay | cadena | Intervalo de actualizaci¨®n de la m¨¦trica. Acepta segundos o una unidad de tiempo con sufijo (30s,1m,2h,1d). Opcionalmente uno o m¨¢s intervalos personalizados se pueden especificar como intervalos flexibles o programaci¨®n. Varios intervalos est¨¢n separados por un punto y coma. Se pueden utilizar macros de usuario. Una sola macro tiene que llenar todo el campo. No se admiten varias macros en un campo ni macros mezcladas con texto. Los intervalos flexibles se pueden escribir como dos macros separadas por una barra diagonal (por ejemplo, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).<br >Ejemplo: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Comportamiento de la propiedad: - obligatorio si tipo est¨¢ configurado en "Agente Áú»¢¶Ä²©" (0), "Comprobaci¨®n simple" (3), "Áú»¢¶Ä²© interno" (5), "Verificaci¨®n externa" (10), "Monitor de base de datos" (11), "Agente IPMI" (12), "Agente SSH" (13), "Agente TELNET" (14), "Calculado" ( 15), "agente JMX" (16), "agente HTTP" (19), "agente SNMP" (20), "Script" (21), "Browser" (22), o si type est¨¢ configurado como "agente Áú»¢¶Ä²© (activo)" (7) y key_ no contiene "mqtt.get" |
| hostid | ID | ID del equipo o plantilla a la que pertenece la m¨¦trica. Comportamiento de la propiedad: - constante - obligatorio para operaciones de creaci¨®n |
| interfaceid | ID | ID de la interfaz de la m¨¦trica del equipo. Comportamiento de la propiedad: - obligatorio si la m¨¦trica pertenece al equipo y type est¨¢ configurado en "agente Áú»¢¶Ä²©", "agente IPMI", "agente JMX", "Captura SNMP" o "agente SNMP"- soportado si la m¨¦trica pertenece al equipo y el type est¨¢ configurado en "Simple check", "Comprobaci¨®n externa", "Agente SSH", "Agente TELNET" o "Agente HTTP"- solo lectura para objetos descubiertos |
| key_ | cadena | Clave de la m¨¦trica. Comportamiento de la propiedad: - obligatorio para operaciones de creaci¨®n - leer- s¨®lo para objetos heredados u objetos descubiertos |
| name | cadena | Nombre de la m¨¦trica. Comportamiento de la propiedad: - obligatorio para operaciones de creaci¨®n - leer- s¨®lo para objetos heredados u objetos descubiertos |
| name_resolved | cadena | Nombre de la m¨¦trica con las macros de usuario resueltas. Comportamiento de la propiedad: - solo-lectura |
| type | entero | Tipo de m¨¦trica. Valores posibles: 0 - Agente de Áú»¢¶Ä²©; 2 - Captura Áú»¢¶Ä²©; 3 - Comprobaci¨®n simple; 5 - Interno de Áú»¢¶Ä²© ; 7 - Agente Áú»¢¶Ä²© (activo); 9 - Elemento web; 10 - Verificaci¨®n externa; 11 - Monitor de base de datos; 12 - Agente IPMI; 13 - Agente SSH; 14 - Agente TELNET; 15 - Calculado; 16 - Agente JMX; 17 - Captura SNMP; 18 - Elemento dependiente; 19 - Agente HTTP;< br>20 - Agente SNMP; 21 - Script; 22 - Browser. Comportamiento de la propiedad: - obligatorio para las operaciones de creaci¨®n - solo lectura para objetos heredados u objetos descubiertos |
| url | cadena | Cadena URL. Admite macros de usuario, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID} , {ITEM.KEY}. Comportamiento de la propiedad: - obligatorio si tipo est¨¢ configurado como "agente HTTP"<br >- solo lectura para objetos heredados u objetos descubiertos |
| value_type | entero | Tipo de informaci¨®n del elemento. Valores posibles: 0 - ²Ô¨²³¾±ð°ù´Ç flotante; 1 - ³¦²¹°ù¨¢³¦³Ù±ð°ù; 2 - registro; 3 - num¨¦rico sin signo; 4 - texto; 5 - Binario. Comportamiento de la propiedad: - obligatorio para operaciones de creaci¨®n - solo-lectura para objetos heredados u objetos descubiertos |
| allow_traps | entero | Permitir completar el valor de manera similar a la m¨¦trica de captura. 0 - (predeterminado) No permitir aceptar datos entrantes; 1 - Permitir aceptar datos entrantes.< br> Comportamiento de la propiedad: - soportado si type est¨¢ configurado en "Agente HTTP"- solo lectura para objetos descubiertos |
| authtype | entero | M¨¦todo de autenticaci¨®n. Valores posibles si type est¨¢ configurado en "Agente SSH":0 - contrase?a (predeterminada); 1 - clave p¨²blica.<br > Valores posibles si tipo est¨¢ configurado en "Agente HTTP":0 - (predeterminado) ninguno; 1 - b¨¢sico; 2 - NTLM; 3 - Kerberos . Comportamiento de la propiedad: - compatible si type est¨¢ configurado como "agente SSH" o "agente HTTP"- solo lectura para objetos heredados (si tipo est¨¢ configurado en "agente HTTP") u objetos descubiertos |
| description | cadena | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô de la m¨¦trica. Comportamiento de la propiedad: - solo lectura para objetos descubiertos |
| error | cadena | Texto de error si hay problemas al actualizar la m¨¦trica. Comportamiento de la propiedad: - solo lectura |
| flags | entero | Origen de la m¨¦trica. Valores posibles: 0 - una m¨¦trica simple; 4 - una m¨¦trica descubierta. Comportamiento de la propiedad: - solo lectura |
| follow_redirects | entero | Seguir las redirecciones de la respuesta mientras sondea los datos. Valores posibles: 0: no seguir las redirecciones; 1: (predeterminado) Seguir las redirecciones. < br>Comportamiento de la propiedad: - compatible si type est¨¢ configurado como "agente HTTP"- solo lectura para objetos heredados o objetos descubiertos |
| headers | matriz | Matriz de encabezados que se enviar¨¢ al realizar una solicitud HTTP. Comportamiento de la propiedad: - soportada si type est¨¢ configurado en "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| history | cadena | Una unidad de tiempo de la duraci¨®n de los datos duranta la que el historial debe almacenarse. Tambi¨¦n acepta macro de usuario. Valor predeterminado: 31d. Comportamiento de la propiedad: - * solo lectura* para objetos descubiertos |
| http_proxy | cadena | Cadena de conexi¨®n de proxy HTTP(S). Comportamiento de la propiedad: - soportada si type est¨¢ configurado en "Agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| inventory_link | entero | ID del campo de inventario del equipo que se completa con la m¨¦trica. Consulte la p¨¢gina de inventario del equipo para obtener una lista de los campos de inventario de equipo admitidos y sus ID. Valor predeterminado: 0. Comportamiento de la propiedad: - soportada si value_type est¨¢ configurado en "num¨¦rico flotante", "³¦²¹°ù¨¢³¦³Ù±ð°ù", "num¨¦rico sin signo" , o "texto"- solo lectura para objetos descubiertos |
| ipmi_sensor | cadena | Sensor IPMI. Comportamiento de la propiedad : - soportada si type est¨¢ configurado como "agente IPMI" y key_ no est¨¢ configurado como "ipmi.get"- soportada si type est¨¢ configurado como "agente IPMI" - solo lectura para objetos heredados u objetos descubiertos |
| jmx_endpoint | cadena | Cadena de conexi¨®n personalizada del agente JMX. Valor predeterminado: service:jmx:rmi:///jndi/rmi ://{HOST.CONN}:{HOST.PORT}/jmxrmi Comportamiento de la propiedad: - soportada si type est¨¢ configurado en "agente JMX"- solo lectura para objetos descubiertos |
| lastclock | timestamp | Hora en la que se actualiz¨® por ¨²ltima vez el valor de la m¨¦trica. De forma predeterminada, solo los valores que se encuentran dentro dede las ¨²timas 24 horas se muestran. Puede ampliar este per¨ªodo de tiempo cambiando el valor del par¨¢metro Per¨ªodo m¨¢ximo de visualizaci¨®n del historial en la secci¨®n del men¨² Administraci¨®n ¡ú General. Comportamiento de la propiedad: - solo lectura |
| lastns | entero | Nanosegundos cuando el valor de la m¨¦trica se actualiz¨® por ¨²ltima vez. De forma predeterminada, s¨®lo se muestran los valores que se encuentran dentro de las ¨²ltimas 24 horas. Puede ampliar este per¨ªodo de tiempo cambiando el valor del par¨¢metro Per¨ªodo m¨¢ximo de visualizaci¨®n del historial en la secci¨®n del men¨² Administraci¨®n ¡ú General. Comportamiento de la propiedad: - solo lectura |
| lastvalue | cadena | ?ltimo valor de la m¨¦trica. De forma predeterminada, solo los valores que caen en las ¨²ltimas 24 horas. Puede ampliar este per¨ªodo de tiempo cambiando el valor del par¨¢metro Per¨ªodo m¨¢ximo de visualizaci¨®n del historial en la secci¨®n del men¨² Administraci¨®n ¡ú General. Comportamiento de la propiedad: - solo lectura |
| logtimefmt | cadena | Formato de la hora en las entradas del registro. [Comportamiento de la propiedad] (/manual/api/reference_commentary#property-behavior): - soportada si value_type est¨¢ configurado en "log"- solo lectura para objetos heredados u objetos descubiertos |
| master_itemid | ID | ID de la m¨¦trica maestra. Se permite la recursividad de hasta 3 m¨¦tricas dependientes y un recuento m¨¢ximo de m¨¦tricas dependientes igual a 29999. Comportamiento de la propiedad: - obligatorio si type est¨¢ configurado en "²Ñ¨¦³Ù°ù¾±³¦²¹ dependiente"- solo lectura para objetos heredados u objetos descubiertos |
| output_format | entero | ?Deber¨ªa convertirse la respuesta a JSON. 0 - (predeterminado) Almacenar sin formato; 1 - Convertir a JSON. Comportamiento de la propiedad: - soportada si type est¨¢ configurado en "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| params | cadena | Par¨¢metros adicionales dependiendo del tipo de m¨¦trica:< br>- script ejecutado para m¨¦tricas del agente SSH y del agente TELNET; - consulta SQL para m¨¦tricas del monitor de base de datos; - f¨®rmula para m¨¦tricas calculadas; - script para m¨¦tricas de script y navegador. <br >Comportamiento de la propiedad: - obligatorio si type est¨¢ configurado en "Monitor de base de datos", "Agente SSH", "Agente TELNET", "Calculado" , "Script" o "Navegador"- solo lectura para objetos heredados (si tipo est¨¢ configurado en "Script" o "Navegador") u objetos descubiertos |
| parameters | objeto/matriz | Par¨¢metros adicionales si type est¨¢ configurado en "Script" o "Browser". Matriz de objetos con propiedades nombre y valor, donde el nombre debe ser ¨²nico.Comportamiento de la propiedad: - soportada si type est¨¢ configurado en "Script" o "Browser" - solo lectura para objetos heredados u objetos descubiertos |
| password | cadena | Contrase?a para autenticaci¨®n. Comportamiento de la propiedad:<br >- obligatorio si type est¨¢ configurado en "agente JMX" y nombre de usuario est¨¢ configurado- compatible si type est¨¢ configurado en "Comprobaci¨®n simple", "agente SSH", "agente TELNET" , "Monitor de base de datos" o "agente HTTP"- solo lectura para objetos heredados (si type est¨¢ configurado como "agente HTTP") u objetos descubiertos |
| post_type | entero | Tipo de publicaci¨®n cuerpo de datos almacenado en la propiedad posts.Valores posibles: 0 - (predeterminado) Datos sin procesar; 2 - datos JSON; 3 - datos XML. Comportamiento de la propiedad: - compatible si type est¨¢ configurado como "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| posts | cadena | HTTP(S) datos del cuerpo de la solicitud. Comportamiento de la propiedad: - obligatorio si type est¨¢ configurado en "agente HTTP" y post_type est¨¢ configurado en "datos JSON" o "datos XML"- compatible si type est¨¢ configurado en "agente HTTP" y post_type est¨¢ configurado en " Datos sin procesar"- solo lectura para objetos heredados u objetos descubiertos |
| prevvalue | cadena | Valor anterior de la m¨¦trica. De forma predeterminada, solo se muestran los valores que se encuentran dentro de las ¨²ltimas 24 horas . Puede ampliar este per¨ªodo de tiempo cambiando el valor del par¨¢metro Per¨ªodo m¨¢ximo de visualizaci¨®n del historial en la secci¨®n del men¨² Administraci¨®n ¡ú General. Comportamiento de la propiedad: - solo lectura |
| privatekey | cadena | Nombre del archivo de clave privada. Comportamiento de la propiedad: - obligatorio si type est¨¢ configurado como "agente SSH" y authtype est¨¢ configurado como "clave p¨²blica"- solo lectura para objetos descubiertos |
| publickey | cadena | Nombre del archivo de clave p¨²blica. Comportamiento de la propiedad: - obligatorio si type est¨¢ configurado en "agente SSH" y authtype est¨¢ configurado en "clave p¨²blica"- solo lectura para objetos descubiertos |
| query_fields | matriz | Matriz de campos de consulta que se enviar¨¢ al realizar una solicitud HTTP. Comportamiento de la propiedad: - compatible si type est¨¢ configurado en " Agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| request_method | entero | Tipo de m¨¦todo de solicitud. Valores posibles: 0 - (predeterminado) GET; 1 - POST; 2 - PUT; 3 - HEAD. Comportamiento de la propiedad: - soportada si type est¨¢ configurado en "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| retrieve_mode | entero | Qu¨¦ parte de la respuesta debe almacenarse. <br >Valores posibles si request_method est¨¢ configurado en "GET", "POST" o "PUT":0 - (predeterminado) Cuerpo; 1 - Encabezados; 2 - Tanto el cuerpo como se almacenar¨¢n los encabezados. Valores posibles si request_method est¨¢ configurado en "HEAD":1 - Encabezados. Comportamiento de la propiedad: - soportada si type est¨¢ configurado en "Agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| snmp_oid | cadena | SNMP OID.<br > Comportamiento de la propiedad: - obligatorio si type est¨¢ configurado en "Agente SNMP"- solo lectura para herencia objetos u objetos descubiertos |
| ssl_key_file | cadena | Ruta del archivo de clave SSL privada. Propiedad comportamiento: - compatible si type est¨¢ configurado en "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| ssl_key_password | cadena | Contrase?a para el archivo de clave SSL. Comportamiento de la propiedad: - soportada si se establece type a "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| state | entero | Estado de la m¨¦trica. Valores posibles: 0 - (predeterminado) normal; 1 - no compatible. Comportamiento de la propiedad: - solo lectura |
| status | entero | Estado de la m¨¦trica. Valores posibles: 0 - (predeterminado) m¨¦trica habilitada; 1 - m¨¦trica deshabilitada. |
| status_codes | cadena | Rangos de c¨®digos de estado HTTP requeridos, separados por comas. Tambi¨¦n admite macros de usuario como part de lista separada por comas. Ejemplo: 200,200-{$M},{$M},200-400 Comportamiento de propiedad: - soportada si type est¨¢ configurado en "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| templateid | ID | ID del elemento de plantilla principal.<br > Sugerencia: Utilice la propiedad hostid para especificar la plantilla a la que pertenece el elemento.Comportamiento de la propiedad: - solo lectura |
| timeout | cadena | Tiempo de espera de solicitud de sondeo de datos de la m¨¦trica. Acepta segundos o unidades de tiempo con sufijo (por ejemplo, 30 s, 1 m). Tambi¨¦n acepta macros de usuario. Rango de valores posibles: 1-600 s. Predeterminado: "" - use configuraci¨®n proxy/global. Comportamiento de la propiedad: - soportada si type est¨¢ configurado en "Agente Áú»¢¶Ä²©" (0), "Comprobaci¨®n simple" (3) y key_ no comienza con "vmware." y "icmpping", "Agente Áú»¢¶Ä²© (activo)" (7), "Comprobaci¨®n externa" (10), "Monitor de base de datos" (11), "Agente SSH" (13), "Agente TELNET" (14 ), "agente HTTP" (19), "agente SNMP" (20) y snmp_oid comienza con "walk[" o "get[", "Script" (21), "Navegador" (22) - solo lectura para objetos heredados y descubiertos |
| trapper_hosts | cadena | Equipos permitidos. Comportamiento de la propiedad:<br >- solo lectura para objetos descubiertos - compatible si type est¨¢ configurado como "Áú»¢¶Ä²© trapper", o si type est¨¢ configurado como "Agente HTTP" y allow_traps est¨¢ configurado como "Permitir aceptar datos entrantes" |
| trends | cadena | Una unidad de tiempo de cu¨¢nto tiempo se deben almacenar los datos de tendencias. Tambi¨¦n acepta macros de usuario. Predeterminado: 365d. Comportamiento de la propiedad: - compatible si value_type est¨¢ configurado en "num¨¦rico flotante" o "num¨¦rico sin firmar"- solo lectura para objetos descubiertos |
| units | cadena | Unidades de valor. Comportamiento de la propiedad: - soportada si value_type est¨¢ establecido en "flotante num¨¦rico" o " num¨¦rico sin firmar"- solo lectura para objetos heredados u objetos descubiertos |
| username | cadena | Nombre de usuario para autenticaci¨®n. Comportamiento de la propiedad : - obligatorio si type est¨¢ configurado como "agente SSH", "agente TELNET", o si type est¨¢ configurado como "agente JMX" y contrase?a est¨¢ configurada- compatible si type est¨¢ configurado en "Comprobaci¨®n simple", "Monitor de base de datos" o "agente HTTP"- solo lectura para objetos heredados (si tipo est¨¢ configurado en "agente HTTP") u objetos descubiertos |
| uuid | cadena | Identificador ¨²nico universal, utilizado para vincular elementos importados con elementos ya existentes. Generado autom¨¢ticamente, si no se proporciona. Comportamiento de la propiedad: - compatible si el elemento pertenece a una plantilla |
| valuemapid | ID | ID del mapa de valores asociado. Comportamiento de la propiedad: - compatible si value_type est¨¢ establecido en "flotante num¨¦rico", "³¦²¹°ù¨¢³¦³Ù±ð°ù" o "num¨¦rico sin firmar"- solo lectura para objetos heredados u objetos descubiertos |
| verify_host | entero | Si se valida que el nombre de host para la conexi¨®n coincide con el del certificado del host. Valores posibles: 0 - (predeterminado) No validar; 1 - Validar. Comportamiento de la propiedad: - compatible si tipo est¨¢ configurado en "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
| verify_peer | entero | Si se valida que el host el certificado es aut¨¦ntico. Valores posibles: 0 - (predeterminado) No validar; 1 - Validar. Comportamiento de la propiedad: - compatible si type est¨¢ configurado en "agente HTTP"- solo lectura para objetos heredados u objetos descubiertos |
Encabezado HTTP
El objeto de encabezado tiene las siguientes propiedades:
|Propiedad|Tipo|¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô| |--------|---------------------------------------- -----------|-----------| |name|cadena|nombre del encabezado HTTP.
Comportamiento de la propiedad:
- obligatorio| |value|cadena|Valor del encabezado.
Comportamiento de la propiedad:
- obligatorio|
Campo de consulta HTTP
El objeto del campo de consulta define un nombre y un valor que se utiliza para especificar un par¨¢metro de URL. Tiene las siguientes propiedades:
|Propiedad|Tipo|¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô| |--------|---------------------------------------- -----------|-----------| |name|cadena|Nombre del par¨¢metro.
Comportamiento de la propiedad:
- obligatorio| |value|cadena|Valor del par¨¢metro.
Comportamiento de la propiedad:
- obligatorio|
Etiqueta de m¨¦trica
El objeto de etiqueta de m¨¦trica tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| tag | cadena | Nombre de etiqueta de la m¨¦trica. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor de etiqueta de la m¨¦trica. |
Preprocesamiento de m¨¦tricas
El objeto de preprocesamiento de m¨¦tricas tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| type | entero | El tipo de opci¨®n de preprocesamiento. Valores posibles: 1 - Multiplicador personalizado; 2 - Recorte derecho; 3 - Recorte izquierdo; 4 - Recorte; 5 - Expresi¨®n regular; 6 - Booleano a decimal; 7 - Octal a decimal; 8 - Hexadecimal a decimal; 9 - Cambio simple; 10 - Cambio por segundo; 11 - XML XPath; 12 - JSONPath; 13 - Dentro del rango; 14 - Coincide con la expresi¨®n regular; 15 - No coincide con la expresi¨®n regular; 16 - Comprobar errores en JSON; 17 - Comprobar errores en XML; 18 - Comprobar errores usando expresiones regulares; 19 - Descartar sin cambios; 20 - Descartar sin cambios con un latido; 21 - JavaScript; 22 - Patr¨®n Prometheus; 23 - Prometheus a JSON; 24 - CSV a JSON; 25 - Reemplazar; 26 - Verificar no compatible; 27 - XML a JSON; 28 - Valor de SNMP walk; 29 - SNMP walk a JSON; 30 - Valor SNMP get. Comportamiento de la propiedad: - obligatorio |
| params | cadena | Par¨¢metros adicionales utilizados por la opci¨®n de preprocesamiento. Varios par¨¢metros est¨¢n separados por el ³¦²¹°ù¨¢³¦³Ù±ð°ù de nueva l¨ªnea (\n). Si type est¨¢ configurado a "Check unsupported", los par¨¢metros siguen una sintaxis <scope>[\n<pattern>], donde pattern es una expresi¨®n regular, y scope es uno de:-1 - cumple con cualquier error; ?0 - comprueba si el mensaje de error coincide con el pattern; ?1 - comprueba si el mensaje de error no coincide con el pattern. Comportamiento de la propiedad: - obligatorio si tipo est¨¢ configurado en "Multiplicador personalizado" (1), "Recorte derecho" (2), "Recorte izquierdo" (3), "Recortar" (4), "Expresi¨®n regular " (5), "XML XPath" (11), "JSONPath" (12), "Dentro del rango" (13), "Coincide con la expresi¨®n regular" (14), "No coincide con la expresi¨®n regular" (15), "Verificar "Buscar errores en JSON" (16), "Verificar errores en XML" (17), "Verificar errores usando expresiones regulares" (18), "Descartar sin cambios con latido" (20), "JavaScript" (21), " Patr¨®n de Prometheus" (22), "Prometheus a JSON" (23), "CSV a JSON" (24), "Reemplazar" (25), "Valor de caminata SNMP" (28) o "Caminar SNMP a JSON" (29)), o "Valor SNMP get" (30). ) |
| error_handler | entero | Tipo de acci¨®n utilizado en caso de error en el paso de preprocesamiento. Valores posibles: 0: el servidor Áú»¢¶Ä²© establece el mensaje de error; 1: descartar valor; 2 - Establecer un valor personalizado; 3 - Establecer un mensaje de error personalizado. Valores posibles si tipo est¨¢ configurado en "Verificar no admitido":1 - Descartar valor; 2 - Establecer valor personalizado; 3 - Establecer mensaje de error personalizado. Comportamiento de la propiedad: - obligatorio si tipo est¨¢ configurado en "Multiplicador personalizado" (1), "Expresi¨®n regular" (5), "Booleano a decimal" (6), "Octal a decimal" (7), "Hexadecimal a decimal" (8), "Cambio simple" (9) , "Cambio por segundo" (10), "XML XPath" (11), "JSONPath" (12), "Dentro del rango" (13), "Coincide con la expresi¨®n regular" (14), "No coincide con la expresi¨®n regular" ( 15), "Verificar errores en JSON" (16), "Verificar errores en XML" (17), "Verificar errores usando expresiones regulares" (18), "Patr¨®n de Prometheus" (22), "Prometheus a JSON" (23), "CSV a JSON" (24), "Verificar no compatible" (26), "XML a JSON" (27), "Valor de recorrido SNMP" (28) o "Recorrido SNMP a JSON" (29), o "Valor SNMP get" (30) |
| error_handler_params | cadena | Par¨¢metros del controlador de errores. Comportamiento de la propiedad: - obligatorio si error_handler est¨¢ configurado en "Establecer valor personalizado" o "Establecer mensaje de error personalizado" |
Se admiten los siguientes par¨¢metros y controladores de errores para cada tipo de preprocesamiento.
| Tipo de preprocesamiento | Nombre | Par¨¢metro 1 | Par¨¢metro 2 | Par¨¢metro 3 | Manejadores de errores admitidos |
|---|---|---|---|---|---|
| 1 | Multiplicador personalizado | ²Ô¨²³¾±ð°ù´Ç1,?6 | 0, 1, 2, 3 | ||
| 2 | Recorte derecho | lista de caracteres2 | |||
| 3 | Recorte izquierdo | lista de caracteres2 | |||
| 4 | Recortar | lista de caracteres2 | |||
| 5 | Expresi¨®n regular | ±è²¹³Ù°ù¨®²Ô3 | salida2 | 0, 1, 2, 3 | |
| 6 | Booleano a decimal | 0, 1, 2, 3 | |||
| 7 | Octal a decimal | 0, 1, 2, 3 | |||
| 8 | Hexadecimal a decimal | 0, 1, 2, 3 | |||
| 9 | Cambio simple | 0, 1, 2, 3 | |||
| 10 | Cambio por segundo | 0, 1, 2, 3 | |||
| 11 | XML XPath | ruta4 | 0, 1, 2, 3 | ||
| 12 | JSONPath | ruta4 | 0, 1, 2, 3 | ||
| 13 | En el rango | min1,?6 | max1,?6 | 0, 1, 2, 3 | |
| 14 | Coincide con la expresi¨®n regular | ±è²¹³Ù°ù¨®²Ô3 | 0, 1, 2, 3 | ||
| 15 | No coincide con la expresi¨®n regular | ±è²¹³Ù°ù¨®²Ô3 | 0, 1, 2, 3 | ||
| 16 | Compruebe si hay errores en JSON | ruta4 | 0, 1, 2, 3 | ||
| 17 | Compruebe si hay errores en XML | ruta4 | 0, 1, 2, 3 | ||
| 18 | Compruebe si hay errores usando la expresi¨®n regular | ±è²¹³Ù°ù¨®²Ô3 | salida2 | 0, 1, 2, 3 | |
| 19 | Descartar sin cambios | ||||
| 20 | Descartar sin cambios con latidos | segundos5,?6 | |||
| 21 | JavaScript | script2 | |||
| 22 | Patr¨®n de Prometheus | ±è²¹³Ù°ù¨®²Ô6,?7 | valor, etiqueta, ´Ú³Ü²Ô³¦¾±¨®²Ô |
salida8,?9 | 0, 1, 2, 3 |
| 23 | Prometheus a JSON | ±è²¹³Ù°ù¨®²Ô6,?7 | 0, 1, 2, 3 | ||
| 24 | CSV a JSON | ³¦²¹°ù¨¢³¦³Ù±ð°ù2 | ³¦²¹°ù¨¢³¦³Ù±ð°ù2 | 0,1 | 0, 1, 2, 3 |
| 25 | Reemplazar | cadena de b¨²squeda2 | reemplazo2 | ||
| 26 | Comprobaci¨®n no admitida | 1, 2, 3 | |||
| 27 | XML a JSON | 0, 1, 2, 3 | |||
| 28 | Valor de SNMP walk | OID2 | Formato: 0 - Sin cambios 1 - UTF-8 de Hex-STRING 2 - MAC de Hex-STRING 3 - Entero de BITS |
0, 1, 2, 3 | |
| 29 | SNMP walk a JSON10 | Nombre de campo2 | Prefijo OID2 | Formato: 0 - Sin cambios 1 - UTF-8 de Hex-STRING 2 - MAC de Hex-STRING 3 - Entero de BITS |
0, 1, 2, 3 |
| 30 | Valor SNMP get | Formato: 1 - UTF-8 desde Hex-STRING 2 - MAC desde Hex-STRING 3 - Entero desde BITS |
0, 1, 2, 3 | ||
1 ²Ô¨²³¾±ð°ù´Ç entero o de coma flotante
2 cadena
3 expresi¨®n regular
4 JSONPath o XML XPath
5 entero positivo (con soporte de sufijos de tiempo, por ejemplo, 30s, 1m, 2h, 1d)
6 macro de usuario
7 Patr¨®n de Prometheus siguiendo la sintaxis: <nombre de m¨¦trica>{<nombre de etiqueta>="<valor de etiqueta>", ...} == <valor>. Cada Componente del ±è²¹³Ù°ù¨®²Ô Prometheus (m¨¦trica, nombre de etiqueta, valor de etiqueta y m¨¦trica) valor) puede ser una macro de usuario.
8 Salida de Prometheus siguiendo la sintaxis: <nombre de etiqueta> (puede ser una macro de usuario) si se selecciona etiqueta como segundo par¨¢metro.
9 Una de las funciones de agregaci¨®n: sum, min, max, avg, count si se selecciona ´Ú³Ü²Ô³¦¾±¨®²Ô como segundo par¨¢metro.
10 Admite m¨²ltiples registros de "Nombre de campo, prefijo OID, registros de formato" delimitados por un ³¦²¹°ù¨¢³¦³Ù±ð°ù de nueva l¨ªnea.