Nagios 告警事件

在 Nagios

不同的系统和安装方式，Nagios 的安装路径可能不同，请根据实际情况调整以下配置中的路径。

一、下载通知脚本

Debian/Ubuntu 系统（通常为 /usr/lib/nagios/plugins/）：

cd /usr/lib/nagios/plugins/
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/send_to_flashduty.sh
chmod +x send_to_flashduty.sh

RHEL/CentOS 系统（通常为 /usr/lib64/nagios/plugins/）：

cd /usr/lib64/nagios/plugins/
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/send_to_flashduty.sh
chmod +x send_to_flashduty.sh

源码安装（通常为 /usr/local/nagios/libexec/）：

cd /usr/local/nagios/libexec/
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/send_to_flashduty.sh
chmod +x send_to_flashduty.sh

脚本中使用了 curl 命令，请确保 Nagios Server 上已安装 curl。

二、创建 Flashduty 配置文件

下载 Flashduty 配置文件到 Nagios 配置目录：

Debian/Ubuntu 系统（通常为 /etc/nagios3/conf.d/）：

cd /etc/nagios3/conf.d/
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/flashduty.cfg

RHEL/CentOS 系统（通常为 /etc/nagios/objects/）：

cd /etc/nagios/objects/
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/flashduty.cfg

源码安装（通常为 /usr/local/nagios/etc/objects/）：

cd /usr/local/nagios/etc/objects/
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/flashduty.cfg

三、修改配置文件

编辑下载的 flashduty.cfg 文件，修改以下内容：

将 pager 字段的值替换为你在 Flashduty 控制台获取的集成推送地址
根据你的 Nagios 安装路径，修改 command_line 中脚本的路径

配置文件内容示例：

define contact {
    contact_name                    Flashduty
    alias                           Flashduty Alert Receiver
    service_notification_commands   notify-service-by-Flashduty
    host_notification_commands      notify-host-by-Flashduty
    service_notification_options    w,u,c,r
    host_notification_options       d,u,r
    service_notification_period     24x7
    host_notification_period        24x7
    pager                           <YOUR_FLASHDUTY_PUSH_URL>
}

define command {
    command_name    notify-host-by-Flashduty
    command_line    <NAGIOS_PLUGIN_PATH>/send_to_flashduty.sh type=HOST WEBHOOK_URL="$CONTACTPAGER$" hostname="$HOSTNAME$" state="$HOSTSTATE$" output="$HOSTOUTPUT$" notification_type="$NOTIFICATIONTYPE$" time="$LONGDATETIME$" host_address="$HOSTADDRESS$" host_alias="$HOSTALIAS$" check_command="$HOSTCHECKCOMMAND$"
}

define command {
    command_name    notify-service-by-Flashduty
    command_line    <NAGIOS_PLUGIN_PATH>/send_to_flashduty.sh type=SERVICE WEBHOOK_URL="$CONTACTPAGER$" hostname="$HOSTNAME$" state="$SERVICESTATE$" output="$SERVICEOUTPUT$" notification_type="$NOTIFICATIONTYPE$" time="$LONGDATETIME$" host_address="$HOSTADDRESS$" service_desc="$SERVICEDESC$" host_alias="$HOSTALIAS$" max_attempts="$MAXSERVICEATTEMPTS$"
}

参数说明：

pager：Flashduty 推送地址，即你在 Flashduty 控制台获取的集成推送地址
<NAGIOS_PLUGIN_PATH>：需要替换为实际的脚本路径，如 /usr/local/nagios/libexec
service_notification_options：服务告警通知选项，w=警告，u=未知，c=严重，r=恢复
host_notification_options：主机告警通知选项，d=宕机，u=不可达，r=恢复

如需在告警中携带更多信息，可以在 command_line 末尾按照 key=value 格式追加参数，例如：environment="production" region="$_HOSTREGION$"。这些参数将作为标签（labels）推送到 Flashduty。

四、引入配置文件

如果你使用的是 RHEL/CentOS 系统 或 源码安装，需要在 Nagios 主配置文件中引入 Flashduty 配置文件。

RHEL/CentOS 系统：编辑 /etc/nagios/nagios.cfg，添加：

cfg_file=/etc/nagios/objects/flashduty.cfg

源码安装：编辑 /usr/local/nagios/etc/nagios.cfg，添加：

cfg_file=/usr/local/nagios/etc/objects/flashduty.cfg

Debian/Ubuntu 系统通常会自动加载 /etc/nagios3/conf.d/ 目录下的所有配置文件，无需手动引入。

五、将 Flashduty 添加到联系人组

编辑联系人配置文件，将 Flashduty 联系人添加到 admins 联系人组（或你使用的其他联系人组）：

Debian/Ubuntu 系统：编辑 /etc/nagios3/conf.d/contacts_nagios2.cfg
RHEL/CentOS 系统：编辑 /etc/nagios/objects/contacts.cfg
源码安装：编辑 /usr/local/nagios/etc/objects/contacts.cfg

找到联系人组定义，将 Flashduty 添加到成员列表：

define contactgroup {
    contactgroup_name       admins
    alias                   Nagios Administrators
    members                 nagiosadmin,Flashduty
}

六、验证配置并重启服务

验证 Nagios 配置文件：

Debian/Ubuntu 系统：

/usr/sbin/nagios3 -v /etc/nagios3/nagios.cfg

RHEL/CentOS 系统：

/usr/sbin/nagios -v /etc/nagios/nagios.cfg

源码安装：

/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg

如果验证通过，重启 Nagios 服务：

# Debian/Ubuntu
systemctl restart nagios3

# RHEL/CentOS/源码安装
systemctl restart nagios

完成配置后，当 Nagios 检测到告警时，将自动推送到 Flashduty。

状态对照

Nagios 到 Flashduty 告警等级映射关系：

Nagios	Flashduty	状态
CRITICAL	Critical	严重
DOWN	Critical	严重
UNREACHABLE	Critical	严重
WARNING	Warning	警告
OK	Ok	恢复
UP	Ok	恢复
UNKNOWN	Info	提醒

快速开始

产品对比

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

在 Flashduty On-call

使用专属集成

使用共享集成

在 Nagios

一、下载通知脚本

二、创建 Flashduty 配置文件

三、修改配置文件

四、引入配置文件

五、将 Flashduty 添加到联系人组

六、验证配置并重启服务

状态对照

​在 Flashduty On-call

​使用专属集成

​使用共享集成

​在 Nagios

​一、下载通知脚本

​二、创建 Flashduty 配置文件

​三、修改配置文件

​四、引入配置文件

​五、将 Flashduty 添加到联系人组

​六、验证配置并重启服务

​状态对照

在 Flashduty On-call

使用专属集成

使用共享集成

在 Nagios

一、下载通知脚本

二、创建 Flashduty 配置文件

三、修改配置文件

四、引入配置文件

五、将 Flashduty 添加到联系人组

六、验证配置并重启服务

状态对照