nagios_配置文件參數說明

nagios配置文件的介紹，此處介紹各個配置參數的做用,各個配置文件的關係不在此進行介紹:
  nagios的配置文件默認位於/usr/local/nagios/etc/目錄下，
  # cd /etc/local/nagios/etc

配置Nagios

爲了能更清楚的說明問題，同時也爲了維護方便，建議將nagios各個定義對象建立獨立的配置文件：

hosts.cfg文件來定義主機和主機組

services.cfg文件來定義服務

contacts.cfg文件來定義聯繫人和聯繫人組

commands.cfg文件來定義命令

timeperiods.cfg來定義監控時間段

templates.cfg文件定義模板


templates.cfg文件

define contact{
        name                            generic-contact         ; 聯繫人名稱
        service_notification_period     24x7                    ; 當服務出現異常時，發送通知的時間段，這個時間段"24x7"在timeperiods.cfg文件中定義
        host_notification_period        24x7            ; 當主機出現異常時，發送通知的時間段，這個時間段"24x7"在timeperiods.cfg文件中定義
        service_notification_options    w,u,c,r            ; 這個定義的是「通知能夠被髮出的狀況」。w即warn，表示警告狀態，u即unknown，表示不明狀態;
                                ; c即criticle，表示緊急狀態，r即recover，表示恢復狀態;
                                ; 也就是在服務出現警告狀態、未知狀態、緊急狀態和從新恢復狀態時都發送通知給使用者。
        host_notification_options       d,u,r                   ; 定義主機在什麼狀態下須要發送通知給使用者，d即down，表示宕機狀態;
                                                                ; u即unreachable，表示不可到達狀態，r即recovery，表示從新恢復狀態。
        service_notification_commands   notify-service-by-email ; 服務故障時，發送通知的方式，能夠是郵件和短信，這裏發送的方式是郵件;
                                                                ; 其中「notify-service-by-email」在commands.cfg文件中定義。
        host_notification_commands      notify-host-by-email    ; 主機故障時，發送通知的方式，能夠是郵件和短信，這裏發送的方式是郵件;
                                                                ; 其中「notify-host-by-email」在commands.cfg文件中定義。
        register                        0                       ; 說明這是一個模板，不是一個真實的聯繫人
        }


define host{
        name                            generic-host        ; 主機名稱，這裏的主機名，並非直接對應到真正機器的主機名;
                                ; 乃是對應到在主機配置文件裏所設定的主機名。
        notifications_enabled           1            ; 主機通知是否啓用,1 啓用,0 禁用
        event_handler_enabled           1            ; Host event handler is enabled
        flap_detection_enabled          1            ; Flap detection is enabled
        failure_prediction_enabled      1            ; Failure prediction is enabled
        process_perf_data               1            ; 其值能夠爲0或1，其做用爲是否啓用Nagios的數據輸出功能;
                                ; 若是將此項賦值爲1，那麼Nagios就會將收集的數據寫入某個文件中，以備提取。
        retain_status_information       1            ; Retain status information across program restarts
        retain_nonstatus_information    1            ; Retain non-status information across program restarts
        notification_period             24x7            ; 指定「發送通知」的時間段，也就是能夠在何時發送通知給使用者。
        register                        0            ; DONT REGISTER THIS DEFINITION - ITS NOT A REAL HOST, JUST A TEMPLATE!
        }


define service{
        name                            generic-service         ; 定義一個服務名稱
        active_checks_enabled           1                       ; Active service checks are enabled
        passive_checks_enabled          1                       ; Passive service checks are enabled/accepted
        parallelize_check               1                       ; Active service checks should be parallelized;
                                                                ; (disabling this can lead to major performance problems)
        obsess_over_service             1                       ; We should obsess over this service (if necessary)
        check_freshness                 0                       ; Default is to NOT check service 'freshness'
        notifications_enabled           1                       ; Service notifications are enabled
        event_handler_enabled           1                       ; Service event handler is enabled
        flap_detection_enabled          1                       ; Flap detection is enabled
        failure_prediction_enabled      1                       ; Failure prediction is enabled
        process_perf_data               1                       ; Process performance data
        retain_status_information       1                       ; Retain status information across program restarts
        retain_nonstatus_information    1                       ; Retain non-status information across program restarts
        is_volatile                     0                       ; The service is not volatile
        check_period                    24x7            ; 這裏的check_period告訴nagios檢查服務的時間段。
        max_check_attempts              3            ; nagios對服務的最大檢查次數。
        normal_check_interval           5            ; 此選項是用來設置服務檢查時間間隔，也就是說，nagios這一次檢查和下一次檢查之間所隔的時間;
                                ; 這裏是5分鐘。
        retry_check_interval            2            ; 重試檢查時間間隔，單位是分鐘。
        contact_groups                  ts            ; 指定聯繫人組
        notification_options            w,u,c,r            ; 這個定義的是「通知能夠被髮出的狀況」。w即warn，表示警告狀態;
                                ; u即unknown，表示不明狀態;
                                ; c即criticle，表示緊急狀態，r即recover，表示恢復狀態;
                                ; 也就是在服務出現警告狀態、未知狀態、緊急狀態和從新恢復後都發送通知給使用者。
        notification_interval           10            ; Re-notify about service problems every hour
        notification_period             24x7            ; 指定「發送通知」的時間段，也就是能夠在何時發送通知給使用者。
        register                        0            ; DONT REGISTER THIS DEFINITION - ITS NOT A REAL SERVICE, JUST A TEMPLATE!
        }


define service{
        name                            local-service           ; The name of this service template
        use                             generic-service         ; Inherit default values from the generic-service definition
        max_check_attempts              4            ; Re-check the service up to 4 times in order to determine its final (hard) state
        normal_check_interval           5            ; Check the service every 5 minutes under normal conditions
        retry_check_interval            1            ; Re-check the service every minute until a hard state can be determined
        register                        0            ; DONT REGISTER THIS DEFINITION - ITS NOT A REAL SERVICE, JUST A TEMPLATE!
        }



resource.cfg文件

resource.cfg是nagios的變量定義文件，文件內容只有一行：

$USER1$=/usr/local/nagios/libexec

其中，變量$USER1$指定了安裝nagios插件的路徑，若是把插件安裝在了其它路徑，只需在這裏進行修改便可。一共能夠定義32個$USER#$



commands.cfg文件

此文件默認是存在的，無需修改便可使用，固然若是有新的命令須要加入時，在此文件進行添加便可。

define command{
        command_name    check_local_users
        command_line    $USER1$/check_users -w $ARG1$ -c $ARG2$
        }



hosts.cfg文件

此文件默認不存在，須要手動建立，hosts.cfg主要用來指定被監控的主機地址以及相關屬性信息，根據實驗目標配置以下：

define host{   
        use                     linux-server          #引用主機linux-server的屬性信息，linux-server主機在templates.cfg文件中進行了定義。
        host_name               Nagios-Linux          #主機名
        alias                   Nagios-Linux          #主機別名
        address                 192.168.1.111         #被監控的主機地址，這個地址能夠是ip，也能夠是域名。
        }
    
#定義一個主機組   
define hostgroup{      
        hostgroup_name          bsmart-servers        #主機組名稱，能夠隨意指定。
        alias                   bsmart servers        #主機組別名
        members                 Nagios-Linux          #主機組成員，其中「Nagios-Linux」就是上面定義的主機,多個成員使用","分隔。     
        }



注意：在/usr/local/nagios/etc/objects 下默認有localhost.cfg和windows.cfg 這兩個配置文件，localhost.cfg 文件是定義監控主機自己的，windows.cfg文件是定義windows 主機的，其中包括了對host 和相關services 的定義。因此在本次實驗中，將直接在localhost.cfg 中定義監控主機（Nagios-Server），在windows.cfg中定義windows 主機（Nagios-Windows）。根據本身的須要修改其中的相關配置，詳細以下：

localhost.cfg

define host{
        use                     linux-server     ; Name of host template to use
                                                        ; This host definition will inherit all variables that are defined
                                                        ; in (or inherited by) the linux-server host template definition.
        host_name               Nagios-Server
        alias                   Nagios-Server
        address                 127.0.0.1
        }
define hostgroup{
        hostgroup_name  linux-servers ; The name of the hostgroup
        alias           Linux Servers ; Long name of the group
        members         Nagios-Server ; Comma separated list of hosts that belong to this group
        }
define service{
        use                             local-service         ; Name of service template to use
        host_name                       Nagios-Server
        service_description             PING
        check_command                   check_ping!100.0,20%!500.0,60%
        }


services.cfg文件

此文件默認也不存在，須要手動建立，services.cfg文件主要用於定義監控的服務和主機資源，例如監控http服務、ftp服務、主機磁盤空間、主機系統負載等等。Nagios-Server 和Nagios-Windows相關服務已在相應的配置文件中定義，因此這裏只須要定義Nagios-Linux相關服務便可，這裏只定義一個檢測是否存活的服務來驗證配置文件的正確性，其餘服務的定義將在後面講到。

define service{  
        use                     local-service          #引用local-service服務的屬性值，local-service在templates.cfg文件中進行了定義。
        host_name               Nagios-Linux           #指定要監控哪一個主機上的服務，「Nagios-Server」在hosts.cfg文件中進行了定義。
        service_description     check-host-alive       #對監控服務內容的描述，以供維護人員參考。
        check_command           check-host-alive       #指定檢查的命令。
        }  




contacts.cfg文件

contacts.cfg是一個定義聯繫人和聯繫人組的配置文件，當監控的主機或者服務出現故障，nagios會經過指定的通知方式（郵件或者短信）將信息發給這裏指定的聯繫人或者使用者。

define contact{
        contact_name                    David             #聯繫人的名稱,這個地方不要有空格
        use                             generic-contact   #引用generic-contact的屬性信息，其中「generic-contact」在templates.cfg文件中進行定義
        alias                           Nagios Admin
        email                           david.tang@bsmart.cn
        }
define contactgroup{
        contactgroup_name       ts                              #聯繫人組的名稱,一樣不能空格
        alias                   Technical Support               #聯繫人組描述
        members                 David                           #聯繫人組成員，其中「david」就是上面定義的聯繫人，若是有多個聯繫人則以逗號相隔
        }




timeperiods.cfg文件

此文件只要用於定義監控的時間段，下面是一個配置好的實例：

#下面是定義一個名爲24x7的時間段，即監控全部時間段  
define timeperiod{  
        timeperiod_name 24x7       #時間段的名稱,這個地方不要有空格
        alias           24 Hours A Day, 7 Days A Week  
        sunday          00:00-24:00  
        monday          00:00-24:00  
        tuesday         00:00-24:00  
        wednesday       00:00-24:00  
        thursday        00:00-24:00  
        friday          00:00-24:00  
        saturday        00:00-24:00  
        }  
#下面是定義一個名爲workhours的時間段，即工做時間段。  
define timeperiod{  
        timeperiod_name workhours   
        alias           Normal Work Hours  
        monday          09:00-17:00  
        tuesday         09:00-17:00  
        wednesday       09:00-17:00  
        thursday        09:00-17:00  
        friday          09:00-17:00  
        }  


cgi.cfg文件

此文件用來控制相關cgi腳本，若是想在nagios的web監控界面執行cgi腳本，例如重啓nagios進程、關閉nagios通知、中止nagios主機檢測等，這時就須要配置cgi.cfg文件了。

default_user_name=david
authorized_for_system_information=nagiosadmin,david  
authorized_for_configuration_information=nagiosadmin,david  
authorized_for_system_commands=david
authorized_for_all_services=nagiosadmin,david  
authorized_for_all_hosts=nagiosadmin,david
authorized_for_all_service_commands=nagiosadmin,david  
authorized_for_all_host_commands=nagiosadmin,david



nagios.cfg文件

nagios.cfg默認的路徑爲/usr/local/nagios/etc/nagios.cfg，是nagios的核心配置文件，全部的對象配置文件都必須在這個文件中進行定義才能發揮其做用，這裏只需將對象配置文件在Nagios.cfg文件中進行引用便可。

log_file=/usr/local/nagios/var/nagios.log                  # 定義nagios日誌文件的路徑
cfg_file=/usr/local/nagios/etc/objects/commands.cfg        # 「cfg_file」變量用來引用對象配置文件，若是有更多的對象配置文件，在這裏依次添加便可。
cfg_file=/usr/local/nagios/etc/objects/contacts.cfg
cfg_file=/usr/local/nagios/etc/objects/hosts.cfg
cfg_file=/usr/local/nagios/etc/objects/services.cfg
cfg_file=/usr/local/nagios/etc/objects/timeperiods.cfg
cfg_file=/usr/local/nagios/etc/objects/templates.cfg
cfg_file=/usr/local/nagios/etc/objects/localhost.cfg       # 本機配置文件
cfg_file=/usr/local/nagios/etc/objects/windows.cfg         # windows 主機配置文件
object_cache_file=/usr/local/nagios/var/objects.cache      # 該變量用於指定一個「全部對象配置文件」的副本文件，或者叫對象緩衝文件
precached_object_file=/usr/local/nagios/var/objects.precache
resource_file=/usr/local/nagios/etc/resource.cfg           # 該變量用於指定nagios資源文件的路徑，能夠在nagios.cfg中定義多個資源文件。
status_file=/usr/local/nagios/var/status.dat               # 該變量用於定義一個狀態文件，此文件用於保存nagios的當前狀態、註釋和宕機信息等。
status_update_interval=10                                  # 該變量用於定義狀態文件（即status.dat）的更新時間間隔，單位是秒，最小更新間隔是1秒。
nagios_user=nagios                                         # 該變量指定了Nagios進程使用哪一個用戶運行。
nagios_group=nagios                                        # 該變量用於指定Nagios使用哪一個用戶組運行。
check_external_commands=1                                  # 該變量用於設置是否容許nagios在web監控界面運行cgi命令;
                                                           # 也就是是否容許nagios在web界面下執行重啓nagios、中止主機/服務檢查等操做;
                                                           # 「1」爲運行，「0」爲不容許。
command_check_interval=10s                                 # 該變量用於設置nagios對外部命令檢測的時間間隔，若是指定了一個數字加一個"s"(如10s);
                                                           # 那麼外部檢測命令的間隔是這個數值以秒爲單位的時間間隔;
                                                           # 若是沒有用"s"，那麼外部檢測命令的間隔是以這個數值的「時間單位」的時間間隔。
interval_length=60                                         # 該變量指定了nagios的時間單位，默認值是60秒，也就是1分鐘;
                                                           # 即在nagios配置中全部的時間單位都是分鐘。