7 Web 监控

概述

使用 Zabbix，您可以检查网站的多个可用性方面。

要执行 web 监控，Zabbix 服务器必须先使用 cURL（libcurl）支持进行配置。

要启用 web 监控，您需要定义 web 场景。一个 web 场景由一个或多个 HTTP 请求或“步骤”组成。这些步骤由 Zabbix 服务器按预定义顺序定期执行。如果某个主机通过 proxy 监控，则这些步骤由 proxy 执行。

web 场景以与监控项、触发器等相同的方式关联到主机/模板。这意味着 web 场景也可以在模板级别创建，然后一次性应用到多个主机。

任何 web 场景都会收集以下信息：

  • 整个场景所有步骤的平均每秒下载速度
  • 失败的步骤编号
  • 最后一个错误消息

任何 web 场景步骤都会收集以下信息：

  • 每秒下载速度
  • 响应时间
  • 响应代码

更多详情，请参见web 监控监控项。

执行 web 场景时收集的数据会保存在数据库中。这些数据会自动用于图形、触发器和通知。

Zabbix 还可以检查检索到的 HTML 页面是否包含预定义字符串。它可以执行模拟登录，并沿着页面上的模拟鼠标点击路径进行操作。

Zabbix web 监控同时支持 HTTP 和 HTTPS。运行 web 场景时，Zabbix 可选择跟随重定向（参见下方选项 Follow redirects）。重定向的最大数量硬编码为 10（使用 cURL 选项 CURLOPT_MAXREDIRS）。在单个场景的执行过程中，所有 cookie 都会被保留。

配置 web 场景

要配置 web 场景：

  • 转到：数据采集 → 主机（或 模板）
  • 在主机/模板所在行点击 Web
  • 点击右侧的 创建 web 场景（或点击场景名称以编辑现有场景）
  • 在表单中输入场景参数

场景 选项卡允许您配置 web 场景的通用参数。

所有必填输入字段都用红色星号标记。

场景参数：

Parameter Description
Name 唯一的场景名称。
支持用户宏。注意，如果使用了用户宏，这些宏在web 监控项名称中将保持未解析状态。
Update interval 场景执行的频率。
支持时间后缀，例如 30s、1m、2h、1d。
支持用户宏。注意，如果使用了用户宏且其值发生变化（例如 5m → 30s），下一次检查将按照之前的值执行（按示例值会更靠后）。
新建的 web 场景会在创建后 60 秒内进行检查。
Attempts 执行 web 场景步骤的尝试次数。若出现网络问题（超时、无连接等），Zabbix 可以重复执行某一步骤若干次。设置的次数会同等影响场景中的每个步骤。最多可指定 10 次尝试，默认值为 1。
注意：由于错误的响应代码或所需字符串不匹配，Zabbix 不会重复执行某一步骤。
Agent 选择客户端 agent。
Zabbix 将伪装成所选浏览器。这在网站针对不同浏览器返回不同内容时很有用。
此字段可使用用户宏。
HTTP proxy 您可以使用格式 [protocol://][username[:password]@]proxy.example.com[:port] 指定要使用的 HTTP proxy。
这会设置 CURLOPT_PROXY cURL 选项。
可选的 protocol:// 前缀可用于指定其他 proxy 协议（对协议前缀的支持是在 cURL 7.21.7 中加入的）。如果未指定协议，proxy 将被视为 HTTP proxy。
默认使用 1080 端口。
如果指定了 proxy，它将覆盖与 proxy 相关的环境变量，如 http_proxy、HTTPS_PROXY。如果未指定，则不会覆盖与 proxy 相关的环境变量。输入的值会按“原样”传递，不会进行有效性检查。
您也可以输入 SOCKS proxy 地址。如果指定了错误的协议，连接将失败，监控项将变为不受支持。
注意：HTTP proxy 仅支持简单认证。
此字段可使用用户宏。
Variables 可在场景步骤中使用的变量（URL、post 变量）。
其格式如下：
{macro1}=value1
{macro2}=value2
{macro3}=regex:<regular expression>
{macro4}=jsonpath:<jsonpath>
{macro5}=xmlxpath:<xmlxpath>
{macro6}={{macro}.function()}（参见宏函数）
例如：
{username}=Alexei
{password}=kj3h5kJ34bd
{hostid}=regex:hostid is ([0-9]+)
{url}=jsonpath:$.host_url
{status}=xmlxpath://host/response/status
{newvar}={{myvar}.btoa()}
随后可在步骤中将这些宏引用为 {username}、{password}、{hostid} 等。Zabbix 会自动将它们替换为实际值。请注意，带有 regex: 的变量需要一个步骤来获取正则表达式的值，因此提取出的值只能应用于后续步骤。
如果值部分以 regex: 开头，则其后的内容会被视为用于搜索网页的正则表达式，若找到匹配项，则将匹配结果存储到变量中。至少必须包含一个子组，以便提取匹配到的值。
支持用户宏和 {HOST.*}宏。
当变量用于查询字段或 post 变量的表单数据时，会自动进行 URL 编码；但当用于原始 post 或直接用于 URL 时，必须手动进行 URL 编码。
Headers 执行请求时使用 HTTP 头。可使用默认头和自定义头。
头将根据在场景级别下拉列表中选择的 Agent 类型使用默认设置分配，并应用于所有步骤，除非在步骤级别自定义定义了头。
需要注意的是，在步骤级别定义头会自动丢弃之前定义的所有头，除了通过在场景级别下拉列表中选择 'User-Agent' 而分配的默认头。
不过，即使是 'User-Agent' 默认头，也可以通过在步骤级别指定它来覆盖。
要取消场景级别的头，应在步骤级别为该头命名并将其值留空。
头应使用与 HTTP 协议中相同的语法列出，也可使用 CURLOPT_HTTPHEADER cURL 选项支持的一些附加功能。
例如：
Accept-Charset=utf-8
Accept-Language=en-US
Content-Type=application/xml; charset=utf-8
支持用户宏和 {HOST.*}宏。
Enabled 如果勾选此框，则场景处于启用状态；否则为禁用。

请注意，在编辑现有场景时，表单中还会提供两个额外按钮：
基于现有场景的属性创建另一个场景。
删除该场景的历史数据和趋势数据。这将使服务器在删除数据后立即执行该场景。

如果 HTTP proxy 字段留空，使用 HTTP proxy 的另一种方法是设置与 proxy 相关的环境变量。

对于 HTTP 检查 - 为 Zabbix 服务器用户设置 http_proxy 环境变量。例如，http_proxy=http://proxy_ip:proxy_port。

对于 HTTPS 检查 - 设置 HTTPS_PROXY 环境变量。例如，HTTPS_PROXY=http://proxy_ip:proxy_port。更多详情可通过运行 shell 命令查看：# man curl。

步骤 选项卡允许您配置 web 场景步骤。要添加 web 场景步骤，请在 步骤 区块中点击 添加。

机密用户宏不得用于 URL 中，因为它们会解析为 "******"。

配置步骤

步骤参数：

参数 描述
名称 唯一的步骤名称。
支持用户宏。请注意，如果使用了用户宏，这些宏在web 监控项名称中将保持未解析状态。
URL 用于连接并获取数据的 URL。例如：
https://www.example.com
http://www.example.com/download
域名可以使用 Unicode 字符指定。在执行 web 场景步骤时，它们会自动通过 punycode 转换为 ASCII。
Parse 按钮可用于将可选查询字段（如 ?name=Admin&password=mypassword）从 URL 中分离出来，并将属性和值移入 Query fields，以便自动进行 URL 编码。
变量可通过 {macro} 语法在 URL 中使用。变量也可通过 {{macro}.urlencode()} 语法手动进行 URL 编码。
支持用户宏和 {HOST.*} 宏。
限制为 2048 个字符。
Query fields URL 的 HTTP GET 变量。
以属性和值对的形式指定。
值会自动进行 URL 编码。来自场景变量、用户宏或 {HOST.*} 宏的值会先被解析，然后自动进行 URL 编码。使用 {{macro}.urlencode()} 语法会对其进行双重 URL 编码。
支持用户宏和 {HOST.*} 宏。
Post HTTP POST 变量。
在 Form data 模式下，以属性和值对的形式指定。
值会自动进行 URL 编码。来自场景变量、用户宏或 {HOST.*} 宏的值会先被解析，然后自动进行 URL 编码。
在 Raw data 模式下，属性/值显示在单行中，并使用 & 符号连接。
原始值可通过 {{macro}.urlencode()} 或 {{macro}.urldecode()} 语法手动进行 URL 编码/解码。
例如：id=2345&userid={user}
如果 {user} 被定义为 web 场景的变量，则在执行该步骤时会被替换为其值。如果希望对该变量进行 URL 编码，请将 {user} 替换为 {{user}.urlencode()}。
支持用户宏和 {HOST.*} 宏。
Variables 步骤级变量，可用于 GET 和 POST 功能。
以属性和值对的形式指定。
步骤级变量会覆盖场景级变量或前一步骤中的变量。但是，步骤级变量的值只会影响后续步骤（而不会影响当前步骤）。
其格式如下：
{macro}=value
{macro}=regex:<regular expression>
更多信息请参见场景级别中的变量说明。
变量在查询字段或 post 变量的表单数据中使用时会自动进行 URL 编码，但在原始 post 中使用或直接在 URL 中使用时，必须手动进行 URL 编码。
Headers 执行请求时将发送的自定义 HTTP 标头。
以属性和值对的形式指定。
在步骤级别定义的标头将用于该特定步骤。
请注意，在步骤级别定义标头时，除通过场景级别下拉列表中选择 'User-Agent' 所分配的默认标头外，之前定义的所有标头都会被自动丢弃。
不过，即使是 'User-Agent' 默认标头，也可以通过在步骤级别指定它来覆盖。
例如，为某个标头指定名称但不设置值，将会取消设置场景级别中的默认标头。
支持用户宏和 {HOST.*} 宏。
这将设置 CURLOPT_HTTPHEADER cURL 选项。
Follow redirects 选中复选框以跟随 HTTP 重定向。
这将设置 CURLOPT_FOLLOWLOCATION cURL 选项。
Retrieve mode 选择获取模式：
Body - 仅从 HTTP 响应中获取正文
Headers - 仅从 HTTP 响应中获取标头
Body and headers - 从 HTTP 响应中获取正文和标头
Timeout Zabbix 在处理该 URL 时花费的时间不会超过设定值（从 1 秒到最长 1 小时）。实际上，此参数定义了与该 URL 建立连接的最长时间以及执行 HTTP 请求的最长时间。因此，Zabbix 在该步骤上花费的时间不会超过 2 x Timeout 秒。
支持时间后缀，例如 30s、1m、1h。支持用户宏。
Required string 必需的正则表达式模式。
除非获取到的内容（HTML）匹配该必需模式，否则该步骤将失败。如果为空，则不对必需字符串执行检查。
例如：
Homepage of Zabbix
Welcome.*admin
注意：此字段不支持引用在 Zabbix 前端中创建的正则表达式。
支持用户宏和 {HOST.*} 宏。
Required status codes 预期的 HTTP 状态码列表。如果 Zabbix 获取到的状态码不在列表中，则该步骤将失败。
如果为空，则不对状态码执行检查。
例如：200,201,210-299
支持用户宏。

仅当保存整个场景时， web 场景步骤中的任何更改才会被保存。

另请参见一个实际示例，了解如何 配置 web 监控步骤。

标签配置

Tags（标签）配置选项允许定义场景级别的标签。

标签允许过滤 Web 场景和 Web的监控项。

配置认证

认证 选项卡允许你配置场景的认证选项。选项卡名称旁边的绿色圆点表示已启用某种 HTTP 认证。

认证参数：

Parameter Description
HTTP authentication 选择认证选项：
None - 不使用认证；
Basic - 使用基本认证；
NTLM - 使用 NTLM (Windows NT LAN Manager) 认证；
Kerberos - 使用 Kerberos 认证（另请参见：使用 Zabbix 配置 Kerberos）；
Digest - 使用摘要认证。
User 输入用户名（最多 255 个字符）。
当 HTTP authentication 设置为 Basic、NTLM、Kerberos 或 Digest 时，此字段可用。支持用户宏。
Password 输入用户密码（最多 255 个字符）。
当 HTTP authentication 设置为 Basic、NTLM、Kerberos 或 Digest 时，此字段可用。支持用户宏。
SSL verify peer 勾选此复选框以验证 Web 服务器的 SSL 证书。
服务器证书将自动从系统范围的证书颁发机构（CA）位置获取。你可以使用 Zabbix 服务器或 proxy 配置参数 SSLCALocation 覆盖 CA 文件位置。
这会设置 cURL 选项 CURLOPT_SSL_VERIFYPEER。
SSL verify host 勾选此复选框以验证 Web 服务器证书的 Common Name 字段或 Subject Alternate Name 字段是否匹配。
这会设置 cURL 选项 CURLOPT_SSL_VERIFYHOST。
SSL certificate file 用于客户端认证的 SSL 证书文件名。证书文件必须为 PEM1 格式。如果证书文件中还包含私钥，请将 SSL key file 字段留空。如果密钥已加密，请在 SSL key password 字段中指定密码。包含此文件的目录由 Zabbix 服务器或 proxy 配置参数 SSLCertLocation 指定。
此字段可使用 HOST.* 宏和用户宏。
这会设置 cURL 选项 CURLOPT_SSLCERT。
SSL key file 用于客户端认证的 SSL 私钥文件名。私钥文件必须为 PEM1 格式。包含此文件的目录由 Zabbix 服务器或 proxy 配置参数 SSLKeyLocation 指定。
此字段可使用 HOST.* 宏和用户宏。
这会设置 cURL 选项 CURLOPT_SSLKEY。
SSL key password SSL 私钥文件密码。
此字段可使用用户宏。
这会设置 cURL 选项 CURLOPT_KEYPASSWD。

[1] Zabbix 仅支持 PEM 格式的证书和私钥文件。如果你的证书和私钥数据位于 PKCS #12 格式文件中（通常扩展名为 *.p12 或 *.pfx），你可以使用以下命令将其生成 PEM 文件：

openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem
openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes  -out ssl-cert.key

Zabbix 服务器会在不重启的情况下获取证书变更。

如果客户端证书和私钥位于同一个文件中，只需在 "SSL certificate file" 字段中指定该文件，并将 "SSL key file" 字段留空。证书和密钥仍必须为 PEM 格式。合并证书和密钥很简单：

cat client.crt client.key > client.pem

显示

要查看为主机配置的 web 场景，请转到 Monitoring → Hosts， 在列表中找到该主机，然后单击最后一列中的 Web 超链接。单击场景名称可获取详细信息。

也可以通过 Web 监控小组件在 Dashboards 中显示 web 场景概览。

web 场景执行的最近结果可在 Monitoring → Latest data 部分中查看。

扩展监控

有时需要记录接收到的 HTML 页面内容。
如果某个 web 场景步骤失败，这尤其有用。
调试级别 5（trace）用于实现这一目的。
该级别可以在 服务器 和 proxy 配置文件中设置，或者使用 运行时控制 选项（-R log_level_increase="http poller,N"，其中 N 为进程编号）。
以下示例演示了在已设置调试级别 4 的情况下如何启动扩展监控：

# Increase log level of all http pollers:
zabbix_server -R log_level_increase="http poller"

# Increase log level of second http poller:
zabbix_server -R log_level_increase="http poller,2"

如果不需要扩展 web 监控，可以使用 -R log_level_decrease 选项停止它。