3 自定义告警脚本

概述

如果您对现有用于发送告警的媒体类型不满意，还有一种替代方法。 您可以创建一个脚本，以您自己的方式处理通知。

自定义告警脚本在 Zabbix 服务器上执行。 这些脚本必须位于服务器配置文件中 AlertScriptsPath 参数指定的目录下。

下面是一个自定义告警脚本示例：

#!/bin/bash

to=$1
subject=$2
body=$3
host=$4
value=$5

cat <<EOF | mail -s "$subject" "$to"
$body

Host: $host
Value: $value
EOF

Zabbix 会检查已执行命令和脚本的退出码。 任何不等于 0 的退出码都将被视为 命令执行 错误。 在这种情况下，Zabbix 将尝试重新执行失败的操作。

脚本不会保留或创建环境变量，因此应显式处理这些变量。

配置

要将自定义告警脚本配置为一种媒体类型：

  1. 转到 告警 → 媒体类型。
  2. 单击 创建媒体类型。

媒体类型 选项卡包含通用媒体类型属性：

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

以下参数是脚本媒体类型特有的：

Parameter Description
Script name 输入脚本文件的名称（例如，notification.sh），该文件位于 AlertScriptsPath 服务器配置参数指定的目录中。
Script parameters 添加可选的脚本参数，这些参数将按定义顺序作为命令行参数传递给脚本。

脚本参数支持 {ALERT.SENDTO}、{ALERT.SUBJECT}、{ALERT.MESSAGE} 宏，以及通知中支持的所有 宏 和 用户宏。

有关如何配置默认消息和告警处理选项的详细信息，请参见 通用媒体类型参数。

即使告警脚本不使用默认消息，该媒体类型所使用的操作类型的消息模板仍必须定义。 否则，将不会发送通知。

如果配置了多个脚本媒体类型，这些脚本可能会由告警进程并行处理。 告警进程的总数受服务器配置文件中的 StartAlerters 参数限制。

测试

要测试已配置的脚本 media type：

  1. 在 media type 的 列表 中找到相关脚本。

  2. 在列表的最后一列点击 Test；测试表单将会在弹出窗口中打开。 测试表单将包含与该脚本 media type 配置相同数量的参数。

  3. 如有需要，编辑脚本参数值。编辑仅影响测试过程；实际值不会被更改。

  4. 点击 Test。

在测试已配置的脚本 media type 时，{ALERT.SENDTO}、{ALERT.SUBJECT}、{ALERT.MESSAGE} 和用户宏将解析为其值， 但与事件相关的宏（例如 {HOST.HOST}、{ITEM.LASTVALUE} 等）不会被解析，因为在测试期间没有相关事件可用于获取详细信息。 请注意，{ALERT.SUBJECT} 和 {ALERT.MESSAGE} 中的宏也不会被解析。 例如，如果 {ALERT.SUBJECT} 的值由 "Problem: {EVENT.NAME}" 组成，那么 {EVENT.NAME} 宏将不会被解析。

用户媒介

配置好媒介类型后，进入 用户 → 用户 部分，编辑用户资料，并将此媒介类型分配给该用户。 设置用户媒介的步骤对所有媒介类型都相同，详见媒介类型页面。

请注意，在定义用户媒介时，发送到 字段不能为空。 如果告警脚本中未使用此字段，请输入任意受支持字符的组合以绕过验证要求。