Intergral Infrmatin Slutins 483 Green Lanes Lndn N13 4BS FusinReactr Nagis Plugin Dcumentatin David Stcktn Publicatin Number: 000000 Print Date 12.03.2009 Revisin 01.00 Intergral Infrmatin Slutins Ltd. Cpyright 2009
Intergral Infrmatin Slutins Ltd. FusinReactr Nagis Plugin Table f Cntents 1 Backgrund... 3 1.1 What is Nagis?... 3 1.2 What is FusinReactr?... 3 1.3 What is this Nagis plugin?... 3 2 Installatin... 4 2.1 Install Pre-requisites... 4 2.2 Cpy check_fusinreactr.pl... 4 2.3 Cnfigure cmmand... 4 2.4 Cnfigure service... 4 3 Service Arguments... 6 3.1 Arguments... 6 3.2 XML Field... 6 Page 2 f 7
Intergral Infrmatin Slutins Ltd. FusinReactr Nagis Plugin 1 Backgrund 1.1 What is Nagis? Nagis is an enterprise-class mnitring slutin fr hsts, services, and netwrks released under an Open Surce license. Surce: www.nagis.rg, March 12 th 2009 1.2 What is FusinReactr? FusinReactr is lightweight applicatin, database and server mnitr - built fr mnitring prductin envirnments running the latest web centric and Rich Internet Applicatin (RIA) technlgies, especially Adbe CldFusin, Blaze DS, LiveCycle Data Services and J2EE servers such as JBss, Tmcat and Websphere. FusinReactr is ptimized fr CldFusin and J2EE applicatin server mnitring, but as a cmprehensive server mnitring tl it will likely be the nly mnitr yu will ever need t gain unparalleled insight int what's really happening within yur business applicatins and t maintain high server availability n yur Adbe and J2EE servers. Surce: www.fusin-reactr.cm, March 12 th 2009 1.3 What is this Nagis plugin? This is a Perl plugin fr the Nagis mnitring system t allw mnitring f yur J2EE applicatin thrugh the FusinReactr sftware. Yu can mnitr & track high level metrics (instance CPU, heap memry, JDBC calls, average request time, etc) frm within Nagis. If/When an issue is alerted frm Nagis, yu can use FusinReactr t investigate further. Page 3 f 7
Intergral Infrmatin Slutins Ltd. FusinReactr Nagis Plugin 2 Installatin 2.1 Install Pre-requisites The plugin has sme requirements: Nagis::Plugin File::Basename LWP::UserAgent URI::URL Digest::MD5 MIME::Base64 XML::XPath XML::XPath::XMLParser Yu can easily reslve these using CPAN: #cpan Nagis::Plugin File::Basename LWP::UserAgent URI::URL Digest::MD5 MIME::Base64 XML::XPath XML::XPath::XMLParser 2.2 Cpy check_fusinreactr.pl The plugin is deplyed as a single Perl file. Simply cpy int yur plugin flder with apprpriate naming strategy fr yur cnfiguratin. Fr example: #cp check_fusinreactr.pl /usr/lcal/nagis/libexec/check_fusinreactr 2.3 Cnfigure cmmand Setup the new cmmand in yur nagis cnfiguratin. This culd be in /usr/lcal/nagis/etc/bjects/cmmands.cfg by default: # ADDED FOR FUSIONREACTOR define cmmand{ cmmand_name check_fusinreactr cmmand_line $USER1$/check_fusinreactr -H $HOSTADDRESS$ --prt $ARG1$ --path $ARG2$ -l $ARG3$ --passwrd $ARG4$ --field $ARG5$ -w $ARG6$ -c $ARG7$ } 2.4 Cnfigure service Setup a new service fr yur hst-type in yur nagis cnfiguratin. In ur example we re using the lcalhst s it s /usr/lcal/nagis/etc/bjects/lcalhst.cfg by default: # ADDED FOR FUSIONREACTOR define service{ use lcal-service hst_name lcalhst service_descriptin FusinReactr check_cmmand check_fusinreactr!8088!/fusinreactr/!administratr!passwrd Page 4 f 7
Intergral Infrmatin Slutins Ltd. FusinReactr Nagis Plugin!/FusinReactrFederatedDataTransfer/SerializedMetrics/CPUPrbe/Syste musage!50!80 ntificatins_enabled 0 } Page 5 f 7
Intergral Infrmatin Slutins Ltd. FusinReactr Nagis Plugin 3 Service Arguments 3.1 Arguments Name Descriptin -H Hst address f the FusinReactr instance --prt TCP prt FusinReactr is running n --path Path t FusinReactr. Usually /fusinreactr/ -l User lgin name fr FusinReactr. Usually Administratr NB: The current API des nt require the lgin name but this is kept fr future cmpatibility. --passwrd Lgin passwrd --field XML Field t retrieve (see list belw) -w WARNING level t cmpare with field -c CRITICAL level t cmpare with field 3.2 XML Field FusinReactr expses many fields. This plugin is designed t cpe with future updates and as such takes an XMLPath argument fr the field t be analysed. Belw is a listing f currently available fields: Server Details Request Details Server Versin /FusinReactrFederatedDataTransfer@createdByRevisin Prcess ID /FusinReactrFederatedDataTransfer@pid Licence Cde /FusinReactrFederatedDataTransfer/License Server Start Time (epch time) /FusinReactrFederatedDataTransfer/SerializedMetrics/ServerStartTi memillis Instance ID /FusinReactrFederatedDataTransfer/SerializedMetrics/SurceSystemI d Current Running Requests /FusinReactrFederatedDataTransfer/SerializedMetrics/CurrentReques tcunt FR Queue Size /FusinReactrFederatedDataTransfer/SerializedMetrics/QueueSize Recent Request Mean Runtime (ms) /FusinReactrFederatedDataTransfer/SerializedMetrics/RecentRequest MeanRuntimeMillis Ttal Requests Executed /FusinReactrFederatedDataTransfer/SerializedMetrics/TtalRequestC unt Recent Slw Pages /FusinReactrFederatedDataTransfer/SerializedMetrics/RecentSlwPag es Average Request Time (ms) /FusinReactrFederatedDataTransfer/SerializedMetrics/AverageReques ttimemillis Memry Memry Usage (%) /FusinReactrFederatedDataTransfer/SerializedMetrics/MemryPrbe/F ree/@percentage Memry Free (bytes) Page 6 f 7
Intergral Infrmatin Slutins Ltd. FusinReactr Nagis Plugin /FusinReactrFederatedDataTransfer/SerializedMetrics/MemryPrbe/F ree Memry Max (bytes) /FusinReactrFederatedDataTransfer/SerializedMetrics/MemryPrbe/M ax Memry Ttal (bytes) /FusinReactrFederatedDataTransfer/SerializedMetrics/MemryPrbe/T tal CPU Instance CPU Usage (%) /FusinReactrFederatedDataTransfer/SerializedMetrics/CPUPrbe/Usag e System CPU Usage (%) /FusinReactrFederatedDataTransfer/SerializedMetrics/CPUPrbe/Syst emusage JDBC JDBC Running Requests /FusinReactrFederatedDataTransfer/SerializedMetrics/JDBC/JDBCDriv er/jdbclad Page 7 f 7