雲監控插件編寫規范

 　　阿裡雲監控系統支持用戶自定義監控類型，具有極強的監控擴展能力，支持用戶自己編寫監控插件實現自定義監控類型。編寫完後將插件放到Agent安裝目錄下面的scripts目錄下面，如果是linux服務器則是/usr/local/cms/scripts目錄下面。

　　監控插件不管以何種語言編寫，只要是可以直接執行就可以，它可以是已編譯成功的可執行二進制程序文件(例如: C， C++等)，同時也可以是可執行腳本文件(例如: shell， Perl， PHP等)。

　　為了雲監控插件能夠被雲監控Agent正確調用和執行，監控插件的參數和退出值必須遵守以下規則，其中業務邏輯完全由您決定：

　　1、雲監控插件輸出規范

　　雲監控Agent根據插件的返回值來判斷其狀態是Ok還是Critical。目前只有Ok和Critical兩種狀態。

　　如果是exit(0)，則表示其狀態是OK的。這種狀態表示插件檢測的結果是正常的，不需要報警。

　　如果是exit(2)，則表示其狀態是Critical的。這種狀態表示插件檢測異常，需要報警。

　　如果雲監控插件運行完後的退出值不是以上固定值，雲監控不會做任何處理。

　　具體的報警信息就是雲監控插件執行時的輸出字符串，它可以完全由您自己決定。

　　2、雲監控插件輸入規范

　　雲監控Agent在調用插件時會向插件傳三個參數。 您可以不處理這些參數，也可以處理這些參數。

　　第一個輸入參數是就是頁面上監控項的參數，是由您在頁面上自行輸入的。

　　第二個輸入參數是報警阈值，是您在頁面上配置的報警阈值。如果您的插件需要阈值，則您的插件裡面需要解析阈值，並與阈值比較以決定返回值是0，還是1或2。

　　第三個輸入參數是超時時間，是您在頁面上選擇的超時時間。這個參數可以根據您的需要決定是否處理。如果插件執行時間超過這個時間值，雲監控Agent則會終止這個插件的運行。

　　3、插件注意事項：

　　如果插件是用腳本語言寫的話，第一行要有解釋器，否則雲監控Agent無法執行這些插件。比如如果是用shell寫的話，第一行應該是類似這樣的：#!/bin/sh

　　#!/bin/sh #請注意這個shell的解釋器POLICY_PARAMS=$1 #將第一個參數接收進來，便於後面處理CRITICAL_PARAMS=$2 #將報警阈值接收進來，後面檢測到的值跟這個阈值相比如，如果大於等於阈值，則exit(1)退出，表示Critical;如果小於阈值，則exit(0)退出,表示OK。TIMEOUT=$3 #將超時時間接收進來，便於後面處理。比如裡面調用wget命令，希望這個命令執行超過這個時間後超時，則可以在wget命令中使用$TIMEOUT這個變量………If (Critical) Echo “Critical-The filesystem is readonly.” Exit 1 #異常退出If (OK) Echo “OK-The filesystem is normal.” Exit 0 #正常退出