Checkmk
to checkmk.com

1. Einleitung

Checkmk bietet eine Vielzahl von Features, die kontinuierlich weiterentwickelt und verbessert werden. Wie Sie Checkmk bei der täglichen Arbeit nutzen, bietet uns wertvolle Informationen, um die nächsten Versionen von Checkmk zu planen und zu entwickeln: Welche Features nutzen Sie oft? Wie viele Objekte überwachen Sie? Mit wie vielen Ordnern organisieren Sie Ihre Hosts? Nutzen Sie das Grafana-Plugin, und falls ja, in welcher Version?

Diese und ähnliche Informationen über Ihre Nutzung von Checkmk können uns helfen, die wichtigsten Features bei der Entwicklung höher zu priorisieren. Abkündigungen von Features können vermieden werden, wenn aus den Nutzungsdaten ersichtlich ist, dass die Features weiterhin gefragt sind.

Checkmk kann Daten über Ihre Produktnutzung automatisch in regelmäßigen Abständen an die Checkmk GmbH übermitteln. Diese Funktion ist verfügbar in den Versionen 2.5.0, ab 2.4.0p26 und ab 2.3.0p47.

Ohne Ihre aktive Einwilligung (Opt-In wie unten beschrieben) werden keinerlei Nutzungsdaten übertragen. Als Checkmk-Administrator entscheiden Sie selbst, ob Sie diese Datenübermittlung aktivieren, um die Weiterentwicklung der Software auf diese Weise mit zu beeinflussen.

Dieser Artikel beschreibt, wie Sie die Übermittlung von Produktnutzungsdaten in Ihrer Checkmk-Instanz ablehnen oder aktivieren können. Um einen Überblick darüber zu erhalten, was für Daten bei aktiver Datenübermittlung gesammelt werden, werfen Sie gerne einen Blick in das Product usage analytics manifest.

Checkmk wird Sie automatisch fragen, ob Sie Daten zur Analyse der Produktnutzung (product usage analytics) bereitstellen wollen. Ein modaler Dialog dazu wird Ihnen nach 30 Tagen auf einer entsprechenden Checkmk-Version in der GUI angezeigt.

2.1. Einstellungen in der GUI

Die Entscheidung über die Übermittlung von Nutzungsdaten obliegt denjenigen Benutzern Ihrer Instanz, die Administratorrechte haben. Sobald ein Administrator sich nach Ablauf von 30 Tagen in der Weboberfläche Ihrer Checkmk-Instanz anmeldet, erscheint ein Pop-up zur Analyse der Produktnutzungsdaten.

Das Pop-up zur Analyse der Produktnutzungsdaten erscheint beim Einloggen nach 30 Tagen.
Pop-up zur Übermittlung von Produktnutzungsdaten an die Checkmk GmbH

Falls Sie die Option Remind me again in 30 days wählen, wird Ihre Instanz weiterhin keinerlei Nutzungsdaten erheben und übermitteln. Nach weiteren 30 Tagen erscheint der modale Dialog in der gleichen Form erneut.

Die Option Manage in global settings führt Sie zur Seite für die Einstellung Ihrer Entscheidung zur Übermittlung der Produktnutzungsdaten. Hier stehen Ihnen drei Möglichkeiten zur Verfügung. Vorausgewählt ist die Option Disabled. Reminder scheduled.

In den globalen Einstellungen Ihrer Instanz finden Sie die Seite zum Konfigurieren der Übermittlung von Produktnutzungsdaten
Einstellungen zur Übermittlung von Produktnutzungsdaten

Um die Übermittlung von Nutzungsdaten zu aktivieren, wählen Sie die Option Allow collection and transmission of product usage data. Sie können dann noch Details zum HTTP proxy hinterlegen, der verwendet werden soll. Diese Informationen werden benötigt, falls von Ihrem Checkmk-Server aus keine direkte Verbindung ins Internet möglich oder gewünscht ist.

Selbstverständlich können Sie die Übermittlung auch ablehnen. In diesem Fall sind keine weiteren Einstellungen notwendig. Nachdem Sie die Option Do not collect product usage data ausgewählt haben, werden Sie keine weiteren Aufforderungen zum Übermitteln von Daten erhalten.

Über Setup > Global settings > Product usage analytics erreichen Sie jederzeit die Einstellung für Ihre Zustimmung oder Ablehnung, falls Sie sich später umentscheiden sollten.

2.2. Einstellungen in Ihrer Systemumgebung

Möglicherweise sind noch zusätzliche Einstellungen in Ihrer Systemumgebung nötig, bevor die Daten an die Checkmk GmbH gesendet werden können. Erlauben Sie ausgehende https-Verbindungen von Ihrem Checkmk-Server zu https://analytics.checkmk.com/upload auf Port 443.

3. Ihre Nutzungsdaten

Damit Sie entscheiden können, ob Sie mit der Übermittlung von Nutzungsdaten einverstanden sind, geben wir Ihnen hier einen Überblick darüber, welche Nutzungsdaten gemeint sind und wie sie gesammelt und verarbeitet werden.

3.1. Welche Daten werden übermittelt?

Es werden vor allem quantitative Daten über Ihre Produktnutzung gesammelt und übermittelt. Einen vollständigen Überblick über die Daten, die gesammelt werden, erhalten Sie im Product usage analytics manifest. Einen Link zu diesem Dokument finden Sie auch in Ihrer Checkmk-Instanz unter Help > About Checkmk > Product usage analytics manifest.

Ihre Nutzungsdaten werden in Form eines JSON-Objekts dargestellt und übermittelt.

Um zu erfahren, welche Daten Ihre Instanz zum aktuellen Zeitpunkt übermitteln würde, können Sie als Instanzbenutzer den Befehl cmk-product-usage --dry-run ausführen. Zum jederzeit aktuellen JSON-Datensatz gelangen Sie alternativ auch mit einem Klick auf Download the full JSON report auf der Einstellungsseite für die Übermittlung der Produktnutzungsdaten.

In der folgenden Beispielausgabe wurde das JSON-Objekt aus Gründen der Lesbarkeit gekürzt.

OMD[mysite]:~$ cmk-product-usage --dry-run
{
    "id": "2f1a0be7-69bd-44f4-b6af-cdce64136f57",
    "count_hosts": 596,
    "count_services": 11502,
    "count_folders": 35,
    "edition": "ultimate",
    "cmk_version": "2.5.0p1",
    "timestamp": 1770628100,
    "checks": {
        "check-mk": {
            "count": 593,
            "count_hosts": 593,
            "count_disabled": 0
        },
        "check_mk-uptime": {
            "count": 286,
            "count_hosts": 286,
            "count_disabled": 0
        },
        // ... some additional checks following the same pattern...
        "check_mk-liebert_chilled_water": {
            "count": 9,
            "count_hosts": 3,
            "count_disabled": 0
        },
        // ... and more checks...
    },
    "grafana": null
}
Befehl(e) in die Zwischenablage kopieren
Befehl(e) erfolgreich in die Zwischenablage kopiert!
Schreibzugriff auf die Zwischenablage wurde verweigert!

Anhand der enthaltenen Check-Namen kann die Checkmk GmbH auswerten, welche Check-Plugins wie viel genutzt werden. Auch Plugins, die Sie selbst geschrieben oder aus der Checkmk Exchange bezogen haben, werden hier aufgelistet.

Der Befehl cmk-product-usage --dry-run führt im Hintergrund alle Aktionen zum Sammeln der Daten aus, sendet aber keine Daten nach außen. Er dient allein zu Ihrer Information. Sie können ihn jederzeit ausführen, unabhängig von Ihren Einstellungen für die Analyse der Produktnutzung.

Übrigens wird die Sammlung von Nutzungsdaten mithilfe einer Reihe von Livestatus-Abfragen umgesetzt.

3.2. Was passiert mit den Daten?

Falls Sie sich entschieden haben, Ihre Produktnutzungsdaten an die Checkmk GmbH übermitteln zu lassen, läuft ab jetzt alles im Hintergrund. Es ist vorstellbar, dass dabei gelegentlich Probleme auftauchen, zum Beispiel wenn Ihr Server zum Zeitpunkt der Übermittlung nicht in der Lage ist, eine Verbindung zum Server der Checkmk GmbH aufzubauen. In diesem Fall schlägt der Vorgang fehl, ohne dass Sie darüber informiert werden. Sie können als Instanzbenutzer in der Log-Datei unter ~/var/log/product_usage_analytics.log nachsehen, zu welchen Zeitpunkten die Übermittlung stattgefunden hat und ob sie erfolgreich war.

Übermittlung an die Checkmk GmbH

Zu einem zufälligen Zeitpunkt in den ersten 30 Tagen nach dem Erteilen Ihrer Zustimmung wird der erste Datensatz zusammengestellt und versendet. Ab diesem Zeitpunkt wird die Sammlung und Übermittlung immer im Abstand von 30 Tagen wieder ausgeführt.

Ihre Instanz übermittelt die gesammelten Daten mit einer verschlüsselten POST-Anfrage von Ihrem Checkmk-Server via https an https://analytics.checkmk.com/upload auf Port 443.

Speicherung und Analyse

Unabhängig davon, wo Sie Ihre Checkmk-Instanz betreiben, werden Ihre Nutzungsdaten immer an einen Server der Checkmk GmbH in der AWS-Region Europe (Frankfurt) übermittelt (eu-central-1) und dort gespeichert.

Bei der Speicherung wird keine Verknüpfung zwischen sendenden Instanzen und empfangenen Datensätzen hergestellt — die Daten werden anonym ausgewertet. Mit statistischen Analysen über alle erhaltenen Daten erkennen wir Trends über die Nutzung der verschiedenen Funktionen von Checkmk.

Jeder empfangene Datensatz wird für fünf Jahre gespeichert und anschließend gelöscht.

4. Nutzungsdaten übermitteln im verteilten Monitoring

Auch im verteilten Monitoring können Daten über die Produktnutzung gesammelt und übermittelt werden.

4.1. Zentralinstanz und Remote-Instanzen konfigurieren

Die modale Dialogbox über die Übermittlung von Produktnutzungsdaten wird nur auf der Zentralinstanz angezeigt. Hier können Sie die gewünschte Einstellung festlegen wie im Abschnitt Datenübermittlung erlauben oder ablehnen beschrieben. Sie können selbst steuern, ob die einzelnen Remote-Instanzen Nutzungsdaten übermitteln oder nicht.

Für jede Remote-Instanz haben Sie beim Einrichten des verteilten Monitoring festgelegt, ob die Konfiguration der Zentralinstanz auf die jeweilige Remote-Instanz repliziert werden soll. Die Einstellung hierfür finden Sie in den Eigenschaften der Remote-Instanz unter Setup > General > Distributed monitoring. Von dieser Option hängt das Verhalten der Instanzen im verteilten Monitoring in Bezug auf die Übermittlung von Produktnutzungsdaten ab:

  • Haben Sie für eine Remote-Instanz die Option Enable replication auf den Wert Push configuration to this site gesetzt, handelt es sich um ein verteiltes Monitoring mit zentralem Setup. In diesem Fall werden Ihre Einstellungen zur Übermittlung der Produktnutzungsdaten automatisch für diese Instanz übernommen.

  • Haben Sie die Replikation der Konfiguration für eine Remote-Instanz deaktiviert (No replication with this site), wird auch Ihre Entscheidung zur Übermittlung von Nutzungsdaten nicht auf die Remote-Instanz übertragen.

  • Sie können selbstverständlich jederzeit aktiv die Einstellung zur Datenübermittlung für jede Remote-Instanz individuell ändern, indem Sie unter Setup > General > Distributed monitoring auf die Site specific global settings für die jeweilige Instanz zugreifen.

4.2. Übermittlungsverhalten von Zentralinstanz und Remote-Instanzen

Falls Sie sich in einem Szenario mit verteiltem Monitoring entscheiden, Produktnutzungsdaten an die Checkmk GmbH übermitteln zu lassen, werden Ihre Instanzen sich folgendermaßen verhalten:

  • Jede Remote-Instanz mit aktivierter Übermittlung der Produktnutzungsdaten wird ihre eigenen Nutzungsdaten sammeln und diese auch eigenständig direkt an die Checkmk GmbH übermitteln.

  • Die Zentralinstanz wird ausschließlich ihre eigenen Nutzungsdaten sammeln und diese direkt an die Checkmk GmbH übermitteln.

  • Jede Instanz mit aktivierter Übermittlung der Produktnutzungsdaten übermittelt genau die Daten, die im Abschnitt zum Product usage analytics manifest beschrieben werden.

  • Auf jeder Instanz mit aktivierter Übermittlung der Produktnutzungsdaten wird die Log-Datei ~/var/log/product_usage_analytics.log angelegt.

4.3. Konfiguration in Checkmk Ultimate mit Multi-Tenancy

Das Verhalten von Instanzen in Checkmk Ultimate mit Multi-Tenancy in Bezug auf die Übermittlung von Produktnutzungsdaten ist analog zum beschriebenen Verhalten im verteilten Monitoring.


Letzte Änderung: Thu, 02 Apr 2026 07:08:04 GMT via Commit a447e888f
Auf dieser Seite