Opsview 告警集成

Opsview 支持添加自定义通知方法（Custom Notification Method）：Opsview 在通知时执行您安装的脚本，并把告警内容通过 NAGIOS_ 开头的环境变量（NAGIOS_HOSTNAME、NAGIOS_SERVICEDESC、NAGIOS_NOTIFICATIONTYPE 等）传给它。用一个脚本把这些内容以标准告警事件格式推送给 Flashduty 即可：问题通知触发告警，恢复通知关闭告警。

在 Opsview 中配置

在 Orchestrator 上创建通知脚本

操作路径：Opsview Orchestrator 服务器 › notify_by_flashduty

项	填写
文件	新建 `notify_by_flashduty`，并设置为可执行（`chmod +x`）
第一个参数（必填）	`{integration_url}`，推送地址通过脚本的第一个参数传入，不写在脚本里
依赖	脚本使用 `curl`；如果通知方法在 Collector 上运行，Collector 上也要安装 `curl`，并能访问 `api.flashcat.cloud`

#!/bin/sh
# Opsview custom notification method: forward host/service notifications to a
# Flashduty Standard Alert Event integration. The push URL is the first argument.
URL="$1"
[ -n "$URL" ] || exit 1

case "$NAGIOS_NOTIFICATIONTYPE" in
  PROBLEM|RECOVERY) ;;
  *) exit 0 ;;   # ignore acknowledgements, flapping and downtime notifications
esac

if [ -n "$NAGIOS_SERVICEDESC" ]; then
  KEY="opsview:$NAGIOS_HOSTNAME:$NAGIOS_SERVICEDESC"
  STATE="$NAGIOS_SERVICESTATE"
  OUTPUT="$NAGIOS_SERVICEOUTPUT"
  CHECK="$NAGIOS_SERVICEDESC"
  TITLE="$NAGIOS_HOSTNAME - $NAGIOS_SERVICEDESC - $STATE"
else
  KEY="opsview:$NAGIOS_HOSTNAME"
  STATE="$NAGIOS_HOSTSTATE"
  OUTPUT="$NAGIOS_HOSTOUTPUT"
  CHECK="host"
  TITLE="$NAGIOS_HOSTNAME - $STATE"
fi

if [ "$NAGIOS_NOTIFICATIONTYPE" = "RECOVERY" ]; then
  STATUS=Ok
else
  case "$STATE" in
    CRITICAL|DOWN|UNREACHABLE) STATUS=Critical ;;
    WARNING)                   STATUS=Warning ;;
    OK|UP)                     STATUS=Ok ;;
    *)                         STATUS=Info ;;
  esac
fi

esc() { printf '%s' "$1" | tr '\n\r\t' '   ' | sed 's/\\/\\\\/g; s/"/\\"/g'; }

JSON=$(printf '{"title_rule":"%s","event_status":"%s","alert_key":"%s","description":"%s","labels":{"resource":"%s","check":"%s","host_address":"%s","host_alias":"%s","opsview_keywords":"%s"}}' \
  "$(esc "$TITLE")" "$STATUS" "$(esc "$KEY")" "$(esc "$OUTPUT")" "$(esc "$NAGIOS_HOSTNAME")" "$(esc "$CHECK")" \
  "$(esc "$NAGIOS_HOSTADDRESS")" "$(esc "$NAGIOS_HOSTALIAS")" "$(esc "$OPSVIEW_KEYWORDS")")

curl -fsS -m 10 -X POST -H 'Content-Type: application/json' -d "$JSON" "$URL" >/dev/null

脚本读取的环境变量都在 Opsview 文档列出的通知环境变量中，处理规则如下：

环境变量	用途
`NAGIOS_NOTIFICATIONTYPE`	只处理 `PROBLEM` 和 `RECOVERY`；`ACKNOWLEDGEMENT`、`FLAPPINGSTART` 等类型直接忽略
`NAGIOS_SERVICEDESC`	非空表示服务告警，否则是主机告警
`NAGIOS_HOSTNAME`、`NAGIOS_SERVICEDESC`	Alert Key：服务为 `opsview:<主机名>:<服务名>`，主机为 `opsview:<主机名>`；标题为 `<主机名> - <服务名> - <状态>` 或 `<主机名> - <状态>`
`NAGIOS_SERVICESTATE`、`NAGIOS_HOSTSTATE`	告警等级：`CRITICAL`、`DOWN`、`UNREACHABLE` → Critical；`WARNING` → Warning；`OK`、`UP` → 恢复；其他（`UNKNOWN`）→ Info。`RECOVERY` 通知一律按恢复处理
`NAGIOS_SERVICEOUTPUT`、`NAGIOS_HOSTOUTPUT`	告警描述
`NAGIOS_HOSTADDRESS`、`NAGIOS_HOSTALIAS`、`OPSVIEW_KEYWORDS`	标签 `host_address`、`host_alias`、`opsview_keywords`；`NAGIOS_HOSTNAME` 写入标签 `resource`

在 Orchestrator 上导入脚本并应用变更

操作路径：Opsview Orchestrator 服务器的终端；Opsview › Configuration › Apply Changes以 opsview 用户导入脚本：

sudo -u opsview /opt/opsview/orchestrator/bin/orchestratorimportscripts notifications /path/to/notify_by_flashduty

导入后进入 Configuration › Apply Changes 完成脚本安装。

在 Opsview 中添加通知方法

操作路径：Opsview › Configuration › Notification Methods › Add New

字段	填写
Name（必填）	`Flashduty`
Enable	勾选
Run On（必填）	在 Orchestrator 或 Collector 上运行
Command（必填）	`notify_by_flashduty {integration_url}`（脚本默认从 `/opt/opsview/monitoringscripts/notifications` 读取，参数写在脚本名后面）

保存后再次进入 Configuration › Apply Changes，让新通知方法生效。

把通知方法加入用户的 Notification Profile

操作路径：Opsview › Configuration › Users and Roles › Users › 编辑用户 › Notification Profiles › Add NewOpsview 的通知由用户的 Notification Profile 决定，每个要接收 Flashduty 通知的用户都要选择这个通知方法（也可以从右上角的用户名进入 My Profile）：

字段	填写
Alert me by	`Flashduty`
During	生效的时间段
Host and Services	选择要通知的主机组和服务检查，并勾选要通知的状态，需要同时包含问题状态和恢复状态，否则 Flashduty 收不到恢复通知

点击 Update，再点击 Submit Changes，最后进入 Configuration › Apply Changes 使配置生效。也可以在 Shared Notification Profiles 中创建共享配置，分配给多个用户。

用 test_notifications 测试脚本并确认真实告警

操作路径：Opsview Orchestrator 服务器的终端Opsview 提供 test_notifications 工具，模拟 Nagios Core 通知时设置的环境变量，用它测试脚本：

# 主机问题
sudo -u opsview /opt/opsview/coreutils/utils/test_notifications hostproblem /path/to/notify_by_flashduty '{integration_url}'
# 服务问题
sudo -u opsview /opt/opsview/coreutils/utils/test_notifications serviceproblem /path/to/notify_by_flashduty '{integration_url}'

测试会向 Flashduty 发送真实事件，确认告警出现后在 Flashduty 中手动关闭；集成显示 最新事件时间，说明脚本和推送地址正确。该测试绕过通知方法和 Notification Profile，不能证明它们已生效，请在 Opsview 中让一个受监控对象真实变为非 OK 状态再恢复，确认问题与恢复通知都到达 Flashduty。没有出现告警时，按下文“排查问题”查看脚本实际收到的环境变量。

如果通知方法设置为在 Collector 上运行，需要在 Collector 服务器上同样测试脚本。

恢复与去重

同一台主机或同一个服务始终使用同一个 Alert Key，重复的问题通知（例如 Opsview 的重复通知间隔）只更新同一条告警，RECOVERY 通知恢复它
服务从 WARNING 变为 CRITICAL 时，等级在同一条告警上更新
确认（ACKNOWLEDGEMENT）、抖动（FLAPPING*）和停机维护（DOWNTIME*）通知被脚本忽略，不会在 Flashduty 产生事件

排查问题

没有收到告警：确认 Notification Profile 中选择了 Flashduty 且已执行 Apply Changes；在 Opsview 的 Notifications View 查看通知是否已发送；用 test_notifications 单独测试脚本
测试成功但真实告警没有推送：脚本在真实通知中读取的是 Opsview 传入的环境变量；在脚本开头加入 { date; echo "Called with $@"; env; echo; } >> /tmp/env.txt（Opsview 文档给出的排查方法）查看实际收到的变量
告警没有恢复：确认 Notification Profile 勾选了恢复状态；Nagios 只在发过问题通知后才发送对应的恢复通知
Flashduty 返回参数错误：确认 Command 里的推送地址完整，包含 integration_key

更多说明请参阅 Opsview 文档 Custom Notification Methods 和 Notification Profiles。

快速开始

产品对比

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

在 Flashduty On-call

使用专属集成

使用共享集成

在 Opsview 中配置

恢复与去重

排查问题