有關CGI的信息

介紹

本文介紹了與Nagios一起分發的各種CGI，以及訪問和使用每個CGI的授權要求。默認情況下，CGI要求您已通過Web服務器的身份驗證，并有權查看您所請求的任何信息。有關配置授權的更多信息，請參見此處。

CGI指數

狀態CGI 狀態圖CGI WAP接口CGI 狀態世界CGI（VRML） 戰術概述CGI 網絡中斷CGI 配置CGI 命令CGI 擴展信息CGI 事件日志CGI 警報歷史記錄CGI 通知CGI 趨勢CGI 可用性報告CGI 警報直方圖CGI 警報摘要CGI

狀態CGI

說明： 這是Nagios附帶的最重要的CGI。它使您可以查看正在監視的所有主機和服務的當前狀態。狀態CGI可以產生兩種主要類型的輸出-所有主機組（或特定主機組）的狀態概述和所有服務（或與特定主機相關聯的服務）的詳細視圖。授權要求： 如果您有權使用所有主機，則可以查看所有主機和所有服務。如果您有權使用所有服務，則可以查看所有服務。如果您是經過身份驗證的聯系人，則可以查看您作為聯系人的所有主機和服務。

狀態圖CGI

說明： 此CGI創建您在網絡上定義的所有主機的映射。CGI使用Thomas Boutell的gd庫（版本1.6.3或更高版本）創建網絡布局的PNG圖像。繪制每個主機時使用的坐標（以及可選的漂亮圖標）取自主機定義。如果您希望CGI為您自動生成圖形坐標，請使用default_statusmap_layout指令指定應使用的布局算法。授權要求： 如果您有權使用所有主機，則可以查看所有主機。如果您是經過身份驗證的聯系人，則可以查看您作為其聯系人的主機。 注意：未經授權查看特定主機的用戶將在那些位置看到未知節點。我意識到他們真的不應該在那里看到任何東西，但是如果您看不到所有主機依賴項，甚至生成地圖都沒有意義…

WAP界面CGI

說明： 此CGI用作網絡狀態信息的WAP接口。如果您具有支持WAP的設備（例如，可上網的手機），則可以在旅途中查看狀態信息。不同的狀態視圖包括主機組摘要，主機組概述，主機詳細信息，服務詳細信息，所有問題和未處理的問題。除了查看狀態信息之外，您還可以禁用通知，檢查并確認手機中的問題。太酷了吧？授權要求： 如果您有權使用系統信息，則可以查看Nagios流程信息。如果您有權使用所有主機，則可以查看所有主機和服務的狀態數據。如果您有權使用所有服務，則可以查看所有服務的狀態數據。如果您是經過身份驗證的聯系人，則可以查看您作為聯系人的所有主機和服務的狀態數據。

狀態世界CGI（VRML）

說明： 此CGI為您在網絡上定義的所有主機創建3-D VRML模型。繪制主機（以及漂亮的紋理貼圖）時使用的坐標取自主機定義。如果您希望CGI為您自動生成圖形坐標，請使用default_statuswrl_layout指令指定應使用的布局算法。在實際查看生成的模型之前，需要在系統上安裝VRML瀏覽器（例如Cortona，Cosmo Player或WorldView）。授權要求： 如果您有權使用所有主機，則可以查看所有主機。如果您是經過身份驗證的聯系人，則可以查看您作為其聯系人的主機。 注意：未經授權查看特定主機的用戶將在那些位置看到未知節點。我意識到他們真的不應該在那里看到任何東西，但是如果您看不到所有主機依賴項，甚至生成地圖都沒有意義…

戰術概述CGI

說明： 此CGI旨在作為所有網絡監視活動的“鳥瞰”服務器。它使您可以快速查看網絡中斷，主機狀態和服務狀態。它區分已通過某種方式“處理”的問題（即已確認，已禁用通知等）和尚未處理的問題，因此需要引起注意。如果您要監視的主機/服務很多，這非常有用，并且您需要保持一個屏幕以提醒您問題。授權要求： 如果您有權使用所有主機，則可以查看所有主機和所有服務。如果您有權使用所有服務，則可以查看所有服務。如果您是經過身份驗證的聯系人，則可以查看您作為聯系人的所有主機和服務。

網絡中斷CGI

說明： 此CGI將在您的網絡上生成導致網絡中斷的“問題”主機列表。如果您的網絡規模較大，并且想快速確定問題的根源，這將特別有用。根據主機造成中斷的嚴重性對主機進行排序。授權要求： 如果您有權使用所有主機，則可以查看所有主機。如果您是經過身份驗證的聯系人，則可以查看您作為其聯系人的主機。

配置CGI

說明： 此CGI允許您查看在對象配置文件中定義的對象（即主機，主機組，聯系人，聯系人組，時間段，服務等）。授權要求： 您必須獲得配置信息的授權才能使用任何類型的配置信息。

命令CGI

說明： 此CGI允許您將命令發送到Nagios進程。盡管此CGI有幾個論點，但您最好還是不要理會它們。大多數將在不同版本的Nagios之間進行更改。使用擴展信息CGI作為發出命令的起點。授權要求： 您必須獲得系統命令的授權才能發出影響Nagios進程的命令（重新啟動，關閉，模式更改等）。如果您有權使用所有主機命令，則可以為所有主機和服務發出命令。如果您有權使用所有服務命令，則可以發出所有服務的命令。如果您是經過身份驗證的聯系人，則可以為您作為其聯系人的所有主機和服務發出命令。筆記：如果您選擇不使用身份驗證與CGI的，這個CGI將不會允許任何人發布命令給Nagios。這樣做是為了保護您自己。如果您決定不對CGI使用身份驗證，則建議完全刪除此CGI。

擴展信息CGI

說明： 此CGI允許您查看Nagios進程信息，主機和服務狀態統計信息，主機和服務注釋等。它還用作通過命令CGI向Nagios發送命令的啟動點。盡管此CGI有幾個論點，但您最好還是不要理會它們-它們可能會在不同版本的Nagios之間發生變化。您可以通過單擊側面導航欄上的“網絡運行狀況”和“過程信息”鏈接，或單擊狀態CGI輸出中的主機或服務鏈接來訪問此CGI。授權要求： 您必須具有系統信息的授權才能查看Nagios的過程信息。如果您有權使用所有主機，則可以查看所有主機和服務的擴展信息。如果您有權使用所有服務，則可以查看所有服務的擴展信息。如果您是經過身份驗證的聯系人，則可以查看您作為其聯系人的所有主機和服務的擴展信息。

事件日志CGI

說明： 此CGI將顯示日志文件。如果啟用了日志輪轉，則可以使用頁面頂部附近的導航鏈接瀏覽已歸檔日志文件中的通知。授權要求： 您必須具有系統信息的授權才能查看日志文件。

警報歷史記錄CGI

說明： 此CGI用于顯示特定主機或所有主機的問題歷史記錄。輸出基本上是日志文件CGI顯示的信息的子集。您可以過濾輸出以僅顯示希望看到的特定類型的問題（即，硬和/或軟警報，各種類型的服務和主機警報，所有類型的警報，等等）。如果啟用了日志輪轉，則可以使用頁面頂部附近的導航鏈接來瀏覽歸檔日志文件中存在的歷史記錄信息。授權要求： 如果您有權使用所有主機，則可以查看所有主機和所有服務的歷史記錄信息。如果您有權使用所有服務，則可以查看所有服務的歷史記錄信息。如果您是經過身份驗證的聯系人，則可以查看您作為聯系人的所有服務和主機的歷史記錄信息。

通知CGI

說明： 此CGI用于顯示已發送到各個聯系人的主機和服務通知。輸出基本上是日志文件CGI顯示的信息的子集。您可以過濾輸出以僅顯示希望查看的特定通知類型（即服務通知，主機通知，發送給特定聯系人的通知等）。如果啟用了日志輪轉，則可以使用頁面頂部附近的導航鏈接瀏覽已歸檔日志文件中的通知。授權要求： 如果您有權使用所有主機，則可以查看所有主機和所有服務的通知。如果您有權使用所有服務，則可以查看所有服務的通知。如果您是經過身份驗證的聯系人，則可以查看與您聯系的所有服務和主機的通知。

趨勢CGI

說明： 此CGI用于在任意時間段內創建主機或服務狀態圖。為了使該CGI更加有用，您應該啟用日志輪轉并將存檔的日志保留在log_archive_path指令指定的路徑中。CGI使用Thomas Boutell的gd庫（版本1.6.3或更高版本）來創建趨勢圖。授權要求： 如果您有權使用所有主機，則可以查看所有主機和所有服務的趨勢。如果您有權使用所有服務，則可以查看所有服務的趨勢。如果您是經過身份驗證的聯系人，則可以查看您作為聯系人的所有服務和主機的趨勢。

可用性報告CGI

說明： 此CGI用于報告用戶指定的時間段內主機和服務的可用性。為了使該CGI更加有用，您應該啟用日志輪換并將存檔的日志保留在log_archive_path指令指定的路徑中。授權要求： 如果您有權使用所有主機，則可以查看所有主機和所有服務的可用性數據。如果您有權使用所有服務，則可以查看所有服務的可用性數據。如果您是經過身份驗證的聯系人，則可以查看您作為聯系人的所有服務和主機的可用性數據。

警報直方圖CGI

說明： 此CGI用于報告用戶指定的時間段內主機和服務的可用性。為了使該CGI更加有用，您應該啟用日志輪換并將存檔的日志保留在log_archive_path指令指定的路徑中。CGI使用Thomas Boutell的gd庫（版本1.6.3或更高版本）創建直方圖圖像。授權要求： 如果您有權使用所有主機，則可以查看所有主機和所有服務的直方圖。如果您有權使用所有服務，則可以查看所有服務的直方圖。如果您是經過身份驗證的聯系人，則可以查看您作為聯系人的所有服務和主機的直方圖。

警報摘要CGI

描述： 此CGI提供有關主機和服務警報數據的一些常規報告，包括警報總數，最高警報產生者等。授權要求： 如果您有權使用所有主機，則可以查看所有主機和所有服務的摘要信息。如果您有權使用所有服務，則可以查看所有服務的摘要信息。如果您是經過身份驗證的聯系人，則可以查看與您聯系的所有服務和主機的摘要信息。