NSClient++

Der NSClient ist der Windows-Client für NRPE.
Downloaden kann man den Client hier: https://www.nsclient.org/download/
Der Nagiosserver fragt den NSClient per „check_nrpe“ ab.

Installation

Der Client kann defaultmäßig instliert werden.
Wenn nichts eingestellt ist, benötigt man Certifikate zur verschlüsselten Kommunikation zwischen Server und Client.
Benötigt man keine Verschlüsselung, kann diese in der Install-GUI abschalten, oder in der Konfiguration diesen Parameter wie folgt setzen:

insecure = true

Module

Der NSClient besteht aus Modulen, welche aktiviert und konfiguriert werden können.

Modulname	Beschreibung
NRPE	Protokol über das Nagios zum NSClient spricht.
NSCA	Protokol mit dem der Client zu Nagios kommunizieren kann
WEBServer	Webserver im NSClient

Konfiguration

Nach der Installation sollte die nsclient.ini, aus dem Installationsverzeichnis, angepasst werden. Man kann sich aber auch eine allgemeine Konfigurationsdatei erstellen, und
diese immer anwenden.
Nachdem die nsclient.ini angepasst wurde, muss der Dienst zwingend neugestartet werden.

Nachfolgend werden Konfigurationsbeispiele als einzelne Abschnitte der nsclient.ini beschrieben.

Defaults (unverschlüsselt)

Diese Defaults sollten immer angepasst werden.

[/settings/default]
allowed hosts = 127.0.0.1, <WEITERE_IP>, <WEITERE_IP>
bind to = 
cache allowed hosts = true
inbox = inbox
timeout = 30
use ssl = false

NRPE-Client

[/modules]
NRPEClient = 0

[/settings/NRPE/client]
channel = NRPE

NSCA-Client

[/modules]
NSCAClient = 0

[/settings/NSCA/client]
channel = NSCA
hostname = auto

Webserver

Die URL für die Webseite lautet https://127.0.0.1:8443/

[/modules]
; Start NSClient++ WebServer
WEBServer = 1

[/settings/WEB/server]
allowed hosts = 127.0.0.1
cache allowed hosts = true
certificate = ${certificate-path}/certificate.pem
password = <PASSWORD>
port = 8443

Aliase

Mit Aliasen kann man den eigentlichen Check-Befehlen, mit ihren Parametern, aussagekräftige Namen geben, welche in Nagios dann als Argument für den Befehl verwendet werden können.
Syntax:

[/settings/external scripts/alias]
<ALIAS_NAME> = <CHECK_COMMAND> <ARGUMENTS>

Beispiele:

[/settings/external scripts/alias]
; alias_cpu - Alias for alias_cpu. To configure this item add a section called: /settings/external scripts/alias/alias_cpu
alias_cpu = checkCPU warn=80 crit=90 time=5m time=1m time=30s

[/settings/external scripts/alias]
; alias_process - Alias for alias_process. To configure this item add a section called: /settings/external scripts/alias/alias_process
alias_process = checkProcState "$ARG1$=started"

; alias_process_count - Alias for alias_process_count. To configure this item add a section called: /settings/external scripts/alias/alias_process_count
alias_process_count = checkProcState MaxWarnCount=$ARG2$ MaxCritCount=$ARG3$ "$ARG1$=started"