Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

1 Objetos JavaScript adicionales

Descripción general

Esta sección describe las adiciones de Zabbix al lenguaje JavaScript implementadas con Duktape y las funciones globales de JavaScript admitidas (#global-javascript-functions).

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)

HttpRequest

Este objeto encapsula el manejador cURL permitiendo realizar solicitudes HTTP simples. Los errores se lanzan como excepciones.

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

Método Descripción
addHeader(value) Agrega un campo de cabecera 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 cabecera que se pueden agregar a un solo objeto HttpRequest está limitada a 128 Kbytes (incluidos los caracteres especiales y los nombres de los campos de cabecera).
clearHeader() Borra la cabecera HTTP. Si no se establecen campos de cabecera, HttpRequest establecerá Content-Type en application/json si los datos que se envían tienen formato JSON; en text/plain en caso contrario.
connect(url) Envía una solicitud HTTP CONNECT a la URL y devuelve la respuesta.
customRequest(method, url, data) Permite especificar cualquier método HTTP en el primer parámetro. Envía la solicitud del método a la URL con una carga data opcional y devuelve la respuesta.
delete(url, data) Envía una solicitud HTTP DELETE a la URL con una carga data opcional y devuelve la respuesta.
getHeaders(<asArray>) Devuelve el objeto de los campos de cabecera HTTP recibidos.
El parámetro asArray puede establecerse en "true" (por ejemplo, getHeaders(true)), "false" o no estar definido. Si se establece en "true", los valores de los campos de cabecera HTTP recibidos se devolverán como arrays; esto debe usarse para recuperar los valores de campos de cabecera con el mismo nombre múltiples veces.
Si no se establece o se establece en "false", los valores de los campos de cabecera HTTP recibidos se devolverán como cadenas.
get(url, data) Envía una solicitud HTTP GET a la URL con una carga data opcional y devuelve la respuesta.
head(url) Envía una solicitud HTTP HEAD a la URL y devuelve la respuesta.
options(url) Envía una solicitud HTTP OPTIONS a la URL y devuelve la respuesta.
patch(url, data) Envía una solicitud HTTP PATCH a la URL con una carga data opcional y devuelve la respuesta.
put(url, data) Envía una solicitud HTTP PUT a la URL con una carga data opcional y devuelve la respuesta.
post(url, data) Envía una solicitud HTTP POST a la URL con una carga data 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(bitmask, username, password) Establece los métodos de autenticación HTTP habilitados (HTTPAUTH_BASIC, HTTPAUTH_DIGEST, HTTPAUTH_NEGOTIATE, HTTPAUTH_NTLM, HTTPAUTH_NONE) en el parámetro 'bitmask'.
La bandera HTTPAUTH_NONE permite deshabilitar la autenticación HTTP.
Ejemplos:
request.setHttpAuth(HTTPAUTH_NTLM | HTTPAUTH_BASIC, username, password)
request.setHttpAuth(HTTPAUTH_NONE)
trace(url, data) Envía una solicitud HTTP TRACE a la URL con una carga data opcional y devuelve la respuesta.

Ejemplo:

try {
           Zabbix.log(4, 'jira webhook script value='+value);
         
           var result = {
               'tags': {
                   'endpoint': 'jira'
               }
           },
           params = JSON.parse(value),
           req = new HttpRequest(),
           fields = {},
           resp;
         
           req.addHeader('Content-Type: application/json');
           req.addHeader('Authorization: Basic '+params.authentication);
         
           fields.summary = params.summary;
           fields.description = params.description;
           fields.project = {"key": params.project_key};
           fields.issuetype = {"id": params.issue_id};
           resp = req.post('https://jira.example.com/rest/api/2/issue/',
               JSON.stringify({"fields": fields})
           );
         
           if (req.getStatus() != 201) {
               throw 'Response code: '+req.getStatus();
           }
         
           resp = JSON.parse(resp);
           result.tags.issue_id = resp.id;
           result.tags.issue_key = resp.key;
       } catch (error) {
           Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));
           Zabbix.log(4, 'jira issue creation failed : '+error);
         
           result = {};
       }
         
       return JSON.stringify(result);

XML

El objeto XML permite el procesamiento de datos XML en la métrica y el preprocesamiento del 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:

<menu>
           <food type = "breakfast">
               <name>Chocolate</name>
               <price>$5.95</price>
               <description></description>
               <calories>650</calories>
           </food>
       </menu>

Salida:

{
           "menu": {
               "food": {
                   "@type": "breakfast",
                   "name": "Chocolate",
                   "price": "$5.95",
                   "description": null,
                   "calories": "650"
               }
           }
       }
Reglas de serialización

La conversión de XML a JSON se procesará de acuerdo con las siguientes 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 antepuestos por "@".

Ejemplo:

Entrada:

 <xml foo="FOO">
          <bar>
            <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:

Entrada:

<xml>
         <foo/>
       </xml>

Salida:

{
         "xml": {
           "foo": null
         }
       }

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

Ejemplo:

Entrada:

<xml>
         <foo bar="" />
       </xml>

Salida:

{
         "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:

Entrada:

<xml>
         <foo>BAR</foo>
         <foo>BAZ</foo>
         <foo>QUX</foo>
       </xml>

Salida:

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

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

Ejemplo:

Entrada:

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

Salida:

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

6. Si un elemento de texto no tiene hijos, pero tiene atributos: el 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 regla 1 de serialización.

Ejemplo:

Entrada:

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

Salida:

{
         "xml": {
           "foo": {
             "@bar": "BAR",
             "#text": "BAZ"
           }
         }
       }

Funciones globales de JavaScript

Se han implementado funciones globales adicionales de JavaScript con Duktape:

  • btoa(data): codifica los datos en una cadena Base64;
  • atob(base64_string): desde la versión 7.0.1, decodifica la cadena Base64 como un búfer Uint8Array (en Zabbix 7.0.0 esta función devuelve una cadena decodificada).
try {
           b64 = btoa("test string");
           buffer = atob(b64);
       
           // Tenga en cuenta que la lógica de decodificación depende del formato de datos del búfer.
           decoded = String.fromCharCode.apply(this, [].slice.call(buffer));
       } 
       catch (error) {
           return {'error.name' : error.name, 'error.message' : error.message};
       }
  • md5(data): calcula el hash MD5 de los datos

  • sha256(data): calcula el hash SHA256 de los datos

  • hmac('<tipo de hash>',clave,dato): devuelve el hash HMAC como una cadena formateada en hexadecimal; se admiten los tipos de hash MD5 y SHA256; los parámetros clave y dato admiten datos binarios. Ejemplos:

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

    • con espacios en lugar de saltos de línea;
    • con \n escapados o no escapados en lugar de saltos de línea;
    • sin ningún salto de línea como una cadena de una sola línea;
    • como una cadena con formato JSON.

    La clave también puede cargarse desde una macro de usuario/macro secreta/vault.

    dato: 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 compiló sin ninguna de estas bibliotecas de cifrado, se lanzará un error ('falta la biblioteca OpenSSL o GnuTLS').