1 Objetos JavaScript adicionales

Descripción general

Esta sección describe las adiciones de Zabbix al lenguaje JavaScript implementado con Duktape y las funciones globales de JavaScript compatibles.

Objetos integrados

Zabbix

El objeto Zabbix proporciona interacción con la funcionalidad interna de Zabbix.

Ejemplo:

Zabbix.log(3, "esta es una entrada de registro escrita con el nivel de registro 'Advertencia'")

Puede utilizar los siguientes alias:

Ejemplo (retrasar la ejecución 15 segundos):

Zabbix.sleep(15000)

Solicitud HTTP

::: nota importante "HttpRequest" es un nuevo nombre para este objeto desde Zabbix 5.4. Anteriormente se llamaba "CurlHttpRequest". Los nombres de los métodos también se cambiaron en Zabbix 5.4. Los antiguos nombres de objetos/métodos ahora están en desuso y su soporte dejará de ser compatible después de Zabbix 6.0. :::

Este objeto encapsula el identificador cURL que permite realizar solicitudes HTTP simples. Los errores se lanzan como excepciones.

::: nota importante La inicialización de múltiples objetos HttpRequest está limitada a 10 por ejecución de script. :::

Ejemplo:

intentar {
           Zabbix.log(4, 'valor del script de jira webhook='+valor);
         
           resultado var = {
               'etiquetas': {
                   'punto final': 'jira'
               }
           },
           parámetros = JSON.parse(valor),
           solicitud = nueva HttpRequest(),
           campos = {},
           resp;
         
           req.addHeader('Tipo de contenido: aplicación/json');
           req.addHeader('Autorización: Básica '+params.authentication);
         
           campos.summary = params.summary;
           campos.descripción = parámetros.descripción;
           campos.proyecto = {"clave": params.project_key};
           campos.issuetype = {"id": params.issue_id};
           resp = req.post('https://jira.example.com/rest/api/2/issue/',
               JSON.stringify({"campos": campos})
           );
         
           si (req.getStatus()! = 201) {
               throw 'Código de respuesta: '+req.getStatus();
           }
         
           resp = JSON.parse(resp);
           resultado.tags.issue_id = resp.id;
           resultado.tags.issue_key = resp.key;
       } captura (error) {
           Zabbix.log(4, 'falló la creación del problema de jira json: '+JSON.stringify({"fields": campos}));
           Zabbix.log(4, 'Error al crear el problema de Jira: '+error);
         
           resultado = {};
       }
         
       devolver JSON.stringify(resultado);

XML

El objeto XML permite el procesamiento de datos XML en la métrica y en el preprocesamiento de descubrimiento de bajo nivel y webhooks.

Ejemplo:

Entrada:

<menú>
           <comida tipo="desayuno">
               <nombre>Chocolate</nombre>
               <precio>$ 5,95</precio>
               <descripción></descripción>
               <calorías>650</calorías>
           </comida>
       </menú>

Salida:

{
           "menú": {
               "comida": {
                   "@tipo": "desayuno",
                   "nombre": "Chocolate",
                   "precio": "$5,95",
                   "descripción": nulo,
                   "calorías": "650"
               }
           }
       }

Reglas de serialización

La conversión de XML a JSON se procesará de acuerdo con lo siguiente reglas (para conversiones de JSON a XML se aplican reglas invertidas):

1. Los atributos XML se convertirán en claves que tendrán sus nombres. antepuesto "@".

Ejemplo:

Aporte:

 <xml foo="FOO">
          <barra>
            <baz>BAZ</baz>
          </bar>
        </xml>

Producción:

 {
          "xml": {
            "@Foo Foo",
            "bar": {
              "baz": "BAZ"
            }
          }
        }

2. Los elementos de cierre automático (<foo/>) se convertirán como si tuvieran 'valor nulo.

Ejemplo:

Aporte:

<xml>
         <foo/>
       </xml>

Producción:

{
         "xml": {
           "foo": nulo
         }
       }

3. Los atributos vacíos (con valor "") se convertirán como si estuvieran vacíos. valor de cadena.

Ejemplo:

Aporte:

<xml>
         <foo barra="" />
       </xml>

Producción:

{
         "xml": {
           "foo": {
             "@bar": ""
           }
         }
       }

4. Varios nodos secundarios con el mismo nombre de elemento se convertirán en una única clave que tiene una matriz de valores como valor.

Ejemplo:

Aporte:

<xml>
         <foo>BARRA</foo>
         <foo>BAZ</foo>
         <foo>QUX</foo>
       </xml>

Producción:

{
         "xml": {
           "foo": ["BAR", "BAZ", "QUX"]
         }
       }

5. Si un elemento de texto no tiene atributos ni hijos, será convertido como una cadena.

Ejemplo:

Aporte:

<xml>
           <foo>BAZ</foo>
       </xml>

Producción:

{
         "xml": {
           "foo": "BAZ"
          }
       }

6. Si un elemento de texto no tiene hijos, pero tiene atributos: contenido de texto se convertirá en un elemento con la clave '#text' y el contenido como valor; Los atributos se convertirán como se describe en la serialización. regla 1.

Ejemplo:

Aporte:

<xml>
         <foobar="BAR">
           BAZ
         </foo>
       </xml>

Producción:

{
         "xml": {
           "foo": {
             "@bar": "BARRA",
             "#texto": "BAZ"
           }
         }
       }

Funciones globales de JavaScript

Se han implementado funciones globales adicionales de JavaScript con Duktape:

• btoa(datos) - codifica los datos en una cadena base64
• atob(base64_string) - decodifica cadena base64

intentar {
           b64 = btoa("cadena utf8");
           utf8 = atob(b64);
       } 
       atrapar (error) {
           return {'error.nombre': error.nombre, 'error.mensaje': error.mensaje}
       }

• md5(datos) - calcula el hash MD5 de los datos

• sha256(datos) - calcula el hash SHA256 de los datos

• hmac('<tipo de hash>',key,data) - devuelve el hash HMAC como una cadena con formato hexadecimal; Se admiten los tipos de hash MD5 y SHA256; Los parámetros clave y de datos admiten datos binarios. Ejemplos:

  • hmac('md5',clave,datos)
  • hmac('sha256',clave,datos)

• sign(hash,key,data) - devuelve la firma calculada (firma RSA con SHA-256) como una cadena, donde:
  hash: solo se permite 'sha256'; de lo contrario, se genera un error;
  clave - la clave privada. Debe corresponder al estándar PKCS#1 o PKCS#8. La clave se puede proporcionar de diferentes formas:
  

  • con espacios en lugar de nuevas líneas;
  • con ''s con o sin escape en lugar de nuevas líneas;
  • sin nuevas líneas como una cadena de una sola línea;
  • como una cadena con formato JSON.

  La clave también se puede cargar desde una macro de usuario/macro secreta/bóveda.

  datos: los datos que se firmarán. Puede ser una cadena (también se admiten datos binarios) o un búfer (Uint8Array/ArrayBuffer).
  Se utiliza OpenSSL o GnuTLS para calcular las firmas. Si Zabbix se creó sin ninguna de estas bibliotecas de cifrado, se generará un error ('falta la biblioteca OpenSSL o GnuTLS').
  Esta función es compatible desde Zabbix 6.0.15.