Plugin LSI RAID Monitoring

Plugin LSI RAID Monitoring umożliwia monitoring macierzy RAID na kontrolerach firmy LSI. Plugin jest napisany w języku skryptowym Perl i używa narzędzia wiersza poleceń storcli do interakcji z kontrolerem RAID.

Ten artykuł pokazuje konfigurację pod Linuksem. Więcej informacji na temat konfiguracji w systemie Windows można znaleźć w artykule Konfiguracja pluginu do monitoringu macierzy RAID LSI w Windows Server 2012.

Wersja

Aktualną wersję pluginu check_lsi_raid można znaleźć na stronie GitHub:

https://github.com/thomas-krenn/check_lsi_raid.git

Funkcje

W README tego pluginu znajduje się szczegółowa lista komponentów, które mogą być monitorowane:

README Pluginu w wersji 2.3 (github.com)

Wymagania

Wymagania wstępne są opisane szczegółowo w następnym rozdziale:

Na monitorowanym serwerze
- zainstalowany plugin check_lsi_raid
- zainstalowany storcli
- zainstalowany libfile-which-perl
- wpis sudoers dla użytkowników nagios i storcli
- podczas korzystania z NRPE, definicja komendy dla NRPE
Na serwerze Icingar
- definicja komendy
- definicja serwisu
- W przypadku korzystania z serwisu Call-Home
  - Dostępne szablony (Serwis Call-Home z oprogramowaniem Icinga lub Nagios)

Instalacja

Manualna

Podczas manualnej instalacji plik pluginu jest kopiowany do katalogu /usr/lib/nagios/plugins.

:~$ git clone https://github.com/thomas-krenn/check_lsi_raid.git
Cloning into 'check_lsi_raid'...
:~$ cd check_lsi_raid/
:~/check_lsi_raid$ ls
changelog  check_lsi_raid  README
:~/check_lsi_raid$ sudo cp check_lsi_raid /usr/lib/nagios/plugins/

Narzędzie LSI Storage Command Line Tool (StorCLI) można pobrać dla danego produktu i systemu operacyjnego ze strony internetowej LSI: http://www.lsi.com/Search/Pages/downloads.aspx?k=Latest%20StorCLI

Repozytorium TK Ubuntu

Po dodaniu repozytorium Thomas-Krenn (vide Repozytorium Ubuntu firmy Thomas Krenn) plugin check_lsi_plugin znajduje się w pakiecie nagios-plugins-thomas-krenn:

:~$ sudo apt-get install nagios-plugins-thomas-krenn
[...]
Suggested packages:
  arcconf storcli freeipmi-tools libipc-run-perl
The following NEW packages will be installed:
  nagios-plugins-thomas-krenn
0 upgraded, 1 newly installed, 0 to remove and 79 not upgraded.
Need to get 0 B/25.2 kB of archives.
After this operation, 127 kB of additional disk space will be used.
Selecting previously unselected package nagios-plugins-thomas-krenn.
(Reading database ... 68398 files and directories currently installed.)
Unpacking nagios-plugins-thomas-krenn (from .../nagios-plugins-thomas-krenn_0.3-1_all.deb) ...
Setting up nagios-plugins-thomas-krenn (0.3-1) ...

Proponowane pakiety storcli, libfile-which-perl należy również zainstalować:

:~$ sudo apt-get install storcli libfile-which-perl
[...]
The following NEW packages will be installed:
  storcli libfile-which-perl
[...]

Konfiguracja

Plugin nadaje się do monitorowania zdalnego serwera poprzez NRPE, jak i również lokalnego hosta. W każdym przypadku plugin check_lsi_raid musi być zainstalowany na monitorowanym systemie.

Przez NRPE

Na serwerze Icinga

Podczas tworzenia definicji hosta jest definiowane polecenie, które jest wykonywane przez NRPE. Parametry same w sobie są określone na hoście, który ma być monitorowany.

define service {
    service_description           lsi-raid-nrpe
    display_name                  LSI RAID
    use                           generic-service
    host_name                     test
    check_command                 check_nrpe_1arg!check_lsi_raid
}

Uwaga: Jeżeli ma być wykorzystywany serwis Call-Home to należy utworzyć szablony (templates) w oparciu o artykuł Serwis Call-Home z oprogramowaniem Icinga lub Nagios. Następnie przy Service należy wprowadzić use thomas-krenn-service, zamiast use generic-service.

Na serwerze Icinga 2

Konfiguracja pluginu LSI RAID przez NRPE na hoście Icinga 2 odbywa się w następujący sposób.

Definicja komendy Utwórz nowy plik o nazwie lsi-nrpe.conf z następującą zawartością w podkatalogu commands katalogu konfiguracyjnego Icinga 2, dla Ubuntu /etc/icinga2/conf.d.

object CheckCommand "nrpe-lsi" {
	import "plugin-check-command"
	command = [PluginContribDir + "/check_nrpe" ]
	arguments = {
        "-H" = "$address$"
        "-c" = "$nrpe_lsi$"
        }
}

Definicja reguły Apply Service

Tak zwane Apply Rule jest teraz tworzone w katalogu konfiguracyjnym Icinga 2, w ten sposób na hoście z odpowiednio skonfigurowanym parametrem jest ten check automatycznie wykonywany. W katalogu konfiguracyjnym Icinga 2 należy utworzyć folder services i następnie nowy plik o nazwie "lsi-raid.conf".

Ten nowy plik konfiguracyjny zawiera następujące polecenia:

apply Service "check-nrpe-lsi" {
	import "generic-service"
	check_command = "nrpe-lsi"
	assign where host.vars.nrpe_lsi
}

assign where host.vars.nrpe_lsi oznacza, że w przypadku, gdy monitowany host posiada parametr vars.nrpe_lsi z parametrem NRPE to service check "check-nrpe-lsi" jest automatycznie wykonywany przez NRPE na tym serwerze.

Definicja hosta W konfiguracji hosta należy dodać wiersz vars.nrpe_lsi.

object Host "Testserver" {
	import "generic-host"
	address = "<IP-Adresse>"
	vars.nrpe_lsi = "check_lsi_raid"
}

TKmon

Plugin LSI-Raid-Plugin jest już zintegrowany w katalogu usług kontrolnych TKmon. Podczas dodawania nowej usługi wystarczy wybrać check "LSI RAID via NRPE":

Na monitorowanym serwerze

Poniższa konfiguracja sudoers musi zostać zdefiniowana, żeby użytkownik "nagios" mógł korzystać z narzędzia wiersza poleceń z sudo bez wprowadzania hasła:

Uwaga: W CentOS deamon NRPE funkcjonuje pod użytkownikiem nrpe! Dlatego w CentOS, w konfiguracji sudo zamiast nagios musi być wprowadzone nrpe.

:~$ sudo vi /etc/sudoers.d/check_lsi_raid 
nagios ALL=(root)NOPASSWD:/usr/sbin/storcli
:~$ sudo chmod 440 /etc/sudoers.d/check_lsi_raid

W następującym teście nie powinno być wymagane podanie hasła:

:~$ sudo su nagios --shell /bin/bash
:~$ sudo /usr/sbin/storcli -V

      Storage Command Line Tool  Ver 1.03.11 Jan 30, 2013

    (c)Copyright 2012, LSI Corporation, All Rights Reserved.

Exit Code: 0x00

Plik konfiguracyjny NRPE określa, który check jest wykonywany, po wywołaniu polecenia "check_lsi_raid". Polecenie to musi być takie samo jak parametr po stronie serwera Icinga w definicji hosta.

Uwaga: W CentOS pomocne może być podanie interpretera dla wtyczki, np. perl /usr/lib/nagios/plugins/check_lsi_raid -C 0 -p /usr/sbin/storcli.

:~$ sudo vi /etc/nagios/nrpe.d/raid.cfg
command[check_lsi_raid]=/usr/lib/nagios/plugins/check_lsi_raid -C 0 -p /usr/sbin/storcli

:~$ sudo service nagios-nrpe-server restart

Po stronie serwera Icinga może zostać przetestowane, czy check funkcjonuje:

:~$ /usr/lib/nagios/plugins/check_nrpe -H 10.0.0.2 -c check_lsi_raid
OK (CTR, LD, PD, CV)|CV_Temperature=27;70;85 ROC_Temperature=62;80;90

Lokalnie

Konfiguracja lokalna jest przydatna, jeśli serwer Icinga lub Icinga 2 ma zainstalowany kontroler RAID LSI i dlatego musi być monitorowany. Opisane powyżej kroki, mające na celu zainstalowanie wtyczki storcli i konfiguracji sudo dla użytkownika nagios, są warunkami wstępnymi dla instalacji lokalnej.

Icinga

Lokalna konfiguracja wtyczki LSI RAID Monitoring Plugin w Icinga odbywa się w przedstawiony poniżej sposób.

Pierwszym krokiem jest stworzenie definicji polecenia Icinga:

:~$ sudo vi /etc/nagios-plugins/config/check_lsi_raid.cfg
define command {
        command_name    check_lsi_raid
        command_line    /usr/lib/nagios/plugins/check_lsi_raid -C '$ARG1$' -p '$ARG2$'
}

Definicja usługi może następnie użyć tego polecenia:

define service{
        use                             generic-service
        host_name                       tkmon
        service_description             lsi-raid
        check_command                   check_lsi_raid!0!/usr/sbin/storcli
}

Icinga 2

Lokalna konfiguracja w Icinga 2 przebiega w poniżej przedstawiony sposób.

Definicja komendy Np. w podkatalogu commands folderu konfiguracyjnego Icinga 2, w Ubuntu /etc/icinga2/conf.d, należy zapisać plik o nazwie lsi-raid.conf z następującą zawartością.

object CheckCommand "lsi-raid" {
        import "plugin-check-command"
        command = [ PluginDir + "/check_lsi_raid" ]
        arguments = {
                "-C" = {
                        required = true
                        value = "$lsi_controller_number$"
                        description = "The controller number to be checked."
                }
                "-p" = "/usr/sbin/storcli"
        }
}