19 Browser监控项

Overview

Browser items allow monitoring complex websites and web applications using a browser.

The support of Browser items is currently experimental.

Browser items collect data by executing a user-defined JavaScript code and retrieving data over HTTP/HTTPS. This item can simulate such browser-related actions as clicking, entering text, navigating through web pages, and other user interactions with websites or web applications.

In addition to the script, an optional list of parameters (pairs of name and value) and timeout can be specified.

The item partially implements the W3C WebDriver standard with either Selenium Server or a plain WebDriver (for example, ChromeDriver) as a web testing endpoint. For the item to work, set the endpoint in the Zabbix server/proxy configuration file WebDriverURL parameter.

Browser items are executed and processed by Zabbix server or proxy browser pollers. If necessary, you can adjust the number of pre-forked instances of Browser item pollers in the Zabbix server/proxy configuration file StartBrowserPollers parameter.

For monitoring complex websites and web applications, the Website by Browser template is available as an out-of-the-box template.

配置

如果使用 ChromeDriver 作为网络测试端点，请参阅 安全注意事项。

在 监控项配置表 的 类型 字段中，选择 Browser，然后填写必填字段。

所有标红星号为必填字段。

Browser 监控项需要特定信息的字段有：

示例

默认脚本

以下脚本：

1. 初始化一个浏览器会话。
2. 导航到指定的 URL。
3. 收集性能条目和会话统计数据，并以 JSON 字符串的形式返回它们。

在脚本字段中，输入以下内容：

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

检查 Zabbix 登录

脚本执行以下操作：

1. 初始化一个浏览器会话。
2. 导航到 Zabbix 登录页面。
3. 输入用户名 “Admin” 和密码 “zabbix”。
4. 查找并点击登录按钮。
5. 查找并点击注销按钮。
6. 收集登录前后以及注销后的性能数据。
7. 通过捕获错误消息和屏幕截图来处理错误。
8. 将收集到的结果作为 JSON 字符串返回。

在 脚本 字段中，输入以下 JavaScript 代码：

var browser, result;
       browser = new Browser(Browser.chromeOptions());
       try {
           browser.navigate("http://example.com/zabbix/index.php");
           browser.collectPerfEntries("open page");
           var el = browser.findElement("xpath", "//input[@id='name']");
           if (el === null) {
               throw Error("cannot find name input field");
           }
           el.sendKeys("Admin");
           el = browser.findElement("xpath", "//input[@id='password']");
           if (el === null) {
               throw Error("cannot find password input field");
           }
           el.sendKeys("zabbix");
           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);
       }

初始化浏览器

以下脚本执行以下操作：

1. 根据脚本中指定的顺序，为可用的浏览器初始化一个浏览器会话，选择第一个匹配的浏览器。
2. 定义浏览器能力，包括页面加载策略以及针对每个浏览器的特定选项，例如 Chrome、Firefox 和 Microsoft Edge 浏览器的无头模式。

请注意，为了设置 WebDriver 实例，您将需要额外的测试脚本或场景来与被测试的网站或 Web 应用程序进行交互。

在脚本字段中，输入以下内容：

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"
                   }
               ]
           }
       });