Esta sección describe las adiciones de Zabbix al lenguaje JavaScript implementadas con Duktape y las funciones globales de JavaScript admitidas (#global-javascript-functions).
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:
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):
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);
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"
}
}
}
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:
Producción:
2. Los elementos de cierre automático (<foo/>) se convertirán como si tuvieran valor nulo.
Ejemplo:
Entrada:
Salida:
3. Los atributos vacíos (con valor "") se convertirán como si tuvieran un valor de cadena vacía.
Ejemplo:
Entrada:
Salida:
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:
Salida:
5. Si un elemento de texto no tiene atributos ni hijos, será convertido como una cadena.
Ejemplo:
Entrada:
Salida:
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:
Salida:
Se han implementado funciones globales adicionales de JavaScript con Duktape:
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:
\n
escapados o no escapados en lugar de saltos de línea;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').