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.

Método Descripción
log(loglevel, mensaje) Escribe el <mensaje> en el registro de Zabbix usando el nivel de registro <loglevel> (consulte el parámetro DebugLevel del archivo de configuración).

Ejemplo:

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

Puede utilizar los siguientes alias:

Alias Alias de
console.log(objeto) Zabbix.log(4, JSON.stringify(objeto))
console.warn(objeto) Zabbix.log(3, JSON.stringify(objeto))
console.error(objeto) Zabbix.log(2, JSON.stringify(objeto))

El tamaño total de todos los mensajes registrados está limitado a 8 MB por cada ejecución del script.

Método Descripción
sleep(delay) Retrasa la ejecución de JavaScript en delay milisegundos.

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

Método Descripción
addHeader(value) Agrega el campo de encabezado HTTP. Este campo se utiliza para todas las solicitudes siguientes hasta que se borre con el método clearHeader().
La longitud total de los campos de encabezado que se pueden agregar a un único objeto HttpRequest está limitada a 128 Kbytes (caracteres especiales y nombres de encabezado). incluido).
clearHeader() Borra el encabezado HTTP. Si no se establecen campos de encabezado, HttpRequest establecerá el tipo de contenido en aplicación/json si los datos que se publican tienen formato JSON; texto/sin formato en caso contrario.
connect(url) Envía la solicitud HTTP CONNECT a la URL y devuelve la respuesta.
customRequest(método, url, datos) Permite especificar cualquier método HTTP en el primer parámetro. Envía la solicitud del método a la URL con la carga útil datos opcional y devuelve la respuesta.
delete(url, datos) Envía la solicitud HTTP DELETE a la URL con la carga útil datos opcional y devuelve la respuesta.
getHeaders(<asArray>) Devuelve el objeto de los campos de encabezado HTTP recibidos.
El parámetro asArray puede establecerse en "true" (por ejemplo, getHeaders(true)), "false" o no estar definido . Si se establece en "verdadero", los valores del campo de encabezado HTTP recibidos se devolverán como matrices; esto debe usarse para recuperar los valores de los campos de múltiples encabezados con el mismo nombre.
Si no se establece o se establece en "falso", los valores de los campos del encabezado HTTP recibidos se devolverán como cadenas.
get(url, datos) Envía la solicitud HTTP GET a la URL con la carga útil datos opcional y devuelve la respuesta.
head(url) Envía la solicitud HTTP HEAD a la URL y devuelve la respuesta.
options(url) Envía la solicitud HTTP OPTIONS a la URL y devuelve la respuesta.
patch(url, datos) Envía la solicitud HTTP PATCH a la URL con la carga útil datos opcional y devuelve la respuesta.
put(url, datos) Envía la solicitud HTTP PUT a la URL con la carga útil datos opcional y devuelve la respuesta.
post(url, datos) Envía una solicitud HTTP POST a la URL con la carga útil datos opcional y devuelve la respuesta.
getStatus() Devuelve el código de estado de la última solicitud HTTP.
setProxy(proxy) Establece el proxy HTTP al valor "proxy". Si este parámetro está vacío, no se utiliza ningún proxy.
setHttpAuth(máscara de bits, nombre de usuario, contraseña) Establece los métodos de autenticación HTTP habilitados (HTTPAUTH_BASIC, HTTPAUTH_DIGEST, HTTPAUTH_NEGOTIATE, HTTPAUTH_NTLM, HTTPAUTH_NONE) en el parámetro 'bitmask'.
HTTPAUTH El indicador _NONE permite deshabilitar la autenticación HTTP.
Ejemplos:
request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC, nombre de usuario, contraseña)
request.setHttpAuth(HTTPAUTH_NONE)
trace(url, datos) Envía la solicitud HTTP TRACE a la URL con la carga útil datos opcional y devuelve la respuesta.

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.

Para utilizar un objeto XML, el servidor/proxy debe estar compilado con soporte libxml2.

Método Descripción
XML.query(datos, expresión) Recupera el contenido del nodo usando XPath. Devuelve nulo si no se encuentra el nodo.
expresión: una expresión XPath;
datos: datos XML como una cadena.
XML.toJson(data) Convierte datos en formato XML a JSON.
XML.fromJson(object) Convierte datos en formato JSON a XML.

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.