8 脚本

概述

在管理 → 脚本部分可以配置和维护用户定义的全局脚本。

根据配置的作用域和用户权限，全局脚本可用于以下场景执行：

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

脚本将在Zabbix agent、Zabbix server（proxy）或仅Zabbix server上执行。另见Command execution。

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

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

显示现有脚本及其详细信息的列表。

显示的数据：

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

批量编辑选项

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

• Delete - delete 脚本

使用此选项时，请勾选相应脚本前的复选框 并点击 Delete。

使用过滤器

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

过滤器链接位于脚本列表上方。点击该链接后，将显示一个过滤器界面，您可以根据名称和范围筛选脚本。

配置全局脚本

脚本属性:

脚本执行与结果

脚本 run 由 Zabbix server 按照 command execution page 中描述的顺序执行。

脚本结果会在脚本 run 后弹出的窗口中显示。脚本的返回值为标准输出：

• 若脚本成功完成 (退出码检查 0)，返回值限制为16MB（包含会被截断的尾部空格）。
• 若脚本因错误退出（非零退出码），返回值为限制为2KB的标准错误输出。

Zabbix默认不存储扩展脚本输出。如需保留完整输出细节，可在脚本内部实现日志记录（例如将输出重定向至本地日志 file）。

注意：对于在 Zabbix server 或 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.

为避免这种情况,建议通过修改Zabbix agent configuration和Zabbix server configuration来优化脚本本身(而不是将Timeout参数调整为相应值,在我们的例子中是> 5).

如果在Zabbix agent configuration中更改了Timeout参数,将出现以下错误信息:

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

这意味着修改是在Zabbix agent configuration中进行的,同时也需要在Zabbix server configuration中修改Timeout设置.

Zabbix server/proxy

查看在Zabbix server上运行的脚本示例及下方结果窗口:

sleep 11
       df -h

还建议通过修改Zabbix server configuration来优化脚本本身(而非将TrapperTimeout参数调整为对应值(本例中>‘11’))