3 脚本

概述

在 警报 → 脚本 部分，用户可以配置和维护自定义的全局脚本。

全局脚本可以根据配置的范围以及用户权限，在以下地方执行：

• 在主机菜单的各个前端位置（仪表盘、问题、最新数据、地图 等）
• 在事件菜单
• 可作为动作操作执行

这些脚本支持在 Zabbix agent、Zabbix proxy或仅在 Zabbix server上执行。详见 命令执行。

默认情况下，Zabbix agent和 Zabbix proxy上的远程脚本是禁用的。您可以通过以下方式启用：

• 对于在 Zabbix agent上执行的远程命令：
  • 在agent配置中为每个允许的命令添加 AllowKey=system.run[<command>,*] 参数，其中 * 表示等待和非等待模式；
• 对于在 Zabbix proxy上执行的远程命令：
  • 警告：如果在由 Zabbix agent监控的 Zabbix agent上执行远程命令，则不需要在 Zabbix proxy上启用远程命令。 但是，如果需要在 Zabbix proxy上执行远程命令，则在proxy配置中将 EnableRemoteCommands 参数设置为 '1'。

通过在 Zabbix server 配置中设置 EnableGlobalScripts=0 可以禁用 Zabbix Server 执行全局脚本的功能。从 Zabbix 7.0 开始的新安装中，默认情况下禁用 Zabbix server上的全局脚本执行。

显示现有脚本及其详细信息的列表如下所示：

显示的数据包括：

要配置新脚本，请单击右上角的 创建脚本 按钮。

批量编辑选项

列表下方的按钮提供了一个批量编辑选项：

• 删除 - 删除脚本

要使用此选项，请在相应脚本前面勾选复选框，然后单击 删除。

使用过滤器

您可以使用过滤器仅显示您感兴趣的脚本。为了获得更好的搜索性能，搜索数据时未解析宏。

过滤器 链接位于脚本列表上方。 如果您单击它，则会出现一个过滤器，您可以在其中按名称和范围过滤脚本。

配置全局脚本

脚本属性：

高级配置

高级配置选项可在可折叠的 高级配置 部分中找到：

如果同时配置了手动用户输入和确认消息，则它们将依次显示在弹出窗口中。

手动用户输入

手动用户输入允许在每次执行脚本时提供自定义参数。这样可以避免创建多个只有一个参数差异的相似用户脚本。

例如，您可能希望在执行期间向脚本提供不同的整数或不同的URL地址。

要启用手动用户输入：

• 在脚本（命令、脚本、脚本参数）中必要时使用 {MANUALINPUT} 宏；或在URL脚本的URL字段中使用；
• 在高级脚本配置中，启用手动用户输入并配置输入选项。

启用用户输入后，在执行脚本之前，将弹出一个 手动输入 弹出窗口，要求用户提供自定义值。提供的值将替换脚本中的 {MANUALINPUT}。

根据配置不同，用户将被要求输入字符串值：

或从预定义选项的下拉菜单中选择值：

手动用户输入仅适用于范围为“手动主机操作”或“手动事件操作”的脚本。

脚本执行和结果

由 Zabbix server运行的脚本按照命令执行页面描述的顺序执行（包括退出代码检查）。 脚本的执行结果将显示在弹出窗口中，该窗口会在脚本运行后出现。

脚本的返回值包括标准输出和标准错误信息。

返回值被限制为16MB（包括被截断的尾随空白字符）；也适用于数据库限制。 当数据必须经过 Zabbix proxy传输时，它必须存储在数据库中，因此也受到相同的数据库限制。

以下是一个脚本示例及其结果窗口的示例：

uname -v
       /tmp/non_existing_script.sh
       echo "This script was started by {USER.USERNAME}"

脚本的执行结果中不显示脚本本身。

脚本超时

Zabbix agent

在执行脚本时，可能会遇到超时的情况。

以下是一个在 Zabbix agent 上运行的脚本示例及其结果窗口：

sleep 5
       df -h

在这种情况下，错误消息如下：

Timeout while executing a shell script.

为了避免这种情况，建议优化脚本本身（在上面的例子中，优化 "sleep 5"），而不是调整Zabbix agent 配置和Zabbix server 配置中的 Timeout 参数。 然而，对于 Zabbix agent 主动模式，Zabbix server 配置中的 Timeout 参数应该至少比Zabbix agent 配置中的 RefreshActiveChecks 参数长几秒钟。 这确保服务器有足够的时间从agent接收到主动检查的结果。请注意，从 Zabbix agent 7.0 开始，支持在主动agent上执行脚本。

如果在Zabbix agent 配置中更改了 Timeout 参数，则会出现以下错误消息：

Get value from agent failed: ZBX_TCP_READ() timed out.

这意味着在Zabbix agent 配置中已经进行了修改，但还需要修改Zabbix server 配置中的 Timeout 参数。

Zabbix server/proxy

以下是在 Zabbix server 上运行的脚本示例及其结果窗口：

sleep 11
       df -h

建议优化脚本本身，而不是通过调整Zabbix server配置中的 TrapperTimeout 参数来使其值大于 11。