Nagios 监控运维完整教程 / 第6章：联系人与通知

第6章：联系人与通知

通知是监控系统的核心价值之一——及时将告警信息传达给相关人员。本章详细讲解联系人管理、通知命令、通知升级、过滤和静默机制。

一、联系人定义

1.1 联系人对象

define contact {
    contact_name                    zhangsan
    alias                           张三 - 系统运维工程师
    email                           [email protected]
    pager                           [email protected]

    # 主机通知配置
    host_notification_period        24x7
    host_notification_options       d,u,r
    host_notification_commands      notify-host-by-email,notify-host-by-sms

    # 服务通知配置
    service_notification_period     24x7
    service_notification_options    w,u,c,r
    service_notification_commands   notify-service-by-email,notify-service-by-sms

    # 模板
    use                             generic-contact

    # 高级选项
    can_submit_commands             1
    retain_status_information       1
    retain_nonstatus_information    1
}

1.2 通知选项详解

标志	主机通知	服务通知	说明
`d`	DOWN	-	主机变为 DOWN 状态
`u`	UNREACHABLE	UNKNOWN	不可达/未知状态
`r`	RECOVERY	RECOVERY	恢复正常
`w`	-	WARNING	警告状态
`c`	-	CRITICAL	严重状态
`f`	FLAPPING	FLAPPING	抖动状态
`s`	DOWNTIME	DOWNTIME	计划维护时段
`n`	None	None	不发送通知

1.3 联系人模板

define contact {
    name                                generic-contact
    service_notification_period         24x7
    host_notification_period            24x7
    service_notification_options        w,u,c,r
    host_notification_options           d,u,r
    service_notification_commands       notify-service-by-email
    host_notification_commands          notify-host-by-email
    register                            0
}

# 邮件+短信通知模板
define contact {
    name                                contact-with-sms
    use                                 generic-contact
    service_notification_commands       notify-service-by-email,notify-service-by-sms
    host_notification_commands          notify-host-by-email,notify-host-by-sms
    register                            0
}

# 仅邮件通知模板
define contact {
    name                                email-only-contact
    use                                 generic-contact
    service_notification_commands       notify-service-by-email
    host_notification_commands          notify-host-by-email
    register                            0
}

二、联系人组

2.1 联系人组定义

define contactgroup {
    contactgroup_name       admins
    alias                   系统管理员
    members                 zhangsan,lisi,wangwu
    contactgroup_members    senior-ops  # 嵌套联系人组
}

define contactgroup {
    contactgroup_name       web-ops
    alias                   Web 运维组
    members                 zhangsan,lisi
}

define contactgroup {
    contactgroup_name       dba-team
    alias                   DBA 团队
    members                 wangwu,zhaoliu
}

define contactgroup {
    contactgroup_name       senior-ops
    alias                   高级运维
    members                 ops-manager
}

define contactgroup {
    contactgroup_name       all-ops
    alias                   全部运维人员
    contactgroup_members    admins,web-ops,dba-team
}

2.2 联系人组在主机/服务中的应用

# 主机通知联系人组
define host {
    use                 linux-server
    host_name           web-server-01
    address             192.168.1.100
    contact_groups      web-ops
}

# 服务通知联系人组
define service {
    use                 generic-service
    host_name           db-server-01
    service_description MySQL
    check_command       check_mysql
    contact_groups      dba-team
}

三、通知命令

3.1 邮件通知命令

# 主机邮件通知
define command {
    command_name    notify-host-by-email
    command_line    /usr/bin/printf "%b" "\
        ***** Nagios *****\n\n\
        Notification Type: $NOTIFICATIONTYPE$\n\
        Host: $HOSTNAME$\n\
        State: $HOSTSTATE$\n\
        Address: $HOSTADDRESS$\n\
        Info: $HOSTOUTPUT$\n\n\
        Date/Time: $LONGDATETIME$\n" | \
        /usr/bin/mail -s "** $NOTIFICATIONTYPE$ Host Alert: $HOSTNAME$ is $HOSTSTATE$ **" $CONTACTEMAIL$
}

# 服务邮件通知
define command {
    command_name    notify-service-by-email
    command_line    /usr/bin/printf "%b" "\
        ***** Nagios *****\n\n\
        Notification Type: $NOTIFICATIONTYPE$\n\n\
        Service: $SERVICEDESC$\n\
        Host: $HOSTNAME$\n\
        Address: $HOSTADDRESS$\n\
        State: $SERVICESTATE$\n\n\
        Date/Time: $LONGDATETIME$\n\
        Additional Info:\n\n\
        $SERVICEOUTPUT$\n\n\
        Comment: [$SERVICEACKCOMMENT$]\n" | \
        /usr/bin/mail -s "** $NOTIFICATIONTYPE$ Service Alert: $HOSTNAME$/$SERVICEDESC$ is $SERVICESTATE$ **" $CONTACTEMAIL$
}

3.2 短信通知命令

# 通过短信网关发送短信
define command {
    command_name    notify-host-by-sms
    command_line    /usr/bin/curl -s \
        "http://sms.gateway.com/send?phone=$CONTACTPAGER$&message=Host+$HOSTNAME$+is+$HOSTSTATE$" \
        > /dev/null
}

define command {
    command_name    notify-service-by-sms
    command_line    /usr/bin/curl -s \
        "http://sms.gateway.com/send?phone=$CONTACTPAGER$&message=$HOSTNAME$/$SERVICEDESC$+is+$SERVICESTATE$" \
        > /dev/null
}

3.3 企业微信/钉钉通知

# 钉钉机器人通知
define command {
    command_name    notify-service-by-dingtalk
    command_line    /usr/bin/curl -s -X POST \
        "https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
            "msgtype": "markdown",
            "markdown": {
                "title": "Nagios 告警",
                "text": "## Nagios 告警通知\n\n- **通知类型**: $NOTIFICATIONTYPE$\n- **主机**: $HOSTNAME$\n- **服务**: $SERVICEDESC$\n- **状态**: $SERVICESTATE$\n- **信息**: $SERVICEOUTPUT$\n- **时间**: $LONGDATETIME$"
            }
        }'
}

# 企业微信通知
define command {
    command_name    notify-service-by-wechat
    command_line    /usr/bin/curl -s -X POST \
        "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY" \
        -H 'Content-Type: application/json' \
        -d '{
            "msgtype": "markdown",
            "markdown": {
                "content": "## Nagios 告警\n> 主机: $HOSTNAME$\n> 服务: $SERVICEDESC$\n> 状态: <font color=\"warning\">$SERVICESTATE$</font>\n> 时间: $LONGDATETIME$"
            }
        }'
}

3.4 电话通知

# 通过 Twilio API 发送语音通知
define command {
    command_name    notify-host-by-phone
    command_line    /usr/bin/curl -s -X POST \
        "https://api.twilio.com/2010-04-01/Accounts/YOUR_SID/Calls.json" \
        -u "YOUR_SID:YOUR_AUTH_TOKEN" \
        --data-urlencode "To=$CONTACTPAGER$" \
        --data-urlencode "From=+1234567890" \
        --data-urlencode "Url=http://your-server/voice-alert.php?host=$HOSTNAME$&state=$HOSTSTATE$" \
        > /dev/null
}

四、通知升级

4.1 主机通知升级

# 当主机 DOWN 超过 30 分钟后，通知高级运维
define hostescalation {
    host_name               web-server-01
    first_notification      3      # 第 3 次通知开始
    last_notification       0      # 0 = 无限（直到恢复）
    notification_interval   30     # 每 30 分钟通知一次
    contact_groups          senior-ops
    escalation_period       24x7
    escalation_options      d,u
}

# 当主机 DOWN 超过 2 小时后，通知管理层
define hostescalation {
    host_name               web-server-01
    first_notification      7
    last_notification       0
    notification_interval   60
    contact_groups          management
    escalation_period       24x7
    escalation_options      d,u
}

4.2 服务通知升级

# 初始通知：运维团队
# 默认配置在服务定义中

# 15 分钟后升级：高级运维
define serviceescalation {
    host_name               web-server-01
    service_description     HTTP
    first_notification      2
    last_notification       5
    notification_interval   10
    contact_groups          senior-ops
    escalation_period       24x7
    escalation_options      w,u,c,r
}

# 1 小时后升级：管理层
define serviceescalation {
    host_name               web-server-01
    service_description     HTTP
    first_notification      6
    last_notification       0
    notification_interval   30
    contact_groups          management
    escalation_period       24x7
    escalation_options      c,r
}

4.3 批量升级配置

# 使用主机/服务组批量配置升级
define serviceescalation {
    hostgroup_name          webservers
    service_description     HTTP
    first_notification      3
    last_notification       0
    notification_interval   15
    contact_groups          senior-ops
    escalation_period       24x7
    escalation_options      c
}

4.4 通知升级流程图

服务变为 CRITICAL
    │
    ▼
第 1 次通知 → 运维团队（web-ops）
    │ (5分钟后未恢复)
    ▼
第 2 次通知 → 高级运维（senior-ops）
    │ (10分钟后未恢复)
    ▼
第 3 次通知 → 高级运维（senior-ops）
    │ (15分钟后未恢复)
    ▼
第 4 次通知 → 高级运维（senior-ops）
    │ (30分钟后未恢复)
    ▼
第 5 次通知 → 高级运维（senior-ops）
    │ (30分钟后未恢复)
    ▼
第 6 次通知 → 管理层（management）
    │ (继续...)
    ▼
直到恢复或确认

五、通知过滤

5.1 基于时间段过滤

# 仅在工作时间通知
define service {
    ...
    notification_period     workhours
}

# 全天候通知（关键服务）
define service {
    ...
    notification_period     24x7
}

5.2 基于状态过滤

# 仅通知 CRITICAL 和 RECOVERY
define service {
    ...
    notification_options    c,r
}

# 通知所有状态变化
define service {
    ...
    notification_options    w,u,c,r
}

5.3 基于联系人过滤

# 不同服务通知不同团队
define service {
    use                 generic-service
    host_name           web-server-01
    service_description HTTP
    contact_groups      web-ops      # Web 团队
}

define service {
    use                 generic-service
    host_name           db-server-01
    service_description MySQL
    contact_groups      dba-team     # DBA 团队
}

六、静默与维护

6.1 按计划停机（Downtime）

# 通过 Web 界面设置计划停机
# 或通过命令文件：

# 设置主机停机（2小时）
echo "[$(date +%s)] SCHEDULE_HOST_DOWNTIME;web-server-01;$(date +%s);$(date -d '+2 hours' +%s);1;0;2;admin;Planned maintenance" \
    >> /var/log/nagios/rw/nagios.cmd

# 参数说明：
# SCHEDULE_HOST_DOWNTIME;主机名;开始时间;结束时间;固定/灵活;触发ID;持续时间;用户;备注
# 固定=1, 灵活=0

6.2 取消通知（Acknowledge）

# 确认问题（停止重复通知）
echo "[$(date +%s)] ACKNOWLEDGE_HOST_PROBLEM;web-server-01;2;1;0;zhangsan;已知故障，正在处理" \
    >> /var/log/nagios/rw/nagios.cmd

# 参数：ACKNOWLEDGE_HOST_PROBLEM;主机名;粘性;通知;持久;作者;备注
# 粘性: 0=非粘性, 1=粘性, 2=粘性+下一检查

6.3 禁用/启用通知

# 禁用主机通知
echo "[$(date +%s)] DISABLE_HOST_NOTIFICATIONS;web-server-01" \
    >> /var/log/nagios/rw/nagios.cmd

# 启用主机通知
echo "[$(date +%s)] ENABLE_HOST_NOTIFICATIONS;web-server-01" \
    >> /var/log/nagios/rw/nagios.cmd

# 禁用服务通知
echo "[$(date +%s)] DISABLE_SERVICE_NOTIFICATIONS;web-server-01;HTTP" \
    >> /var/log/nagios/rw/nagios.cmd

# 禁用全局通知
echo "[$(date +%s)] DISABLE_NOTIFICATIONS" \
    >> /var/log/nagios/rw/nagios.cmd

6.4 批量静默脚本

#!/bin/bash
# batch_downtime.sh - 批量设置维护窗口

HOSTGROUP=$1
DURATION=$2  # 分钟
START=$(date +%s)
END=$(date -d "+${DURATION} minutes" +%s)

# 获取主机组成员
HOSTS=$(nagios -v /etc/nagios/nagios.cfg 2>&1 | grep "hostgroup_name.*${HOSTGROUP}" -A 20 | grep members | sed 's/.*: //')

for HOST in $(echo $HOSTS | tr ',' ' '); do
    echo "[$(date +%s)] SCHEDULE_HOST_DOWNTIME;${HOST};${START};${END};1;0;0;admin;Scheduled maintenance" \
        >> /var/log/nagios/rw/nagios.cmd
    echo "已设置 $HOST 维护窗口: ${DURATION} 分钟"
done

七、通知模板定制

7.1 丰富格式的通知

define command {
    command_name    notify-service-by-email-html
    command_line    /usr/bin/printf "%b" "\
        <html>\
        <head><style>\
            body { font-family: Arial; }\
            .critical { color: red; font-weight: bold; }\
            .warning { color: orange; }\
            .ok { color: green; }\
        </style></head>\
        <body>\
        <h2>Nagios 告警通知</h2>\
        <table border='1' cellpadding='5'>\
        <tr><td><b>通知类型</b></td><td>$NOTIFICATIONTYPE$</td></tr>\
        <tr><td><b>主机</b></td><td>$HOSTNAME$ ($HOSTADDRESS$)</td></tr>\
        <tr><td><b>服务</b></td><td>$SERVICEDESC$</td></tr>\
        <tr><td><b>状态</b></td><td class='$(echo $SERVICESTATE$ | tr A-Z a-z)'>$SERVICESTATE$</td></tr>\
        <tr><td><b>输出</b></td><td>$SERVICEOUTPUT$</td></tr>\
        <tr><td><b>时间</b></td><td>$LONGDATETIME$</td></tr>\
        </table>\
        </body></html>" | \
        /usr/bin/mail -s "$(echo $SERVICESTATE$ | tr a-z A-Z): $HOSTNAME$/$SERVICEDESC$" \
        -a "Content-Type: text/html" $CONTACTEMAIL$
}

7.2 通知宏变量参考

宏	说明	示例值
$NOTIFICATIONTYPE$	通知类型	PROBLEM, RECOVERY, ACKNOWLEDGEMENT
$CONTACTEMAIL$	联系人邮箱	[email protected]
$CONTACTNAME$	联系人名称	zhangsan
$HOSTNAME$	主机名	web-server-01
$HOSTADDRESS$	主机地址	192.168.1.100
$HOSTSTATE$	主机状态	DOWN, UP, UNREACHABLE
$HOSTOUTPUT$	主机检查输出	PING CRITICAL - Packet Loss = 100%
$SERVICEDESC$	服务描述	HTTP
$SERVICESTATE$	服务状态	CRITICAL, WARNING, OK
$SERVICEOUTPUT$	服务检查输出	Connection refused
$LONGDATETIME$	完整日期时间	Mon Jan 01 12:00:00 CST 2024
$SERVICEACKCOMMENT$	确认备注	已知故障

八、业务场景示例

8.1 分级通知策略

# 一线运维：所有告警
define contactgroup {
    contactgroup_name   l1-ops
    alias               一线运维
    members             operator1,operator2
}

# 二线专家：严重告警
define contactgroup {
    contactgroup_name   l2-ops
    alias               二线专家
    members             expert1,expert2
}

# 管理层：持续严重告警
define contactgroup {
    contactgroup_name   management
    alias               管理层
    members             ops-manager,cto
}

# 升级策略
define serviceescalation {
    hostgroup_name          production
    service_description     *
    first_notification      1
    last_notification       3
    notification_interval   5
    contact_groups          l1-ops
}

define serviceescalation {
    hostgroup_name          production
    service_description     *
    first_notification      4
    last_notification       8
    notification_interval   10
    contact_groups          l2-ops
}

define serviceescalation {
    hostgroup_name          production
    service_description     *
    first_notification      9
    last_notification       0
    notification_interval   30
    contact_groups          management
}

九、注意事项

注意事项	说明
通知风暴防护	设置合理的 `notification_interval`，避免重复告警
联系人轮值	使用多个联系人组实现轮值机制
通知确认	鼓励使用 ACKNOWLEDGE 减少重复通知
静默审批	计划停机应有审批流程
测试通知	定期测试通知命令确保可达
敏感信息	通知内容中不要包含密码等敏感信息

十、本章小结

联系人定义接收通知的人员及其联系方式
联系人组将联系人组织为团队
通知命令定义如何发送通知（邮件、短信、IM）
通知升级实现分层响应机制
静默机制通过停机和确认管理告警

下一章：第7章：命令与插件开发 - 学习命令定义和自定义插件开发。