In our previous tutorial, we discussed about Shinken monitoring framework installation on Ubuntu 14.04. Today, we will discuss how to monitor a Linux client with Shinken. For the purpose of this tutorial, we will monitor Ubuntu client. Although the same method will work for the other Linux distributions.
Step 1: Log in to Shinken server
First, log in to Shinken server as root user.
sudo su
And switch to the shinken user using command:
su shinken
Step 2: Search for Linux packs
Shinken uses predefined templates(packs) to monitor Linux, Windows.
We can see the list of available Linux packs using command:
shinken search linux
Sample output:
glances (david-guenault) [pack,system,linux,glances] : Standard check through checkglances.py and glances server linux-snmp (naparuba) [pack,linux,snmp] : Linux checks based on SNMP linux-ssh (naparuba) [pack,linux,ssh] : Linux checks based on SSH without any script on distant server pack-glances (david-guenault) [pack,system,linux,glances] : Standard check through checkglances.py and glances server raspberrypi (frescha) [pack,linux,raspberrypi,server,os] : Standard checks varnish-ssh (kokosny) [pack,linux,varnish,ssh] : varnish checks based on ssh
For windows clients, run:
shinken search windows
Sample output:
windows (naparuba) [pack,microsoft,windows,server,os,wmi] : Standard windows checks, like CPU, RAM and disk space. Checks are done by WMI.
We will test ssh pack. So, install it using command:
shinken install ssh
3. Create host file configuration for Client
Create a new file:
nano /etc/shinken/hosts/client.cfg
Add the following contents.
define host{
use linux,ssh
host_name sk
address 192.168.1.200
_SNMPCOMMUNITY P@ssw0rd
Save and close the file.
Here,
- use: Client uses the Linux template(linux-snmp);
- hostname: Client system name;
- address: Client system’s IP address;
- SNMPCOMMUNITY: Client system’s password.
Likewise you can edit the localhost.cfg file and add ssh tag on it.
nano /etc/shinken/hosts/localhost.cfg
define host{
use generic-host,ssh
contact_groups admins
host_name localhost
address localhost
}
Save and close the file.
Now, switch to root user and restart the shinken service.
exit
service shinken restart
4. Configure Client system
Go to your client system. Here, I will be using Ubuntu 14.04 client.
Install SNMPD package.
sudo apt-get install snmpd
Edit file:
sudo nano /etc/snmp/snmpd.conf
Comment the following line:
#agentAddress udp:127.0.0.1:161
Uncomment the following line:
agentAddress udp:161,udp6:[::1]:161
Find the following line, and set the password for the client system. You should use the same password as defined in the shinken server.
rocommunity P@ssw0rd default -V systemonly
Save and close the file.
Restart snmpd service:
sudo service snmpd restart
That’s it.
5. Check Shinken web interface
Now, go to the Shinken web interface and check the status of the client.
Click on the each host to find out the services.
For detailed configuration, check the Shinken’s official documentation page.
Cheers!
