Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

5 Preprocesamiento de JavaScript

Descripción general

Esta sección proporciona detalles del preprocesamiento mediante JavaScript.

Preprocesamiento de JavaScript

El preprocesamiento de JavaScript se realiza invocando una función de JavaScript con un único parámetro 'value' y el cuerpo de la función proporcionado por el usuario. El resultado del paso de preprocesamiento es el valor devuelto por esta función; por ejemplo, para realizar la conversión de Fahrenheit a Celsius, introduzca:

return (value - 32)  * 5 / 9

en los parámetros de preprocesamiento de JavaScript, que serán envueltos en una función de JavaScript por el servidor:

function (value)
       {
          return (value - 32) * 5 / 9
       }

El parámetro de entrada 'value' siempre se pasa como una cadena. El valor de retorno se convierte automáticamente a cadena mediante el método toString() (si falla, entonces el error se devuelve como valor de cadena), con algunas excepciones:

  • devolver un valor undefined resultará en un error;
  • devolver un valor null hará que el valor de entrada se descarte, de manera similar al preprocesamiento 'Descartar valor' en la acción 'Personalizado en caso de fallo'.

Los errores pueden devolverse lanzando valores/objetos (normalmente cadenas u objetos Error).

Por ejemplo:

if (value == 0)
           throw "Zero input value"
       return 1/value

Cada script tiene un tiempo de espera de ejecución de 10 segundos (dependiendo del script, puede tardar más en activarse el tiempo de espera); si se excede, se devolverá un error. Se aplica un límite de heap de 512 megabytes.

El bytecode del paso de preprocesamiento de JavaScript se almacena en caché y se reutiliza cuando el paso se aplica la próxima vez. Cualquier cambio en los pasos de preprocesamiento de la métrica hará que el script en caché se restablezca y se vuelva a compilar más tarde.

Los fallos consecutivos en tiempo de ejecución (3 seguidos) harán que el motor se reinicialice para mitigar la posibilidad de que un script rompa el entorno de ejecución para los siguientes scripts (esta acción se registra con DebugLevel 4 o superior).

El preprocesamiento de JavaScript se implementa con el motor de JavaScript Duktape.

Consulte también: Objetos JavaScript adicionales y funciones globales

Uso de macros en scripts

Es posible utilizar macros de usuario en el código JavaScript. Si un script contiene macros de usuario, estas macros son resueltas por el servidor/proxy antes de ejecutar pasos específicos de preprocesamiento. Tenga en cuenta que al probar los pasos de preprocesamiento en la interfaz, los valores de las macros no se obtendrán y deberán introducirse manualmente.

El contexto se ignora cuando una macro se reemplaza por su valor. El valor de la macro se inserta en el código tal cual, no es posible añadir escapado adicional antes de colocar el valor en el código JavaScript. Tenga en cuenta que esto puede causar errores de JavaScript en algunos casos.

En el siguiente ejemplo, si el valor recibido supera el valor de la macro {$THRESHOLD}, se devolverá el valor del umbral (si está presente) en su lugar:

var threshold = '{$THRESHOLD}';
       return (!isNaN(threshold) && value > threshold) ? threshold : value;

Ejemplos

Los siguientes ejemplos ilustran cómo puede utilizar el preprocesamiento de JavaScript.

Cada ejemplo contiene una breve descripción, un cuerpo de función para los parámetros de preprocesamiento de JavaScript y el resultado del paso de preprocesamiento: el valor devuelto por la función.

Ejemplo 1: Convertir un número (notación científica a entero)

Convierte el número "2.62128e+07" de notación científica a un entero.

return (Number(value))

Valor devuelto por la función: 26212800.

Ejemplo 2: Convertir un número (binario a decimal)

Convertir el número binario "11010010" a un número decimal.

return(parseInt(value,2))

Valor devuelto por la función: 210.

Ejemplo 3: Redondear un número

Redondear el número "18.2345" a 2 dígitos.

return(Math.round(value* 100) / 100)

Valor devuelto por la función: 18.23.

Ejemplo 4: Contar letras en una cadena

Cuenta el número de letras en la cadena "Zabbix".

return (value.length)

Valor devuelto por la función: 6.

Ejemplo 5: Obtener el tiempo restante

Obtener el tiempo restante (en segundos) hasta la fecha de expiración de un certificado (12 de febrero 12:33:56 2022 GMT).

var split = value.split(' '),
           MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
           month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2),
           ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2],
           now = Date.now();
       
       return parseInt((Date.parse(ISOdate) - now) / 1000);

Valor devuelto por la función: 44380233.

Ejemplo 6: Eliminar propiedades JSON

Modifica la estructura de datos JSON eliminando cualquier propiedad con la clave "data_size" o "index_size".

var obj=JSON.parse(value);
       
       for (i = 0; i < Object.keys(obj).length; i++) {
           delete obj[i]["data_size"];
           delete obj[i]["index_size"];
       }
       
       return JSON.stringify(obj)

Valor aceptado por la función:

[
           {
               "table_name":"history",
               "data_size":"326.05",
               "index_size":"174.34"
           },
           {
               "table_name":"history_log",
               "data_size":"6.02",
               "index_size":"3.45"
           }
       ]

Valor devuelto por la función:

[
           {
               "table_name":"history"
           },
           {
               "table_name":"history_log"
           }
       ]
Ejemplo 7: Convertir el estado de Apache a JSON

Convierte el valor recibido de una métrica del agente Zabbix web.page.get (por ejemplo, web.page.get[http://127.0.0.1:80/server-status?auto]) en un objeto JSON.

// Convertir el estado de Apache a JSON
       
       // Divide el valor en subcadenas y coloca estas subcadenas en un array
       var lines = value.split('\n');
       
       // Crea un objeto vacío "output"
       var output = {};
       
       // Crea un objeto "workers" con propiedades predefinidas
       var workers = {
           '_': 0, 'S': 0, 'R': 0, 'W': 0,
           'K': 0, 'D': 0, 'C': 0, 'L': 0,
           'G': 0, 'I': 0, '.': 0
       };
       
       // Agrega las subcadenas del array "lines" al objeto "output" como propiedades (pares clave-valor)
       for (var i = 0; i < lines.length; i++) {
           var line = lines[i].match(/([A-z0-9 ]+): (.*)/);
       
           if (line !== null) {
               output[line[1]] = isNaN(line[2]) ? line[2] : Number(line[2]);
           }
       }
       
       // Métricas multiversión
       output.ServerUptimeSeconds = output.ServerUptimeSeconds || output.Uptime;
       output.ServerVersion = output.ServerVersion || output.Server;
       
       // Analiza la propiedad "Scoreboard" para obtener el recuento de workers
       if (typeof output.Scoreboard === 'string') {
           for (var i = 0; i < output.Scoreboard.length; i++) {
               var char = output.Scoreboard[i];
       
               workers[char]++;
           }
       }
       
       // Agrega los datos de workers al objeto "output"
       output.Workers = {
           waiting: workers['_'], starting: workers['S'], reading: workers['R'],
           sending: workers['W'], keepalive: workers['K'], dnslookup: workers['D'],
           closing: workers['C'], logging: workers['L'], finishing: workers['G'],
           cleanup: workers['I'], slot: workers['.']
       };
       
       // Devuelve la cadena JSON
       return JSON.stringify(output);

Valor aceptado por la función:

HTTP/1.1 200 OK
       Date: Mon, 27 Mar 2023 11:08:39 GMT
       Server: Apache/2.4.52 (Ubuntu)
       Vary: Accept-Encoding
       Content-Encoding: gzip
       Content-Length: 405
       Content-Type: text/plain; charset=ISO-8859-1
       
       127.0.0.1
       ServerVersion: Apache/2.4.52 (Ubuntu)
       ServerMPM: prefork
       Server Built: 2023-03-08T17:32:01
       CurrentTime: Monday, 27-Mar-2023 14:08:39 EEST
       RestartTime: Monday, 27-Mar-2023 12:19:59 EEST
       ParentServerConfigGeneration: 1
       ParentServerMPMGeneration: 0
       ServerUptimeSeconds: 6520
       ServerUptime: 1 hour 48 minutes 40 seconds
       Load1: 0.56
       Load5: 0.33
       Load15: 0.28
       Total Accesses: 2476
       Total kBytes: 8370
       Total Duration: 52718
       CPUUser: 8.16
       CPUSystem: 3.44
       CPUChildrenUser: 0
       CPUChildrenSystem: 0
       CPULoad: .177914
       Uptime: 6520
       ReqPerSec: .379755
       BytesPerSec: 3461.58
       BytesPerReq: 3461.58
       DurationPerReq: 21.2916
       BusyWorkers: 2
       IdleWorkers: 6
       Scoreboard: ____KW__..............................................................................................................................................

Valor devuelto por la función:

{
           "Date": "Mon, 27 Mar 2023 11:08:39 GMT",
           "Server": "Apache/2.4.52 (Ubuntu)",
           "Vary": "Accept-Encoding",
           "Encoding": "gzip",
           "Length": 405,
           "Type": "text/plain; charset=ISO-8859-1",
           "ServerVersion": "Apache/2.4.52 (Ubuntu)",
           "ServerMPM": "prefork",
           "Server Built": "2023-03-08T17:32:01",
           "CurrentTime": "Monday, 27-Mar-2023 14:08:39 EEST",
           "RestartTime": "Monday, 27-Mar-2023 12:19:59 EEST",
           "ParentServerConfigGeneration": 1,
           "ParentServerMPMGeneration": 0,
           "ServerUptimeSeconds": 6520,
           "ServerUptime": "1 hour 48 minutes 40 seconds",
           "Load1": 0.56,
           "Load5": 0.33,
           "Load15": 0.28,
           "Total Accesses": 2476,
           "Total kBytes": 8370,
           "Total Duration": 52718,
           "CPUUser": 8.16,
           "CPUSystem": 3.44,
           "CPUChildrenUser": 0,
           "CPUChildrenSystem": 0,
           "CPULoad": 0.177914,
           "Uptime": 6520,
           "ReqPerSec": 0.379755,
           "BytesPerSec": 1314.55,
           "BytesPerReq": 3461.58,
           "DurationPerReq": 21.2916,
           "BusyWorkers": 2,
           "IdleWorkers": 6,
           "Scoreboard": "____KW__..............................................................................................................................................",
           "Workers": {
               "waiting": 6,
               "starting": 0,
               "reading": 0,
               "sending": 1,
               "keepalive": 1,
               "dnslookup": 0,
               "closing": 0,
               "logging": 0,
               "finishing": 0,
               "cleanup": 0,
               "slot": 142
           }
       }