Home » Categories » Multiple Categories

Nagios XI - BPI XML Cache

Overview

This KB article will explain how the Business Process Intelligence (BPI) component uses the XML cache file.

If you are not familiar with BPI, please refer to the following documentation:

Using Nagios BPI

 

 

What Is The BPI Cache

The BPI cache is a "point in time" dump of the BPI groups that currently exist in Nagios XI. It contains all the information of each group including the current state of each group. The cache is stored in the file bpi.xml and is stored by default in the /usr/local/nagiosxi/var/components/ location.

However the bpi.xml file does not exist by default. It only exists once you have run the BPI Configuration Wizard to create service checks of your BPI groups. From the documentation:

Once you've created your BPI groups, to receive notifications when their thresholds are exceeded you need to create services.

The plugin check_bpi.php is what actually creates/updates the bpi.xml file.

 

 

How Is The BPI Cache Used

After creating service(s) for your BPI group(s), the plugin check_bpi.php is executed as per the Nagios XI service check_interval, lets use 5 minutes as the example for this KB article.

If the check_bpi.php plugin cannot locate the bpi.xml file, it will create the file by talking to the Nagios XI database to generate the current state of all the BPI groups.

The check_bpi.php plugin will then finish it's job, to check to see if that specific BPI group has exceeded it's threshold.

Every time the check_bpi.php plugin is run, it will use the values in the bpi.xml file, instead of having to talk to the Nagios XI databases. The following chapter explains when the file is updated.

 

 

BPI Cache Threshold

There is an XML Cache Threshold of 90 seconds defined in the BPI Settings (default value).

Every time the check_bpi.php plugin is run, it will test to see if the bpi.xml file age is greater than the XML Cache Threshold. If the file is older than the threshold, the bpi.xml will be updated by talking to the Nagios XI database to generate the current state of all the BPI groups.

This means that when you have lots of BPI service checks, the check_bpi.php plugin does not need to perform a database query each time to get the status, it can be obtained directly from the bpi.xml file.

The BPI Settings can be accessed from the BPI home page by clicking the Edit BPI Settings button.

 

 

Threshold Example

Nagios XI service check_interval for "Service A", "Service B", "Service C", "Service D", "Service E" = 5 minutes.

XML Cache Threshold = 90 seconds.

 

  • 10.01 = "Service A" check, does not find bpi.xml file so it is created, next check 10.06
  • 10.02 = "Service B" check, finds bpi.xml file and it is not older than 90 seconds, the data in the file is used, next check 10.07
  • 10.03 = "Service C" check, finds bpi.xml file and it is older than 90 seconds, the file is updated, next check 10:08
  • 10.04 = "Service D" check, finds bpi.xml file and it is not older than 90 seconds, the data in the file is used, next check 10.09
  • 10.05 = "Service E" check, finds bpi.xml file and it is older than 90 seconds, the file is updated, next check 10:10
  • 10.06 = "Service A" check, finds bpi.xml file and it is not older than 90 seconds, the data in the file is used, next check 10.11

 

You can see in that simple example how the bpi.xml file is regularly updated as per the threshold setting.

 

 

Final Thoughts

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

http://support.nagios.com/forum/

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 XI - Maximizing Performance In Nagios XI
Viewed 1714 times since Thu, Jan 28, 2016
Nagios XI - Create "Actions URL" Link In Quick Actions Menu
Viewed 4122 times since Tue, Feb 2, 2016
Nagios XI - Monitoring VMware Virtualization Using vMA - NWC14
Viewed 2093 times since Thu, Feb 4, 2016
Nagios XI - How XI Works
Viewed 1695 times since Wed, Jul 19, 2017
Nagios XI - How To Use CA Certificates With check_ldaps Plugin
Viewed 2746 times since Tue, Jul 26, 2016
Nagios XI - Monitoring Windows With NCPA
Viewed 2250 times since Wed, Jul 19, 2017
Nagios XI - Modifying The Contents Of /usr/local/nagios/etc
Viewed 1595 times since Tue, Jan 26, 2016
Nagios XI - Special Characters
Viewed 6351 times since Tue, Apr 25, 2017
Nagios XI - Using The Config Import Prep Tool
Viewed 5948 times since Thu, Jan 28, 2016
Nagios Network Analyzer - Adding Reports For Nagios Network Analyzer in Nagios XI
Viewed 1797 times since Thu, Jan 28, 2016