Checkmk
Unsere KI-RichtlinieKI

1. Einleitung

CEE Es gibt Fälle, in denen eine Checkmk-Instanz den zu überwachenden Host nicht erreichen kann – beispielsweise, wenn eine Firewall eingehenden Datenverkehr blockiert. Bei Checkmk Ultimate können Sie das Checkmk Relay einsetzen, um Monitoring-Daten einzusammeln und zu Ihrer Checkmk-Instanz zu schicken.

1.1. Unterschiede zum verteilten Monitoring

Die folgenden Unterschiede verglichen mit verteiltem Monitoring sind zu beachten:

  • Die Kommunikationsrichtung: Das Relay sendet Daten immer zur Monitoring-Instanz.

  • Der Ort der Datenverarbeitung: Das Relay verarbeitet weder Daten, noch speichert es sie – es sammelt nur Monitoring-Daten ein und gibt sie weiter. Ausgenommen hiervon sind aktive Checks, deren Ergebnisse das Relay zunächst selbst ermittelt und dann an die Checkmk-Instanz weitergibt.

Die Verwendung des Relays in Kombination mit verteiltem Monitoring ist derzeit auf die Zentralinstanz beschränkt. In Umgebungen, die Checkmk Ultimate mit Multi-Tenancy bestimmungsgemäß einsetzen, gibt es daher derzeit keinen praktischen Nutzen für das Relay.

1.2. Funktionsumfang

Der gegenwärtige Stand des Relays umfasst die folgende Funktionalität:

Die Priorisierung der hinzugefügten Spezialagenten hängt vom Nutzen für die Anwendenden und dem benötigten Aufwand ab. Eine Liste der im Relay enthaltenen Spezialagenten kann auf GitHub eingesehen werden. Spezialagenten, die via MKP zu einer Checkmk-Instanz hinzugefügt wurden, werden nicht auf das Relay übertragen.

2. Einrichtung

2.1. Technische Voraussetzungen

Unterstützte Betriebssysteme

Das Checkmk Relay wird als Container für die Plattform x86-64 bereitgestellt. Derzeit werden die folgenden Betriebssysteme unterstützt:

  • Ubuntu Linux 24.04

  • Red Hat Enterprise Linux 8.10+, 9.7+ und 10

  • Windows Server 2022 und 2025

Beim Betrieb unter Windows läuft das Checkmk Relay auf dem Windows Subsystem for Linux in der Version 2 (WSL2). Dazu wird im Zuge der Installation eine Ubuntu-Distribution in WSL aufgesetzt.

Falls Sie Windows in einer virtuellen Maschine betreiben, muss dieses System verschachtelte Virtualisierung ermöglichen, damit das Relay erwartungsgemäß funktioniert.

Podman und Verbindung zu Docker Hub

Für die Installation stellen wir ein Skript bereit, das voraussetzt, dass das von der Distribution angebotene Podman-Paket vorhanden ist. Das benötigte Image für den Container wird bei der Installation und bei jedem Update direkt von Docker Hub heruntergeladen. Stellen Sie also sicher, dass Ihr Zielsystem eine Verbindung zu Docker Hub aufbauen kann.

Der Assistent für die Installation auf Linux-Systemen enthält einen Schritt für die explizite Installation von Podman. Bei der Installation unter Windows kümmert sich der von uns bereitgestellte MSI-Installer auch um die Installation von Podman innerhalb der WSL-Umgebung.

Wir haben uns für Podman entschieden, weil dessen enge Integration mit systemd automatische Updates des Relay-Containers erleichtert. Das Einrichten auf anderen Container-Runtimes als Podman, der Betrieb auf anderen als den genannten Distributionen, die Aktualisierung auf anderen Wegen als dem direkten Zugriff auf hub.docker.com, die Nutzung mit anderen Podman-Paketen als denen der Distribution oder die Verwendung von mehreren Relays auf einem Linux-Host mag für erfahrene Benutzer funktionieren – allerdings bietet Checkmk keinen Support für derartige Umgebungen an.

Sie können das Installationsskript auf anderen als den oben genannten Distributionen ausführen. Auf nicht unterstützten Distributionen fragt das Skript, ob Sie trotzdem fortfahren möchten. Anschließend wird geprüft, ob kompatible Versionen von Podman und systemd vorhanden sind.

Windows: Verbindung zu GitHub und zu cloud-images.ubuntu.com

Eine zusätzliche Voraussetzung unter Windows ist eine Verbindung zu GitHub zum Zeitpunkt der Installation. Diese Verbindung wird benötigt, um die neueste Version von WSL2 herunterladen und installieren zu können.

Im Zuge der Installation wird außerdem ein Linux-System von cloud-images.ubuntu.com für die WSL-Umgebung heruntergeladen.

Hardware-Anforderungen

In der Standardkonfiguration (13 Fetcher) sollte ein Arbeitsspeicherbedarf von etwa einem Gigabyte und die Auslastung eines Prozessorkerns aktueller Hardware mit weniger als 20 % eingeplant werden. Mit diesem Ressourcenumfang konnten wir problemlos mehr als 50 SNMP-Geräte überwachen. Bei einer deutlich höheren Zahl zu überwachender Geräte muss gegebenenfalls die Zahl der Fetcher erhöht werden. Nach oben skaliert der Ressourcenbedarf nahezu linear mit der Zahl zu überwachender Geräte.

Für jedes Relay, das bei einer Instanz registriert ist, kann die Anzahl der Fetcher über Setup > Hosts > Relays mit einem Klick auf das Symbol zum Bearbeiten (Symbol für das Bearbeiten.) angepasst werden.

2.2. Relay konfigurieren und installieren

Zum Einrichten eines Relays navigieren Sie zu Setup > Hosts > Relays. Klicken Sie dort auf Add Relay configuration, um den Einrichtungsassistenten zur Konfiguration eines neuen Relays zu starten. Wählen Sie zuerst zwischen Linux und Windows, um die passenden Anweisungen für Ihr Zielsystem zu erhalten.

Im Quick Setup für ein neues Relay zeigt der Schritt den curl-Befehl zum Herunterladen des Installationsskripts.
Im ersten Schritt wird der Downloadlink des Installationsskripts bereitgestellt

Folgen Sie den Anweisungen des Assistenten.

Linux
Windows
Linux

Im Assistenten für Linux-Systeme ist die Installation von Podman ein separater Schritt, den Sie einzeln auf dem Zielsystem ausführen.

Danach können Sie das bereitgestellte Installationsskript wie im Assistenten beschrieben ausführen. Beim Ausführen des Skripts wird der Container mit dem Relay heruntergeladen und eingerichtet, der Dienst für die Aktualisierung installiert und das Relay mit der Checkmk-Instanz verbunden — in einem einzigen Schritt.

Unter Linux wird keine eigene Log-Datei für die Installation angelegt. Bei Bedarf können Sie die Ausgabe des Installationsskripts in eine Datei umleiten.

Windows
Tip

Um das Relay bei Ihrer Checkmk-Instanz zu registrieren, weist der Assistent Sie an, die Installation mit einem Einmal-Token (one-time token) auszuführen. Dieses ist nach Erzeugung eine Stunde lang gültig. Sollte diese Stunde nicht ausreichend sein, können Sie die Registrierung auch mit Benutzername und Passwort eines Benutzers vornehmen, der ausreichende Berechtigungen für die Registrierung des Relays hat.

In der Checkmk-Instanz, zu der Sie eben das Relay hinzugefügt haben, müssen Sie jetzt noch die ausstehenden Änderungen aktivieren, um dessen Registrierung abzuschließen.

Hinweise zur Neuinstallation

Sie können ein bereits installiertes und registriertes Relay auf einem System durch ein anderes Relay ersetzen. Beginnen Sie mit der Deinstallation des vorhandenen Relays (mit anschließender Löschung des Relays in Ihrer Checkmk-Instanz). Folgen Sie dann erneut dem Installations-Assistenten in der Weboberfläche von Checkmk und vergeben Sie einen neuen Namen für das neue Relay.

Hosts, die bereits über das vorige Relay überwacht wurden, müssen dann explizit dem neu registrierten Relay zugeordnet werden — auch, wenn das Relay auf der gleichen Maschine läuft wie bisher.

2.3. Updates der Installation

Ein mit dem bereitgestellten Installationsskript verteiltes Checkmk Relay hält sich automatisch auf dem neuesten Stand. Sobald es erkennt, dass sich die Version der zugehörigen Checkmk-Instanz geändert hat, lädt es das passende Container Image von Docker Hub herunter und startet ohne manuellen Eingriff neu. Abhängig von Ihrer Netzwerkgeschwindigkeit kann dieser Vorgang bis zu 10 Minuten dauern.

Bei Problemen mit unvollendeten Updates beachten Sie bitte unsere Hinweise zum Troubleshooting.

2.4. Das Relay überwachen

Wenn Sie den Container überwachen möchten, in dem Sie das Relay betreiben, können Sie ihn über das Agentenplugin mk_podman zum Monitoring hinzufügen.

3. Monitoring mit dem Relay

3.1. Hosts mit dem Relay verknüpfen

Nachdem Sie das Relay eingerichtet haben, können Sie nun damit beginnen, Hosts zu diesem Relay zuzuordnen. Beim Hinzufügen eines Hosts aktivieren Sie Monitored on Relay im Abschnitt Basic settings und wählen Sie das Relay aus, welches den Host kontaktieren kann, den Sie gerade hinzufügen. Beachten Sie dabei, dass Hosts, die einem Relay zugeordnet sind, nicht mit dem Checkmk-Agenten überwacht werden können. Wählen Sie daher beim Erstellen von Hosts im Kasten Monitoring agents für die Einstellung Checkmk agent / API integrations eine der Optionen, die no Checkmk agent beinhalten.

Die gewünschte Art der Überwachung konfigurieren Sie anschließend für die zugeordneten Hosts mit den dafür zur Verfügung stehenden Regeln. Sie können dabei wählen zwischen Spezialagenten, SNMP-Monitoring und seit Version 2.5.0p18 von Checkmk auch einigen aktiven Checks.

Sobald die benötigten Regeln konfiguriert sind, beginnt das Relay damit, die relevanten Daten von den Hosts abzurufen und im Monitoring zur Verfügung zu stellen.

3.2. Zustand von Hosts mit aktiven Checks überwachen

Das Relay ermöglicht Ihnen seit Version 2.5.0p18 von Checkmk, aktive Checks für Hosts auszuführen, die zwar vom Relay, aber nicht direkt von Ihrer Checkmk-Instanz aus erreichbar sind. Das ist vor allem für solche Hosts nützlich, die nicht mit dem Checkmk-Agenten überwacht werden können oder für die ein spezielles Check-Intervall gewünscht ist.

Die folgenden aktiven Checks stehen bei Relay-überwachten Hosts zur Verfügung:

  • Check hosts with ping (ICMP echo request) / check_icmp zum Prüfen der Erreichbarkeit über IP und von Latenzen

  • Check certificates / check_cert zum Prüfen von Zertifikaten

  • Check HTTP web service / check_httpv2 zum Prüfen der Verfügbarkeit von Webdiensten

Bei Bedarf können Sie für ein Relay die Anzahl der maximal laufenden Helper für aktive Checks anpassen. Die Einstellung hierfür heißt Maximum concurrent active-check helpers und steht standardmäßig auf dem Wert 5. Sie erreichen die Einstellung unter Setup > Hosts > Relays mit einem Klick auf das Symbol zum Bearbeiten (Symbol für das Bearbeiten.).

Um aktive Checks für Relay-überwachte Hosts zu nutzen, konfigurieren Sie zuerst die gewünschten aktiven Checks. Nutzen Sie dann die Regel unter Setup > Hosts > Host monitoring rules > Host check command, um den Zustand eines Hosts vom zuvor konfigurierten Service abzuleiten.

3.3. Updates der Konfiguration

Jedes Relay kontaktiert die ihm zugeordnete Checkmk-Instanz regelmäßig für Konfigurations-Updates. Nachdem eine aktualisierte Konfiguration erhalten wurde, führt es die Checks für neu hinzugekommene Services sofort aus. Eine Service-Erkennung für Spezialagenten sollte schnell abgeschlossen sein, bei langsamen SNMP-Geräten kann es jedoch länger dauern. Generell ist die Verzögerung durch das Relay marginal und liegt in den meisten Fällen im Bereich weniger Sekunden.

4. Troubleshooting

Zur Erinnerung: Diese Komponente von Checkmk ist Work-in-Progress! Obwohl schon recht stabil, ist es möglich, dass Sie auf den einen oder anderen Bug stoßen.

Bei technischen Problemen kann es nützlich sein, das Verhalten und den Zustand des Relays und des Containers, in dem es läuft, zu untersuchen. Unter Windows wechseln Sie dafür zunächst in die WSL-Umgebung:

PS C:\Users\hhirsch> wsl.exe -d Ubuntu-Checkmk-Relay
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

Auf Linux-Systemen ist kein solcher Wechsel nötig.

Alle Befehle, die im Folgenden gezeigt werden, können auf Linux-Systemen direkt ausgeführt werden und auf Windows-Systemen nach dem Wechsel in die WSL-Umgebung.

4.1. Betriebszustand des Relays prüfen

Sie können über systemctl jederzeit prüfen, ob das Relay aktiv ist, und Details über seinen Betriebszustand einsehen:

user@host:~$ systemctl status checkmk_relay
● checkmk_relay.service - Checkmk Relay Container
     Loaded: loaded (/etc/containers/systemd/checkmk_relay.container; generated)
     Active: active (running) since Mon 2026-10-19 10:13:58 UTC; 1min 55s ago
   Main PID: 21434 (conmon)
      Tasks: 27 (limit: 11791)
     Memory: 573.0M (peak: 573.4M)
        CPU: 5.589s
     CGroup: /system.slice/checkmk_relay.service
             ├─libpod-payload-f3ff62713b3a6b12b338d3deba1aad69e38794ee59258ab6e45c174f376464f6
             │ ├─21446 python3 /opt/check-mk-relay/bin/cmk-relay daemon
             │ ├─21497 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21498 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21499 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21500 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21501 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21502 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21503 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21504 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21505 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21506 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21507 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21508 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21509 python3 /opt/check-mk-relay/bin/fetcher
             │ ├─21510 python3 -m cmk.fetcher_helper.fetch_ad_hoc
             │ ├─21511 python3 -m cmk.fetcher_helper.fetch_ad_hoc
             │ ├─21512 python3 -m cmk.fetcher_helper.fetch_ad_hoc
             │ ├─21513 python3 -m cmk.fetcher_helper.fetch_ad_hoc
             │ ├─21514 /opt/check-mk-relay/lib/cmc/checkhelper
             │ ├─21515 /opt/check-mk-relay/lib/cmc/checkhelper
             │ ├─21516 /opt/check-mk-relay/lib/cmc/checkhelper
             │ ├─21517 /opt/check-mk-relay/lib/cmc/checkhelper
             │ └─21518 /opt/check-mk-relay/lib/cmc/checkhelper
             └─runtime
               └─21434 /usr/bin/conmon --api-version 1 -c f3ff62713b3a6b12b338d3deba1aad69e38794ee59258ab6e45c174f376464f6 -u f3ff62713b3a6b12b338d3deba1aad69e38794ee59258ab6e45c174f376464f6 -r /usr/bin/runc -b /var/lib/containers/storage/overlay-containers/f3ff62713b3a6b12b338d3deba1aad69e38794ee59258ab6e45c174f376464f6/userdata -p /run/containers/storage/overlay-containers/f3ff62713b3a6b12b338d3deba1aad69e38794ee59258ab6e45c174f376464f6/userdata/pidfile -n checkmk_relay-container --exit-dir /run/libpod/exits --full-attach -l journald --log-level warning --syslog --runtime-arg --log-format=json --runtime-arg --log --runtime-arg=/run/containers/storage/overlay-containers/f3ff62713b3a6b12b338d3deba1aad69e38794ee59258ab6e45c174f376464f6/userdata/oci-log --conmon-pidfile /run/containers/storage/overlay-containers/f3ff62713b3a6b12b338d3deba1aad69e38794ee59258ab6e45c174f376464f6/userdata/conmon.pid --exit-command /usr/bin/podman --exit-command-arg --root --exit-command-arg /var/lib/containers/storage --exit-command-arg --runroot --exit-command-arg /run/containers/storage --exit-command-arg --log-level --exit-command-arg warning --exit-command-arg --cgroup-manager --exit-command-arg systemd --exit-command-arg --tmpdir --exit-command-arg /run/libpod --exit-command-arg --network-config-dir --exit-command-arg "" --exit-command-arg --network-backend --exit-command-arg netavark --exit-command-arg --volumepath --exit-command-arg /var/lib/containers/storage/volumes --exit-command-arg --db-backend --exit-command-arg sqlite --exit-command-arg --transient-store=false --exit-command-arg --runtime --exit-command-arg runc --exit-command-arg --events-backend --exit-command-arg journald --exit-command-arg container --exit-command-arg cleanup --exit-command-arg --rm --exit-command-arg f3ff62713b3a6b12b338d3deba1aad69e38794ee59258ab6e45c174f376464f6
user@host:~$ sudo podman container list
CONTAINER ID  IMAGE                                 COMMAND               CREATED         STATUS         PORTS       NAMES
f3ff62713b3a  localhost/checkmk_relay:checkmk_sync  sh -c cmk-relay d...  10 minutes ago  Up 10 minutes              checkmk_relay-container
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

4.2. Prüfung der Version des Relays

Die Version des Relay Container Image muss genau mit der Version der Checkmk-Instanz übereinstimmen, der es zugeordnet ist. Sie können die Version mit dem Befehl podman images überprüfen. Führen Sie diesen Befehl als Root oder mit vorangestelltem sudo aus, um sicherzustellen, dass die Ausgabe alle relevanten Images enthält:

root@linux# podman images
REPOSITORY                        TAG           IMAGE ID      CREATED       SIZE
docker.io/checkmk/check-mk-relay  2.5.0b1       423f9b67558b  5 months ago  428 MB
localhost/checkmk_relay           checkmk_sync  72c27637aa5a  5 months ago  428 MB
docker.io/checkmk/check-mk-relay  2.5.0b2       72c27637aa5a  5 months ago  428 MB
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

4.3. Neustart des Containers

Wie bereits erwähnt, ist Podman eng mit systemd integriert. Daher sind Neustarts von Containern einfach Neustarts von systemd-Units.

root@linux# systemctl restart checkmk_relay
root@linux# systemctl status checkmk_relay
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

4.4. Zustand des Aktualisierungsdienstes

Bei der Verteilung über das mitgelieferte Installationsskript richtet das Checkmk Relay einen Dienst ein, der das Container Image automatisch auf die gleiche Version wie die zugehörige Instanz aktualisiert und den Container anschließend neu startet.

Um den Status des Aktualisierungsdienstes für das Checkmk Relay zu überprüfen, führen Sie folgenden Befehl aus:

user@host:~$ systemctl status checkmk_relay-update-manager
○ checkmk_relay-update-manager.service - Checkmk Relay Update Manager
     Loaded: loaded (/etc/systemd/system/checkmk_relay-update-manager.service; static)
     Active: inactive (dead)
TriggeredBy: ● checkmk_relay-update-manager.path
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

Hier ist der Dienst geladen, es wurde jedoch noch keine Aktualisierung durchgeführt. Da die Aktualisierung selbst erst gestartet wird, wenn die relevante Triggerdatei geändert wird, zeigt der Dienst im obigen Beispiel den (irreführenden) Status inactive (dead).

Falls Sie feststellen, dass das Relay in einem Fehlerzustand ist, weil ein Update nicht durchgeführt werden konnte, können Sie dieses Problem manuell beheben. Setzen Sie zunächst den Fehlerzustand des Aktualisierungsdienstes zurück:

root@linux# systemctl reset-failed checkmk_relay-update-manager.service checkmk_relay-update-manager.path
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

Danach können Sie den Aktualisierungsdienst neu starten:

root@linux# systemctl restart checkmk_relay-update-manager.path
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

Prüfen Sie zum Abschluss, ob der Status des Aktualisierungsdienstes nach dem Neustart in Ordnung ist.

user@host:~$ systemctl status checkmk_relay-update-manager.path checkmk_relay-update-manager.service --no-pager
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

Wenn Sie den Dienst manuell neu starten und den Status unmittelbar danach überprüfen, werden Sie möglicherweise eine Ausgabe wie die folgende zu sehen bekommen:

user@host:~$ systemctl status checkmk_relay-update-manager
● checkmk_relay-update-manager.service - Checkmk Relay Update Manager
     Loaded: loaded (/etc/systemd/system/checkmk_relay-update-manager.service; static)
     Active: activating (start) since Tue 2026-10-20 17:47:38 CET; 46s ago
TriggeredBy: ● checkmk_relay-update-manager.path
   Main PID: 47108 (checkmk_relay-u)
      Tasks: 12 (limit: 9484)
     Memory: 772.8M (peak: 780.0M)
        CPU: 15.249s
     CGroup: /system.slice/checkmk_relay-update-manager.service
             ├─47108 /bin/bash /usr/local/bin/checkmk_relay-update-manager.sh
             └─47110 podman pull docker.io/checkmk/check-mk-relay:2.5.0p3
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

Hier zeigt der laufende Prozess podman pull, dass gerade ein Update läuft und der neueste Container heruntergeladen wird.

4.5. Log-Dateien prüfen

Falls etwas nicht richtig funktioniert oder Ihr Support-Ansprechpartner bei Checkmk Sie um Log-Einträge bittet, werfen Sie einen Blick in die Container-Logs. Verwenden Sie journalctl mit der Option -f (wie follow), um zehn Log-Zeilen anzuzeigen und hinzukommende Zeilen sofort auszugeben:

root@linux# journalctl -u checkmk_relay.service -f
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,711 - cmk.relay.processors.configuration - INFO - Adding task for processing new configuration [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","serial":"4","type":"'ConfigUpdateTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,711 - cmk.relay.processors.configuration - INFO - Processing configuration update task [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","serial":"4","type":"'ConfigUpdateTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,711 - cmk.relay.processors.configuration - INFO - Extracting config update [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","serial":"4","type":"'ConfigUpdateTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,715 - cmk.relay.processors.configuration - INFO - Config update extracted [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","serial":"4","type":"'ConfigUpdateTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,717 - cmk.relay.processors.configuration - INFO - Updated 'latest' symlink to point to serial '4' [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","serial":"4","type":"'ConfigUpdateTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,717 - cmk.relay.processors.configuration - INFO - Successfully unpacked configuration [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","serial":"4","type":"'ConfigUpdateTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,717 - cmk.relay.processors.subprocess_pool - INFO - Scaling pool fetcher to size: 13 [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","type":"'ApplyConfigTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,717 - cmk.relay.processors.subprocess_pool - INFO - Scaling pool adhoc-fetcher to size: 4 [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","type":"'ApplyConfigTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,718 - cmk.relay.processors.subprocess_pool - INFO - Scaling pool checkhelper to size: 5 [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","type":"'ApplyConfigTask'"}]
Oct 19 10:13:31 relayhost checkmk_relay-container[8525]: 2026-10-19 10:13:31,718 - cmk.relay - INFO - Log level set: INFO [context: {"id":"'c19550be-3d65-416a-857e-2fc95da94038'","type":"'ApplyConfigTask'"}]
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

4.6. Troubleshooting unter Windows

Hinweise zum Beheben spezifischer Probleme beim Betrieb unter Windows finden Sie in der Checkmk Knowledge Base.

5. Das Relay entfernen

Falls Sie das Relay nicht mehr benötigen, können Sie es deinstallieren.

Linux
Windows
Linux

Nutzen Sie zum Deinstallieren die Option --uninstall des Installationsskripts, wodurch das Relay ohne weitere Rückfrage entfernt wird.

root@linux# bash install_relay.sh --uninstall
=== Checkmk Relay Installer ===
[2026-03-14 11:52:55] [INFO] Checking prerequisites for uninstall...
[2026-03-14 11:52:55] [INFO] Uninstalling Checkmk Relay...
[2026-03-14 11:52:55] [INFO] Stopping services...
[2026-03-14 11:53:06] [INFO] Disabling services...
[2026-03-14 11:53:07] [INFO] Removing installed files...
[2026-03-14 11:53:07] [INFO] Removing data directories...
[2026-03-14 11:53:07] [INFO] Reloading Systemd daemon...
[2026-03-14 11:53:07] [INFO] Removing Podman volumes...
relay
[2026-03-14 11:53:07] [INFO] Relay uninstalled.

--------------------------------------------------------
The Checkmk Relay has been removed.
--------------------------------------------------------
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!
Windows

Vergessen Sie nicht, das verbundene Relay in Ihrer Checkmk-Instanz zu löschen, nachdem Sie das Relay entfernt haben.


Letzte Änderung: Thu, 12 Nov 2026 11:38:58 GMT via Commit ca992376b
Auf dieser Seite