---
title: Monitoring RELIANOID with Icinga or Nagios
description: "# Overview The goal of this article is to explain how to monitor RELIANOID system health and performance with Icinga monitoring system. [Icinga](https://icinga.com/) is an open-source computer system and network monitoring application. It was originally created as a fork of…"
url: "https://www.relianoid.com/resources/knowledge-base/howtos/monitoring-relianoid-nagios/"
updated: "2024-01-05"
category: "Howto's"
---

# Monitoring RELIANOID with Icinga or Nagios

# Overview

The goal of this article is to explain how to monitor RELIANOID system health and performance with Icinga monitoring system. [Icinga](https://icinga.com/) is an open-source computer system and network monitoring application. It was originally created as a fork of the [Nagios](https://www.nagios.org/) system monitoring application in 2009.

In this document we’ll use Icinga to monitor system health and performance of a RELIANOID ADC Load Balancer appliance.

Explaining Icinga Server installation & setup is out of the scope of this document. You can refer to Icinga official documentation [https://icinga.com/docs/](https://icinga.com/docs/).

 

# Conventions

We’ll use the following conventions in this document:

| **Name** | **Value** |
| --- | --- |
| Icinga Server IP address | monitor.icinga.com |
| Icinga Server Web Interface URL | http://monitor.icinga.com |
| RELIANOID ADC Load Balancer appliance IP address | ZLB-IP |

 

# RELIANOID Monitoring Plugins

[![Icinga services](https://www.relianoid.com/wp-content/uploads/2020/09/Monitoring_Relianoid_Load_Balancer_with_Icinga.png)](https://www.relianoid.com/wp-content/uploads/2020/09/Monitoring_Relianoid_Load_Balancer_with_Icinga.png)

[RELIANOID Monitoring Plugins](https://github.com/zevenet/zevenet-monitoring-plugins/) is a collection of Nagios plugins written in Perl to monitor RELIANOID ADC Load Balancer Enterprise Edition system health and performance metrics.

| Plugin | Check | Provided performance data |
| --- | --- | --- |
| check_zevenet_farm.pl | Farm status | Established and pending connections to the farm |
| check_zevenet_farm_backend.pl | Backend status | Established and pending connections to the backends |

 

RELIANOID Monitoring Plugins are developed to be installed in your Icinga (Or Icinga plugin's compatible like Nagios, Naemon, Shinken, Sensu, and other monitoring applications.) monitoring server. So please access via SSH to
 your monitoring host as root to install the required software.

## Install dependencies

Install required perl modules:

Debian Buster:

```
apt update && apt install libwww-perl libjson-perl libmonitoring-plugin-perl libswitch-perl
```

If Perl modules don't exist in your distribution package manager, then you can install manually:

Other distributions:

```
cpan install LWP::UserAgent'
cpan install Monitoring::Plugin'
cpan install JSON'
cpan install Switch'
```

 

## Grab latest version

Download from [here](https://github.com/zevenet/zevenet-monitoring-plugins/archive/master.zip).

```
wget https://github.com/zevenet/zevenet-monitoring-plugins/archive/master.zip 
unzip zevenet-monitoring-plugins-master.zip
```

 

## Copy check scripts

```
cd zevenet-monitoring-plugins-master
cp -r libexec/* /usr/lib/nagios/plugins/
```

 

## Create a RELIANOID API v4 key

Login into RELIANOID web interface and go to System > Users > Edit zapi user > Generate random key, we'll use this key as an authentication method to retrieve the metrics from RELIANOID ADC Load Balancer appliance. Finally make sure the zapi user is active.

 

## Test plugin manually

```
cd /usr/lib/nagios/plugins/
./check_zevenet_farm.pl -H ZLB-IP -z monitorkey -f ReverseProxy -w 20,20 -c 25,25
```

Example output:

```
Relianoid OK - profile='https' farm='ReverseProxy' listen='ZLB-IP:ZLB-Port' status='up' (established_connections='10') (pending_connections='0') | established_connections=10;20;25 pending_connections=0;20;25
```

 

## Add command definitions to Icinga

See Icinga command definitions example file in "icinga/icinga_commands.cfg" .

You can add the command definitions to your Icinga configuration:

```
cd zevenet-monitoring-plugins/icinga/
cat icinga_commands.cfg >> /usr/share/icinga2/include/command-plugins.conf
```

 

## Add service definitions to Icinga

See Icinga service definitions example file in "icinga/icinga_services.cfg" .

You can add the service definitions to your Icinga configuration:

```
cd zevenet-monitoring-plugins/icinga/
cat icinga_services.cfg >> /etc/icinga2/conf.d/services.conf
```

 

## Restart Icinga and have fun!

Restart Icinga process and access Icinga web interface to see the services you have just created.

```
/etc/init.d/icinga2 restart
```

 

# NRPE

You can use the check_nrpe plugin from the NRPE project to query the NRPE daemon. Icinga 2 provides the [nrpe check command](https://icinga.com/docs/icinga2/v2.11.0-rc1/doc/10-icinga-template-library/#plugin-check-command-nrpe) for this:

## Add command definitions to Icinga

See Icinga service definitions example file in "nrpe/nrpe_services.cfg" .

You can add the service definitions to your Icinga configuration:

```
cd zevenet-monitoring-plugins/nrpe/
cat nrpe_services.cfg >> /etc/icinga2/conf.d/services.conf
```

 

## Add command definitions to ZLB

See NRPE command definitions example file in "nrpe/nrpe_commands.cfg" .

You can add the command definitions to your NRPE configuration:

```
cd zevenet-monitoring-plugins/nrpe/
cat nrpe_commands.cfg >> /etc/nagios/nrpe.cfg
```

 

## Restart NRPE and Icinga and have fun!

Restart NRPE process and Icinga process and access Icinga web interface to see the services you have just created.

Execute command in ZLB:

```
/etc/init.d/nagios-nrpe-server restart
```

Execute command in Icinga:

```
/etc/init.d/icinga2 restart
```

 

### 📄 Download this document in PDF format