1 Objectes JavaScript addicionals

Vista general

Aquesta secció descriu les addicions de Zabbix al llenguatge JavaScript implementats amb Duktape i les funcions globals de JavaScript admeses.

Objectes integrats

Zabbix

L'objecte Zabbix proporciona interacció amb la funcionalitat interna de Zabbix.

Exemple:

 Zabbix.log(3, "aquesta és una entrada de registre escrita amb el nivell de registre 'Avís'")

Podeu emprar els àlies següents:

Exemple (execució endarrerida durant 15 segons):

 Zabbix.sleep(15000)

HttpRequest

Aquest objecte encapsula el maneig cURL que permet fer peticions HTTP senzilles. Els errors es llancen com a excepcions.

::: nota important La inicialització de diversos objectes HttpRequest és limitada a 10 per execució de l'script. :::

Exemple:

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

L'objecte XML permet el processament de dades XML en preprocessament de descoberta d'elements de baix nivell i webhooks.

Exemple :

Entrada:

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

Sortida:

{
           "menu": {
               "food": {
                   "@type": "breakfast",
                   "name": "Chocolate",
                   "price": "$5.95",
                   "description": null,
                   "calories": "650"
               }
           }
       }

Regles de serialització

La conversió de XML a JSON es processarà d'acord amb les regles següents (per a les conversions de JSON a XML, s'apliquen regles inverses):

1. Els atributs XML es convertiran en claus els noms de les quals aniran precedits per '@'.

Exemple:

Entrada:

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

Sortida:

 {
          "xml": {
            "@foo": "FOO",
            "bar": {
              "baz": "BAZ"
            }
          }
        }

2. Els elements de tancament automàtic (<foo/>) es convertiran com a valor "nul".

Exemple:

Entrada:

<xml>
         <foo/>
       </xml>

Sortida:

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

3. Els atributs buits (amb el valor "") es convertiran com a valor de cadena buida ('').

Exemple:

Entrada:

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

Sortida:

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

4. Diversos nodes secundaris amb el mateix nom d'element es convertiran en una única clau que tingui una matriu de valors com a valor.

Exemple:

Entrada:

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

Sortida:

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

5. Si un element de text no té ni atribut ni elements fills, es convertirà a cadena.

Exemple:

Entrada:

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

Sortida:

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

6. Si un element de text no té fills, però té atributs: el contingut del text es convertirà a un element amb la clau '#text' i el contingut com a valor; els atributs es convertiran tal com es descriu a la regla de serialització 1.

Exemple:

Entrada:

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

Sortida:

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

Funcions globals de JavaScript

S'han afegit funcions JavaScript globals addicionals amb Duktape:

• btoa (data) - codifica la cadena a cadena en base64;
• atob(base64_string) - des de la versió 6.4.16, descodifica la cadena en base64 com a buffer Uint8Array (a Zabbix 6.4.0 - 6.4.15 retornava una cadena descodificada).

try {
           b64 = btoa("test string");
           buffer = atob(b64);
       
           // Fixeu-vos que la lògica de descodificació depen del format de les dades del buffer.
           decoded = String.fromCharCode.apply(this, [].slice.call(buffer));
       } 
       catch (error) {
           return {'error.name' : error.name, 'error.message' : error.message};
       }

• md5(dades) - calcula el hash MD5 d'una cadena

• sha256(dades) - calcula el hash SHA256 d'una cadena

• mac('<tipus hash>',clau,dades) - retorna el hash HMAC com una cadena en format hexadecimal; S'admeten els tipus hash MD5 i SHA256; Els paràmetres clau i de dades admeten dades binàries. Exemples:

  • hmac('md5',clau,dades)
  • hmac('sha256',clau,dades)

• sign(hash,clau,dades) - retorna la signatura calculada (signatura RSA amb SHA-256) com a cadena, on:
  hash - només es permet 'sha256', en cas contrari es genera un error;
  clau - la clau privada. Ha de correspondre a l'estàndard PKCS#1 o PKCS#8. La clau es pot proporcionar de diferents formes:
  

  • amb espais en lloc de noves línies;
  • amb o sense escapat '' en lloc de noves línies;
  • sense cap nova línia com una cadena d'una sola línia;
  • com a cadena en format JSON.

  La clau també es pot carregar des d'una macro d'usuari/macro/macro secreta.

  dades - les dades que es signaran. Pot ser una cadena (també s'admeten dades binàries) o una memòria intermèdia (Uint8Array/ArrayBuffer).
  OpenSSL o GnuTLS s'empren per calcular signatures. Si Zabbix s'ha compilat sense cap d'aquestes biblioteques de xifrat, es generarà un error ('Manca la biblioteca OpenSSL o GnuTLS').
  Aquesta funció és compatible des de Zabbix 6.4.1.