Home » Categories » Products » Nagios Log Server » Documentation » Architecture

Nagios Log Server - Poller Subsystem Architecture

Poller Subsystem Overview

The poller subsystem of Nagios Log Server runs on every instance. In addition to updating the elasticsearch database with the current running configuration, the poller subsystem also updates service state information for all of the instances in the Nagios Log Server cluster. In addition to this, the poller subsystem also updates each instance with the current list of all known hosts in the cluster.


Architecture Components And Execution Flow

The poller subsystem starts every minute via a cron located at /etc/cron.d/nagioslogserver and runs as the nagios user. 



This cron executes a loop that by default runs every 15 seconds to perform the following action:

  1. Update the cluster_hosts file (located at /usr/local/nagioslogserver/var/cluster_hosts ) with the list of all known hosts in the cluster (gathered from an elasticsearch query). The cluster_hosts file is used to determine which hosts the local instance will try to connect to when elasticsearch services are started on the instance.

  2. Sends updates of the following information to elasticsearch for this particular instance:

    1. last_updated time

    2. Log Server Release version

    3. elasticsearch service status

    4. logstash service status

    5. Instance IP address

    6. Instance hostname












The general flow of execution of the poller subsystem works as follows:

  1. The poller.php controller runs as a background process and executes the commands in the process_jobs() method.  The poller.php script is located at /var/www/html/nagioslogserver/application/controllers/poller.php and runs under cron every minute. The cron job is defined in /etc/cron.d/nagioslogserver

  2. The poller.php script executes the functions listed in the process_jobs() method of the Poller Controller, and the functions will be located in the poller_helper.php located at /var/www/html/nagioslogserver/application/helpers/poller_helper.php

  3. The poller cron saves output of the run in /usr/local/nagioslogserver/var/poller.log


Troubleshooting Problems

Some potential problems with the poller subsystem, as well as troubleshooting information are listed below:

Problem: The Instance Status page doesn't list all instances or your service statuses are not updating

Potential Causes:

  • The poller scripts may not be running.  Run the following from the command line to see if the script is running:

    • ps axuw | grep poller
  • There may be a problem with the cron job.  Check the cron file /etc/cron.d/nagioslogserver to ensure the job is not commented out. Execute the following from the command line to look for possible errors:

    • tail /var/log/cron
  • Check the /usr/local/nagioslogserver/var/poller.log log file for errors

  • The nagios user account could be expired - you can check this with the following from the command line:

    • chage -l nagios


Final Thoughts

For any support related questions please visit the Nagios Support Forums at:


1 (1)
Article Rating (1 Votes)
Rate this article
  • Icon PDFExport to PDF
  • Icon MS-WordExport to MS Word
Attachments Attachments
There are no attachments for this article.
Related Articles RSS Feed
Nagios Log Server - API Examples
Viewed 4714 times since Tue, Jun 13, 2017
Nagios Log Server - Overview And Terminology
Viewed 2236 times since Wed, Jan 28, 2015
Nagios Log Server - Data Backup and Archiving
Viewed 2526 times since Sat, Feb 7, 2015
Nagios Log Server - Architecture and Overview - NWC15
Viewed 2122 times since Mon, Feb 1, 2016
Nagios Log Server - Configuration Overview
Viewed 2911 times since Sat, Feb 7, 2015
Nagios Log Server - Real Life Experience of Nagios Log Server - NWC15
Viewed 2112 times since Mon, Feb 8, 2016
Nagios Log Server - Log Monitoring and Log Management with Nagios - NWC14
Viewed 1816 times since Thu, Feb 4, 2016
Nagios Log Server - Jobs Subsystem Architecture
Viewed 2621 times since Fri, Feb 6, 2015
Nagios Log Server - Full Architecture Overview
Viewed 6639 times since Thu, Jun 4, 2015