17 Browser-Datenpunkt

Übersicht

Browser-Datenpunkte ermöglichen die Überwachung komplexer Websites und Webanwendungen mithilfe eines Browsers.

Browser-Datenpunkte erfassen Daten, indem sie benutzerdefinierten JavaScript-Code ausführen und Daten über HTTP/HTTPS abrufen. Dieser Datenpunkt kann browserbezogene Aktionen wie Klicken, Texteingabe, Navigieren durch Webseiten und andere Benutzerinteraktionen mit Websites oder Webanwendungen simulieren.

Zusätzlich zum Skript können eine optionale Liste von Parametern (Paare aus Name und Wert) sowie ein Timeout angegeben werden.

Browser-Datenpunktprüfungen werden von Browser-Pollern des Zabbix Server oder Proxy ausgeführt und verarbeitet. Falls erforderlich, können Sie die Anzahl der vorab erzeugten Instanzen der Browser-Poller im Parameter StartBrowserPollers der Konfigurationsdatei des Zabbix Server/Proxy anpassen.

Für die Überwachung komplexer Websites und Webanwendungen steht die Vorlage Website by Browser als Out-of-the-box-Vorlage zur Verfügung.

Konfiguration

Wählen Sie im Feld Typ des Datenpunkt-Konfigurationsformulars Browser aus und füllen Sie dann die erforderlichen Felder aus.

Alle obligatorischen Eingabefelder sind mit einem roten Sternchen markiert.

Die Felder, die für Browser-Datenpunkte spezifische Informationen erfordern, sind:

Beispiele

Ein Beispiel dafür, wie Zabbix für die Überwachung von Websites mit der Vorlage Website by Browser eingerichtet wird, finden Sie unter Websites mit Browser-Datenpunkten überwachen.

Standardskript

Das folgende Skript:

1. Initialisiert eine Browser-Sitzung.
2. Navigiert zu einer angegebenen URL.
3. Erfasst Performance-Einträge und Sitzungsstatistiken und gibt sie als JSON-Zeichenfolge zurück.

Geben Sie im Feld Skript Folgendes ein:

var browser = new Browser(Browser.chromeOptions());

try {
    browser.navigate("http://example.com");
    browser.collectPerfEntries();
}
finally {
    return JSON.stringify(browser.getResult());
}

Browser mit benutzerdefinierten Fähigkeiten initialisieren

Das folgende Skript:

1. Initialisiert eine Browser-Sitzung für den verfügbaren Browser auf Grundlage des ersten passenden Browsers in der im Skript angegebenen Reihenfolge.
2. Definiert Browser-Fähigkeiten, einschließlich der Seitenlade-Strategie und browser-spezifischer Optionen, wie etwa den Headless-Modus für Chrome-, Firefox- und Microsoft Edge-Browser.

Geben Sie im Feld Script Folgendes ein:

var browser = new Browser({
    "capabilities":{
        "firstMatch":[
            {
                "browserName":"chrome",
                "pageLoadStrategy":"normal",
                "goog:chromeOptions":{
                    "args":[
                        "--headless=new"
                    ]
                }
            },
            {
                "browserName":"firefox",
                "pageLoadStrategy":"normal",
                "moz:firefoxOptions":{
                    "args":[
                        "--headless"
                    ]
                }
            },
            {
                "browserName":"MicrosoftEdge",
                "pageLoadStrategy":"normal",
                "ms:edgeOptions":{
                    "args":[
                        "--headless=new"
                    ]
                }
            },
            {
                "browserName":"safari",
                "pageLoadStrategy":"normal"
            }
        ]
    }
});

Browser mit GUI initialisieren

Standardmäßig werden Browsersitzungen (mit Ausnahme von Safari) im Headless-Modus initialisiert, was bedeutet, dass die grafische Benutzeroberfläche (GUI) des Browsers nicht angezeigt wird.

Das folgende Skript initialisiert eine Browsersitzung mit aktivierter GUI.

Beachten Sie, dass Sie den Pfad manuell angeben können, wenn der WebDriver die Browser-Binärdatei nicht finden kann.

var opts = Browser.chromeOptions();
opts.capabilities.alwaysMatch['goog:chromeOptions'].args = [];

// Um eine Firefox-Sitzung mit GUI zu initialisieren, kommentieren Sie die folgenden Zeilen aus:
// var opts = Browser.firefoxOptions();
// opts.capabilities.alwaysMatch['moz:firefoxOptions'].binary = 'usr/bin/firefox';
// opts.capabilities.alwaysMatch['moz:firefoxOptions'].args = [];

// Um eine Microsoft Edge-Sitzung mit GUI zu initialisieren, kommentieren Sie die folgenden Zeilen aus:
// var opts = Browser.edgeOptions();
// opts.capabilities.alwaysMatch['ms:edgeOptions'].binary = 'usr/bin/microsoft-edge';
// opts.capabilities.alwaysMatch['ms:edgeOptions'].args = [];

var browser = new Browser(opts);

Screenshots aufnehmen

Das folgende Skript:

1. Initialisiert eine Browser-Sitzung.
2. Legt die Viewport-Größe des Browsers fest, um die Größe des Screenshots zu bestimmen (als Parameter angegeben, siehe unten).
3. Navigiert zu einer URL (als Parameter angegeben, siehe unten).
4. Erfasst Sitzungsstatistiken, erstellt einen Screenshot und fügt ihn den erfassten Statistiken hinzu.
5. Behandelt Fehler, indem Fehlermeldungen und ein Screenshot erfasst werden.
6. Gibt die erfassten Ergebnisse als JSON-String zurück.

Das Skript verwendet außerdem Parameter aus dem Formular zur Konfiguration des Datenpunkts:

• webURL - http://example.com
• width - 1920
• height - 1080

Geben Sie im Feld Script Folgendes ein:

var browser, result;

var browser = new Browser(Browser.chromeOptions());

try {
    var params = JSON.parse(value); // Parse the JSON string containing parameters passed from Zabbix.

    browser.setScreenSize(Number(params.width), Number(params.height))

    browser.navigate(params.webURL);

    result = browser.getResult();
    result.screenshot = browser.getScreenshot();
}
catch (err) {
    if (!(err instanceof BrowserError)) {
        browser.setError(err.message);
    }
    result = browser.getResult();
    result.error.screenshot = browser.getScreenshot();
}
finally {
    return JSON.stringify(result);
}

Zabbix-Anmeldung prüfen

Das folgende Skript:

1. Initialisiert eine Browser-Sitzung.
2. Navigiert zu einer Seite (als Parameter angegeben, siehe unten).
3. Gibt den Benutzernamen und das Passwort ein (als Parameter angegeben, siehe unten).
4. Findet die Anmeldeschaltfläche und klickt darauf.
5. Findet die Abmeldeschaltfläche und klickt darauf.
6. Erfasst Performancedaten vor und nach der Anmeldung sowie nach der Abmeldung.
7. Behandelt Fehler, indem Fehlermeldungen und ein Screenshot erfasst werden.
8. Gibt die erfassten Ergebnisse als JSON-Zeichenfolge zurück.

Das Skript verwendet außerdem Parameter aus dem Datenpunkt-Konfigurationsformular:

• webURL - http://{HOST.CONN}/index.php
• username - {$USERNAME}
• password - {$PASSWORD}

Geben Sie im Feld Script Folgendes ein:

var browser, result;

browser = new Browser(Browser.chromeOptions());

try {
    var params = JSON.parse(value); // Parse the JSON string containing parameters passed from Zabbix.

    browser.navigate(params.webURL);
    browser.collectPerfEntries("open page");

    var el = browser.findElement("xpath", "//input[@id='name']");
    if (el === null) {
        throw Error("cannot find name input field");
    }
    el.sendKeys(params.username);

    el = browser.findElement("xpath", "//input[@id='password']");
    if (el === null) {
        throw Error("cannot find password input field");
    }
    el.sendKeys(params.password);

    el = browser.findElement("xpath", "//button[@id='enter']");
    if (el === null) {
        throw Error("cannot find login button");
    }
    el.click();

    browser.collectPerfEntries("login");

    el = browser.findElement("link text", "Sign out");
    if (el === null) {
        throw Error("cannot find logout button");
    }
    el.click();

    browser.collectPerfEntries("logout");

    result = browser.getResult();
}
catch (err) {
    if (!(err instanceof BrowserError)) {
        browser.setError(err.message);
    }
    result = browser.getResult();
    result.error.screenshot = browser.getScreenshot();
}
finally {
    return JSON.stringify(result);
}

Links finden

Das folgende Skript:

1. Initialisiert eine Browsersitzung.
2. Definiert eine Funktion zum Entfernen doppelter Elemente aus einem Array (siehe Schritt 5).
3. Navigiert zu einer Seite (angegeben als Parameter, siehe unten).
4. Findet Links auf der Seite.
5. Entfernt doppelte Links, um sicherzustellen, dass sie eindeutig sind.
6. Extrahiert nur die Links, die mit "http" beginnen.
7. Formatiert die extrahierten Links in eine bestimmte Struktur.
8. Behandelt Fehler, indem Fehlermeldungen und ein Screenshot erfasst werden.
9. Gibt die gesammelten Ergebnisse als JSON-String zurück.

Das Skript verwendet außerdem Parameter aus dem Formular zur Item-Konfiguration:

• scheme - {$WEBSITE.SCHEME}
• domain - {$WEBSITE.DOMAIN}
• path - {$WEBSITE.PATH}

Geben Sie im Feld Script Folgendes ein:

var browser, result;

browser = new Browser(Browser.chromeOptions());

try {
    var params = JSON.parse(value);  // Parse the JSON string containing parameters passed from Zabbix.

    function uniq(a) {
        return a.sort().filter(function (item, pos, ary) {
            return !pos || item != ary[pos - 1];
        });
    }

    browser.navigate(params.scheme + '://' + params.domain + params.path);

    var el = browser.findElements("link text", "");
    var links = [];
    for (var n = 0; n < el.length; n++) {
        links.push(el[n].getAttribute('href'));
    }

    links = uniq(links);

    result = [];
    for (i = 0; i < links.length; i++) {
        if (links[i].match(/^http.*/)) {
            var row = {};
            row["{#URL}"] = links[i];
            result.push(row);
        }
    }
}
catch (err) {
    if (!(err instanceof BrowserError)) {
        browser.setError(err.message);
    }
    result = browser.getResult();
    result.error.screenshot = browser.getScreenshot();
}
finally {
    return JSON.stringify(result);
}