NagiosXI has a multitude of ways of monitoring hosts or services. Typically with a Microsoft Windows or Linux host you can monitor using SNMP, but you may also now want to check out the NCPA agent as a way to monitor from NagiosXI. Newer versions of NagiosXI also give the ability to administer, update and track the status of the NCPA agent on each monitored host, so you can tell when you need to upgrade the agent, handy!<\/p>\n\n\n\n
The NCPA Agent is a custom monitoring agent that can be installed on Microsoft Windows or Linux machines for both active and passive monitoring of the standard CPU, RAM, Disk, Network and Services, but also for running of local custom plugins.<\/p>\n\n\n\n
To avoid just repeating the official documentation, you can find the full installation and configuration guides here: NCPA Getting Started<\/a>.<\/p>\n\n\n\n Once installed, you can use the NCPA Web Interface at: https:\/\/<FQDN>:5693<\/a>, you need the Token you’ll specify during installation.<\/p>\n\n\n\n Download the latest version from:\u00a0https:\/\/www.nagios.org\/ncpa\/#downloads<\/a>, then install as follows:<\/p>\n\n\n\n The above installation only installs the NCPA agent in active monitoring mode, for enabling the passive monitoring mode you need to configure the ncpa.cfg file with additional options, but this is beyond the scope of this document.<\/p>\n\n\n\n You may also need to open the firewall for the Port 5693, it is strongly advised to restrict the sources to only the NagiosXI Servers.<\/p>\n\n\n\n Download the latest version from: https:\/\/www.nagios.org\/ncpa\/#downloads<\/a> and install using the following procedure:<\/p>\n\n\n\n The above installation only installs the NCPA agent in active monitoring mode, for enabling the passive monitoring mode you need to configure the ncpa.cfg file with additional options, but this is beyond the scope of this document.<\/p>\n\n\n\n You may also need to open the firewall as follows, it is strongly advised to restrict the sources to only the NagiosXI Servers.<\/p>\n\n\n\n Example CPU Average Utilisation active monitoring:<\/p>\n\n\n\n Example service status monitoring (“Task Scheduler”):<\/p>\n\n\n\n For other available API endpoints you can monitor you can consult the NCPA Web Interface at:\u00a0https:\/\/<FQDN>:5693<\/a>\u00a0API section.<\/p>\n","protected":false},"excerpt":{"rendered":" NagiosXI has a multitude of ways of monitoring hosts or services. Typically with a Microsoft Windows or Linux host you can monitor using SNMP, but you may also now want to check out the NCPA agent as a way to monitor from NagiosXI. Newer versions of NagiosXI also give the ability to administer, update and … Read more<\/a><\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[16],"tags":[],"class_list":["post-4030","post","type-post","status-publish","format-standard","hentry","category-nagios-and-nagiosxi"],"_links":{"self":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/4030","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=4030"}],"version-history":[{"count":1,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/4030\/revisions"}],"predecessor-version":[{"id":4031,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/4030\/revisions\/4031"}],"wp:attachment":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=4030"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=4030"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=4030"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Microsoft Windows – Installation Quick Start<\/h1>\n\n\n\n
ncpa-3.0.1.exe \/S \/TOKEN='<MY_TOKEN>'<\/code><\/code><\/pre>\n\n\n\nLinux – Installation Quick Start<\/h1>\n\n\n\n
# Add to the apt sources list\r\necho \"deb https:\/\/repo.nagios.com\/deb\/$(lsb_release -cs) \/\" > \/etc\/apt\/sources.list.d\/nagios.list\r\n \r\n# Add our public GPG key\r\nwget -qO - https:\/\/repo.nagios.com\/GPG-KEY-NAGIOS-V3 | apt-key add -\r\n \r\n# Update your repositories\r\napt-get update\r\n \r\n# Install NCPA Agent\r\napt-get install ncpa<\/code><\/pre>\n\n\n\nufw allow from <Nagios Server IP> to any port 5693\r\n\r \r\nufw status<\/code><\/pre>\n\n\n\nExample Usage<\/h1>\n\n\n\n
.\/check_ncpa.py -H server.domain.com -t '<MY_TOKEN>' -M 'cpu\/percent' -w 70 -c 90 -q 'aggregate=avg'\r\nOK: Percent was 50.00 % | 'percent'=50.00%;70;90;<\/code><\/pre>\n\n\n\n.\/check_ncpa.py -H server.domain.com -t '<MY_TOKEN>' -M 'services' -q 'service=Schedule,status=running'OK: Schedule is running<\/code><\/code><\/pre>\n\n\n\n