對象的定義

介紹

Nagios對象配置格式的功能之一是，您可以創建從其他對象定義繼承屬性的對象定義。關于對象繼承如何工作的解釋可以在這里找到。我強烈建議您閱讀下面介紹的文檔后，熟悉一下對象繼承，因為它會使創建和維護對象定義的工作比以前容易得多。另外，請閱讀對象技巧，這些技巧為完成繁瑣的配置任務提供了捷徑。

創建和/或編輯配置文件時，請記住以下幾點：

1. 以“＃”字符開頭的行將被視為注釋，并且不會被處理
2. 指令名稱區分大小寫
3. 在配置行中在分號（;）之后出現的字符被視為注釋，并且不進行處理

通用指令

這三個指令是所有對象定義所共有的：

• 名稱
• 用
• 寄存器

有關模板如何工作的詳細信息，請參閱帶有模板的對象繼承。

保留說明

重要的是要指出，在配置文件中更改主機，服務和聯系人定義中的多個指令時，Nagios可能不會使用它們。可能表現出這種行為的對象指令標有星號（*）。這樣做的原因行為是由于這樣的事實，Nagios的選擇存儲在榮譽值的狀態保持文件交換值在配置文件中發現，假設你狀態保持的程序范圍內的基礎上啟用和指令的值被改變在運行時使用外部命令。

解決此問題的一種方法是使用主機，服務和聯系人定義中的retain_nonstatus_information偽指令禁用非狀態信息的保留。禁用此指令將使Nagios從配置文件中獲取這些指令的初始值，而不是從（重新）啟動時從狀態保留文件中獲取這些指令的初始值。

注意：當您遵循快速入門安裝指南時，示例對象配置文件將安裝在/ usr / local / nagios / etc /目錄中。

文件包含，級聯配置和“ include_file”指令

使用include_file = <文件名>和include_dir = 指令，對象定義文件可以包括其他對象定義文件。前者包括指定的單個文件，后者將處理所有在指定目錄中以.cfg擴展名結尾的文件。可以重復這些指令以包括多個文件/目錄。指令不允許在對象的實際定義中出現，并且應出現在任何對象定義之前，之后或之間。

它們與主配置文件中的cfg_file =和cfg_dir =指令緊密相關。這些指令可以鏈接在一起。例如，使用cfg_file =或cfg_dir =指令從主配置文件包含的對象定義文件可以使用include_file =或include_dir =來包含另一個對象定義文件，后者又可以使用include_file =或include_dir =來包含另一個對象定義文件等。

當某些對象是動態的但需要引入許多配置時，或者某些配置文件增長到無法控制的大小時，這很有用。

對象類型

主機定義
主機組定義
服務定義
服務組定義
聯系人定義
聯系人組定義
時間段定義
命令定義
服務依賴項定義
服務升級定義
主機依賴項定義
主機升級定義
擴展主機信息定義（不推薦使用）
擴展服務信息定義（不推薦使用）

主機定義

描述：

主機定義用于定義網絡上的物理服務器，工作站，設備等。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義主機{
    host_name偽路由器
    別名假路由器＃1
    地址192.168.1.254
    父母服務器骨干
    check_command檢查主機有效
    check_interval 5
    retry_interval 1
    max_check_attempts 5
    check_period 24x7
    process_perf_data 0
    keep_nonstatus_information 0
    contact_groups路由器管理員
    notification_interval 30
    notification_period 24x7
    notification_options d，u，r
}

指令說明：

主機組定義

描述：

主機組定義用于將一個或多個主機組合在一起，以簡化具有對象技巧的配置或在CGI中顯示的目的。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義主機組{
    hostgroup_name Novell服務器
    別名Novell服務器
    成員netware1，netware2，netware3，netware4
}

指令說明：

服務定義

描述：

服務定義用于標識在主機上運行的“服務”。術語“服務”非常寬松地使用。它可能意味著在主機上運行的實際服務（POP，SMTP，HTTP等）或與主機相關聯的某種其他類型的指標（響應ping，登錄用戶數，可用磁盤空間等）。 。下面概述了服務定義的不同參數。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義服務{
    host_name linux服務器
    service_description檢查磁盤sda1
    check_command檢查磁盤！/ dev / sda1
    max_check_attempts 5
    check_interval 5
    retry_interval 3
    check_period 24x7
    notification_interval 30
    notification_period 24x7
    notification_options w，c，r
    contact_groups linux-admins
}

指令說明：

服務組定義

描述：

服務組定義用于將一個或多個服務組合在一起，以簡化具有對象技巧或CGI中顯示目的的配置。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義服務組{
    servicegroup_name dbservices
    別名數據庫服務
    成員ms1，SQL Server，ms1，SQL Server代理，ms1，SQL DTC
}

指令說明：

接觸定義

描述：

聯系人定義用于識別在您的網絡出現問題時應聯系的人。聯系人定義的不同參數如下所述。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義聯系人{
    contact_name jdoe
    別名John Doe
    host_notifications_enabled 1
    service_notifications_enabled 1
    service_notification_period 24x7
    host_notification_period 24x7
    service_notification_options w，u，c，r
    host_notification_options d，u，r
    service_notification_commands通過電子郵件通知
    host_notification_commands主機通過電子郵件通知
    電子郵件jdoe@localhost.localdomain
    傳呼機555-5555@pagergateway.localhost.localdomain
    地址1 xxxxx.xyyy@icq.com
    地址2 555-555-5555
    can_submit_commands 1
}

指令說明：

聯系人組定義

描述：

聯系人組定義用于將一個或多個聯系人分組在一起，以發出警報/恢復通知。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義聯系人組{
    contactgroup_name Novell-admins
    別名Novell Administrators
    成員jdoe，rtobert，tzach
}

指令說明：

時間段定義

描述：

時間段是在各個天中被視為通知和服務檢查的“有效”時間的時間列表。它包含一周中每一天結束后每周“旋轉”的時間范圍。支持正常每周時間的不同類型的例外，包括：特定的工作日，一般月份的天，特定月份的天和日歷日期。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義時間{
    timeperiod_name非工作時間
    別名非工作時間
    星期日00：00-24：00; 每周的每個星期日
    星期一00：00-09：00,17：00-24：00; 每周的每個星期一
    周二00：00-09：00,17：00-24：00; 每周的每個星期二
    周三00：00-09：00,17：00-24：00; 每周的每個星期三
    星期四00：00-09：00,17：00-24：00; 每周的每個星期四
    星期五00：00-09：00,17：00-24：00; 每周的每個星期五
    星期六00：00-24：00; 每周的每個星期六
}

定義時間{
    timeperiod_name錯誤單日
    別名雜項單日
    1999-01-28 00：00-24：00; 1999年1月28日
    星期一3 00：00-24：00; 每個月的第三個星期一
    第2天00：00-24：00; 每月第二天
    2月10日00：00-24：00; 每年2月10日
    2月-1日00：00-24：00; 每年2月的最后一天
    星期五-2 00：00-24：00; 每個月的第二個到最后一個星期五
    11月-1日星期四00：00-24：00; 每年11月的最后一個星期四
}

定義時間{
    timeperiod_name錯誤日期范圍
    別名雜項日期范圍
    2007-01-01-2008-02-01 00：00-24：00; 2007年1月1日至2008年2月1日
    星期一3-星期四4 00：00-24：00; 每個月的第3個星期一至第4個星期四
    第1-15天00：00-24：00; 每月1日至15日
    第20天--1 00：00-24：00; 每個月的20號到最后一天
    7月10日-15日00：00-24：00; 每年7月10日至7月15日
    4月10日-5月15日00：00-24：00; 每年4月10日至5月15日
    4月1日星期二至5月2日星期五00：00-24：00; 每年4月1日星期二至5月2日星期五
}

定義時間{
    timeperiod_name其他跳過范圍
    別名雜項跳過范圍
    2007-01-01-2008-02-01 / 3 00：00-24：00; 從2007年1月1日到2008年2月1日，每3天
    2008-04-01 / 7 00：00-24：00; 從2008年4月1日起每7天（永遠持續）
    星期一3-星期四4/2 00：00-24：00; 從每月的第3個星期一到第4個星期四，每隔一天
    第1-15/5天00：00-24：00; 從每月的1號到15號每5天
    7月10日-15日/ 2 00：00-24：00; 每年7月10日至7月15日每隔一天
    4月1日星期二至5月2日星期五6：00：00-24：00; 從每年四月的第一個星期二至每年五月的第二個星期五每6天
}

指令說明：

命令定義

描述：

命令定義就是這樣。它定義了一個命令。可以定義的命令包括服務檢查，服務通知，服務事件處理程序，主機檢查，主機通知和主機事件處理程序。命令定義可以包含宏，但是您必須確保僅包含在使用該命令的情況下“有效”的那些宏。可以在此處找到有關哪些宏可用以及何時“有效”的更多信息。下面概述了命令定義的不同參數。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義命令{
    command_name check_pop
    command_line / usr / local / nagios / libexec / check_pop -H $ HOSTADDRESS $
}

指令說明：

服務依賴定義

描述：

服務依賴項是Nagios的一項高級功能，可讓您根據一項或多項其他服務的狀態來抑制通知和對服務的主動檢查。服務依賴性是可選的，并且主要針對具有復雜監視設置的高級用戶。可以在此處找到有關服務依賴項如何工作的更多信息（請閱讀本文！）。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。但是，您必須至少提供一種類型的條件才能使該定義有用。

示例定義：

定義服務依賴性{
    host_name WWW1
    service_description Apache Web服務器
    dependent_host_name WWW1
    dependent_service_description主網站
    execution_failure_criteria n
    notification_failure_criteria w，u，c
}

指令說明：

服務升級定義

描述：

服務升級是完全可選的，用于升級特定服務的通知。可以在此處找到有關通知升級工作原理的更多信息。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。可選指令，如果留為空白，將從服務對象繼承。

示例定義：

定義服務升級{
    host_name nt-3
    service_description處理器負載
    first_notification 4
    last_notification 0
    notification_interval 30
    contact_groups all-nt-admins，經理
}

指令說明：

主機依賴性定義

描述：

主機依存關系是Nagios的一項高級功能，可讓您根據一個或多個其他主機的狀態禁止顯示主機通知。主機依賴性是可選的，并且主要針對具有復雜監視設置的高級用戶。可以在此處找到有關主機依賴項如何工作的更多信息（請閱讀本文！）。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義hostdependency {
    host_name WWW1
    dependent_host_name DBASE1
    notification_failure_criteria d，u
}

指令說明：

主機升級定義

描述：

主機升級完全是可選的，用于升級特定主機的通知。可以在此處找到有關通知升級工作原理的更多信息。

定義格式：

注意：紅色的指令是必需的，而黑色的指令是可選的。

示例定義：

定義主機升級{
    host_name路由器-34
    first_notification 5
    last_notification 8
    notification_interval 60
    contact_groups所有路由器管理員
}

指令說明：

擴展主機信息定義（不建議使用）

描述：

擴展主機信息條目基本上用于使status，statusmap，statuswrl和extinfo CGI的輸出看起來很漂亮。它們對監視沒有影響，并且是完全可選的。

提示：從Nagios Core 3開始，擴展的主機信息定義中包含的所有指令也可以在 主機定義中使用。從Nagios Core 4開始，hostextinfo對象已棄用，并將在以后的Nagios Core版本中刪除。

定義格式：

注意：紅色為必填項，而黑色為可選。但是，您需要在每個定義中至少提供一個可選變量，以使其有用。

示例定義：

定義hostextinfo {
    host_name netware1
    notes這是主要的Netware文件服務器
    notes_url http：//webserver.localhost.localdomain/hostinfo.pl？host = netware1
    icon_image novell40.png 
    icon_image_alt IntranetWare 4.11
    vrml_image novell40.png
    statusmap_image novell40.gd2
    2d_coords 100,250
    3d_coords 100.0,50.0,75.0
}

變量說明：

擴展服務信息定義（不建議使用）

描述：

擴展服務信息條目基本上用于使status和extinfo CGI 的輸出看起來很漂亮。它們對監視沒有影響，并且是完全可選的。

提示：從Nagios Core 3開始，擴展的服務信息定義中包含的所有指令也可以在 服務定義中使用。從Nagios Core 4開始，serviceextinfo對象已棄用，并將在以后的Nagios Core版本中刪除。

定義格式：

注意：紅色為必填項，而黑色為可選。但是，您需要在每個定義中至少提供一個可選變量，以使其有用。

示例定義：

定義serviceextinfo {
    host_name linux2
    service_description日志異常
    注釋輔助Linux服務器上與安全相關的日志異常
    notes_url http：//webserver.localhost.localdomain/serviceinfo.pl？host = linux2＆service = Log +異常
    icon_image security.png 
    icon_image_alt與安全相關的警報
}

變量說明：