How To Add Remote Linux Machines into Icinga 2 Server

4

ADVERTISEMENT

Setup Master with Clients

On the master node, create a new configuration directory using the following command.

mkdir -p /etc/icinga2/zones.d/master

We will now define the client nodes and apply service checks using the command endpoint execution method on them.

For this demo, I will create an individual configuration for each node instead of putting all nodes in the single hosts.conf file.

centos.itzgeek.local:

vi /etc/icinga2/zones.d/master/centos.itzgeek.local.conf

Add the following in the above file.

// Endpoints & Zones
object Endpoint "centos.itzgeek.local" {
}

object Zone "centos.itzgeek.local" {
     endpoints = [ "centos.itzgeek.local" ]
     parent = "master"
}

// Host Objects
object Host "centos.itzgeek.local" {
    check_command = "hostalive"
    address = "192.168.1.20"
    vars.client_endpoint = name //follows the convention that host name == endpoint name

// Custom Optional check - START
    vars.local_disks["/app Filesystem"] = {
       disk_partitions = "/app"
  }

    vars.local_http_vhosts["http"] = {
       http_uri = "/"
  }

    vars.local_tcp_port["tcp"] ={
       tcp_port = "23"
       service_name = "Telnet Check"
       port_number = "Port 23"
  }
// Custom Optional Check - END
}

Ubuntu.itzgeek.local:

vi /etc/icinga2/zones.d/master/ubuntu.itzgeek.local.conf

Simple monitoring check for Ubuntu.

// Endpoints & Zones
object Endpoint "ubuntu.itzgeek.local" {
}

object Zone "ubuntu.itzgeek.local" {
     endpoints = [ "ubuntu.itzgeek.local" ]
     parent = "master"
}

// Host Objects
object Host "ubuntu.itzgeek.local" {
    check_command = "hostalive"
    address = "192.168.1.30"
    vars.client_endpoint = name //follows the convention that host name == endpoint name
}

Since we have disabled inclusion of the conf.d directory during the setup icinga2 node wizard, we have to add services using command endpoint checks.

vi /etc/icinga2/zones.d/master/services.conf

Add the following basic services and few custom services.

// Ping Check
apply Service "Ping" {
  check_command = "ping4"
  assign where host.address // check is executed on the master node
}

// System Load
apply Service "System Load" {
  check_command = "load"
  command_endpoint = host.vars.client_endpoint // Check executed on client node
  assign where host.vars.client_endpoint
}

// System Process Count
apply Service "Process" {
  check_command = "procs"
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint
}

// Logged in User Count
apply Service "Users" {
  check_command = "users"
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint
}

// Disk Usage Check
apply Service "Disk" {
  check_command = "disk"
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint
}

// Disk Usage Check for Specific Partition
apply Service for (disk => config in host.vars.local_disks) {
  check_command = "disk"
  vars += config
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint
}

// System Swap Check
apply Service "SWAP" {
  check_command = "swap"
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint
}

// SSH Service Check
apply Service "SSH Service" {
  check_command = "ssh"
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint

}

// FTP Service Check
apply Service "FTP Service" {
  check_command = "ftp"
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint

}

// Icinga 2 Service Check
apply Service "Icinga2 Service" {
  check_command = "icinga"
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint
}

// Apache VirtualHost Check
apply Service for (http_vhost => config in host.vars.local_http_vhosts) {
  check_command = "http"
  vars += config
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint
}

// TCP Port Check
apply Service for (tcp_port => config in host.vars.local_tcp_port) {
  check_command = "tcp"
  vars += config
  display_name = + vars.service_name + " - " + vars.port_number
  command_endpoint = host.vars.client_endpoint
  assign where host.vars.client_endpoint
}

You can read more about service monitoring here.

Validate the configuration.

icinga2 daemon -C

Restart Icinga 2 on the master node.

### For Systemd Systems ###

systemctl restart icinga2

### For SysVinit Systems ###

service icinga2 restart

Monitor Remote Linux Machines with Icinga 2

Now, you should be able to see both machines in Icinga Web 2 dashboard.

Dashboard >> Overview >> Hosts.

If the client checks are yet to complete, then status would be shown as pending. Once all the service checks have been completed, you would get the accurate status of the services being monitored.
Add Remote Linux Machines into Icinga 2 Server - Hosts List
Add Remote Linux Machines into Icinga 2 Server – Hosts List

Click on the client machine to get the details of a particular node.

Add Remote Linux Machines into Icinga 2 Server - Host Status
Add Remote Linux Machines into Icinga 2 Server – Host Status

You can click on Services tab to see the status of checked services.

ADVERTISEMENT

centos.itzgeek.local:

Add Remote Linux Machines into Icinga 2 Server - CentOS Services Status
Add Remote Linux Machines into Icinga 2 Server – CentOS Services Status

ubuntu.itzgeek.local:

Add Remote Linux Machines into Icinga 2 Server - Ubuntu Services Status
Add Remote Linux Machines into Icinga 2 Server – Ubuntu Services Status

Hope this article series helped you to setup Icinga 2 on your environment.

That’s All.

You might also like