Spezialagenten

Auf einigen Hosts lässt sich der Checkmk-Agent nicht installieren und SNMP steht nicht — oder nicht befriedigend — zur Verfügung. Trotzdem kann Checkmk auch ein solches System überwachen — sofern es eine Anwendungsprogrammierschnittstelle (API) gibt, mit der Checkmk die Monitoring-Daten abholen kann. Eine solche API basiert in der Regel auf Telnet, SSH oder HTTP/XML.

Sie müssen sich um die Abfragen dieser APIs nicht selbst kümmern, denn Checkmk liefert für häufig benötigte Systeme die notwendigen, sogenannten Datenquellenprogramme mit aus, zum Beispiel für Amazon Web Services (AWS), Microsoft Azure und Google Cloud Platform (GCP), aber auch für NetApp, VMware ESXi, Prometheus, Elasticsearch, Cisco Meraki und viele andere mehr. Diese Programme erzeugen Agentenausgaben durch die Abfrage von Hardware oder Software über eine Management-API. Sie werden auch Spezialagenten genannt, weil sie eben ein spezieller Ersatz für den normalen Checkmk-Agenten sind.

Weil Spezialagenten teilweise recht komplexe Parameter benötigen, haben wir dafür spezielle Regelsätze in der Setup-GUI definiert, mit denen Sie diese direkt konfigurieren können. Diese Regelsätze finden Sie gruppiert nach Anwendungsfällen unter Setup > Agents > VM, cloud, container und Setup > Agents > Other integrations:

Die Spezialagenten sind unter ~/share/check_mk/agents/special/ installiert. Wenn Sie eine Modifikation an einem solchen Agenten machen möchten, dann kopieren Sie die Datei mit dem gleichen Namen nach ~/local/share/check_mk/agents/special/ und ändern Sie sie dort.

Nehmen Sie als Beispiel die Überwachung von NetApp Filers. Diese lassen die Installation eines Checkmk-Agenten nicht zu. Die SNMP-Schnittstelle ist langsam, fehlerhaft und unvollständig. Aber es gibt eine spezielle HTTP-Schnittstelle, welche Zugriff auf das NetApp-Betriebssystem Ontap und alle Überwachungsdaten liefert.

Der Spezialagent agent_netapp_ontap greift über eine REST-API auf diese Schnittstelle zu und wird über den Regelsatz NetApp via Ontap REST API als Datenquellenprogramm eingerichtet. Im Inhalt der Regel können Sie dann die Daten eingeben, die der Spezialagent braucht. Fast immer sind das irgendwelche Zugangsdaten. Beim NetApp-Spezialagenten gibt es unter anderen auch noch eine zusätzliche Checkbox für das Erfassen von Metriken (die hier recht umfangreich werden können):

Wichtig ist, dass Sie den Host in der Setup-GUI auf der Einstellung API integrations if configured, else Checkmk agent belassen.

Es gibt Situationen, in denen Sie sowohl einen Spezialagenten als auch den normalen Agenten abfragen möchten. Ein Beispiel dafür ist die Überwachung von VMware ESXi über das vCenter. Letzteres ist auf einer (meist virtuellen) Windows-Maschine installiert, auf welcher sinnvollerweise auch ein Checkmk-Agent läuft: